Claude Code 使用指南

weixin_53165181

808人浏览 · 2026-03-19 16:53:42

weixin_53165181 · 2026-03-19 16:53:42 发布

Claude Code 使用指南

Claude Code 是 Anthropic 官方推出的 CLI 工具，可以直接在终端中与 Claude 进行对话，帮助你完成编码、调试、重构等开发任务。

1. 安装 Claude Code

系统要求

操作系统：macOS、Linux 或 Windows (通过 WSL)
网络：需要能够访问 Anthropic API

安装方式

macOS / Linux

使用 Homebrew

brew install anthropic/claude-code/claude-code

或使用安装脚本

curl -fsSL https://raw.githubusercontent.com/anthropics/claude-code/main/install.sh | sh

npm 安装（推荐）

npm install -g @anthropic-ai/claude-code

验证安装

claude --version

登录认证

安装后首次使用会提示登录：
Claude code国内无法登录可以本地使用，调用第三方模型
如果可以科学上网就可以使用
登录命令/login

claude

系统会自动打开浏览器进行 OAuth 登录
或设置环境变量 ANTHROPIC_API_KEY 使用自己的 API Key

2. 基础用法

启动对话

# 直接启动交互式对话
claude

# 指定模型
claude --model opus

# 指定模型并附带系统提示
claude --model sonnet --system "你是一个Python专家"

启动参数

参数	说明
`--model`	选择模型：`opus`、`sonnet`、`haiku`
`--system`	设置系统提示词
`--dangerously-skip-permissions`	跳过权限确认（慎用）
`--resume [id]`	恢复之前的对话
`--output-format`	输出格式：`text`、`json`

基本对话操作

发起请求：直接输入问题或任务描述
多轮对话：在提示符下继续输入，Claude 会记住上下文
退出对话：输入 exit 或按 Ctrl+C

核心命令

在 Claude Code 会话中可使用以下命令：

命令	说明
`/help`	显示帮助信息
`/clear`	清除当前对话历史
`/model [name]`	切换模型
`/commit`	生成 Git 提交信息
`/review-pr [url]`	审查 Pull Request
`/compact`	压缩对话上下文
`/exit`	退出 Claude Code

常用场景示例

代码审查

claude
> 审查一下 src/auth/login.py 的代码

Bug 修复

claude
> 修复这个错误：NullPointerException at line 42

代码解释

claude
> 解释一下这段代码的作用

重命名变量

claude
> 将所有 camelCase 变量改为 snake_case

3. 高级用法

3.1 MCP 服务器配置

MCP (Model Context Protocol) 允许 Claude Code 访问外部工具和数据源。

配置文件位置

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Linux
~/.config/Claude/claude_desktop_config.json

配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-postgres", "postgresql://localhost:5432/mydb"]
    }
  }
}

常用 MCP 服务器

服务器	功能
`@anthropic/mcp-server-filesystem`	文件系统读写
`@anthropic/mcp-server-github`	GitHub API 操作
`@anthropic/mcp-server-postgres`	PostgreSQL 数据库
`@anthropic/mcp-server-brave`	Brave 搜索
`@anthropic/mcp-server-slack`	Slack 集成

3.2 Hooks 配置

Hooks 允许在特定事件触发自定义脚本。

配置文件: ~/.claude/settings.json

{
  "hooks": {
    "PostToolUse": [
      {
        "name": "lint-check",
        "prompt": "检查代码是否符合 lint 规范"
      }
    ],
    "AfterMessage": [
      {
        "name": "log-conversation",
        "command": "echo '{PROMPT} -> {RESPONSE}' >> ~/claude_logs.txt"
      }
    ]
  }
}

3.3 项目级配置文件

在项目根目录创建 .claude 目录：

mkdir -p .claude

.claude/settings.json - 项目级设置

{
  "model": "sonnet",
  "maxTokens": 8192,
  "permissions": "auto"
}

.claude/commands/ - 自定义命令

mkdir -p .claude/commands

创建文件 .claude/commands/security-review.md：

# Security Review

对代码进行安全审查，检查：
1. SQL 注入风险
2. XSS 漏洞
3. 敏感信息泄露
4. 认证/授权问题

使用时输入 /security-review 即可调用。

3.4 Permissions 控制

# 允许所有操作（不推荐）
claude --allow-all

# 交互式确认每个操作
claude --prompt "重构 src/ 目录"

# 自动拒绝危险操作
claude --safe

3.5 上下文管理

手动压缩上下文

/compact

