2026-04-13 Windy how-claude-code-works 摘要

What it is

一份体量更大的 Claude Code 外部综述项目，作者把源码阅读拆成 15 个专题文档，覆盖主循环、上下文工程、工具系统、多 agent、记忆、技能、Plan 模式、权限安全和 UX。

它不是单篇博客，而更像一套“二手阅读地图”。因此它的价值主要在于：补充 topic 目录、指出哪些横切主题值得单独建页，而不是直接拿来当稳定事实库。

该项目把 Claude Code 明确建模成一套生产级 agent runtime，而不是“LLM + tool call” 的 demo。重点强调的成熟度信号包括：长会话压缩、权限纵深防御、工具并发调度、多 agent 隔离、内存/技能系统、Plan 模式和 UX。
文中对顶层调用链的概括，与 vault 已确认主线基本一致：QueryEngine 负责会话管理，query 负责主循环，工具系统通过统一协议回注到同一条 turn loop。
它提出一个值得继续追的横切框架：Claude Code 不只是模块多，而是围绕“长会话工程”组织了多种补偿机制，包括压缩、失败恢复、上下文恢复、工具延迟隐藏与后台通知。
文中列出 4 级渐进式压缩、5 层安全防御、66+ 工具、15 个专题模块等数字化说法。这些很适合做“阅读导航”，但在没有逐项回源码核验前，不应直接升级为 stable 结论。
多 agent、记忆、技能、Plan 模式、UX 这些章节说明当前 vault 的覆盖面仍偏 runtime 主线，后续可以按价值补更宽的主题页。

这份材料最有价值的地方不是具体新事实，而是提供了一张更完整的“Claude Code 大图”路线图。它提示当前 vault 还缺至少几条系统化主题：

其中，Prompt cache 设计、task-notification 回流、foreground/background 热切换、shell task 生命周期，已经证明“长会话工程”确实是一个比单文件 walkthrough 更高层的组织视角。

如果把 sathwick 看作“模块地图”，wavespeed 看作“产品工程视角”，那 Windy 这套文档更像“系统课程目录”。它最适合作为后续源码阅读 backlog 的生成器，而不是直接作为事实来源。