导读

这份教程研究的不是“Claude Code 有哪些功能”，而是“它如何成为一个可长时运行、可调用工具、可恢复上下文、可拆分子任务的 Agent 系统”。

两条学习主线

主线一：Agent 如何被构造

一个 Agent 不等于一段 Prompt。它至少由身份、指令、上下文、可用工具、模型策略、权限边界和可变状态组成。前七章会把这些部分从外到内拆开。

主线二：Agent 如何运行

一次任务不等于一次 API 调用。用户输入会先被编译成模型上下文，模型可能返回工具意图，本地运行时执行后再把结果回填。期间还有取消、重试、降级、压缩和 Hook。第八到第十三章会说清这个状态机。

后续三组问题

• 能力从哪里来：Tools、ToolSearch、Skills、MCP、Plugins 和 Hooks 分别扮演什么角色？
• 能力如何受控：Plan Mode、工具可见性、参数权限、Sandbox 和 Worktree 如何层层收紧边界？
• 任务如何延续和拆分：Memory、压缩、Subagent、Fork、后台 Agent 和 Agent Team 各自解决什么问题？

每章怎样读

每章会尽量回答六个问题：为什么需要它？在哪一层？输入和输出是什么？什么时候发生？设计精妙在哪里？它不负责什么？

源码路径只放在章末作为证据，正文不进入函数和类。若某项能力受功能开关、平台或内部构建限制，会明确标记“条件启用”。

请始终区分两件事：源码存在某种能力，不等于它在每次运行中都会启用。工具还会经过平台、功能开关、Agent 类型和权限规则的再次筛选。

全书最核心的结论：Claude Code 是一个把本地环境、指令、历史、能力和策略编译成模型请求，再把模型返回的意图编译成受控本地操作的 Agent 运行时。