1. 引言

在前面的博客，博主已经系统讲解了 Claude Code 的核心能力，有兴趣的同学可以先了解：

• 《Claude Code 完整指南（一）：安装、CLI 实战、IDE 集成一次讲透》
• 《Claude Code 完整指南（二）：终端命令全解析（收藏级）》
• 《Claude Code 完整指南（三）：命令背后的数据流动》
• 《Claude Code 完整指南（四）：Hooks（自动化事件触发）》
• 《Claude Code 完整指南（五）：Subagents（AI 角色工程化）》
• 《Claude Code 完整指南（六）：Skills（可复用的标准操作流程）》
• 《Claude Code 完整指南（七）：MCP（让 AI 连接外部真实系统）》
• 《Claude Code 完整指南（八）：Output Styles（系统提示词的真正用法）》
• 《Claude Code 完整指南（九）：Plugins（打包已定义的 AI 能力）》

本文采用 5W1H（What / Why / Who / When / Where / How）来总结 Claude Code，方便大家从“是什么” 一步步走到 “怎么落地”，循序渐进建立整套心智模型。

---

2. 【WHAT】：Claude Code 是什么?

Claude Code 不是“聊天机器人”，更像一个 能在你电脑和代码仓库里做事的工程师，它的核心能力可以拆成 4 层：

一、核心执行层（能读、能改、能跑）

• 读仓库：读文件、搜代码、理解目录结构与依赖。
• 改仓库：跨文件写/改代码与配置（不是只给建议）。
• 跑命令：跑测试/构建/脚本，拿到报错再继续修。

这三件事决定了它能做“真实交付”，而不是“纸上谈兵”。

二、会话与上下文层（让它“持续把一件事做完”）

• 在 Claude Code 的一段持续对话可以理解为一个会话（Session）。
• 会话会累积上下文（Context）：包括文件内容、你输入的信息、以及必要的运行结果。
• 上下文太多会变贵、变慢、变容易跑偏，所以会话管理（恢复/回滚/压缩）很重要。

三、工程化编排层（把能力变成“流程”）

这一层是 Claude Code 和普通“代码补全/聊天 AI”最大的差异：

• Hooks：把关键动作自动化，甚至做“门禁”（能阻断危险/低质量操作）。
• Subagents：把工作拆给不同“岗位”，减少上下文污染与角色混乱。
• Skills：把 SOP 固化成模板，让输出结构稳定、验收可重复。

四、 扩展与分发层（连接外部系统 + 让团队复用）

• MCP：连接外部真实系统（GitHub、数据库、监控、知识库……）。
• Plugins：把 commands/hooks/agents/skills/mcp/lsp 打包分发给团队/多个项目。

---

3. 【WHY】：为什么要用 Claude Code

一、 它解决的不是“会不会写代码”，而是“交付效率”

现实里最耗时的往往不是写某一行代码，而是：

• 找到需要修改的真正位置（跨文件定位）
• 改完之后跑测试、修报错、再跑、再修（闭环）
• 做 Review、补文档、写变更说明、做风险/回滚说明（交付材料）

Claude Code 的优势是：它能在同一个工作台里把闭环跑完 。

二、 它能把“经验”变成默认流程（这是团队价值）

个人用 Claude Code 的收益是 “快”；团队用的收益是 “稳”：

• Hooks 把“必须做的检查”固化（格式化/测试/危险拦截）。
• Skills 把“必须交付的结构”固化（风险/验证/回滚/证据）。
• Subagents 把“必须分工的角色”固化（测试官/审计官/文档工程师）。

三、为什么要理解数据流动与安全边界

因为它会读文件、会写文件、会跑命令，还会在本地落盘记录，在真实团队环境里，需要考虑：

• 它会在本地留下些什么？会不会暴露项目路径/历史操作？
• 哪些文件默认可读？敏感信息如何阻止被读入上下文？
• 哪些操作必须先确认（写文件/跑命令/外部系统写入）？

---

