目 录
第1章 上下文工程 2
1.1 上下文工程简介 2
1.2 Claude Code 及其上下文工程策略 5
1.2.1 策略 1:写入上下文与持久化记忆 5
1.2.2 策略 2:智能上下文检索 8
1.2.3 策略 3:上下文压缩 9
1.2.4 策略 4:利用子智能体实现上下文隔离 9
1.3 系统提示及其重要性 10
本章小结 12
第2章 Claude Code 核心要点 14
2.1 设置 Next.js 项目 15
2.1.1 运行并验证应用 16
2.1.2 初始化 Claude Code 17
2.2 将 Playwright MCP 连接到Claude Code 20
2.2.1 验证 MCP 连接 21
2.2.2 使用 Cursor 规则作为附加上下文 22
2.3 创建前端记忆上下文 22
2.4 基于规范实现主页面 27
本章小结 30
第3章 Claude Code入门——核心命令指南 31
3.1 Claude Code 的定价与方案 32
3.1.1 选项 1:使用 Anthropic API密钥 33
3.1.2 选项 2:使用 Claude订阅 34
3.2 使用斜杠命令控制ClaudeCode 36
3.3 在 Claude Code 中使用钩子机制 39
3.4 理解 Claude Code 中的记忆 43
3.4.1 记忆类型 43
3.4.2 Claude Code 如何读取记忆 44
3.4.3 动手示例:在现有项目中使用记忆功能 46
3.5 Claude Code 中的回退功能 50
3.5.1 回退功能的优势与重要性 50
3.5.2 在实践中使用回退 51
3.6 Claude Code 中的自定义斜杠命令(由技能驱动) 53
3.6.1 创建技能 53
3.6.2 执行技能 54
3.6.3 使用 $ARGUMENTS 改进技能 54
3.7 通过上下文工程改进自动生成的提交消息 55
本章小结 56
第Ⅱ部分 扩展 Claude Code:协议、自动化与结构化工作流
第4章 使用 MCP 服务器和插件扩展 Claude Code 60
4.1 为什么选择 MCP 61
4.1.1 集成难题 61
4.1.2 可移植性挑战 62
4.1.3 作为抽象层的 MCP 63
4.2 MCP 核心架构 64
4.2.1 MCP 的优势 64
4.2.2 MCP 的核心组件 65
4.3 MCP 实践应用 67
4.3.1 未连接 MCP 服务器时的行为 68
4.3.2 连接 MCP 服务器 68
4.3.3 在不同客户端之间复用同一个 MCP 服务器 70
4.4 将 Claude Code 连接到 MCP服务器 71
4.4.1 通过 CLI 添加 Context7MCP 服务器 72
4.4.2 MCP 服务器的作用域与配置 72
4.4.3 重启 Claude Code 并启用MCP 服务器 73
4.5 列出并检查已安装的 MCP服务器 74
4.5.1 使用 Context7 MCP 服务器查询 LangGraph 75
4.5.2 在项目记忆中持久化 MCP服务器的使用 75
4.5.3 验证 MCP 行为的持久性 76
4.5.4 将 MCP 相关产物提交到版本控制 76
4.6 MCP 作用域速查表 76
4.7 MCP 生态中的上下文工程 77
4.7.1 问题:过于泛化的 MCP配置 78
4.7.2 示例仓库与 MCP 服务器 80
4.8 项目级 MCP 配置 81
4.8.1 检查上下文使用情况 82
4.8.2 通过限定 MCP 配置范围来减少上下文占用 83
4.8.3 强制使用严格的 MCP配置 84
4.8.4 在会话中动态管理 MCP 85
4.9 当前MCP的局限性 86
4.9.1 上下文污染 87
4.9.2 智能体执行效率低下 88
4.9.3 “母语”问题—JSON 与代码 89
4.9.4 工具定义与模式的局限性 90
4.10 Cloudflare 的 CodeMode 91
4.10.1 关键观察 92
4.10.2 工具调用及其约束 92
4.10.3 MCP 的作用 92
4.10.4 集成 CodeMode 93
4.10.5 将MCP转换为TypeScript 93
4.10.6 在沙箱中执行 94
4.11 使用 Claude Code 插件管理配置 95
4.11.1 插件系统的优势 96
4.11.2 探索官方插件市场 96
4.11.3 向 Claude Code 添加市场 97
4.11.4 查看插件源码与安全注意事项 97
4.11.5 安装与管理插件 98
4.11.6 使用 feature-dev 插件 99
4.11.7 插件市场与企业应用 103
本章小结 103
第5章 使用 Claude Code 与 GitHub实现开发工作流的自动化 105
5.1 安装并配置 Claude Code 的GitHub 集成 106
5.1.1 安装前置依赖 106
5.1.2 安装 Claude GitHub 应用 107
5.1.3 安装 GitHub 工作流 107
5.2 使用 Claude Code 解决 GitHub问题 110
5.2.1 Claude 的待办列表与上下文探索 111
5.2.2 审查建议的更改 112
5.3 通过 CLAUDE.md 添加仓库上下文 113
本章小结 115
第6章 Claude Code 规划与多智能体工作流 116
6.1 Claude Code 的规划模式 116
6.1.1 规划模式的特性 117
6.1.2 规划工作流 117
6.1.3 规范驱动开发的优势 117
6.1.4 示例:迭代完善 Hook市场规范 118
6.1.5 持久化钩子市场规格说明 119
6.2 并行使用多个 Claude Code智能体 120
6.2.1 识别适合并行执行的任务 121
6.2.2 示例:HookHub 项目中的并行开发 121
6.2.3 将独立任务分配给智能体 122
6.2.4 并发执行任务 123
6.2.5 审查并提交更改 124
本章小结 125
第7章 使用 Claude Code 子智能体 126
7.1 Claude Code 子智能体简介 126
7.1.1 子智能体文件结构 129
7.1.2 与 React 智能体的关系 130
7.2 配置第一个子智能体 131
7.3 测试子智能体 134
7.3.1 运行代码审查子智能体 135
7.3.2 生成多个审查实例 136
7.4 使用子智能体时的上下文流 136
7.4.1 上下文窗口的实际表现 138
7.4.2 示例:创建一个 Mermaid图表子智能体 139
7.5 通过并发子智能体进行扩展 150
7.5.1 环境搭建 151
7.5.2 安装依赖 152
7.5.3 infinite 斜杠命令 153
7.5.4 重构 Hero 组件 153
7.6 infinite 提示 159
7.6.1 阶段 1:规范分析 160
7.6.2 阶段 2:输出目录探查 160
7.6.3 阶段 3:迭代策略 161
7.6.4 阶段 4:并行智能体协同 161
本章小结 162
第8章 创建与自定义输出风格 164
8.1 使用 Claude Code 创建自定义输出风格 164
8.1.1 创建并查看新的输出风格 165
8.1.2 输出样式的工作原理 167
8.1.3 为什么使用 YAML 167
8.1.4 将 YAML 创建为一种输出样式 169
8.2 创建高级项目级输出样式 171
8.2.1 自定义 HTML 输出样式 172
8.2.2 使用 HTML 输出样式 173
8.2.3 自动化文件生成 174
8.2.4 使用多个输出样式 175
8.2.5 专用输出样式工作流 177
8.3 在 Claude Code 中自定义状态行 178
8.3.1 自定义状态行命令 178
8.3.2 初始化状态行设置 178
8.3.3 更新配置 179
8.3.4 实现状态行逻辑 180
8.3.5 ANSI 颜色支持与格式化 180
8.3.6 扩展状态行功能 181
8.4 高级状态行:显示最近的用户提示 182
8.4.1 定义状态行需求 183
8.4.2 测试与最终完善实现 186
8.5 人工智能编码的未来:由专用智能体组成的团队 187
8.5.1 智能体驱动开发与多实例 187
8.5.2 命名与基于角色的上下文 188
本章小结 188
第Ⅲ部分 高级智能体与深度系统设计
第9章 理解智能体技能 192
9.1 智能体技能概述 193
9.1.1 场景 1:不使用技能进行样式设计 194
9.1.2 场景 2:使用技能进行样式设计 194
9.2 深入理解智能体技能 197
9.2.1 探索 Claude 技能市场 197
9.2.2 审查脚本 198
9.2.3 创建项目级自定义技能 199
9.2.4 使用自定义技能 200
9.2.5 在隔离的子智能体上下文中运行技能 205
9.3 将智能体技能与其他智能体原语进行比较 205
9.3.1 智能体技能与MCP 206
9.3.2 智能体技能与子智能体 207
本章小结 208
第10章 使用 Claude Code 桌面版 209
10.1 Claude Code 桌面集成与后台智能体 209
10.2 Claude Code 的安装与运行模式:本地与云端 210
10.2.1 选择工作区文件夹(本地worktree 模式) 211
10.2.2 切换到 Claude Code Web(云模式) 212
10.2.3 Git worktree 如何支持并行开发 213
10.3 编排本地与云端智能体的并行工作 214
10.3.1 在本地运行 Next.js应用 214
10.3.2 协调本地与云端的并行工作 216
10.3.3 执行并行功能开发 216
10.3.4 理解 Git 工作树布局 222
10.3.5 准备合并这些产出 222
10.4 理解 Claude Code 中的 Git工作树 222
10.4.1 Claude Code 如何使用工作树 223
10.4.2 并行使用多个工作树 223
10.5 合并并行功能分支 224
10.5.1 推送工作树分支 226
10.5.2 将所有内容合并到project/hookhub 228
10.5.3 执行合并 230
10.5.4 在推送到 project/hookhub之前进行测试 231
10.5.5 验证集成结果 232
10.5.6 完成合并 233
10.6 通过移动设备在云端运行Claude Code 234
10.6.1 实现页脚组件 235
10.6.2 审查拉取请求 236
10.6.3 在本地验证更改 238
10.7 并行智能体何时适得其反 238
本章小结 239
第11章 理解深度智能体 240
11.1 生产系统中的智能体分类 240
11.1.1 浅层智能体及其局限性 242
11.1.2 深度智能体 243
11.2 什么使智能体成为深度智能体 244
11.2.1 深度智能体中的规划工具 245
11.2.2 子智能体与分层委派 246
11.2.3 深度智能体中的文件系统访问 247
11.3 系统提示 249
本章小结 251
