架构与内部机制
输入“/”快速插入内容
架构与内部机制
架构与内部机制
用户1208用户12087月8日修改
基于 Anthropic 官方文档和经社区验证的分析，对 Claude Code 内部机制进行技术层面的深度剖析。
阅读时间：完整版约 25 分钟 | 仅 TL;DR 约 5 分钟
最后核实：2026 年 2 月（Claude Code v2.1.34）
来源透明度说明
本文档综合了三类来源：
级别 | 描述 | 置信度 | 示例 |
Tier 1 | Anthropic 官方文档 | 100% | |
Tier 2 | 经核实的逆向工程分析 | 70-90% | |
Tier 3 | 社区推断 | 40-70% | 有观察依据但未经官方确认 |
每项信息均标注置信度。有官方文档时，优先参考官方文档。
TL;DR — 5 条要点
1.
简单循环：Claude Code 运行的是 while(tool_call) 循环——没有 DAG、没有分类器、没有 RAG。所有决策均由模型自主做出。
2.
八个核心工具：Bash 工具（万能适配器）、读取工具、编辑工具、写入工具、搜索工具、文件匹配工具、任务工具（子智能体）、TodoWrite。这就是全部工具集。搜索策略演变：早期 Claude Code 版本曾尝试使用 Voyage 嵌入实现语义代码搜索的 RAG。Anthropic 内部基准测试显示，基于 ripgrep 的 agentic 搜索表现更优、运维复杂度更低——无需索引同步，也不存在外部嵌入提供商的安全风险——因此切换至此方案。这一"搜索而非索引"的哲学以简单性和安全性换取了延迟和 Token 成本。社区插件（用于 AST 模式的 ast-grep）和 MCP 服务器（用于符号的 Serena、用于 RAG（检索增强生成）的 grepai）可满足专业化需求。来源：Latent Space 播客（2025 年 5 月）、ast-grep 文档
3.
200K Token（词元）预算：上下文窗口由系统提示、历史记录、工具结果和响应缓冲区共享。容量达到 ~75-92% 时自动压缩。
4.
子智能体 = 隔离：任务工具派生的子智能体拥有独立的上下文窗口。子智能体不能再派生子子智能体（深度=1）。仅摘要文本返回主上下文。
5.
设计哲学："少框架，重模型"——信任 Claude 的推理能力，而非围绕它构建复杂的编排系统。
总体架构图
Claude Code 并非新的 AI 模型，而是一个编排层，它将 Claude（Opus/Sonnet/Haiku）包装为可读取文件、执行 shell 命令、导航代码库、派生子智能体的系统——一切在一个持续循环中运行，直到任务完成。
画板
参考 Mohamed Ali Ben Salem 的架构图——更深入的分解见「架构内部图表」。
目录
•
总体架构图
1.
主循环
2.
工具集
3.
上下文管理内部机制
4.
子智能体架构
5.
权限与安全模型
6.
MCP 集成
7.
高级工具调用模式（API）
8.
编辑工具：实际工作原理
9.
会话持久化
10.
设计哲学：少框架，重模型
11.
Claude Code 与竞品对比
12.
来源与参考
13.
附录：尚不明确的内容
1. 主循环
Claude Code 的核心机制出奇简单：
代码块
┌─────────────────────────────────────────────────────────────┐
│ CLAUDE CODE MASTER LOOP │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ │
│ │ 你的提示词 │ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ │ │
│ │ CLAUDE 推理 │ │
│ │ （无分类器，无路由层） │ │
│ │ │ │
│ └────────────────────────┬─────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────┐ │
│ │ 工具调用？ │ │
│ └───────┬────────┘ │
│ │ │
│ 是 │ 否 │
│ ┌─────────────────┴─────────────────┐ │
│ │ │ │
│ ▼ ▼ │
│ ┌────────────┐ ┌────────────┐ │
│ │ 执行工具 │ │ 文本响应 │ │
│ │ │ │ （完成） │ │
│ └─────┬──────┘ └────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ 将结果返回 │ │
│ │ 给 Claude │──────────────────┐ │
│ └─────────────┘ │ │
│ │ │
│ ▼ │
│ ┌────────────────┐ │
│ │ 循环继续 │ │
│ │ （下一轮次） │ │
│ └────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