4. 【WHO】：谁适合用、怎么分工

一、谁适合用？

• 个人开发者：写代码 + 跑测试 + 快速复盘（效率提升明显）。
• 团队技术负责人/Tech Lead：把流程固化，减少交付不一致。
• 测试/运维/安全：通过角色化（Subagents）与模板化（Skills）参与研发闭环。
• 非纯研发角色：通过 Output Styles 把主对话变成“产品/写作/排障”等身份。

二、团队里怎么分工（Subagents 的视角）

你可以把主对话当成“编排者/Tech Lead”，把子代理当成“岗位工种”：

• security-auditor（安全审计官）：只读（Read/Grep），输出风险清单与修复建议。
• test-writer（测试工程师）：Write + Bash，补测试并给出跑测证据。
• code-reviewer（代码审查官）：只读为主，输出结构化 Review（必须修/建议/风险/验证点）。
• doc-writer（文档工程师）：只写文档目录，产出说明与教程。

这种分工的好处是：

• 避免“同一会话什么都干”导致的上下文污染
• 避免“自己写自己审”的自我通过
• 让每个岗位的工具权限更可控（审计类通常不应有 Write/Bash）

三、Skills 在分工里扮演什么角色

如果 Subagent 解决“谁来做”，Skill 解决“怎么做”：
把团队 SOP（发布检查、迁移可回滚、PR 必须有证据）固化成 Skill，挂在对应 Subagent 上，就能让交付稳定。

---

5. 【WHEN】：什么时候用哪些能力？

把能力按“时间点”组织，读者会更容易形成直觉：什么时候该用 Hook，什么时候该用 Skill，什么时候该用 Subagent。

一、会话开始（SessionStart）：先把“环境与规则”亮出来

适合做：

• 环境体检（Node/Python 版本、依赖是否安装）
• 打印项目约束/团队规范提示
• 确认权限策略是否符合预期

二、做任何危险事之前（PreToolUse）：门禁点

适合做：

• 拦截危险 Bash（rm -rf、git push --force 等）
• 敏感信息检测（避免把密钥读进上下文/写进仓库）
• 参数校验与审计记录

三、写/改文件之后（PostToolUse）：自动化点

适合做：

• 自动格式化（失败不阻断但要提示）
• 自动跑最小测试（尽量给证据）
• 自动生成变更摘要（方便写 PR）

四、准备停止之前（Stop/SubagentStop）：收尾验收点

适合做：

• “停下前质量门禁”：有没有跑测试？有没有未解决报错？有没有未提交改动？
• 对子任务做验收：例如子代理说“测试写完了”，那就要求给测试命令与结果

一句话总结 WHEN： Hooks 管“什么时候发生”，Skills 管“怎么做才算完成”，Subagents 管“谁来负责”。

---

6. 【WHERE】：它在本地/项目里“放在哪、存在哪、接在哪”

这一部分解决“它到底在哪些地方动了我的东西”的问题（也是最容易让新人困惑的点）。

一、存在哪：用户级目录 ~/.claude/

你可以把这里理解成“跨项目的个人工作台数据”，常见包含：

• 项目会话记录（按项目分目录）
• 全局命令索引 history.jsonl（可能包含项目路径信息）
• todos（任务列表 JSON）
• debug/shell-snapshots/ide 等辅助目录

结论：这就是为什么共享账号/共享环境要谨慎。

二、放在哪：项目级目录 {project}/.claude/

这是团队最该沉淀规范的地方（因为它能跟仓库一起走）：

• settings.json：团队共享配置（建议提交 Git）
• settings.local.json：个人覆盖（不要提交）
• CLAUDE.md：项目背景/规范/常用命令（强烈建议有）
• commands/：自定义斜杠命令（把流程做成入口）
• .mcp.json：项目 MCP 配置（团队共享外部连接器）

三、接在哪：入口与集成（Where you use）

Claude Code 的使用入口并不只有 CLI：

• IDE（VS Code / JetBrains）
• 桌面版/Web
• CI/CD（GitHub Actions/GitLab CI）
• IM（Slack 等）

