Claude Code 源码架构全解析

这张图完整拆解了 Claude Code 的底层架构，它不只是一个“会写代码的终端工具”，而是一套由「大模型+工具+记忆+安全+协调」组成的闭环AI智能体系统。

一、核心技术栈

- TypeScript：全栈开发，强类型安全
- Bun：高性能运行时，替代Node.js，提供更快的JST/JS执行效率
- React + Ink：终端UI框架，打造交互化CLI界面
- Zod：Schema校验，保证类型安全
- npm：依托命令行生态分发工具

二、五大核心模块

1. 工具系统（50+ Tools）

提供覆盖开发全流程的能力，支持MCP生态扩展：

- 文件操作：FileReadTool/FileWriteTool、GlobTool、GrepTool、ListDirectoryTool
- 执行工具：BashTool、NotebookTool、JupyterTool
- 版本控制：GitTool
- 扩展能力：MCP协议连接外部服务、AgentTool（派生子Agent）

2. 核心大脑：QueryEngine（ReAct 智能体循环）

这是Claude Code的“决策中枢”，以ReAct模式实现闭环执行：

1. 发送Prompt：接收用户输入，构建系统级提示词
2. 流式响应：Claude模型边思考边输出，生成执行方案
3. 解析工具调用：识别用户需求，解析工具调用参数
4. 执行工具：调用工具获取结果
5. 反馈结果：将工具返回结果反馈给模型，进入下一轮思考
6. 循环执行：重复上述步骤，直到任务完成并返回最终答案

3. 权限与安全系统

三层防护，从根本上避免误操作：

- 三层权限控制：
- Level 1：静态配置（allowedTools白名单）
- Level 2：动态运行时检查
- Level 3：操作安全评估（危险命令拦截）
- Bash安全防护：AST语法分析识别危险操作，拦截 rm -rf / 等高风险命令
- 权限模式：ask模式（每次确认）、auto模式（自动执行，非信任环境禁用）

4. 上下文与记忆管理

通过多层压缩，在有限上下文窗口内高效处理长任务：

- MicroCompact 微压缩：本地上下文窗口，根据触发条件就近更新
- AutoCompact 自动压缩：自动压缩历史记录，生成结构化摘要
- Full Compaction 全量压缩：压整个会话上下文，只保留关键信息
- Prompt Cache 提示词缓存：系统提示词缓存，动态上下文分离，提高复用率

5. 多Agent协调（Multi-Agent Orchestration）

支持两种模式并行处理复杂任务：

- Orchestrator模式：Coordinator统筹全局，Worker子Agent分工执行，任务分发、进度跟踪、结果汇总
- Mailbox邮箱模式：Worker不能独立执行危险操作，任务并行处理互不干扰，结果汇总后协调输出

三、模型调用与提示词策略

1. 模型路由策略

根据任务复杂度自动匹配最优模型：

- 重型任务：Claude Opus（复杂推理、长上下文）
- 中型任务：Claude Sonnet（常规开发、调试）
- 轻型任务：Claude Haiku（快速问答、轻量操作）
同时支持成本优化、流式输出、API集成。

2. 系统提示词架构

 System Prompt（身份定义+工具描述+项目上下文+安全规则+环境信息）  +  User Prompt ，发送给Claude模型，保证行为可控、输出符合规范。

一句话总结：Claude Code 本质是一个跑在终端里的、带安全护栏的、支持多Agent协作的、可扩展的ReAct架构智能体，这也是它能在开发场景下超越普通对话式AI的核心原因。

AI代码理解 企业级AI架构 AI系统架构 AI全栈开发 ai代码索引 codex模型 ai架构图