Claude Code 完全指南：Anthropic 最强 AI 编程助手深度解析

作者说明： 本文写于 2026 年 3 月 15 日，基于 Claude Code 当前最新版本 v2.1.76（2026-03-14）整理，适合希望系统了解和上手 Claude Code 的开发者阅读。

一、Claude Code 是什么？从何而来？

1.1 一句话定义

Claude Code 是 Anthropic 出品的一款以终端（Terminal）为核心的 AI 编程代理工具。它不是一个普通的聊天式代码补全插件，而是一个能够理解你的整个代码库、自主执行复杂任务、跨文件修改代码、调用系统命令、甚至自动提交 PR 的"AI 程序员"。

用官方的话说：

"Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows — all through natural language commands."

翻译过来就是：它住在你的终端里，用自然语言驱动，能帮你干真正的活儿。

1.2 诞生背景

Claude Code 的诞生，离不开 AI 编程工具这条高速赛道的大背景。

2024 年，Cursor、GitHub Copilot、Codeium 等工具已经让"AI 辅助编码"成为主流。但这些工具大多停留在"代码补全"或"对话式建议"层面，真正能自主完成一个完整任务的 Agentic 编程工具凤毛麟角。

Anthropic 看到了这个缺口。2025 年 2 月，Claude Code 以研究预览版（Research Preview）的形式正式对外发布，定位是：不只是聊天，而是真正意义上的 AI 编程代理。彼时，它是一款极简的终端工具——用户可以和它对话、让它编辑文件、执行 Bash 命令、提交代码到 GitHub。

随后 Claude Code 经历了数次重大里程碑：

• 2025年2月：以研究预览版（Research Preview）形式对外发布，功能简洁，主打终端直接使用
• 2025年5月：随 Claude 4 系列正式 GA（General Availability），CLAUDE.md 项目记忆系统、MCP 生态同步开放
• 2025年7月：据 Anthropic 披露，Claude Code 营收较 GA 时增长 5.5 倍
• 2025年8月：Claude in Chrome 扩展上线，Claude Code 可直接控制浏览器
• 2025年10月：Web 版上线，iOS App 同步跟进，无需本地安装即可使用
• 2025年12月：Agent Teams 多智能体协作功能进入研究预览；Claude 被用于为 NASA 火星探测器 Perseverance 规划约 400 米行驶路线；"Vibe Coding"浪潮兴起，大量非程序员用户涌入
• 2026年1月：被广泛评为当时最佳 AI 编程助手；非技术用户图形化工具 Claude Cowork 上线
• 2026年2月：推出 Claude Code Security，支持对代码库进行安全漏洞扫描；16 个 Claude Opus 4.6 Agent 协作从零用 Rust 写出了能编译 Linux kernel 的 C 编译器
• 2026年3月14日：最新版本 v2.1.76 发布，新增 MCP elicitation 交互式输入支持等功能

截至本文写作时（2026年3月），Claude Code 的版本已迭代至 v2.1.76，功能已远超最初的 CLI 原型。NASA、挪威主权财富基金（2.2 万亿美元规模）、Mozilla 等机构都已将其引入实际工作流——Mozilla 在 2026 年初用 Claude 在 Firefox 代码库中扫描出 100 余个 Bug，其中 14 个属于高危漏洞。

1.3 与其他工具的本质区别

Claude Code 最大的差异在于它的"Agentic"特性——它不只是建议你怎么写，而是直接动手写，动手改，动手跑测试，动手提 PR。

二、支持的使用环境

在深入讲用法之前，先搞清楚 Claude Code 可以在哪里用：

2.1 终端 CLI（最核心）

这是 Claude Code 的原生形态。支持：

• macOS
• Linux / Ubuntu
• Windows（需要先安装 Git for Windows）
• WSL（Windows Subsystem for Linux，强烈推荐）

2.2 IDE 插件

Claude Code 提供原生 IDE 扩展，支持可视化 Diff 预览和代码选区共享：

