2026-04-12 wavespeed claude-code-architecture-deep-dive 摘要
What it is
一篇基于泄露源码做的外部架构综述，重点不是逐文件 trace，而是从产品工程视角总结 Claude Code 的运行时分层、tool system、长会话管理与治理机制。
Key claims / findings
- 文中把 Claude Code 描述成一个成熟的 agentic CLI：
QueryEngine负责会话级编排，工具调用、流式输出、重试、缓存与上下文管理被收束在同一主干里。 - 它再次强化了 vault 里已有主线：工具是统一扩展接口，
AgentTool之所以关键，是因为“起子 agent”本身就是一次普通 tool call，而不是框架外特权入口。 - 这份材料最有价值的补充，是把 long-session engineering 单独抬了出来。文中把 context compression、失败自愈、权限隔离、后台审批路径看作 Claude Code 成熟度的主要信号，而不只是额外优化。
- 文中提到三层 context compression（MicroCompact / AutoCompact / Full Compact），这能作为后续源码阅读线索，但当前 vault 还没有对应源码验证页，因此只能视作待验证目录信息。
- telemetry、feature flags、compile-time gating 也被提到，但这份原始素材是“normalized and shortened”版，不能据此写成稳定事实。
Relevant concepts
Cross-source synthesis
与 2026-04-12 sathwick reverse-engineering-claude-code 摘要 相比，这篇文章的新信息密度并不主要体现在模块枚举，而在于更明确地提出：Claude Code 的“产品级完成度”来自横切能力的叠加，包括权限治理、长会话压缩、失败恢复与 telemetry，而不只是 query() + tools 这一条主调用链。
Open questions
QueryEngine.ts内部到底哪些逻辑负责压缩触发、压缩级别选择与压缩后回灌，仍需回源码确认。- 文中提到的 telemetry 指标和 feature-gated 模块，当前应被视为二手线索，而不是 vault 中的稳定结论。
- 如果后续继续 ingest Claude Code 材料，一个值得补的主题是“长会话工程”，它比单独的 prompt cache 更宽。