但无论入口是什么，底层都绕不开：权限、配置、上下文、工具调用。

---

7. 【HOW】：怎么从 0 到工程化落地

这一章按“循序渐进”的方式给出落地路线：先能用，再好用，再团队化，再平台化。

Step1：先把“边界”画出来（权限最小化）

• 读仓库默认允许（否则它没法理解）
• 敏感文件明确 deny（.env、secrets/、证书、私钥等）
• 写文件/跑命令默认 ask（尤其是前期）

Step2：让它“看懂你的项目”（CLAUDE.md）

目标：减少你重复解释、减少上下文浪费、减少误改，建议写进 CLAUDE.md 的最小集合：

• 项目是什么（业务一句话）
• 目录结构（核心模块在哪）
• 如何运行/测试/构建（命令）
• 代码规范与约束（比如必须跑哪些测试、提交规范）

Step3：把日常需求变成可控闭环（CLI + 会话管理）

目标：把“说一句话”变成“交付闭环”：

• 让 Claude 做改动（限定范围与目标）
• 让 Claude 跑测试/构建拿证据
• 根据报错继续修
• 导出摘要/变更说明（用于 PR）

关键习惯：

• 会话变长要压缩（避免越聊越飘）
• 走错路要回滚（不要硬聊到崩）

Step4：把“必须做的事”自动化（Hooks）

目标：把返工成本最高的环节系统化：

• PreToolUse：危险拦截（阻断）
• PostToolUse：自动格式化 + 最小测试（不阻断但要提示）
• Stop：停下前质量门禁（强提醒或阻断）

Step5：把“角色”工程化（Subagents）

目标：让一个 Claude 像一个团队一样工作：

• 业务实现（主对话编排）
• 测试由 test-writer 负责（给证据）
• 安全由 security-auditor 负责（只读）
• 文档由 doc-writer 负责（写文档目录）

Step6：把“流程”标准化（Skills）

目标：让输出稳定、可验收、可复制，推荐你优先沉淀的 4 类 Skill：

• PR/变更总结（风险/验证/回滚/影响面）
• 结构化 Code Review（必须修/建议/风险/验证点）
• 数据库迁移（强制可回滚）
• 文档生成（API/运行手册/排障手册）

Step7：连接外部系统（MCP）

目标：从“改本地仓库”扩展到“操作真实系统”：

• 查外部数据作为上下文（Resources）
• 执行动作（Tools）
• 固化模板（Prompts）

建议：优先 HTTP 形态（便于统一权限与审计）。

Step8：把能力变成团队资产（Plugins）

目标：跨项目复用、版本化管理、统一升级，把你在 .claude/ 里跑通的这些东西打包

• commands + hooks + agents + skills + mcp + lsp

---

8. 官方文档导航

前面九章的内容基本把 Claude Code 核心的内容覆盖了，可能会有缺漏的知识点，这里整理官方的文档，按以下三层来整理：

1. 怎么用起来：安装/快速上手/各种入口（IDE/桌面/Web/CI/IM）
2. 怎么工程化：CLI 参考、常用工作流、Hooks/Subagents/Skills、Output styles
3. 怎么在团队与企业里安全运行：安全/数据使用/合规、网络与 IAM、成本与监控、插件生态与外部系统（MCP）

---

入门与安装：

• Overview：https://code.claude.com/docs/en/overview
• Quickstart：https://code.claude.com/docs/en/quickstart
• Setup：https://code.claude.com/docs/en/setup
• Changelog（版本更新）：https://code.claude.com/docs/en/changelog

使用入口（IDE/桌面/Web）：

• VS Code：https://code.claude.com/docs/en/vs-code
• JetBrains：https://code.claude.com/docs/en/jetbrains
• Desktop：https://code.claude.com/docs/en/desktop
• Claude Code on the Web：https://code.claude.com/docs/en/claude-code-on-the-web
• Chrome extension：https://code.claude.com/docs/en/chrome

