Claude Code 完全指南 V2

书籍简介

《Claude Code 完全指南 V2》是一本以2026年Anthropic发布的Claude Code客户端源码泄露事件为切入点，全面剖析其51.2万行TypeScript代码工程架构的教育性读物。本书并非简单的“使用手册”，而是一部深入AI Agent内部运作机制的“工程史诗”。它将一次意外的“公开透明”转化为零基础读者也能跟进的系统化教学叙事，带领读者从背景故事、源码地图、术语解析开始，一步步深入Agent核心循环、工具系统、权限与安全设计等核心领域。

本书的核心价值在于其独特视角和深度。它不再停留在“Agent会调工具”的表面，而是深入到QueryEngine、Coordinator、Compaction、Hooks、MCP等具体的工程细节，通过生活化的类比、清晰的代码片段（无论是对真实结构的模拟还是教学性伪代码）和大量的Mermaid图表（每种至少1-2张），将复杂的概念和模块间的关系可视化。

全书共20篇，涵盖了从“小白快速上手”到“架构师级全景分析”的完整梯度。无论你是刚接触终端的新手，还是经验丰富的资深开发者，都能在书中找到适合自己的学习路径。本书特别强调“Less scaffolding, more model”的设计哲学，并讨论了泄露事件背后的法律与伦理边界，鼓励学习者在尊重规则的前提下进行探索。

图书目录

前言

• 前言：关于《Claude Code 完全指南 V2》

• 学习路线图：三条路径，同一种好奇心

• 术语表：把「行话」变成你能用的口令

• 环境搭建：工欲善其事，必先利其器

第1篇：背景故事

• 1.1 泄露事件始末

• 1.2 源码规模全貌

• 1.3 社区反应与重建

• 1.4 为什么值得学：AI Agent 的力气，多半花在「AI 之外」

• 1.5 法律与伦理

第2篇：小白快速上手

• 2.1 什么是AI编程助手

• 2.2 安装全流程

• 2.3 第一次对话

• 2.4 编辑文件实操

• 2.5 运行命令实操

• 2.6 Git工作流

• 2.7 命令速查表

• 2.8 费用与省钱技巧

第3篇：架构全景

• 3.1 不是CLI，是「以LLM为内核的操作系统」

• 3.2 四个独立入口

• 3.3 目录结构全景

• 3.4 数据流全景

• 3.5 技术栈深度解析

• 3.6 架构对比

• 3.7 启动流程详解

• 3.8 main.tsx 入口分析

• 3.9 模块依赖关系

• 3.10 设计哲学总结

第4篇：核心循环

• 4.1 QueryEngine：心脏

• 4.2 八步循环

• 4.3 query.ts 逐段走读

• 4.4 消息准备与历史

• 4.5 API 调用与流式响应

• 4.6 工具请求收集

• 4.7 静默错误修复

• 4.8 预算三重关卡

• 4.9 循环终止条件

• 4.10 Thinking 模式

• 4.11 并行工具执行器

• 4.12 协作全景图

第5篇：提示词工程

• 5.1 动态拼装机制

• 5.2 静态部分：系统宪法

• 5.3 动态部分：当期政策

• 5.4 缓存边界设计

• 5.5 Token 缓存经济学

• 5.6 缓存失效7大陷阱

• 5.7 铁血行为约束

• 5.8 工具使用手册

• 5.9 策略对比

• 5.10 实践：设计你自己的系统提示词

第6篇：工具系统

• 6.1 42个内置工具全景

• 6.2 Tool 接口设计

• 6.3 十四步治理流水线

• 6.4 BashTool

• 6.5 FileRead/FileEdit/NotebookEdit

• 6.6 搜索工具族

• 6.7 AgentTool

• 6.8 外部工具

• 6.9 MCP 工具集成

• 6.10 Fail-closed 设计

• 6.11 延迟加载

• 6.12 实践：构建自定义工具

（后续各篇略，完整目录详见文档第8页。）

适合人群

• AI编程工具使用者： 无论你是Claude Code、Cursor还是GitHub Copilot的用户，本书都能让你从“会用”进阶到“懂它”，理解背后的工程逻辑。

• AI Agent开发者与架构师： 想要构建自己的Agent平台或深度理解现有框架的工程师，本书提供了从核心循环、系统提示到工具治理的完整知识体系。

• 对大型软件工程感兴趣的开发者： 本书不仅讲AI，更通过分析51万行真实代码，展示了大型TypeScript项目的模块划分、依赖管理、安全设计、性能优化等实操经验。

• 零基础小白： 本书提供了详尽的术语表、环境搭建指南和学习路线图，即使你对终端和编程一知半解，也能按照作者设计路径，逐步建立起心智模型。

推荐理由

1. 独家的“内部视角”： 基于真实的“泄露”源码进行教学，让你看到产品表象之下的工程架构，这是任何官方文档都无法提供的深度。

2. 化繁为简的教学法： 通过生活化类比（如“操作系统比作办公楼”、“Agent循环比作厨师做菜”）和海量Mermaid图解，将51万行代码的庞杂逻辑拆解得清晰易懂。

3. 内容极其实用： 不仅有理论，还有“小白快速上手”的实操指导，以及环境搭建、费用控制、安全规范等可直接借鉴的最佳实践。

4. 体系化学习路径： 为不同背景的读者（小白、开发者、架构师）设计了三套学习路径，确保每个人都能高效学习，避免在庞杂信息中迷失。

总结

《Claude Code 完全指南 V2》是一本划时代的AI Agent工程教材。它超越了传统的工具使用教程，以一种负责任、教育性的态度，从一个意外事件中挖掘出巨大的学习价值。如果你不满足于做一个“AI乘客”，而渴望成为理解AI Agent并将其应用于实际工程的“驾驶员”和“工程师”，那么这本书是你书架上不可或缺的伙伴。它让你看到，AI Agent的魔法背后，是严谨的工程、精妙的设计和对安全的敬畏。