Claude Code 深度解析：Anthropic 终端 AI 编程助手实战指南

2.3 Web 版与桌面端

访问 claude.ai/code 即可使用，支持桌面浏览器和 iOS App。桌面应用内集成了入口，支持 /desktop 命令将终端会话迁移到桌面进行可视化 Review。

三、安装与配置

3.1 账号要求

需要以下之一：

• Claude Pro 订阅（$20/月）
• Claude Max 订阅（$100~$200/月）
• Team / Enterprise 席位
• Anthropic Console API Key（按量计费）

注意： 国内用户需配合网络代理使用。API Key 方式对代理配置更灵活，可设置 ANTHROPIC_BASE_URL 环境变量指向第三方中转服务。

3.2 安装方式

macOS（Homebrew）：

brew install claude-code

⚠️ Homebrew 安装不会自动更新，需定期执行 brew upgrade claude-code

通用推荐（官方安装包）： 官网下载页提供原生安装包，支持后台自动更新。

旧方式（npm，已弃用）：

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

⚠️ 官方已将 npm 安装方式标记为 Deprecated，建议迁移到原生安装。

3.3 首次登录

进入项目目录运行 claude，首次会自动打开浏览器授权。若使用 API Key：

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx" claude

如需通过代理：

export ANTHROPIC_BASE_URL="https://your-proxy-endpoint.com"
export ANTHROPIC_API_KEY="your-key"
claude

四、核心用法详解

4.1 启动与基础对话

进入项目根目录后运行 claude，直接用自然语言描述需求：

# 生成测试用例
> 帮我找出所有没有单元测试覆盖的函数，并为它们生成测试用例

# 排查错误
> 我的 API 在高并发下会报 500 错误，帮我排查原因

# 重构代码
> 把 src/components 目录下所有 Class Component 重构为 Function Component

Claude Code 会自动扫描代码库、分析文件、执行 Shell 命令、修改文件并展示 Diff 等待确认。

4.2 一次性执行模式

适合 CI/CD 或脚本场景：

# 单次任务
claude -p "检查本次 git diff 中是否有安全漏洞"

# 结合管道
tail -f app.log | claude -p "如果发现异常日志，立刻通知我"

# 批量处理
git diff main --name-only | claude -p "Review 这些改动文件中的安全问题"

4.3 会话管理

# 继续上次会话
claude -c
# 恢复指定历史会话
claude -r <session-id>

4.4 斜杠命令

输入 / 触发内置命令：

4.5 引用与命令注入

• @ 引用文件：> @src/auth/login.ts 这里的 token 验证逻辑有 Bug，帮我修复
• ! 执行命令：> ! npm test，根据报错帮我修复

五、CLAUDE.md：项目记忆系统

这是最独特的功能之一。CLAUDE.md 是放在项目根目录的 Markdown 文件，每次新会话都会读取，相当于给 AI 写的"项目说明书"。

5.1 层级结构

遵循就近优先原则：

• ~/.claude/CLAUDE.md：全局级（个人偏好）
• ./CLAUDE.md：项目级（团队共享）
• ./src/components/CLAUDE.md：子目录级（模块指引）

5.2 示例内容

# 项目说明：电商后台管理系统
## 技术栈
- 前端：React 18 + TypeScript + Tailwind CSS
- 后端：Node.js + Fastify + Prisma + PostgreSQL
## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
## 代码规范
- 所有新组件必须是 Function Component
- 数据校验使用 Zod schema
## 注意事项
- `src/legacy/` 目录是历史遗留代码，不要修改

5.3 自动记忆

从 2026 年 2 月起，新增了自动记忆机制。Claude 会主动识别有价值的信息并在后续会话调用。存储位置可通过 settings.json 中的 autoMemoryDirectory 自定义。

六、Skills：技能库

Skills 是可复用的技能扩展机制。将特定领域的操作规范写成 Skill 文件，Claude 会在需要时自动调用。