• VS Code（以及 Cursor、Windsurf 等 VS Code Fork 均支持）
• JetBrains 全家桶（IntelliJ IDEA、PyCharm、WebStorm 等，从 JetBrains Marketplace 安装）

2.3 Web 版（2025 年 10 月上线）

访问 claude.ai/code 即可，无需本地安装，支持：

• 桌面端浏览器
• Claude iOS App
• 多任务并行执行（kick off 任务后可挂后台）

2.4 桌面 App（Desktop App）

Claude 的桌面应用内集成了 Claude Code 入口，支持 /desktop 命令将终端会话迁移到桌面进行可视化 Diff Review。

三、安装与配置

3.1 账号前置要求

使用 Claude Code，你需要满足以下之一：

• Claude Pro 订阅（$20/月）
• Claude Max 订阅（$100~$200/月，适合重度使用者）
• Claude Team / Enterprise 高级席位
• Anthropic Console API Key（按量计费，适合开发者）

💡 国内用户注意：Anthropic 的服务在中国大陆暂无直接访问渠道，需要配合网络代理使用。API Key 方式对代理配置更灵活，可设置 ANTHROPIC_BASE_URL 环境变量指向第三方中转服务（如 OpenRouter 等兼容接口）。

3.2 安装 Claude Code（终端 CLI）

macOS 推荐方式（Homebrew）：

brew install claude-code 

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

macOS / Linux / Windows（直接安装，推荐）：

官方推荐使用原生安装包（非 npm），支持后台自动更新。详见官网下载页：https://claude.ai/download

旧方式（npm，已弃用但仍可用）：

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

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

3.3 首次登录

安装完成后，进入你的项目目录，运行：

claude 

首次运行会自动打开浏览器，引导你登录 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，进入交互式会话界面：

cd /your/project claude 

你可以直接用自然语言描述你的需求：

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

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

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

Claude Code 会自动：

1. 扫描并理解你的代码库结构
2. 分析相关文件
3. 执行必要的 Shell 命令（如运行测试、查看 git log）
4. 直接修改文件
5. 展示 Diff 并等待你确认

4.2 一次性执行模式（非交互式）

适合用在 CI/CD 或脚本中：

# 单次任务，-p 指定 prompt，执行完直接退出 claude -p "检查本次 git diff 中是否有安全漏洞" # 结合 Unix 管道 tail -f app.log | claude -p "如果发现异常日志，立刻通知我" # 批量处理文件 git diff main --name-only | claude -p "Review 这些改动文件中的安全问题" # 跨目录批量操作 find . -name "*.py" | claude -p "把所有 Python 文件的 print 语句替换为 logging" 

4.3 继续上次会话

# 继续上一次会话（不开新对话） claude -c # 继续指定的历史会话（通过 session ID） claude -r <session-id> 

4.4 Slash 命令（斜杠命令）

在会话中，输入 / 可以触发内置命令：

4.5 @ 引用文件与 ! 执行命令

在对话中，可以用 @ 快速引用文件：

> @src/auth/login.ts 这里的 token 验证逻辑有 Bug，帮我修复 

用 ! 执行 Shell 命令并将结果注入到上下文：

> ! npm test，根据报错帮我修复 

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

这是 Claude Code 最独特也最有价值的功能之一，值得单独讲透。

5.1 什么是 CLAUDE.md？

CLAUDE.md 是一个放在项目根目录（或其他指定位置）的 Markdown 文件，Claude Code 在每次新会话开始时都会自动读取它。它相当于给 Claude 写的一份"项目说明书"，告诉它：

• 这个项目的技术栈是什么
• 代码规范是什么
• 常用的构建/测试命令是什么
• 架构设计原则
• 需要注意的历史遗留问题
• 哪些目录/文件不要动

5.2 CLAUDE.md 层级结构

CLAUDE.md 支持多层级，遵循就近优先原则：

~/.claude/CLAUDE.md → 全局级（适用于所有项目，放你的个人偏好） ./CLAUDE.md → 项目级（团队共享，提交到 git） ./src/components/CLAUDE.md → 子目录级（针对特定模块的指引） 

5.3 一个实用的 CLAUDE.md 示例

