当所有人都在教你怎么用 AI Agent，这本书带你拆开它。
对话循环如何驱动？工具权限为何是四阶段管线？上下文压缩怎样在 token 预算内运转？子智能体如何通过 Fork 继承父级上下文？
读懂 Claude Code 的设计决策，你就拥有了一套可迁移到任何 Agent 框架的心智模型。
⚠️ 声明 本书基于对 Claude Code 公开文档和产品行为的架构分析编写，未引用、未使用任何未公开或未授权的源码。Claude Code 为 Anthropic PBC 产品，本书不隶属于、未获授权于、也不代表 Anthropic。
| 架构代表性 | 工程决策可追溯 | 认知可迁移 |
| 涵盖 Agent Harness 全部核心子系统——工具类型、权限管线、上下文压缩、MCP 集成、子智能体调度 | 为什么用异步生成器而非回调？为什么权限是四阶段管线而非黑白名单？每个决策背后都是真实生产场景的洞察 | 每章提炼通用设计模式，无论你用 LangChain、AutoGen 还是从零构建 |
| # | 章节 | 一句话 |
|---|---|---|
| 01 | 智能体编程的新范式 | 从聊天到工具调用，范式如何转移 |
| 02 | 对话循环 — Agent 的心跳 | 异步生成器驱动的永动主循环 |
| 03 | 工具系统 — Agent 的双手 | 45+ 工具的注册、过滤与并发调度 |
| 04 | 权限管线 — Agent 的护栏 | 四阶段安全管线与权限模式谱系 |
| # | 章节 | 一句话 |
|---|---|---|
| 05 | 设置与配置 — Agent 的基因 | 六层配置优先级与供应链攻击防御 |
| 06 | 记忆系统 — Agent 的长期记忆 | 持久化、索引、自动提取与跨会话保持 |
| 07 | 上下文管理 — Agent 的工作记忆 | 四级渐进压缩与 token 预算管理 |
| 08 | 钩子系统 — Agent 的生命周期扩展点 | 26 个生命周期事件与安全边界 |
| # | 章节 | 一句话 |
|---|---|---|
| 09 | 子智能体与 Fork 模式 | 字节级上下文继承与并行子任务 |
| 10 | 协调器模式 — 多智能体编排 | Coordinator-Worker 架构与 Team 机制 |
| 11 | 技能系统与插件架构 | 零配置可用、可配置强大的技能协议 |
| 12 | MCP 集成与外部协议 | Model Context Protocol 与协议桥接 |
| # | 章节 | 一句话 |
|---|---|---|
| 13 | 流式架构与性能优化 | 并行预取、惰性加载、缓存共享 |
| 14 | Plan 模式与结构化工作流 | 计划与执行分离、定时触发 |
| 15 | 构建你自己的 Agent Harness | 六步从零实现，融会贯通全书 |
| 附录 | 内容 |
|---|---|
| A | 架构导航地图 — 模块依赖与数据流 |
| B | 工具完整清单 — 50+ 工具速查 |
| C | 功能标志速查表 — 89 个 Feature Flag |
| D | 术语表 — 100 条中英对照 |
┌──────────────────────────────────────────────┐
⏱ 时间紧张？ │ Ch1 → Ch2 → Ch4 → Ch15 │
│ 心智模型 + 核心机制 + 动手构建 │
└──────────────────────────────────────────────┘
┌──────────────────────────────────────────────┐
🏗 有经验的架构师？ │ 第二部分(核心系统) → 第三部分(高级模式) │
│ 遇到概念缺口回溯第一部分 │
└──────────────────────────────────────────────┘
┌──────────────────────────────────────────────┐
📖 系统学习？ │ 顺序阅读 → 完成每章实战练习 → Ch15 动手构建 │
│ 预计需要 2-3 周深度阅读 │
└──────────────────────────────────────────────┘
| 读者 | 你将收获 |
|---|---|
| 想构建 Agent 的 架构师 | 完整的设计空间地图与工程权衡分析 |
| 不满足于调 API 的 高级工程师 | 工具调用、流式处理、权限管控的底层机制 |
| 对 Agent 工程感兴趣的 研究者 | 从实现角度理解 Agent 系统的运作方式 |
| 希望最大化利用 Claude Code 的 实践者 | 理解设计意图，用得更准、调得更深 |
- 中文写作，技术术语保留英文原文（如 StreamingToolExecutor、Feature Flag）
- 每章结构：学习目标 → 核心概念 → 架构图 → 实战练习 → 关键要点
- 示例代码为说明设计模式的示意代码，非产品源码
2026 年 3 月 31 日，安全研究员 Chaofan Shou (@Fried_rice) 发现 Anthropic 发布在 npm registry 中的 @anthropic-ai/claude-code 包存在构建配置失误：source map 文件引用了未设访问控制的 Cloudflare R2 存储桶。披露推文获得超 1700 万次浏览，引发了技术社区对 Agent 架构的空前讨论。Anthropic 随后修补了该配置。
本书写作的初衷正是受到这场讨论的启发——当 Agent 架构成为开发者社区的热门话题，我们意识到需要一本系统性的书来讲解 Agent Harness 的设计原理。
欢迎提交 Issue 和 Pull Request：修正技术错误、补充实战案例、改进章节结构。
Linux.Do 社区
本书内容采用 CC BY-NC-SA 4.0 协议发布——可自由分享和改编，但须署名、非商业使用、并以相同协议共享。