第 1 篇 认知篇：走进AI编程与Claude Code
第 1 章 AI编程的演进与变革 2
1.1 从AI Coding到Vibe Coding的演进 2
1.1.1 传统编程辅助工具的局限性 2
1.1.2 AI Agent时代的到来与Vibe Coding理念的兴起 4
1.2 AI编程工具的行业格局与对比 6
1.2.1 市场主流工具盘点 6
1.2.2 终端原生工具的独特价值与应用场景 8
1.3 AI 编程带来的行业变革 11
1.3.1 开发者角色的转变：从代码写作者到需求提出者/审查者 11
1.3.2 企业软件开发流程与人才标准的重塑 13
1.4 AI编程的安全与质量挑战 14
1.4.1 Vibe Coding的安全隐患：从理念到事故 14
1.4.2 AI编程工具的安全设计挑战 15
1.5 AI编程的商业影响与开发者社区的文化变迁 16
1.5.1 AI编程工具的商业影响 16
1.5.2 开发者社区的文化变迁 18
1.6 小结 21
第 2 章 Claude Code基础认知与技术底座 22
2.1 Claude Code的诞生 22
2.1.1 从Meta到Anthropic：Boris Cherny的职业历程 22
2.1.2 什么是Claude Code 23
2.1.3 为什么Claude Code备受瞩目 24
2.2 Claude Code技术底座与源码概览 25
2.2.1 代码公开事件始末：一次配置疏漏引发的技术地震 26
2.2.2 核心技术栈解析 27
2.2.3 源码背后的工程规模与启示 29
2.3 Claude Code的核心交互模式 32
2.3.1 终端CLI交互与斜杠命令基础 32
2.3.2 探索模式与执行模式的差异 34
2.4 Agent Loop初探：驱动Claude Code的核心引擎 37
2.4.1 从递归到状态机：一个关键的架构演进 37
2.4.2 每次迭代的10个步骤 38
2.4.3 隐藏功能与特性标志：108个未发布的模块 39
2.5 系统提示词工程：Claude Code行为的隐形设计师 40
2.5.1 系统提示词的动态构建机制 41
2.5.2 “行为宪法”：硬编码的工程智慧 42
2.5.3 工具提示词：37个工具的“使用说明书” 44
2.5.4 提示词工程的工程化实践 44
2.6 多 Agent协作架构：Claude Code的“蜂巢模式” 45
2.6.1 多Agent协作的必要性 45
2.6.2 Mailbox模式：Agent间的通信机制 46
2.6.3 协调者与工作者的角色分工 47
2.6.4 多 Agent协作的实际应用场景 47
2.7 Claude Code的工程美学 48
2.7.1 简洁的界面，复杂的内核 48
2.7.2 “为未来而构建”的前瞻性设计 49
2.7.3 “可信赖的AI伙伴”的设计目标 49
2.7.4 工程美学的启示：构建自己的AI Harness 50
2.8 小结 50
第 2 篇 理念篇：Harness工程与Claude Code整体架构
第 3 章 Harness工程：AI编程的全新范式 54
3.1 Harness工程的定义与本质 54
3.1.1 什么是Harness 54
3.1.2 Harness五维模型：工具+知识+观察+行动+权限 55
3.1.3 Harness工程的历史渊源与命名由来 56
3.2 Harness工程的核心理想与目标 57
3.2.1 解决AI编程的“不可靠性”痛点 57
3.2.2 从“追求一次性正确”到“构建自动纠错机器” 58
3.2.3 Anthropic实验数据：Harness工程的量化价值 58
3.3 Harness工程在Claude Code中的核心地位 60
3.3.1 Claude Code引入Harness工程的必要性 60
3.3.2 Harness理念在Claude Code整体设计中的贯穿应用 60
3.3.3 护城河不在模型，而在Harness 61
3.4 Harness工程的五大核心组件深度解析 61
3.4.1 Tool（工具）层：模型与外部世界的交互接口 62
3.4.2 Knowledge（知识）层：上下文信息的精准供给 63
3.4.3 Observation（观察）层：闭环反馈回路的底层构建 64
3.4.4 Action（行动）层：执行与验证的闭环调度 64
3.4.5 Permissions（权限）层：安全边界的工程化落地 65
3.5 Harness工程与提示词工程、上下文工程的三角关系 66
3.5.1 提示词工程：模型指令设计 66
3.5.2 上下文工程：模型信息供给 66
3.5.3 Harness工程：系统运行调整 67
3.5.4 三者的协同逻辑与职责边界 67
3.6 总结 68
第 4 章 Claude Code整体设计理念与架构概览 70
4.1 核心设计哲学 70
4.1.1 模型决定做什么，Harness负责怎么做 70
4.1.2 极简架构公式的深层解读 71
4.1.3 从反应式到主动式 72
4.2 整体架构设计原则 72
4.2.1 模块化与可扩展性原则 72
4.2.2 安全性与权限管控原则 73
4.2.3 高效协作与并行执行原则 73
4.2.4 成本效率原则：提示词缓存与Token经济学 73
4.3 整体架构概览与模块划分 74
4.3.1 顶层目录结构与核心模块 75
4.3.2 Harness工程理念在各模块中的映射关系 75
4.3.3 技术栈选型的工程哲学 76
4.4 源码视角：核心架构的工程实现 76
4.4.1 入口文件main.tsx：启动序列与并行预热 77
4.4.2 QueryEngine.ts：Agent Loop的调度引擎 77
4.4.3 系统提示词分层架构：静态段与动态段分离 77
4.4.4 工具池的组装与按需加载机制 78
4.5 Harness工程理念的12层渐进式封装 79
4.5.1 从最小AgentLoop到工业级自主编码智能代理 79
4.5.2 各层封装的工程价值与设计取舍 80
4.5.3 Claude Code的架构美学：简洁性、可扩展性与安全性的统一 80
4.6 总结 81
第 3 篇 剖析篇：Claude Code核心模块深度解析
第 5 章 工具与命令模块：Harness的操作之手 84
5.1 工具模块设计理念 84
5.1.1 设计定位与统一契约 84
5.1.2 核心工具分类与实现逻辑 87
5.1.3 工具的可扩展性与安全边界设计 89
5.2 命令模块设计理念 91
5.2.1 斜杠命令的设计规范 91
5.2.2 命令与工具的联动机制 92
5.3 工具与命令的协同工作流 93
5.3.1 用户输入到工具执行的完整链路 93
5.3.2 工具调用的错误处理与降级策略 94
5.4 工具执行流水线：14 步执行流程 96
5.4.1 流水线的整体架构 96
5.4.2 PreToolUse Hook的参数修改能力 97
5.4.3 执行前快照与乐观锁冲突检测 98
5.4.4 normalizeToSize算法的工程细节 98
5.5 工具系统的测试策略与质量保证 98
5.5.1 单元测试与集成测试 99
5.5.2 快照测试与回归防护 99
5.6 工具系统的反蒸馏机制与知识产权保护 100
5.6.1 模型蒸馏攻击的威胁模型 100
5.6.2 诱饵工具定义的注入策略 100
5.7 总结 101
第 6 章 权限与生命周期模块：Harness的安全边界 102
6.1 权限系统设计逻辑 102
6.1.1 为什么需要多级权限管控 102
6.1.2 权限校验的四层递进拦截机制 103
6.1.3 权限配置的最佳实践 106
6.2 会话生命周期管理 106
6.2.1 Hook的设计哲学与事件体系 106
6.2.2 PreToolUse与PostToolUse的深度应用 108
6.2.3 Stop Hook与输出质量控制 109
6.2.4 InstructionsLoaded Hook与动态指令注入 110
6.3 安全性与易用性的平衡艺术 110
6.3.1 降低用户打扰率的工程实践 110
6.3.2 企业级部署的安全架构设计 111
6.4 Hook 高级应用：企业级工程实践案例 112
6.4.1 案例 1：基于Git分支的动态权限控制 112
6.4.2 案例 2：敏感文件访问的实时告警 113
6.4.3 案例 3：自动化代码质量门控 115
6.5 总结 117
第 7 章 观察与反馈系统：Claude Code的自动纠错机制 118
7.1 Query Loop与核心调度引擎 118
7.1.1 QueryEngine模块的核心职责 118
7.1.2 Agent Loop的10步完整执行周期 120
7.2 Continue Site与自动纠错机制 122
7.2.1 Continue Site的设计与分类 122
7.2.2 错误捕获、分析与重试策略 123
7.3 渐进式上下文展现与状态管理 124
7.3.1 提示词缓存边界与动态上下文管理 124
7.3.2 三级上下文压缩策略 125
7.3.3 状态机在复杂任务中的应用 126
7.4 三级上下文压缩的工程细节 126
7.4.1 微压缩：零API成本的本地裁剪 127
7.4.2 自动压缩：带熔断器的智能摘要 127
7.4.3 完全压缩：全量压缩与预算重置 128
7.4.4 9段式摘要格式：结构化记忆的工程规范 129
7.5 挫败感遥测与用户体验信号 130
7.5.1 挫败感指标：咒骂频率作为UX信号 131
7.5.2 “继续”计数器：停滞检测的代理指标 131
7.6 总结 132
第 8 章 智能协作与记忆模块：Harness的感知与计划 133
8.1 智能协作模块：多智能体协调机制 133
8.1.1 Coordinator+Subagent两层架构 133
8.1.2 Mailbox模式与进程间通信 135
8.1.3 任务类型与执行模型 136
8.1.4 Proactive模式与自主调度 137
8.2 记忆与知识管理模块 137
8.2.1 CLAUDE.md与Auto Memory的互补设计 137
8.2.2 三层记忆架构的设计原理 138
8.2.3 CLAUDE.md的高级特性与最佳实践 139
8.2.4 AutoDream整合机制 141
8.2.5 Skill工作流模板系统 141
8.3 计划生成与执行跟踪 142
8.3.1 计划模式与任务拆解策略 142
8.3.2 执行进度的监控与动态调整 142
8.4 特性标志系统与实验性功能管理 143
8.4.1 108个门控模块的架构意义 143
8.4.2 已知的门控功能模块 143
8.4.3 特性标志与Bun的协同 144
8.5 多智能体系统的5种设计模式 145
8.5.1 模式1：提示词链式调用 146
8.5.2 模式2：并行化 146
8.5.3 模式3：路由分发 146
8.5.4 模式4：编排者—工作者 147
8.5.5 模式5：评估者—优化者 147
8.6 总结 148
第 9 章 交互与扩展模块：终端UI与生态接入 149
9.1 终端UI模块设计理念 149
9.1.1 React+Ink在CLI中的应用实践 149
9.1.2 交互反馈与用户体验优化 150
9.1.3 状态管理与UI层架构 151
9.2 IDE桥接与生态扩展 151
9.2.1 IDE Bridge的技术架构 151
9.2.2 VS Code与JetBrains插件的差异化实现 153
9.3 MCP与插件生态 155
9.3.1 MCP的设计理念与架构 155
9.3.2 Claude Code中的MCP集成实现 156
9.3.3 MCP生态的现状与未来 158
9.4 插件系统与Hook的深度协同 159
9.4.1 Hook与MCP的组合模式 159
9.4.2 扩展机制的安全边界 159
9.5 CI/CD集成与自动化工作流 160
9.5.1 无头模式 160
9.5.2 GitHub Actions集成示例 161
9.5.3 自动化测试修复工作流 163
9.6 Bun运行时的工程选择 164
9.6.1 为什么选择Bun而非Node.js 164
9.6.2 选择Bun带来的工程代价 165
9.7 Claude Code的安全沙箱设计 165
9.7.1 进程隔离与资源限制 165
9.7.2 容器化部署的最佳实践 166
9.8 总结 167
第 4 篇 应用篇：Claude Code实操指南与场景实战
第 10 章 Claude Code安装、配置与使用 170
10.1 安装与环境准备 170
10.1.1 硬件、系统要求与依赖工具 170
10.1.2 多平台安装步骤与API密钥配置 172
10.1.3 订阅计划选择与账号配置 174
10.2 基础使用与交互技巧 175
10.2.1 核心界面、基础指令与操作逻辑 175
10.2.2 上下文管理与高效交互技巧 177
10.2.3 计划模式深度解析 178
10.3 进阶配置与避坑指南 182
10.3.1 CLAUDE.md的编写技巧与层级配置体系 182
10.3.2 MCP服务器接入与插件生态扩展 186
10.3.3 自定义斜杠命令与Skill系统 188
10.3.4 常见实操误区与避坑技巧 192
10.4 总结 193
第 11 章 典型实战场景：从基础脚本到Web项目开发 195
11.1 基础实战场景：文件自动化处理与脚本编写 195
11.1.1 需求分析与可验证性指令设计 195
11.1.2 执行过程监控、问题修正与结果验证 197
11.1.3 工具模块调用的底层逻辑映射 198
11.1.4 Harness视角下的工具调用链路解析 199
11.2 进阶实战场景：Web项目开发与优化 201
11.2.1 项目探索、现状梳理与执行计划生成 201
11.2.2 代码实现、单元测试与问题修复 204
11.2.3 Harness计划与反馈机制在实战中的体现 209
11.2.4 多会话并行开发：Writer/Reviewer模式实战 209
11.3 进阶实战场景：遗留代码库重构与治理 211
11.3.1 大型代码库的探索策略与上下文管理 212
11.3.2 渐进式重构的任务拆解与防回退测试 217
11.3.3 代码审查、安全扫描与质量门禁集成 223
11.4 总结 225
第 5 篇 展望篇：AI编程的未来
第 12 章 未来代码编程的核心发展趋势 228
12.1 AI Agent成为编程主体 228
12.1.1 多智能体协作的规模化应用 228
12.1.2 Agent自主决策与闭环执行能力的提升 229
12.2 Harness工程走向标准化 230
12.2.1 Harness架构的标准化与规范化 230
12.2.2 企业级Harness平台的崛起与模板 231
12.3 自然语言到代码的低门槛化 231
12.3.1 意图驱动编程的普及 231
12.3.2 非技术人员编程门槛与Vibe Coding边界 232
12.4 安全、合规、可追溯成为刚需 232
12.4.1 代码安全校验与漏洞自动修复 232
12.4.2 AI生成代码的可追溯性与合规性 233
12.5 上下文工程成为核心竞争力 233
12.5.1 应对“上下文腐烂”与注意力稀缺 234
12.5.2 动态上下文压缩与边界管理 235
12.6 总结 235
第 13 章 Claude Code未来进化方向与开发者建议 236
13.1 Claude Code功能与架构进化预测 236
13.1.1 更强的上下文处理与更丰富的MCP支持 237
13.1.2 架构的进一步解耦与企业级平台化 237
13.2 设计理念与Harness体系的演进 238
13.2.1 从单机Harness到云端分布式Harness 238
13.2.2 自主代理时代的信任与安全演进 239
13.3 给AI编程时代开发者的建议 239
13.3.1 拥抱变化，提升系统设计与需求拆解能力 240
13.3.2 掌握Harness理念，构建专属的AI编程工作流 241
13.3.3 从代码公开事件汲取的工程启示 241
13.4 总结 242
· · · · · · (
收起)
异步图书
0 有用 WHM 2026-07-23 08:59:36 上海
一本因 Claude Code 源代码意外泄露而诞生的书，某些部分只能不明觉厉。
0 有用 duguguiyu 2026-10-18 18:29:05 山东
翻到就读了下，但现在书的问题是其实核心就两三个章节，但非要撑满那一大本
0 有用 tangboss004 2026-09-28 21:29:30 上海
1、AI也不是银弹，基础架构原则是永恒的，这也是设计多agent系统的指导原则。 2、harness中模型的精确性是基石，同步关注效率（如何使用更少的token以及精炼上下文）与安全（权限控制以及代码审查）。 3、Harness架构的核心是前馈(Feedforward)控制与反馈(Feedback)控制的有机结合。前馈控制通过系统提示词、代码规范（如CLAUDE.md）与静态分析工具，在Age... 1、AI也不是银弹，基础架构原则是永恒的，这也是设计多agent系统的指导原则。 2、harness中模型的精确性是基石，同步关注效率（如何使用更少的token以及精炼上下文）与安全（权限控制以及代码审查）。 3、Harness架构的核心是前馈(Feedforward)控制与反馈(Feedback)控制的有机结合。前馈控制通过系统提示词、代码规范（如CLAUDE.md）与静态分析工具，在Agent执行前提供指导，提升一次性成功率。反馈控制则通过测试套件、动态分析与“LLM作为裁判”(LLM-as-a-judge)机制，在Agent执行后提供纠错信号。 (展开)