# 项目说明：电商后台管理系统 ## 技术栈 - 前端：React 18 + TypeScript + Tailwind CSS - 后端：Node.js + Fastify + Prisma + PostgreSQL - 测试：Vitest + Testing Library - 包管理：pnpm ## 常用命令 - 启动开发服务器：`pnpm dev` - 运行测试：`pnpm test` - 数据库迁移：`pnpm prisma migrate dev` - 构建生产包：`pnpm build` ## 代码规范 - 所有新组件必须是 Function Component，禁止 Class Component - API 调用统一通过 `src/lib/api.ts` 的 `apiClient` 封装 - 数据校验使用 Zod schema，不要用手写 if 判断 - 组件文件名用 PascalCase，工具函数用 camelCase ## 架构原则 - 业务逻辑不允许放在 UI 组件中，应抽到 hooks 或 service 层 - 数据库查询必须放在 Repository 层（src/repositories/） - 错误处理统一通过 GlobalErrorHandler 中间件 ## 注意事项 - `src/legacy/` 目录是历史遗留代码，不要修改，也不要在新功能中引用 - 支付相关逻辑在 `src/payment/`，修改前必须通知 @张三 - 数据库没有级联删除，手动处理关联数据删除 

5.4 自动记忆（Auto Memory）

从 2026 年 2 月起，Claude Code 新增了**自动记忆（Auto Memory）**机制：Claude 在工作过程中会主动识别并记录有价值的信息（如它发现的构建技巧、调试方法、项目规律），并在后续会话中自动调用这些记忆，无需你手动维护。

自动记忆的存储位置可通过 settings.json 中的 autoMemoryDirectory 字段自定义：

{ "autoMemoryDirectory": ".claude/auto-memories/" } 

💡 建议把 autoMemoryDirectory 加入 .gitignore，避免把自动积累的个人记忆提交到团队仓库。

六、Skills：可复用的技能库

6.1 什么是 Skills？

Skills（技能）是 Claude Code 在 2025 年底新增的能力扩展机制。你可以把特定领域的操作规范、最佳实践写成 Skill 文件，Claude 会在需要时自动调用，而不必每次都在 prompt 里重复说明。

6.2 Skills 文件结构

.claude/ └── skills/ ├── react-component.md # React 组件开发规范 ├── api-design.md # API 设计标准 └── code-review.md # Code Review 检查清单 

每个 Skill 文件是普通的 Markdown，Claude 会根据任务相关性自动选择加载哪些 Skill。

6.3 Skills 与 CLAUDE.md 的区别

• CLAUDE.md：项目全局说明，每次会话都会完整读取，适合放核心约定
• Skills：按需加载，适合放数量多、场景细化的专项规范，避免 CLAUDE.md 过度膨胀

⚠️ 注意：沙盒模式（Sandbox）下，.claude/skills/ 目录是只读的，Claude 无法修改它。

七、MCP：打通外部工具生态

6.1 什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 发布的开放标准协议，用于连接 AI 工具与外部数据源和服务。简单理解：MCP 让 Claude Code 能和第三方工具"握手"，直接调用它们的能力。

6.2 MCP 能连什么？

通过配置 MCP Server，Claude Code 可以：

• 读取你的 Google Drive 中的设计文档
• 直接在 Jira 中创建/更新任务
• 从 Slack 频道拉取消息
• 查询你的数据库
• 调用你自己写的内部工具 API

6.3 如何添加 MCP Server？

# 添加一个 MCP Server claude mcp add # 添加支持 OAuth 的 MCP Server（如 Slack） claude mcp add --client-id <id> --client-secret <secret> 

也可以直接编辑配置文件（~/.claude/settings.json 或项目级 .claude/settings.json）。

6.4 MCP 的实际使用场景

> 帮我在 Jira 里找到所有标记为 "blocked" 的 tickets，汇总一下原因 > 把 Google Drive 里的 API 设计文档读一遍，然后帮我实现对应的接口 > 查一下 Slack 里 #backend 频道今天讨论的数据库 schema 变更，同步到代码注释里 

八、自定义命令与 Hooks