这会总结之前的对话，减少 token 消耗。

使用 --context-ratio 控制上下文

claude --context-ratio 0.5

3.6 多模态能力

图片分析

claude
> 分析这张截图中的错误信息
[粘贴图片或使用图片路径]

PDF 读取

claude
> 总结这个 PDF 文档的内容
# 使用 /pdf skill 读取 PDF 文件

4. 配置第三方模型

4.1 使用 OpenAI 兼容 API

Claude Code 支持配置兼容 OpenAI API 格式的第三方模型。

配置文件: ~/.claude/settings.json

{
  "models": [
    {
      "name": "gpt-4",
      "apiType": "openai",
      "baseURL": "https://api.openai.com/v1",
      "apiKey": "sk-xxxxx",
      "default": false
    },
    {
      "name": "local-llama",
      "apiType": "openai",
      "baseURL": "http://localhost:11434/v1",
      "apiKey": "not-needed",
      "default": false
    }
  ]
}

4.2 使用 Anthropic API（默认）

{
  "apiKey": "sk-ant-xxxxx",
  "baseURL": "https://api.anthropic.com"
}

4.3 使用 Azure OpenAI

{
  "models": [
    {
      "name": "azure-gpt-4",
      "apiType": "azure",
      "baseURL": "https://your-resource.openai.azure.com",
      "apiKey": "your-api-key",
      "azureDeployment": "gpt-4",
      "azureApiVersion": "2024-02-01"
    }
  ]
}

4.4 使用本地模型（Ollama）

{
  "models": [
    {
      "name": "llama3",
      "apiType": "openai",
      "baseURL": "http://localhost:11434/v1",
      "apiKey": "not-needed"
    }
  ]
}

启动 Ollama 后，直接使用：

claude --model llama3

4.5 Claude Code 配置文件完整示例

~/.claude/settings.json:

{
  "model": "claude-opus-4-5",
  "maxTokens": 8192,
  "temperature": 0.7,
  "apiKey": "${ANTHROPIC_API_KEY}",
  "baseURL": "https://api.anthropic.com",

  "models": [
    {
      "name": "claude-opus-4-5",
      "apiType": "anthropic"
    },
    {
      "name": "gpt-4-turbo",
      "apiType": "openai",
      "baseURL": "https://api.openai.com/v1",
      "apiKey": "${OPENAI_API_KEY}"
    },
    {
      "name": "local-qwen",
      "apiType": "openai",
      "baseURL": "http://localhost:11434/v1",
      "apiKey": "not-needed"
    }
  ],

  "permissions": {
    "allow": ["Read", "Write", "Bash"],
    "deny": ["Network"]
  },

  "hooks": {
    "PreToolUse": [],
    "PostToolUse": []
  },

  "mcpServers": {}
}

也可以使用 CC Switch 软件中配置

5. 其他进阶用法

5.1 Slash Commands 自定义

在 .claude/commands/ 目录创建自定义命令：

.claude/commands/test.md

# Run Tests

运行项目的测试套件：

1. 检测项目类型（Python/JS/Rust 等）
2. 执行对应的测试命令
3. 报告测试结果和覆盖率

5.2 Agent 模式

# 使用子 agent 并行处理任务
claude
> 使用3个agent同时审查 src/auth、src/api、src/utils 三个目录的代码

5.3 批处理模式

# 对多个文件执行操作
claude --batch "审查以下文件的代码风格" \
  src/auth/login.py \
  src/auth/logout.py \
  src/auth/register.py

5.4 与 Git 集成

生成提交信息

claude
/commit

交互式 rebase

claude
> 使用交互式 rebase 将最近5个提交压缩成一个

5.5 环境变量配置

# 设置 API Key
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 设置代理
export HTTPS_PROXY="http://proxy:8080"

# 设置日志级别
export CLAUDE_LOG_LEVEL="debug"

5.6 Tab 功能（交互式补全）

在交互模式下：

Tab - 接受建议
Shift+Tab - 拒绝建议
Alt+Enter - 强制换行

5.7 配置文件热重载

修改配置后无需重启，下次命令执行时自动加载新配置。

5.8 调试模式

# 启用详细日志
claude --verbose

# 输出完整请求/响应
claude --debug

5.9 常见问题排查

问题	解决方案
`Permission denied`	检查文件权限，使用 `--allow-all` 或配置权限
`API key invalid`	验证 API Key 是否正确，检查是否过期
连接超时	检查网络设置，考虑使用代理
上下文过长	使用 `/compact` 压缩或开启新对话