Claude Code Harness：驾驭 AI 编程 Agent 的工程体系
29 章源码级深度拆解：从 AI Coding Agent 的完整技术架构出发，覆盖工具系统、Agent Loop、Context 管理、提示词工程、安全权限、插件生态、可观测性等生产级工程实践。
📖 本书大纲
Claude Code Harness：驾驭 AI 编程 Agent 的工程体系
本书源自开源项目 harness-engineering-from-cc-to-ai-coding，通过逆向工程 Claude Code 的完整源码，将「驾驭工程（Harness Engineering）」的隐性知识变为显性、可学习的实践。
关于这本书
Claude Code 的成功不是来自某个单一的技术突破，而是来自一整套精心设计的驾驭工程体系。本书以 29 个技术专题，从七层架构出发，逐层拆解一个生产级 AI Coding Agent 到底是如何工作的。
读者对象：正在构建 AI Agent 的工程师、想理解"为什么这个 AI 工具好用而那个不好用"的开发者。
一句话论点
一个 Language Model 本质上只是文本预测引擎。Claude Code 的真正威力不在于模型多强，而在于它构建了一个精密的系统架构，让 AI 能够理解代码库、执行命令、运行测试、修复问题——这一切都通过自然语言对话完成。
章节导航
- 第 1 章：AI Coding Agent 的完整技术架构
- 第 2 章：工具系统——40+ 工具如何让 AI 拥有编程能力
- 第 3 章：Agent Loop——从意图到行动的循环引擎
- 第 4 章：Context 管理——如何把整个代码库塞进上下文
- 第 5 章：提示词工程——让模型理解任务的正确姿势
- 第 6 章：通过提示词引导行为
- 第 7 章：系统提示词的组装
- 第 8 章：插件系统与工具发现（MCP 生态）
- 第 9 章：自动压缩
- 第 10 章：微压缩
- 第 11 章：上下文压缩策略
- 第 12 章：上下文管理全景
- 第 13-19 章：安全权限、文件状态、沙箱隔离、命令执行、权限校验等安全体系
- 第 20-29 章：行为引导、多 Agent 编排、可观测性、生产级遥测等进阶工程实践
参考资料
- 开源书籍：harness-engineering-from-cc-to-ai-coding
- Claude Code 源码仓库（逆向工程版本）
- Anthropic API 文档：缓存机制、前缀匹配、Token 计数
📑 章节目录
Claude Code Harness Chapter 1: AI Coding Agent 的完整技术架构
深入剖析 Claude Code 的多层架构设计，从工具系统到 Agent Loop，从 Context 管理到安全机制，全面揭示生产级 AI Coding Agent 的技术实现
Claude Code Harness Chapter 2: 工具系统：40+ 工具如何让 AI 拥有编程能力
深入剖析 Claude Code 的工具系统架构，探讨 40+ 工具如何作为 AI 的双手，实现从文本预测到实际操作的转变
Claude Code Harness Chapter 3: Agent Loop：从用户输入到模型响应的完整生命周期
深入探讨 Claude Code 的 Agent Loop 机制，揭示从用户输入到模型响应的完整生命周期，包括决策流程、工具编排和消息管理
Claude Code Harness Chapter 4: 工具执行编排：并发、流式输出和中断控制
深入探讨 Claude Code 的工具执行编排系统，包括并发执行、流式输出、细粒度中断控制和资源管理
Claude Code Harness Chapter 5: 系统提示词架构：AI 行为的控制平面
深入剖析 Claude Code 的系统提示词架构，探讨如何通过精心设计的提示词层级系统来引导和约束 AI 的行为
Claude Code Harness 第6章：通过提示词引导行为
深入解析提示词工程中的行为引导模式：如何通过精确的指令设计将 AI 模型的行为引导到期望范围内。
Claude Code Harness 第7章：模型特定调优与 A/B 测试
深入解析 Claude Code 的模型特定调优策略、@[MODEL LAUNCH] 注解系统、A/B 测试方法论以及 Feature Flag 管理
Claude Code Harness 第8章：工具提示词作为微型驾驭器
深入解析工具提示词如何作为微型驾驭器：每个工具都有独立的提示词系统，实现精细化的行为引导
Claude Code Harness 第9章：自动压缩——上下文何时以及如何被压缩
深入解析 Claude Code 的上下文自动压缩机制：200K token 竞技场中的智能压缩策略
Claude Code Harness 第10章：压缩后的文件状态保留
深入解析压缩后如何保留关键文件状态：虚拟文件系统、符号化摘要与增量重建策略
Claude Code Harness 第11章：微压缩——精准上下文修剪
深入解析微压缩技术：比自动压缩更精细的上下文修剪策略，实现精准的token预算控制
Claude Code Harness 第12章：Token 预算策略
深入解析 Token 预算策略：如何在 200K 上下文窗口中实现智能的资源分配与管理
Claude Code Harness 第13章：缓存架构与断点设计
深入解析提示词缓存系统：如何通过智能缓存设计降低 90% 的成本和延迟
Claude Code Harness 第14章：缓存中断检测系统
深入解析缓存中断检测：如何识别和应对缓存失效场景
Claude Code Harness 第15章：缓存优化模式
深入解析提示词缓存优化模式：最大化缓存命中率的设计策略
Claude Code Harness 第16章：权限系统
深入解析 Claude Code 的权限系统设计：如何实现细粒度的操作权限控制
Claude Code Harness 第17章：YOLO 分类器
深入解析 YOLO 分类器：如何在 Auto 模式中实现智能的安全决策
Claude Code Harness 第18章：Hooks——用户自定义拦截点
深入解析 Hooks 系统：如何让用户自定义工具执行前后的拦截逻辑
Claude Code Harness 第19章：CLAUDE.md——用户指令作为覆盖层
深入解析 CLAUDE.md 系统：如何通过项目级配置文件实现自定义指令覆盖
Claude Code Harness 第20章：Agent 集群与多 Agent 编排
深入解析 Agent 集群系统：如何实现多 Agent 协作与编排
Claude Code Harness 第21章：Effort、Fast Mode 与 Thinking
深入解析 Effort 模式系统：如何在性能和质量之间找到最佳平衡点
Claude Code Harness 第22章：技能系统——从内置到用户自定义
深度解析技能系统架构：从内置命令到用户自定义扩展的完整实现路径
Claude Code Harness 第23章：未发布功能管线——89个Feature Flag背后的路线图
深度解析Claude Code的未发布功能管线：89个Feature Flag背后的产品管理哲学与技术实现
Claude Code Harness 第24章：跨会话记忆——从遗忘到持久学习
深度解析Claude Code的跨会话记忆系统：从短期对话到长期持久化的完整解决方案
Claude Code Harness 第25章：驾驭工程原则
深度解析Claude Code的工程原则：从架构设计到实践落地的完整指南
Claude Code Harness 第26章：上下文管理作为核心能力
深度解析Claude Code的上下文管理体系：从信息管理到智能决策的核心能力
Claude Code Harness 第27章：生产级AI编码模式
深度解析Claude Code的生产级AI编码模式：从开发部署到运维监控的完整解决方案
Claude Code Harness 第28章：Claude Code的不足之处
深度解析Claude Code的局限性：从技术约束到实际挑战的全面分析
Claude Code Harness 第29章：可观测性工程——从logEvent到生产级遥测
深度解析Claude Code的可观测性工程：从基础日志到生产级监控的完整体系