Claude Code 完整使用指南

1. 安装与更新

安装

macOS/Linux:

npm install -g @anthropic-ai/claude-code
# 或
curl -sL https://claude.ai/claude-code/install.sh | sh

Windows:

npm install -g @anthropic-ai/claude-code
# 或
winget install anthropic.claude-code

版本检查与更新

claude --version    # 查看版本
npm update -g @anthropic-ai/claude-code   # npm 更新
claude update       # 或使用此命令更新

2. 常用指令 (Slash Commands)

核心命令

版本控制命令

文件操作命令

开发流程命令

快捷键

3. 权限模式

Claude Code 采用分级权限系统，配置在 settings.json 中。

权限级别

• Read-only - 只读，禁止修改文件
• Standard - 标准，允许常见操作
• Developer - 开发者，允许危险操作
• Admin - 管理员，完全访问

交互模式

{
  "permissionMode": "ask"  // ask | allow | deny
}

快速切换命令

# 查看当前权限模式
claude config get permissionMode

# 启动时指定（单次会话）
claude --permission-mode allow

# 完全绕过模式（危险！）
claude --dangerously-skip-permissions

权限配置示例

{
  "permissions": {
    "allow": ["Read", "Write", "Bash:git", "Bash:npm"],
    "deny": ["Bash:rm", "Bash:format", "Write:/etc/**"]
  }
}

允许/禁止特定命令

{
  "permissions": {
    "allowCommands": ["/help", "/clear", "/commit"],
    "denyCommands": ["/sudo", "/shell"]
  }
}

auto 模式（需 Team 套餐）

在 CLI 中按 Shift+Tab 循环切换：default → acceptEdits → plan → auto

• 需要 --enable-auto-mode 参数启动
• 还需要 Team 套餐（或 Enterprise/API 套餐）

claude --enable-auto-mode

4. 使用技巧

1. 明确任务描述 - 包含具体目标和约束
2. 分步骤操作 - 将复杂任务分解
3. 善用自动补全 - Tab 键加速输入
4. 上下文管理 - 定期 /clear 清除不需要的上下文
5. 文件 glob 模式 - 使用 **/*.js 等通配符匹配
6. 定期保存会话 - /save 保存重要会话

常用工作流

快速修复工作流:

描述问题 → 获取修复建议 → 预览更改 → 确认应用

开发新功能工作流:

/branch 新功能分支 → 实现代码 → /test 运行测试 → /commit 提交 → /review 代码审查

5. MCP 服务器配置

什么是 MCP

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

配置示例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem"],
      "env": { "ALLOWED_DIRECTORIES": "/home/user/projects" }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    }
  }
}

常用 MCP 服务器

6. Hooks 配置

Hooks 允许在特定事件发生时自动执行脚本。

Hook 类型

配置示例

{
  "hooks": {
    "pre-command": [{ "command": "npm run lint", "description": "运行 lint" }],
    "post-commit": [{ "command": "git push", "description": "自动推送" }]
  }
}

7. IDE 集成

VS Code

安装 “Claude Code” 扩展后配置:

{
  "claude.enabled": true,
  "claude.apiKey": "your-api-key",
  "claude.autocomplete": true
}

JetBrains

安装 “Claude Code” 插件，配置 API Key 即可。

其他 IDE

8. 配置文件位置

9. 环境变量

export ANTHROPIC_API_KEY="your-api-key"
export ANTHROPIC_BASE_URL="https://api.anthropic.com"
export ANTHROPIC_MODEL="claude-opus-4"
export CLAUDE_DEBUG=true

10. 故障排除

claude --help           # 显示帮助
claude --version        # 版本信息
claude config --show    # 检查配置
claude doctor           # 诊断问题

附录：启动参数大全