7.1 自定义 Slash 命令

你可以把常用工作流封装成自定义命令，与团队共享。

在项目根目录创建 .claude/commands/ 目录，添加 Markdown 文件：

# .claude/commands/review-pr.md 请对当前 git diff 做一次全面的 Code Review，检查： 1. 潜在的安全漏洞 2. 性能问题 3. 未处理的边界情况 4. 是否缺少单元测试 用中文输出结构化的 Review 报告。 

保存后，就可以在会话中使用 /review-pr 调用这个工作流。

团队常见的自定义命令示例：

• /review-pr：PR 审查
• /deploy-staging：部署到 staging 环境
• /gen-changelog：根据 git log 生成 changelog
• /i18n-check：检查国际化字符串是否完整

7.2 Hooks（钩子）

Hooks 允许你在 Claude Code 执行特定动作的前后，自动触发 Shell 命令：

// .claude/settings.json { "hooks": { "afterFileEdit": ["prettier --write {{file}}", "eslint --fix {{file}}"], "beforeCommit": ["pnpm test --run"], "PostCompact": ["echo '上下文已压缩，继续工作'"] } } 

这样 Claude 每次编辑文件后都会自动格式化，大大减少你手动干预的次数。

支持的 Hook 触发时机（截至 v2.1.76）：

• afterFileEdit：每次文件被修改后
• beforeCommit：提交代码前
• PostCompact：上下文压缩完成后触发（v2.1.76 新增）
• Elicitation / ElicitationResult：MCP Server 请求交互式输入前后（v2.1.76 新增）
• WorktreeCreate / WorktreeRemove：Agent Worktree 创建/销毁时（适合 CI 环境自定义初始化）
• TeammateIdle / TaskCompleted：Agent Teams 多智能体工作流中，队友空闲或任务完成时触发

九、在 CI/CD 中使用 Claude Code

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

8.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，重点检查安全性和性能，输出 Markdown 格式报告" 

8.2 自动化翻译示例

# CI 中自动翻译新增的 i18n 字符串 claude -p "把 locales/en.json 中未翻译的新 key 翻译成法语并更新 locales/fr.json，然后提 PR" 

8.3 日志监控示例

# 监控日志并在发现异常时告警 tail -f /var/log/app.log | claude -p "如果发现 ERROR 级别日志，通过 Slack Webhook 发送告警" 

十、Multi-Agent：并行工作流

Claude Code 支持启动多个子 Agent 并行工作，这在处理大型重构或多模块并行开发时极其有用。

9.1 使用 Git Worktree 隔离并行任务

# 为不同任务创建独立的 worktree，避免互相干扰 claude --worktree # 在大型 monorepo 中只 checkout 需要的目录（节省时间） # 通过 settings.json 中的 worktree.sparsePaths 配置 

9.2 在 Web 版中并行执行多个任务

Web 版支持直接在浏览器中开启多个并行任务，适合以下场景：

• 同时修 Bug + 写文档
• 同时处理多个相互独立的 feature
• 把长时任务挂后台，自己去做别的事

十一、进阶配置与环境变量

10.1 常用环境变量

# API Key（必须） export ANTHROPIC_API_KEY="sk-ant-xxxx" # 自定义 API 端点（使用第三方代理时） export ANTHROPIC_BASE_URL="https://your-proxy.com" # 禁用 cron 定时任务（调试时有用） export CLAUDE_CODE_DISABLE_CRON=1 # 启用 Tool Search（处理大量 MCP 工具时） export ENABLE_TOOL_SEARCH=1 

10.2 settings.json 核心配置

配置文件路径：~/.claude/settings.json（全局）或 .claude/settings.json（项目级）

{ "model": "claude-opus-4-6", "theme": "dark", "hooks": { "afterFileEdit": ["prettier --write {{file}}"] }, "worktree": { "sparsePaths": ["src/", "tests/"] }, "feedbackSurveyRate": 0 } 

十二、注意事项与使用技巧

11.1 关于 Token 消耗

Claude Code 在分析大型代码库时，Token 消耗可能非常高。有几点需要注意：

