Claude Code 架构深度解析

基于 2026年3月31日泄漏的 v2.1.88 源码（1,884 个 TypeScript 文件，~512K 行代码）

一、整体架构概览

Claude Code 是一个复杂的 AI 编程助手，采用 分层架构设计：
基础设施层 → 服务层 → 工具层 → 协调层 → UI 层。

二、核心目录结构

src/
├── main.tsx              # CLI 入口（785KB）
├── tools/                # 40+ 内置工具
├── commands/             # 50+ 命令实现
├── services/             # 核心服务
├── coordinator/          # 多 Agent 协调模式
├── assistant/            # KAIROS 主动助手模式
├── buddy/                # AI 伴侣系统（彩蛋）
├── plugins/              # 插件系统
├── skills/               # 技能系统
├── voice/                # 语音交互
├── vim/                  # Vim 模式
└── context/              # React Context 状态管理

三、System Prompt 架构

Claude Code 的 System Prompt 采用 5 层优先级系统：

部分	内容
Identity	“You are an interactive agent…”
System Rules	工具执行、权限模式、Prompt 注入检测
Task Execution	最详细部分：先读后改、不过度设计
Careful Actions	危险操作需用户确认
Tool Usage	优先使用专用工具而非 Bash
Tone	无 emoji、简洁
Cache Boundary	`__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__`

四、工具系统

Claude Code 内置 40+ 工具，核心工具包括：

Bash - 执行 shell 命令
Read/Write/Edit - 文件操作
Glob/Grep - 搜索
Agent - 子 Agent 调用
Memory - 记忆管理
MCP - 外部工具集成

五、多 Agent 协调模式（Coordinator Mode）

四阶段工作流：

阶段	执行者	目的
Research	Workers（并行）	研究代码库、查找文件
Synthesis	Coordinator	阅读发现、制定规范
Implementation	Workers	按规范进行修改
Verification	Workers	测试修改是否有效

关键原则：

“Parallelism is your superpower. Launch independent workers concurrently.”

六、Dream System（记忆整合系统）

Claude Code 有一个名为 autoDream 的后台记忆整合引擎：

阶段	操作
Orient	ls memory 目录，读取 MEMORY.md
Gather Recent Signal	从日常日志中提取新信息
Consolidate	写入或更新记忆文件
Prune and Index	保持 MEMORY.md < 200 行

七、隐藏功能标志

源码中发现了 87 个隐藏功能标志：

代号	功能
KAIROS	主动助手平台
COORDINATOR_MODE	多 Agent 协调模式
VOICE_MODE	语音输入/输出
BUDDY	AI 伴侣精灵
ULTRATHINK	扩展深度推理模式

八、与竞品对比

特性	Claude Code	Cursor	Cline
架构	CLI + React TUI	VSCode Extension	VSCode Extension
Agent 模式	✅ 多 Agent 协调	❌ 单 Agent	✅ 单 Agent
工具系统	40+ 内置 + MCP	内置	内置
记忆系统	✅ Dream 自动整合	❌	❌
插件系统	✅ Skills + Plugins	❌	❌

九、架构设计启示

分层解耦 - 每一层职责清晰，可独立测试和替换
优先级系统 - System Prompt 的 5 层优先级设计
并行优先 - Coordinator 模式明确教导”并行是超能力”
缓存优化 - 静态/动态分离的 Prompt 设计
渐进增强 - 从单 Agent 到多 Agent

分析时间：2026-04-01