Claude Code 101：从安装到 CLAUDE.md、子代理、MCP 和 hooks

路线 B · 用 Claude Code 写代码Claude Code 101适合：刚入行的开发者，或还没用过 AI 编程代理的工程师免费 · 英文 · 有结业证书

这是导读，不是翻译。先用 15 分钟拿到这门课的思想地图，再去 Anthropic Academy 原课程 → 注册学习（免费）。

一句话

Claude Code 是一个 AI 编程代理：它不只回答代码问题，而是自己读代码、改文件、跑命令、看结果，循环到任务完成。这门课从“代理和聊天有什么不同”讲起，经过安装、第一个提示词、日常工作流和上下文管理，最后讲 5 种定制手段：CLAUDE.md、子代理、Skills、MCP、hooks。

代理循环：Claude Code 的工作原理。你给出任务后，Claude 反复做 3 件事：收集信息（读文件、搜代码）、采取行动（改文件、跑命令）、检查结果（看测试输出、看报错）。它根据结果决定下一步，直到任务完成或需要你决定。聊天工具只给你代码片段，代理会自己验证这段代码能不能跑。

权限决定它能做什么。Claude Code 读文件通常不用确认；改文件、跑命令、联网默认会请求你批准。你可以逐步批准，也可以让它自动接受编辑，或切到计划模式（plan mode）让它只读不改、先出方案。在终端里按 Shift+Tab 切换模式。权限是安全阀：任务越陌生，越应该多看几眼。

探索 → 计划 → 编码 → 提交。这是课程最重要的工作流。探索：先让 Claude 读相关代码，讲清楚现状，不许改。计划：让它写出修改方案，你审阅后再动手。编码：按计划实现，并跑测试验证。提交：让它写提交信息、提交代码、必要时开 PR。跳过前两步直接写代码，是新手最常见的返工原因。

上下文窗口是稀缺资源。Claude 读过的每个文件、跑过的每条命令输出都占上下文。窗口满了，早期细节会被压缩，质量下降。3 个命令要记住：/context 看当前占用；/compact 把历史压缩成摘要后继续；/clear 清空、开始新任务。原则是一个会话只做一件事。

5 种定制手段，各管一件事：

CLAUDE.md：项目的长期记忆。写构建命令、代码规范、目录结构、注意事项。每次会话开始自动加载。
子代理（subagents）：在独立上下文里做子任务，只把结论交回主会话，主会话保持干净（详见第 09 篇）。
Skills：按需加载的做事方法，只有任务匹配时才进入上下文（详见第 08 篇）。
MCP：把外部工具和数据（数据库、问题跟踪系统、设计稿）接进来。
hooks：在固定时机自动执行的脚本，例如每次改完文件就跑格式化、拦截危险命令、任务完成时发通知。hooks 是确定执行的，不依赖 Claude 记不记得。

代理循环（agentic loop）: 收集信息、采取行动、检查结果的循环，直到任务完成。
权限模式（permission modes）: 决定 Claude 哪些操作需要你确认，包括手动确认、自动接受编辑、计划模式、自动模式等，Shift+Tab 切换。
计划模式（plan mode）: Claude 只读代码、不改文件，先产出方案供你审批。
CLAUDE.md: 放在项目根目录（或用户目录）的说明文件，每次会话自动加载，作为项目记忆。
/compact 与 /clear: 前者把对话压缩为摘要后继续，后者清空上下文开始新任务。
hooks: 在工具调用前后、会话结束等事件触发的 shell 命令，用来做确定性控制。
MCP 服务器: 按 Model Context Protocol 提供工具和数据的外部程序，Claude Code 可以连接它们。

在你自己的小项目里按顺序做：

cd your-project
claude