Claude Code 完全指南：从安装配置到实战，重新定义你的编程方式

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

# 首次运行，会引导你登录 Anthropic 账号
claude

# 方式 1：直接登录（推荐个人用户）
# 首次运行 claude 时会自动引导登录浏览器

# 方式 2：官方 API Key
export ANTHROPIC_API_KEY="sk-ant-..."
claude

# 方式 3：第三方中转站 / API 代理（国内用户常用）
# 设置 API Key（中转站提供的 key）
export ANTHROPIC_API_KEY="sk-..."
# 关键：设置 Base URL 指向中转站地址
export ANTHROPIC_BASE_URL="https://your-proxy.example.com"
claude

# 方式 4：Amazon Bedrock / Google Vertex
# 适合企业用户走云厂商的 AI 网关
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION="us-east-1"
claude

# 启动 claude 后，运行：
/cost
# 如果能正常显示用量信息，说明连接没问题

# 也可以用 /status 查看当前连接状态
/status

# 如果连接失败，常见原因：
# 1. Base URL 末尾不要加 /（错：https://api.xxx.com/）
# 2. 确认中转站支持 Claude Code 所需的 API 端点
#    （需要支持 /v1/messages 的 streaming 接口）
# 3. 检查中转站是否支持你选择的模型版本

# 在对话中切换模型
/model

# 可选项：
# - claude-sonnet-4-6   → 日常开发（默认，速度快）
# - claude-opus-4-6     → 复杂任务（更聪明，更贵）
# - claude-haiku-4-5    → 简单任务（最快最便宜）

# 也可以用快捷切换
/model opus    # 切到 Opus
/model sonnet  # 切回 Sonnet

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            // 只对 ts/vue 文件执行
            "command": "echo $CLAUDE_FILE_PATH | grep -E '\\.(ts|vue)$' && npx eslint --fix $CLAUDE_FILE_PATH || true"
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            // 拦截 force push 和 reset --hard
            "command": "echo \"$CLAUDE_TOOL_INPUT\" | grep -qE '(push.*--force|reset.*--hard)' && echo 'BLOCKED: 禁止 force push 和 hard reset' && exit 1 || true"
          }
        ]
      }
    ]
  }
}

# 1. 全局配置（所有项目生效）
~/.claude/settings.json

# 2. 项目团队配置（提交到 git，团队共享）
项目/.claude/settings.json

# 3. 项目个人配置（不提交到 git）
项目/.claude/settings.local.json

{
  "permissions": {
    // 允许的 Bash 命令模式
    "allow": [
      "Bash(npm run *)",
      "Bash(pnpm *)",
      "Bash(npx nuxi *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Edit(*)",
      "Read(*)",
      "Write(*.vue)",
      "Write(*.ts)"
    ],
    // 始终拒绝的操作
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)",
      "Write(.env*)"
    ]
  }
}

{
  "env": {
    // 传递给 Claude 的 shell 环境
    "NODE_ENV": "development",
    "DEBUG": "true",

    // Anthropic 相关
    "ANTHROPIC_API_KEY": "sk-ant-...",

    // 代理设置（公司网络）
    "HTTPS_PROXY": "http://proxy.company.com:8080"
  }
}

# 安装 VS Code 扩展
# 在 VS Code 扩展市场搜索 "Claude Code" 安装

# 或者命令行安装
code --install-extension anthropic.claude-code

# 启动后可以用 Ctrl+Shift+P 搜索 Claude 相关命令
# 也可以直接在 VS Code 终端中运行 claude