.claude/
└── skills/
    ├── react-component.md
    ├── api-design.md
    └── code-review.md

与 CLAUDE.md 的区别在于：前者按需加载，后者全局读取。注意沙盒模式下 .claude/skills/ 目录只读。

七、MCP：外部工具生态

MCP（Model Context Protocol）是连接 AI 工具与外部数据的开放标准协议。

7.1 连接能力

通过配置 MCP Server，可以：

• 读取 Google Drive 文档
• 在 Jira 创建/更新任务
• 查询 Slack 消息
• 调用内部工具 API

7.2 添加 Server

# 添加普通 Server
claude mcp add
# 添加 OAuth 支持的 Server
claude mcp add --client-id <id> --client-secret <secret>

也可编辑配置文件 ~/.claude/settings.json。

八、自定义命令与 Hooks

8.1 自定义 Slash 命令

在项目根目录创建 .claude/commands/ 目录，添加 Markdown 文件即可封装工作流。

例如 /review-pr：

请对当前 git diff 做一次全面的 Code Review，检查潜在的安全漏洞、性能问题及边界情况。

8.2 Hooks（钩子）

允许在执行特定动作前后自动触发 Shell 命令：

{
  "hooks": {
    "afterFileEdit": ["prettier --write {{file}}", "eslint --fix {{file}}"],
    "beforeCommit": ["pnpm test --run"]
  }
}

支持的时机包括 afterFileEdit、beforeCommit、PostCompact 等。

九、CI/CD 集成

Claude Code 遵循 Unix 哲学，天然适合自动化流水线。

9.1 GitHub Actions 示例

name: AI Code Review
on: pull_request:
  types: [opened, synchronize]
jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "请对本次 PR 的改动做 Code Review，重点检查安全性和性能"

9.2 其他场景

• 自动化翻译：监控 i18n 文件并自动翻译
• 日志监控：tail -f /var/log/app.log | claude -p "..."

十、进阶配置

10.1 环境变量

export ANTHROPIC_API_KEY="sk-ant-xxxx"
export ANTHROPIC_BASE_URL="https://your-proxy.com"
export CLAUDE_CODE_DISABLE_CRON=1
export ENABLE_TOOL_SEARCH=1

10.2 settings.json

路径：~/.claude/settings.json 或项目级 .claude/settings.json

{
  "model": "claude-opus-4-6",
  "theme": "dark",
  "worktree": {
    "sparsePaths": ["src/", "tests/"]
  }
}

十一、注意事项与技巧

11.1 Token 消耗

分析大型代码库时 Token 消耗较高。建议：

• 合理使用 /compact 压缩上下文
• 用 /clear 开启新任务
• 配置 .gitignore 排除无用目录
• 在 CLAUDE.md 中明确忽略范围

11.2 安全与权限

• 危险命令执行前会请求确认
• CI 中使用只读权限的 Key
• 生产环境谨慎操作，先在 staging 测试

11.3 质量控制

• 善用 /plan 模式审查计划
• 小步提交，避免一次性大改动
• 结合 Hooks 自动运行测试
• 养成 Review Diff 的习惯

11.4 网络配置

由于服务限制，建议配置方案：

# 方案一：全局代理
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
claude

# 方案二：第三方 API 中转
export ANTHROPIC_BASE_URL="https://reliable-proxy.example.com"
export ANTHROPIC_API_KEY="your-api-key"
claude

十二、总结

Claude Code 代表了 AI 编程工具的新范式：不是帮你补全，而是替你干活。

它最适合独立开发者、接手老代码的开发者以及需要自动化重复性任务的团队。虽然存在 Token 消耗和网络要求等局限，但作为目前功能最完整的 Agentic 编程工具之一，值得尝试。

参考资料：

• 官方文档：https://code.claude.com/docs
• GitHub 仓库：https://github.com/anthropics/claude-code
• Anthropic 官网：https://www.anthropic.com