作者说明本文写于 2026 年 3 月 15 日基于 Claude Code 当前最新版本 v2.1.762026-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 系列正式 GAGeneral AvailabilityCLAUDE.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 与其他工具的本质区别工具定位核心模式GitHub CopilotIDE 内代码补全实时补全CursorAI-first IDE对话补全WindsurfAI-first IDE对话补全Claude Code终端 AI 代理自主任务执行Claude Code 最大的差异在于它的Agentic特性——它不只是建议你怎么写而是直接动手写动手改动手跑测试动手提 PR。二、支持的使用环境在深入讲用法之前先搞清楚 Claude Code 可以在哪里用2.1 终端 CLI最核心这是 Claude Code 的原生形态。支持macOSLinux / UbuntuWindows需要先安装 Git for WindowsWSLWindows 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 桌面 AppDesktop AppClaude 的桌面应用内集成了 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终端 CLImacOS 推荐方式Homebrewbrew install claude-code⚠️ Homebrew 安装不会自动更新需定期执行brew upgrade claude-codemacOS / 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_KEYsk-ant-xxxxxxxxxxxx claude如果需要通过第三方代理export ANTHROPIC_BASE_URLhttps://your-proxy-endpoint.com export ANTHROPIC_API_KEYyour-key claude四、核心用法详解4.1 启动会话与基础对话进入项目根目录后运行claude进入交互式会话界面cd /your/project claude你可以直接用自然语言描述你的需求 帮我找出所有没有单元测试覆盖的函数并为它们生成测试用例 我的 API 在高并发下会报 500 错误帮我排查原因 把 src/components 目录下所有 Class Component 重构为 Function ComponentClaude Code 会自动扫描并理解你的代码库结构分析相关文件执行必要的 Shell 命令如运行测试、查看 git log直接修改文件展示 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 语句替换为 logging4.3 继续上次会话# 继续上一次会话不开新对话 claude -c # 继续指定的历史会话通过 session ID claude -r session-id4.4 Slash 命令斜杠命令在会话中输入/可以触发内置命令命令功能/init扫描当前项目自动生成CLAUDE.md项目记忆文件/clear清空当前上下文开始新的对话轮次/compact压缩当前上下文节省 Token适合长会话/plan进入计划模式让 Claude 先规划再执行避免盲目操作/effort调整模型思考力度共三档low○medium◐high●/effort auto重置默认/config打开配置面板调整会话级设置Esc 取消Enter 保存Space 切换开关/context查看当前上下文用量并给出具体优化建议如哪些工具占用大、是否该压缩/rewind撤销上一轮对话及其代码修改相当于时光倒流/resume从历史会话列表中选择一个继续按上箭头可恢复上次被打断的 prompt/loop让 Claude 循环执行同一任务直到满足停止条件/security-review对当前代码库执行安全审查识别潜在漏洞/color更改 Claude Code 的主题颜色/color reset恢复默认/copy复制当前输出到剪贴板按w键直接写入文件SSH 友好/bug向 Anthropic 直接提交 Bug 报告/teleport将 Web/App 会话迁移到本地终端继续/desktop将终端会话切换到桌面 App 进行可视化 Review/ide连接本地 IDEVS Code / JetBrains自动安装扩展4.5 引用文件与 ! 执行命令在对话中可以用快速引用文件 src/auth/login.ts 这里的 token 验证逻辑有 Bug帮我修复用!执行 Shell 命令并将结果注入到上下文 ! npm test根据报错帮我修复五、CLAUDE.md项目记忆系统这是 Claude Code 最独特也最有价值的功能之一值得单独讲透。5.1 什么是 CLAUDE.mdCLAUDE.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 什么是 SkillsSkills技能是 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 文件是普通的 MarkdownClaude 会根据任务相关性自动选择加载哪些 Skill。6.3 Skills 与 CLAUDE.md 的区别CLAUDE.md项目全局说明每次会话都会完整读取适合放核心约定Skills按需加载适合放数量多、场景细化的专项规范避免 CLAUDE.md 过度膨胀⚠️ 注意沙盒模式Sandbox下.claude/skills/目录是只读的Claude 无法修改它。七、MCP打通外部工具生态6.1 什么是 MCPMCPModel Context Protocol是 Anthropic 发布的开放标准协议用于连接 AI 工具与外部数据源和服务。简单理解MCP 让 Claude Code 能和第三方工具握手直接调用它们的能力。6.2 MCP 能连什么通过配置 MCP ServerClaude Code 可以读取你的 Google Drive 中的设计文档直接在 Jira 中创建/更新任务从 Slack 频道拉取消息查询你的数据库调用你自己写的内部工具 API6.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 变更同步到代码注释里八、自定义命令与 Hooks7.1 自定义 Slash 命令你可以把常用工作流封装成自定义命令与团队共享。在项目根目录创建.claude/commands/目录添加 Markdown 文件# .claude/commands/review-pr.md 请对当前 git diff 做一次全面的 Code Review检查 1. 潜在的安全漏洞 2. 性能问题 3. 未处理的边界情况 4. 是否缺少单元测试 用中文输出结构化的 Review 报告。保存后就可以在会话中使用/review-pr调用这个工作流。团队常见的自定义命令示例/review-prPR 审查/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.76afterFileEdit每次文件被修改后beforeCommit提交代码前PostCompact上下文压缩完成后触发v2.1.76 新增Elicitation/ElicitationResultMCP Server 请求交互式输入前后v2.1.76 新增WorktreeCreate/WorktreeRemoveAgent Worktree 创建/销毁时适合 CI 环境自定义初始化TeammateIdle/TaskCompletedAgent Teams 多智能体工作流中队友空闲或任务完成时触发九、在 CI/CD 中使用 Claude CodeClaude 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/checkoutv4 - 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然后提 PR8.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_KEYsk-ant-xxxx # 自定义 API 端点使用第三方代理时 export ANTHROPIC_BASE_URLhttps://your-proxy.com # 禁用 cron 定时任务调试时有用 export CLAUDE_CODE_DISABLE_CRON1 # 启用 Tool Search处理大量 MCP 工具时 export ENABLE_TOOL_SEARCH110.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 DiffVS Code 和 JetBrains 插件都提供可视化 Diff养成 Review 的习惯11.4 关于 CLAUDE.md 的维护提交到 GitCLAUDE.md是团队的共享知识库应该提交到版本控制及时更新技术栈变更、新的代码规范、重要架构决策要及时同步到CLAUDE.md不要塞太多CLAUDE.md过长会占用大量上下文精简、关键的信息比面面俱到更有效11.5 关于网络配置国内用户由于 Anthropic 的服务国内无法直连建议的配置方案# 方案一全局代理推荐 export HTTPS_PROXYhttp://127.0.0.1:7890 export HTTP_PROXYhttp://127.0.0.1:7890 claude # 方案二使用第三方 API 中转需自行寻找可靠服务商 export ANTHROPIC_BASE_URLhttps://reliable-proxy.example.com export ANTHROPIC_API_KEYyour-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/docsClaude Code GitHub 仓库https://github.com/anthropics/claude-codeAnthropic 官网https://www.anthropic.com如果本文对你有帮助欢迎点赞收藏。有任何问题可以在评论区交流。
Claude Code 完全指南：Anthropic 最强 AI 编程助手深度解析
作者说明本文写于 2026 年 3 月 15 日基于 Claude Code 当前最新版本 v2.1.762026-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 系列正式 GAGeneral AvailabilityCLAUDE.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 与其他工具的本质区别工具定位核心模式GitHub CopilotIDE 内代码补全实时补全CursorAI-first IDE对话补全WindsurfAI-first IDE对话补全Claude Code终端 AI 代理自主任务执行Claude Code 最大的差异在于它的Agentic特性——它不只是建议你怎么写而是直接动手写动手改动手跑测试动手提 PR。二、支持的使用环境在深入讲用法之前先搞清楚 Claude Code 可以在哪里用2.1 终端 CLI最核心这是 Claude Code 的原生形态。支持macOSLinux / UbuntuWindows需要先安装 Git for WindowsWSLWindows 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 桌面 AppDesktop AppClaude 的桌面应用内集成了 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终端 CLImacOS 推荐方式Homebrewbrew install claude-code⚠️ Homebrew 安装不会自动更新需定期执行brew upgrade claude-codemacOS / 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_KEYsk-ant-xxxxxxxxxxxx claude如果需要通过第三方代理export ANTHROPIC_BASE_URLhttps://your-proxy-endpoint.com export ANTHROPIC_API_KEYyour-key claude四、核心用法详解4.1 启动会话与基础对话进入项目根目录后运行claude进入交互式会话界面cd /your/project claude你可以直接用自然语言描述你的需求 帮我找出所有没有单元测试覆盖的函数并为它们生成测试用例 我的 API 在高并发下会报 500 错误帮我排查原因 把 src/components 目录下所有 Class Component 重构为 Function ComponentClaude Code 会自动扫描并理解你的代码库结构分析相关文件执行必要的 Shell 命令如运行测试、查看 git log直接修改文件展示 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 语句替换为 logging4.3 继续上次会话# 继续上一次会话不开新对话 claude -c # 继续指定的历史会话通过 session ID claude -r session-id4.4 Slash 命令斜杠命令在会话中输入/可以触发内置命令命令功能/init扫描当前项目自动生成CLAUDE.md项目记忆文件/clear清空当前上下文开始新的对话轮次/compact压缩当前上下文节省 Token适合长会话/plan进入计划模式让 Claude 先规划再执行避免盲目操作/effort调整模型思考力度共三档low○medium◐high●/effort auto重置默认/config打开配置面板调整会话级设置Esc 取消Enter 保存Space 切换开关/context查看当前上下文用量并给出具体优化建议如哪些工具占用大、是否该压缩/rewind撤销上一轮对话及其代码修改相当于时光倒流/resume从历史会话列表中选择一个继续按上箭头可恢复上次被打断的 prompt/loop让 Claude 循环执行同一任务直到满足停止条件/security-review对当前代码库执行安全审查识别潜在漏洞/color更改 Claude Code 的主题颜色/color reset恢复默认/copy复制当前输出到剪贴板按w键直接写入文件SSH 友好/bug向 Anthropic 直接提交 Bug 报告/teleport将 Web/App 会话迁移到本地终端继续/desktop将终端会话切换到桌面 App 进行可视化 Review/ide连接本地 IDEVS Code / JetBrains自动安装扩展4.5 引用文件与 ! 执行命令在对话中可以用快速引用文件 src/auth/login.ts 这里的 token 验证逻辑有 Bug帮我修复用!执行 Shell 命令并将结果注入到上下文 ! npm test根据报错帮我修复五、CLAUDE.md项目记忆系统这是 Claude Code 最独特也最有价值的功能之一值得单独讲透。5.1 什么是 CLAUDE.mdCLAUDE.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 什么是 SkillsSkills技能是 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 文件是普通的 MarkdownClaude 会根据任务相关性自动选择加载哪些 Skill。6.3 Skills 与 CLAUDE.md 的区别CLAUDE.md项目全局说明每次会话都会完整读取适合放核心约定Skills按需加载适合放数量多、场景细化的专项规范避免 CLAUDE.md 过度膨胀⚠️ 注意沙盒模式Sandbox下.claude/skills/目录是只读的Claude 无法修改它。七、MCP打通外部工具生态6.1 什么是 MCPMCPModel Context Protocol是 Anthropic 发布的开放标准协议用于连接 AI 工具与外部数据源和服务。简单理解MCP 让 Claude Code 能和第三方工具握手直接调用它们的能力。6.2 MCP 能连什么通过配置 MCP ServerClaude Code 可以读取你的 Google Drive 中的设计文档直接在 Jira 中创建/更新任务从 Slack 频道拉取消息查询你的数据库调用你自己写的内部工具 API6.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 变更同步到代码注释里八、自定义命令与 Hooks7.1 自定义 Slash 命令你可以把常用工作流封装成自定义命令与团队共享。在项目根目录创建.claude/commands/目录添加 Markdown 文件# .claude/commands/review-pr.md 请对当前 git diff 做一次全面的 Code Review检查 1. 潜在的安全漏洞 2. 性能问题 3. 未处理的边界情况 4. 是否缺少单元测试 用中文输出结构化的 Review 报告。保存后就可以在会话中使用/review-pr调用这个工作流。团队常见的自定义命令示例/review-prPR 审查/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.76afterFileEdit每次文件被修改后beforeCommit提交代码前PostCompact上下文压缩完成后触发v2.1.76 新增Elicitation/ElicitationResultMCP Server 请求交互式输入前后v2.1.76 新增WorktreeCreate/WorktreeRemoveAgent Worktree 创建/销毁时适合 CI 环境自定义初始化TeammateIdle/TaskCompletedAgent Teams 多智能体工作流中队友空闲或任务完成时触发九、在 CI/CD 中使用 Claude CodeClaude 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/checkoutv4 - 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然后提 PR8.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_KEYsk-ant-xxxx # 自定义 API 端点使用第三方代理时 export ANTHROPIC_BASE_URLhttps://your-proxy.com # 禁用 cron 定时任务调试时有用 export CLAUDE_CODE_DISABLE_CRON1 # 启用 Tool Search处理大量 MCP 工具时 export ENABLE_TOOL_SEARCH110.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 DiffVS Code 和 JetBrains 插件都提供可视化 Diff养成 Review 的习惯11.4 关于 CLAUDE.md 的维护提交到 GitCLAUDE.md是团队的共享知识库应该提交到版本控制及时更新技术栈变更、新的代码规范、重要架构决策要及时同步到CLAUDE.md不要塞太多CLAUDE.md过长会占用大量上下文精简、关键的信息比面面俱到更有效11.5 关于网络配置国内用户由于 Anthropic 的服务国内无法直连建议的配置方案# 方案一全局代理推荐 export HTTPS_PROXYhttp://127.0.0.1:7890 export HTTP_PROXYhttp://127.0.0.1:7890 claude # 方案二使用第三方 API 中转需自行寻找可靠服务商 export ANTHROPIC_BASE_URLhttps://reliable-proxy.example.com export ANTHROPIC_API_KEYyour-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/docsClaude Code GitHub 仓库https://github.com/anthropics/claude-codeAnthropic 官网https://www.anthropic.com如果本文对你有帮助欢迎点赞收藏。有任何问题可以在评论区交流。