节省 Token 的方法：

• 合理使用 /compact 命令压缩上下文，而不是让对话越来越长
• 用 /clear 开始新的独立任务，不要把所有事情堆在一个会话里
• 给项目配置好 .gitignore，避免 Claude 扫描 node_modules、.next、dist 等无用目录
• 在 CLAUDE.md 里明确告诉它哪些目录不用看

关于费用：

• Claude Pro（$20/月）有使用量限制，重度编程任务建议用 Claude Max 或 API Key 按量计费
• API Key 方式下，处理一个中型项目的复杂任务，单次对话可能消耗 $0.5~$3 不等，请注意监控用量

11.2 关于安全与权限

Claude Code 有能力执行任意 Shell 命令和修改任意文件，使用时务必注意：

• 在危险命令执行前，它会请求你的确认（除非你将其加入了自动批准白名单）
• 不要在 ANTHROPIC_API_KEY 中存放高权限密钥，如果你在 CI 中使用，请用只读权限的 Key
• 生产环境谨慎操作：建议先在 staging 环境测试 Claude 的改动，再上生产
• 官方声明：Claude Code 收集使用数据（代码接受/拒绝情况、对话片段），但有明确的数据保留限制，且不用于模型训练

11.3 关于代码质量控制

Claude Code 很强，但也会犯错。以下是一些保持代码质量的建议：

• 善用 /plan 模式：对于复杂任务，先让它规划，审查计划后再执行，避免它直接"莽"
• 小步提交：让它完成一个小任务就 commit 一次，而不是一次性做一大堆改动
• 结合 Hooks 自动运行测试：在 beforeCommit 中加入测试命令，确保它的改动不会破坏现有功能
• Review Diff：VS Code 和 JetBrains 插件都提供可视化 Diff，养成 Review 的习惯

11.4 关于 CLAUDE.md 的维护

• 提交到 Git：CLAUDE.md 是团队的共享知识库，应该提交到版本控制
• 及时更新：技术栈变更、新的代码规范、重要架构决策，要及时同步到 CLAUDE.md
• 不要塞太多：CLAUDE.md 过长会占用大量上下文，精简、关键的信息比面面俱到更有效

11.5 关于网络配置（国内用户）

由于 Anthropic 的服务国内无法直连，建议的配置方案：

# 方案一：全局代理（推荐） 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 

十三、实战场景示例

场景一：接手老项目，快速上手

cd legacy-project claude > /init > 帮我读一遍这个项目的代码结构，写一份给新人看的项目说明文档 > 这个项目有哪些技术债？优先级最高的3个是什么？ 

场景二：修复线上 Bug

> 生产环境报错：TypeError: Cannot read properties of undefined (reading 'userId') 错误发生在 src/middleware/auth.ts:47，帮我找到根本原因并修复 

场景三：大规模重构

> /plan 把整个项目的数据访问层从直接 SQL 查询迁移到 Prisma ORM，先给我一个迁移计划 # 审查计划后... > 好，开始执行第一步 

场景四：自动化开发工作流

# 让 Claude Code 看 GitHub Issue 然后自动修复并提 PR claude -p "读取 GitHub Issue #142 的内容，实现对应的功能，写好测试，然后提交 PR" 

十四、总结

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

它最适合以下几类开发者：

• 独立开发者 / 个人项目：一个人顶多个人，极大提升开发效率
• 接手老代码的开发者：快速理解陌生代码库，减少"看代码"的痛苦
• 需要自动化重复性任务的团队：测试生成、文档更新、依赖升级……这些脏活累活全扔给它
• 想做 Vibe Coding 的开发者：用自然语言描述想法，直接出代码

当然，它也有局限：Token 消耗较大、对网络环境有要求、复杂任务仍需要人工审查。

但毫无疑问，2025 年的 Claude Code 已经是目前功能最完整、生态最开放的 Agentic 编程工具之一。如果你还没试过，现在就是最好的时机。

参考资料：

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

如果本文对你有帮助，欢迎点赞收藏。有任何问题可以在评论区交流。