课程大纲
哲学、对比与未知:Claude Code 这套设计为什么成立
哲学、对比与未知:Claude Code 这套设计为什么成立
本文基于 Florian BRUNIAUX 的英文原版改编,原文地址:https://cc.bruniaux.com/guide/architecture 许可:CC BY-SA 4.0
这篇你能拿走什么
到这里你已经看过 Claude Code 的所有内部组件——但单看每个组件容易忽略一件事:为什么这套设计能成立。这一篇收尾,把 Anthropic 的"少搭脚手架,多信模型"哲学讲透;横向对比 Copilot / Cursor / Amazon Q;最后老老实实列出"我们不知道什么",让你知道哪些行为是有意为之的边界。
前置条件
- 已完成本系列前面的章节
哲学:少搭脚手架,多信模型
可信度:100%(Tier 1 - Daniela Amodei 公开表述)
"用更少做更多。聪明的架构选择、更好的训练效率,以及聚焦的问题解决能力,可以与原始规模竞争。" — Daniela Amodei(Anthropic 联合创始人兼总裁)
落到工程上意味着什么:
| 传统方法 | Claude Code 方法 |
|---|---|
| 意图分类器 → 路由器 → 专家 | 单个模型决定一切 |
| 使用 embedding 的 RAG | Grep + Glob(regex 搜索) |
| DAG 任务编排 | 简单 while loop |
| 特定工具的 planner | 模型驱动的工具选择 |
| 复杂状态机 | 把对话作为状态 |
| Prompt engineering 框架 | 信任模型 |
为什么它有效
- 模型能力:Claude 4+ 已经足够能处理路由决策
- 降低延迟:组件更少 = 响应更快
- 更简单的调试:出错时只有一个地方需要看
- 更好的泛化:没有会在边界情况上崩掉的手写规则
权衡
| 优点 | 缺点 |
|---|---|
| 简单性 | 更少细粒度控制 |
| 灵活性 | 更难强制严格行为 |
| 更少 bug | 模型错误会影响一切 |
| 快速迭代 | 需要高质量模型 |
社区验证
"原生能力优先"的方法正在越来越多地被外部实践者验证。嵌入式工程团队(包括以前的 Cursor 重度用户)正在转向 Agent Skills 标准,而不是外部编排框架——这说明相信 Claude 原生推理能力、而不是添加脚手架层,是可行的。
例子:Gur Sannikov(embedded engineering)采用了 ADR 驱动的 workflow,只用 Claude Code 原生能力(hooks、skills、Task Tool),没有外部框架——验证了"less scaffolding, more model"在嵌入式系统这种复杂工程领域同样可扩展。
Claude Code vs 替代方案
可信度:80%(Tier 2 - 基于 2026-03 事实核查)
| 维度 | Claude Code | GitHub Copilot | Cursor | Amazon Q Developer |
|---|---|---|---|---|
| 架构 | while(tool) loop | IDE agent + cloud coding agent | 事件驱动 + 云 | AWS 集成 agent |
| 执行 | 本地终端 | 本地(agent mode)+ 云 VM | 本地 + 云 | 云 / 本地混合 |
| 模型 | Claude(单供应商) | GPT、Claude、Codex(可选) | 多个模型(自适应) | Amazon Titan + 其他 |
| 上下文 | ~200K tokens | 完整代码库(agent mode) | 代码库感知(Composer) | 不固定(AWS-scoped) |
| 透明度 | 高(可见推理) | 中 | 中 | 低 |
| 定制 | CLAUDE.md + hooks + MCP | AGENTS.md、MCP(GA)、custom agents | MCP Apps、.cursorrules | MCP(原生)、AWS 集成 |
| MCP 支持 | 原生 | 是(GA,auto-approve) | 是(MCP Apps v2.6) | 是(原生) |
| 定价 | Pro $20 / Max $100-200 | Free / Pro $10 / Pro+ $39 / Biz $19/seat | Free / Pro $20 / Biz $40/seat | Free / Pro $19/seat / Enterprise |
什么时候选 Claude Code
| 场景 | Claude Code | 替代方案 |
|---|---|---|
| 深度代码库探索 | 优秀 | 良好 |
| 终端原生 workflow | 优秀 | 有限 |
| 自定义自动化(hooks) | 优秀 | 有限 |
| 团队标准化 | 良好(CLAUDE.md) | 不一 |
| IDE 集成 | 有限(VS Code ext) | Cursor / Copilot 更好 |
| 企业合规 | 通过 Anthropic enterprise | 不一 |
简单决策:终端 + hooks + 深度探索 → Claude Code;纯 IDE 内补全 → Copilot/Cursor;AWS 重度用户 → Amazon Q。
我们不知道什么
可信度:70%(Tier 3 - 透明陈述)
对理解中的空白保持透明:
| 主题 | 我们不知道什么 |
|---|---|
| 精确压缩阈值 | 75%?85%?92%?是否随模型变化? |
| 系统提示内容 | 全文不公开,并随模型版本变化 |
| Token 计算方法 | 精确 tokenizer、工具 schema 的额外开销 |
| 模型 fallback | 如果模型失败,Claude Code 是否 fallback? |
| 内部缓存 | 会话之间是否有结果缓存? |
| Rate limiting 逻辑 | 每个工具如何应用 rate limit |
Anthropic 有意没文档化的内容
- 会话文件格式(内部实现细节)
- 不同模型之间的系统提示差异
- 内部组件名称 / 架构
- 每个组件的 token 使用拆解
- 精确的权限评估顺序
这是个重要信号:当 Anthropic 选择不公开某项细节,意味着它可能在版本之间变化。任何依赖它的外部工具都会随时被打破。基于这个清单,别在生产 pipeline 里依赖会话文件格式、压缩时机、token 精确计数。
怎么保持更新
- 官方 changelog:https://anthropic.com/changelog
- GitHub releases:https://github.com/anthropics/claude-code/releases
- 社区 Discord:各种 Claude 相关服务器
- 本系列:会根据已验证信息定期更新
发现错误?有新的已验证信息?欢迎贡献给原作者:
- 官方事实:引用 Anthropic 来源
- 观察结果:说明你如何验证该行为
- 修正:解释哪里错了,以及为什么错
实战注解
我自己读完整篇最大的收获是 "less scaffolding, more model" 的反向意义:很多团队 2024-2025 年花了大量精力在 LangChain / DAG / 自定义编排框架上,结果 2026 年 Claude Code 用一个 while 循环就把同样的事做了——还更稳。复杂度不是能力的标志,简单才是。
这不代表所有 agent 都该这样做。但下次你准备给 agent 加一层"路由器"或"分类器"时,先停一下问自己:**模型自己决定不行吗?**绝大多数时候答案是"行"。
至于"我们不知道什么"——这是这份资料最值钱的地方。多数文档会假装"什么都知道",敢老老实实列出未知点的,反而是可信度最高的。
可信度回顾
- Tier 1(官方 100%):哲学引文(Daniela Amodei)、官方文档级对比维度
- Tier 2(70-90%):竞品对比数据(基于 2026-03 事实核查)、社区验证案例
- Tier 3(透明陈述):"我们不知道什么"清单——这部分本身就是不确定性声明,值得保留
常见问题
Q:Anthropic 为什么不公开系统提示全文? A:原文给的解释是"系统提示在版本之间会变化",公开会让用户误以为它稳定。Anthropic 的透明度承诺覆盖结构和大类(工具定义、安全指令、行为准则),不覆盖逐字内容。
Q:未来 Claude Code 会不会加 DAG / planner? A:从哲学看不会。但 v2.1.32+ 的 Agent Teams 已经是"多 agent 并行协作 + Git 协作"的方向,可以视作受控的扩展,而不是脚手架回归。
Q:本系列怎么跟上版本? A:原作每隔一段时间会更新(最近一版基于 v2.1.34 / 2026-02)。这套教程会在原作有重要更新时同步——你也可以直接订阅原作的英文版(https://cc.bruniaux.com/guide/architecture)追最新。
来源与许可
- 原作者:Florian BRUNIAUX;Claude(Anthropic)参与贡献
- 英文原版地址:https://cc.bruniaux.com/guide/architecture
- 源文件:
FlorianBruniaux/claude-code-ultimate-guide / guide/core/architecture.md - 本文基于 CC BY-SA 4.0 改编:保留署名、来源链接,衍生作品同样以 CC BY-SA 4.0 公开
- 内容版本:原作 v1.1.0 / Claude Code v2.1.34(2026-02)