Skip to content

Claude Code 原理与源码拆解Anthropic 终端 AI Agent 的源码级深度分析

基于 claude-code-rev 逆向还原源码树,从工程视角完整拆解 Claude Code 的启动流程、工具系统、命令系统、系统提示词、MCP 客户端、Ink TUI、状态管理和功能开关双机制。

Claude Code

课程结构

本教程分为三大部分,从概念到源码逐层深入。

第一部分:核心概念

理解 Claude Code 的基本架构和设计哲学。

🎯
Claude Code 到底是什么

定位、核心闭环(Agent Loop)、技术栈全景

🏗️
总体架构

三层架构(启动/CLI/运行)详解

🔧
工具系统

55 个工具的注册与执行机制

⌨️
命令系统

102+ 斜杠命令的设计哲学与分类

📝
系统提示词分析

动态多源的系统提示词构造

💾
会话与状态管理

三层状态持久化与恢复机制

🔌
MCP 与扩展机制

外部服务集成协议详解


第二部分:源码深度分析

深入源码层,逐模块分析 Claude Code 的关键子系统。

🗺️
源码阅读地图

784 个文件的宏观布局与阅读路线

🚀
启动流程深度分析

9 阶段启动序列与 13 条快速路径

🛠️
工具系统实现分析

Tool 接口、55 工具完整清单、权限门控

⚙️
工具注册与执行机制

buildTool 工厂、MCPTool 适配器、条件 require

📋
命令系统实现分析

Command 类型体系、四管道加载、102+ 命令逐一分析

🔀
命令加载管道机制

Bundled/Disk/Plugin/MCP 四源加载

💬
消息构造管线

消息类型层次、格式化管道、内容块类型、序列化

🧠
系统提示词构造管线

5 阶段动态组装与缓存策略

🐚
Bash 执行系统

AST 解析器、纵深防御 7 层安全模型、只读模式

🌐
MCP 客户端实现分析

8 种传输层、memoized 连接、OAuth 认证

📡
MCP 通信协议

JSON-RPC、配置源、工具路由

📚
技能系统实现分析

4 源发现管道、SkillTool 三模式执行

🧩
插件系统实现分析

5 来源加载、信任模型、12 UI 组件

🤖
Agent 工具系统

子 Agent 衍生、AGENTS.md、协调者模式

📡
API 客户端

流式请求、重试降级、认证、缓存策略

📎
附件处理系统

30+ 附件类型、图片压缩、Token 预算控制

💾
会话存储系统

JSONL 持久化、18+ entry 类型、压缩与恢复

🖥️
Ink TUI 渲染引擎

React/Ink 组件树与 REPL 布局

🖻
REPL 交互界面

18+ 子组件、流式消息渲染、键盘快捷键

🖨️
终端输出系统

Markdown 渲染、语法高亮、结构化输出

📊
三层状态管理

Bootstrap/AppState/UI State 协同

🔐
配置/认证/权限

5 层配置加载、OAuth PKCE、YOLO 模式

🔗
Daemon 与 Bridge

远程控制、后台会话、进程管理

🔌
Shim 兼容层

7 个 shim 包与私有模块替代策略

🚩
功能开关系统

编译时 DCE + 运行时 USER_TYPE 门控

🔍
架构缺陷与重构方案

5 大问题领域 + 4 阶段重构路线


第三部分:源码重建分析

从工程实践角度分析 Claude Code 的架构决策。

📖
项目总览

功能目标、架构图、目录结构

📂
源码目录映射

完整目录结构与代码行数热力图

🛤️
重建路线

8 步重建路线与环境配置

👢
Bootstrap 入口

MACRO 注入、快速路径、动态加载

🔩
工具系统

Tool 接口、注册流程、权限体系

⌨️
命令系统

四管道加载、Conditional require

💾
状态管理

三层状态架构与持久化

🌐
MCP 服务

连接生命周期与配置源

🔌
Ink UI 渲染

React/Ink 组件树与屏幕状态

🐛
调试与验证

验证清单与常见问题

🧩
Shim 兼容层

7 个 shim 包逐一分析

📐
启动链路详解

9 阶段完整启动序列

▶️
运行与调试

运行命令与调试技巧

🧭
扩展方向

6 个扩展方向与实现示例

📊
架构分析与重构方案

5 大问题 + 4 阶段重构


参考

⚠️
常见错误

理解源码时的 7 个常见误解

📚
系统提示词来源

50+ 源文件索引与优先级

🔗
资料来源

源码、文档与工具链索引


快速入口

📖学习路线👤关于作者💻源码仓库

加入交流群

作者 鲲鹏 Talk 全平台同名搜索关注。扫码加入交流群,与更多开发者一起探讨 AI Agent 技术。

微信交流群
微信交流群
微信公众号
微信公众号