从零构建代码智能体

如今，人人离不开AI编程，却缺乏深入理解代码智能体（Code Agent）架构与运行机制的途径。许多以Python为主的AI开发者，在试图通过源码学习底层实现时，往往面临项目闭源或开源版本非Python的困境。
本书深入解析Claude Code与Codex两大主流代码智能体，并为Python使用者提供了一套完整的Code Agent参考实现，涵盖从需求分析、系统设计到核心模块的开发全流程。随书附赠案例源码，获取方式见封底。
本书面向具备一定编程基础的学生、开发人员及AI初学者，尤其适合对Python、AI技术及智能体系统感兴趣，并希望通过实践掌握应用的读者。通过本书，读者不仅能理解核心技术与原理，还可借助丰富案例逐步实现自己的智能编程助手，达成理论与实践的深度融合。

前言
第 1 章　Code Agent 概述 1
1.1　定义与核心能力 2
1.1.1　智能体（Agent） 系统的本质 2
1.1.2　代码智能体（Code Agent） 的定义与关键特性 2
1.2　发展历史概述 5
1.3　与传统工具的区别 8
1.4　应用场景概述 10
1.4.1　智能代码生成与实现 10
1.4.2　自动文档生成 10
1.4.3　智能代码审查与优化11
1.4.4　自动化测试与调试 11
1.4.5　协作式开发支持11
第 2 章　Claude Code 核心技术 12
2.1　Claude Code 概述与研究方法 13
2.1.1　产品定位 13
2.1.2　核心设计理念 13
2.1.3　研究方法 14
2.2　系统架构与模块设计 15
2.2.1　三层并行架构概述 15
2.2.2　用户交互层 19
2.2.3　核心调度层 22
2.2.4　工具执行层 27
2.3　查询生命周期与数据流 30
2.3.1　完整查询流程 30
2.3.2　流式响应与并发控制 33
2.3.3　工具执行机制 36
2.3.4　递归查询与状态管理 36
2.4　核心子系统 39
2.4.1　工具系统 39
2.4.2　Agent 系统 44
2.4.3　权限系统 47
2.4.4　记忆管理与上下文压缩 51
2.4.5　Hooks 系统 56
2.4.6　插件系统 61
2.5　提示词工程 63
2.5.1　静态配置层——CLAUDE.md 的设计哲学 65
2.5.2　提示词的结构化技巧——XML 标签与Markdown 层级 65
2.5.3　系统提示词层（一）——身份定位与安全边界 66
2.5.4　系统提示词层（二）——输出风格与交互规范 68
2.5.5　系统提示词层（三）——工作流程与任务管理 71
2.5.6　系统提示词层（四）——代码规范与工具使用策略 73
2.5.7　辅助提示词层——动态上下文注入机制 75
2.5.8　提示词设计的核心原则总结 78
第 3 章　Codex 核心技术 80
3.1　Codex 及其设计理念 81
3.1.1　Codex 是什么 81
3.1.2　设计理念 82
3.2　技术架构与核心模块 83
3.2.1　整体架构概览 83
3.2.2　核心模块详解 86
3.2.3　会话管理与数据持久化 89
3.2.4　工具系统详解 91
3.2.5　沙箱与安全机制 94
3.2.6　MCP 集成 97
3.3　配置与扩展 99
3.3.1　配置系统 99
3.3.2　AGENTS.md 项目配置 102
3.3.3　执行策略（Execpolicy） 104
3.3.4　模型配置 106
3.4　提示词工程 108
3.4.1　系统提示词设计 109
3.4.2　响应管理与工作流控制 113
3.4.3　沙箱、批准与任务执行 115
3.4.4　验证策略与输出格式规范 118
3.5　Claude Code 与Codex 的对比分析 120
3.5.1　系统架构对比 121
3.5.2　提示词工程对比 121
3.5.3　安全机制对比 122
3.5.4　选择建议 123
第 4 章　Code Agent Python 实现样例Pywen 介绍 125
4.1　基本情况介绍 126
4.1.1　问题背景：Python 开发者的 AI 编程助手困境 126
4.1.2　Pywen 的提出：统一底座的解决方案 126
4.1.3　核心特性：全栈 Python 架构 126
4.1.4　设计目标：四大核心原则 127
4.1.5　价值主张：智能体生态的核心 127
4.2　安装与配置 127
4.2.1　环境要求与安装方式 128
4.2.2　配置文件详解与多模型支持 129
4.3　核心功能介绍 130
4.3.1　基础功能 130
4.3.2　智能体切换 131
4.3.3　文件操作与代码编辑 132
4.3.4　命令执行与环境管理 133
4.3.5　高级特性 133
第 5 章　Pywen 工程设计与系统搭建 136
5.1　需求分析与系统设计 139
5.1.1　Code Agent 核心功能需求 139
5.1.2　系统架构设计原则 145
5.1.3　统一数据协议与模型交互机制 149
5.2　Agent 核心模块实现 155
5.2.1　Agent 基础设施 156
5.2.2　Base Agent：统一基类 160
5.2.3　Pywen Agent：多回合迭代 162
5.2.4　Claude Agent：递归工具调用 168
5.2.5　Codex Agent：深度编码能力 172
5.2.6　构建你自己的智能体 175
5.3　工具系统设计与实现 180
5.3.1　BaseTool 与工具注册 180
5.3.2　工具执行链路 182
5.3.3　文件操作工具 185
5.3.4　系统工具 189
5.3.5　网络工具 192
5.3.6　专用工具 194
5.3.7　MCP 集成 198
5.4　系统集成 202
5.4.1　用户界面 202
5.4.2　配置管理 203
5.4.3　记忆管理 205
5.4.4　安全与权限管理 208
5.4.5　轨迹记录与调试 209
5.5　Hooks 扩展机制 211
5.5.1　核心设计211
5.5.2　Hook 事件类型 212
5.5.3　Hook 配置示例 212
5.5.4　Hook 脚本示例 213
5.5.5　最佳实践建议 214
第 6 章　Code Agent 测试与评估 216
6.1　为什么需要评测 217
6.1.1　评测的目标与价值 217
6.1.2　Code Agent 评测的常见类型 217
6.1.3　本章选择的评测基准及理由 219
6.2　BFCL 评测基准 220
6.2.1　BFCL 基准介绍 220
6.2.2　Pywen 的实现：如何适配 BFCL 223
6.2.3　评估执行与结果分析 225
6.3　SWE-bench 评测基准 227
6.3.1　SWE-bench 基准介绍 227
6.3.2　Pywen 的实现：如何适配 SWE-bench 230
6.3.3　评估执行与结果分析 233
6.4　技术挑战与未来改进方向 236
6.4.1　主要技术挑战 236
6.4.2　未来改进方向 238
第 7 章　Code Agent 模型选择与训练方法 241
7.1　大语言模型基础与选择标准 242
7.1.1　主流语言模型概览 242
7.1.2　针对代码任务的模型评估与选型要点 243
7.2　模型训练方法论 244
7.2.1　预训练数据构建：如何准备高质量的代码语料 244
7.2.2　微调技巧：从指令微调到人类反馈强化学习（RLHF）247
7.2.3　策略学习：面向Code Agent 的策略蒸馏与偏好优化 254
第 8 章　Code Agent 实战案例 259
8.1　斯特鲁普效应网页游戏 260
8.1.1　项目概述 260
8.1.2　与Code Agent 对话——一句话生成一个游戏 260
8.1.3　项目测试——让AI 当你的测试工程师267
8.1.4　文档编写——项目的“说明书” 269
8.2　文献跟踪系统——从需求到系统的完整旅程 270
8.2.1　项目概述270
8.2.2　需求梳理与功能分级——磨刀不误砍柴工 271
8.2.3　构建符合需求的提示词——细节决定成败 273
8.2.4　与Code Agent 对话——从需求到系统的实现 275
8.2.5　案例总结：复杂项目开发的关键经验 281
第 9 章　Code Agent 未来发展方向 283
9.1　推理能力与上下文理解的深化 284
9.2　多模态交互与协作模式创新 285
9.2.1　多模态交互的演进 285
9.2.2　人机共创的新模式 285
9.2.3　开发者角色的深刻演变 287
9.3　行业变革与人才需求的深刻调整 288
9.4　伦理、安全与责任治理 288
结语：给学习者的建议 291
参考文献 293