教程计划

读者画像

这套教程面向已经会写 TypeScript 或 JavaScript、理解 HTTP API 和基本 CLI 开发，但没有系统实现过 Agent 的工程师。

读者不需要先理解 Claude Code 的所有功能。教程会沿着一个最小 Agent 的主链路展开，然后逐步加入真实产品需要的工程化机制。

教学目标

读者完成教程后，应该能够：

• 画出一个 Agent CLI 的核心时序图。
• 解释 Message、Tool、ToolUseContext、Session 的职责。
• 设计一个最小 AgentLoop。
• 设计一个工具注册表和工具执行器。
• 说明权限网关和 Hooks 应该插入在哪里。
• 判断哪些 Claude Code 设计适合迁移，哪些只适合大型产品。

章节策略

前 6 章读 Claude Code，最后 1 章实现简化版 Agent。

每章都包含 3 条线：

• 源码线：这一章对应哪些源码文件。
• 架构线：源码背后的通用设计模式是什么。
• 实现线：自己写 Agent 时如何简化落地。

非目标

• 不追求还原 Claude Code 的完整构建流程。
• 不讲官方服务端实现。
• 不复刻 Claude Code 的所有 UI 细节。
• 不把内部 feature flag、私有依赖或 dogfooding 逻辑作为学习重点。