为什么写这本书
2024 年至 2025 年，软件工程领域发生了一场静默而深刻的范式转移。大语言模型不再仅仅是"聊天机器人"或"代码补全引擎"——它们开始以 Agent 的形态，真正参与到软件开发的完整生命周期中。编写代码、阅读文件、执行命令、做出判断、协调子任务——这些曾经只属于人类程序员的能力，如今正在被算法重新定义。
在众多 Agent 应用中，Anthropic 开源的 Claude Code 无疑是标杆级的存在。它不是一个简单的 CLI 工具，而是一个完整的 Agent 运行时系统——拥有推理循环、工具调度、权限决策、多 Agent 协调、MCP 协议通信、钩子管线、容错恢复等一整套精密的算法体系。当我深入阅读它近 5000 行的主入口文件 main.tsx、数十个工具实现、完整的权限分类器、以及多层状态管理架构时，我意识到：这不仅仅是一个产品，更是一部关于"如何构建生产级 AI Agent"的算法教科书。
然而，源码是沉默的。它不会主动告诉你为什么要在启动阶段并行预取 keychain 凭证和 MDM 配置，不会解释推理循环中工具调用与权限校验的微妙时序，也不会阐述多 Agent 协调时状态快照与消息传递的设计权衡。这些隐藏在代码背后的算法思想，才是最有价值的知识——而这正是本书试图揭示的。
我写这本书，是因为我相信：理解一个伟大系统的算法思想，远比学会使用它更重要。 当你真正理解了 Claude Code 背后的设计哲学，你将具备构建任何 Agent 系统的能力。
这本书为谁而写
本书的理想读者是具备一定编程基础的中级开发者、正在或即将投身 AI Agent 领域的工程师，以及所有对"Agent 到底是如何工作的"怀有好奇心的技术人。
你不需要精通 TypeScript 或 React——本书聚焦的是算法思想和架构模式，而非语言细节。但你需要理解基本的编程概念：函数、状态、异步、事件循环。如果你曾经构建过任何形式的软件系统，你就已经具备了阅读本书所需的全部背景。
具体而言：
- 应用开发者将学会如何将 Agent 的思维方式融入自己的产品；
- AI 工程师将获得一套经过生产验证的 Agent 架构参考；
- 系统架构师将看到如何在安全性、性能、可扩展性之间做出精妙的平衡；
- 技术管理者将理解 Agent 系统的复杂性本质，从而做出更好的技术决策。
如何阅读本书
本书分为四个部分，呈递进关系：
第一部分"Agent 思想基础"，建立认知框架。我们从 Agent 的本质出发，理解它与传统程序的根本差异，然后深入 Claude Code 的对象模型和启动算法，建立对整个系统的宏观认知。这是后续一切讨论的基石。
第二部分"Agent 核心算法"，是本书的核心。推理循环、工具调度、权限决策、状态管理——这四大算法构成了任何 Agent 系统的心脏。我们将逐一拆解它们的设计、实现和权衡，并始终以 Claude Code 源码作为印证。
第三部分"多 Agent 与协议"，将视野从单体 Agent 扩展到协作系统。多 Agent 协调、MCP 协议、钩子管线、安全防御——这些是 Agent 从"能跑"到"能用于生产"的关键跃迁。
第四部分"工程算法与实践"，关注真实世界的约束。性能优化、容错恢复、扩展性架构——最终，我们将所有思想融合，指导你构建自己的 Agent 系统。
如果你时间有限，我建议的最短阅读路径是：第 1 章 -> 第 4 章 -> 第 5 章 -> 第 6 章 -> 第 15 章。这条路径将让你以最快速度掌握 Agent 算法的核心脉络。
如果你有充裕的时间，请按顺序完整阅读。每一章都建立在前一章的基础之上，跳过任何一章都可能让你错过某个关键的思想连接。
本书的独特之处
市面上关于 AI Agent 的书籍和教程并不少见，但它们大多停留在概念介绍或 API 调用的层面。本书采用了截然不同的方法论：思想驱动，源码印证。
每一个算法思想，都不是凭空抽象的理论，而是从 Claude Code 这个真实的、经过大规模生产验证的系统中提炼而来。当我们讨论"推理循环"时，你将看到 QueryEngine.ts 中真实的循环结构；当我们讨论"权限决策"时，你将看到 permissions/ 目录下完整的分类器实现；当我们讨论"多 Agent 协调"时，你将看到 coordinator/ 和 AgentTool/ 中真实的调度逻辑。
本书关注的不是"Claude Code 怎么用"，而是"Claude Code 怎么想"。我们追问的是每一个设计决策背后的"为什么"：为什么启动时要分阶段预取而不是一次性加载？为什么权限系统需要多层分类器而不是简单的白名单？为什么多 Agent 通信选择了快照模式而非共享状态？
当你合上这本书时，你获得的不仅是对 Claude Code 的理解，更是一套可迁移的 Agent 算法思维方式。
致谢
首先，感谢 Anthropic 团队将 Claude Code 开源。开放源码是技术进步最有力的催化剂，正是这份慷慨让本书的写作成为可能。
感谢所有在 AI Agent 领域辛勤探索的研究者和工程师们。从 ReAct 范式到 Tool Use 协议，从单 Agent 到多 Agent 协调，每一步进展都凝聚着无数人的智慧。
感谢每一位阅读本书的读者。你愿意深入源码、追问本质的求知精神，正是推动技术社区不断前行的力量。
最后，我想引用 Bruce Eckel 在《C++ 编程思想》前言中的一段话作为共勉：“这本书的目标不是教你一门语言，而是教你一种思考问题的方式。“本书亦然。Agent 技术终将迭代演进，但算法思想的光芒不会褪色。
愿这本书能成为你探索 AI Agent 世界的一盏明灯。
2026 年春