CLI 与日常工作流（查命令/查用法/查最佳实践）：

• CLI reference（命令全集）：https://code.claude.com/docs/en/cli-reference
• Common workflows（常用工作流）：https://code.claude.com/docs/en/common-workflows
• Slash commands（自定义斜杠命令）：https://code.claude.com/docs/en/slash-commands
• Output styles：https://code.claude.com/docs/en/output-styles
• Statusline：https://code.claude.com/docs/en/statusline
• Terminal config：https://code.claude.com/docs/en/terminal-config
• Model config：https://code.claude.com/docs/en/model-config
• Memory：https://code.claude.com/docs/en/memory

自动化（Hooks）：

• Hooks：https://code.claude.com/docs/en/hooks
• Hooks guide：https://code.claude.com/docs/en/hooks-guide

角色与 SOP（Subagents / Skills）：

• Sub-agents：https://code.claude.com/docs/en/sub-agents
• Skills：https://code.claude.com/docs/en/skills
• Agent SDK / Subagents：https://code.claude.com/docs/en/agent-sdk/subagents

连接外部系统（MCP）：

• MCP：https://code.claude.com/docs/en/mcp

插件生态（Plugins）：

• Plugins（概览）：https://code.claude.com/docs/en/plugins
• Discover plugins（发现/安装）：https://code.claude.com/docs/en/discover-plugins
• Plugins reference（参考手册）：https://code.claude.com/docs/en/plugins-reference
• Plugin marketplaces：https://code.claude.com/docs/en/plugin-marketplaces

集成（CI/IM/第三方）：

• GitHub Actions：https://code.claude.com/docs/en/github-actions
• GitLab CI/CD：https://code.claude.com/docs/en/gitlab-ci-cd
• Slack：https://code.claude.com/docs/en/slack
• Third-party integrations：https://code.claude.com/docs/en/third-party-integrations

安全、合规与网络（团队/企业最常查）：

• Security：https://code.claude.com/docs/en/security
• Data usage：https://code.claude.com/docs/en/data-usage
• Legal and compliance：https://code.claude.com/docs/en/legal-and-compliance
• Sandboxing：https://code.claude.com/docs/en/sandboxing
• Network config：https://code.claude.com/docs/en/network-config
• IAM：https://code.claude.com/docs/en/iam
• LLM gateway：https://code.claude.com/docs/en/llm-gateway

成本、用量与分析（想控预算/看趋势）：

• Costs：https://code.claude.com/docs/en/costs
• Monitoring usage：https://code.claude.com/docs/en/monitoring-usage
• Analytics：https://code.claude.com/docs/en/analytics

企业/云平台接入（Bedrock / Vertex / Foundry）：

• Amazon Bedrock：https://code.claude.com/docs/en/amazon-bedrock
• Google Vertex AI：https://code.claude.com/docs/en/google-vertex-ai
• Microsoft Foundry：https://code.claude.com/docs/en/microsoft-foundry

运行形态与容器（自动化/远程/容器化）：

• Headless：https://code.claude.com/docs/en/headless
• Devcontainer：https://code.claude.com/docs/en/devcontainer

排障：

• Troubleshooting：https://code.claude.com/docs/en/troubleshooting

9. 总结

通过阅读本文，相信大家已经从 5W1H（What / Why / Who / When / Where / How） 的完整视角，系统建立了对 Claude Code 的认知框架：它并不是一个“更强的聊天式写代码工具”，也不是单点能力的堆叠，而是一套 将 AI 纳入真实工程流程的执行型系统。

• Hooks 负责“什么时候必须发生”；
• Skills 定义“做到什么才算完成”；
• Subagents 明确“谁对结果负责”；
• MCP 与 Plugins 则让能力走出本地，成为团队级、平台级资产。

希望本文能帮助大家理解 Claude Code的设计边界与工程定位，避免将其误用为“自动化更强的聊天 AI”。感谢大家的阅读，谢谢大家，本文完！