随笔
Claude Code 源码解读导读
把 Claude Code 源码解读拆成快速版和工程师深度版两条阅读路径。
这一组文章拆成两条线：快速版给想先抓主线的读者；深度版给需要读源码、做架构判断、迁移工程经验的技术读者。
我保留当前 9 篇快速版，不把它们强行改成硬核长文。快速版先回答两件事：这个机制解决什么问题，源码主线和场景插入如何分层；当 Codex 差异有助于拆开 agent harness 的设计取向时，再作为辅助视角加入。深度版则专门追源码怎么组织、状态怎么转移、失败路径怎么处理、设问如何回应，以及哪些架构原则和工程经验可以迁移。
两条阅读路径
| 读者 | 推荐路径 | 适合场景 |
|---|---|---|
| 快速浏览者 | 读快速版 | 先理解 Claude Code Harness 为什么需要 Context、权限、Hooks、Memory、Query Loop 和可观测性 |
| 技术读者 / 架构读者 | 读深度版 | 追源码入口、主线链路、场景插入、失败路径、Codex 对比和工程可迁移经验 |
目录分流
| 篇章 | 主题 | 快速版 | 技术深度版 |
|---|---|---|---|
| 01 | Harness 总览 | 快速版 | 深度版 |
| 02 | Context 构建 | 快速版 | 深度版 |
| 03 | Tools / Permissions | 快速版 | 深度版 |
| 04 | Query Loop / Recovery | 快速版 | 深度版 |
| 05 | Hooks 纠偏 | 快速版 | 深度版 |
| 06 | Memory 连续性 | 快速版 | 深度版 |
| 07 | 多 Agent / Task | 快速版 | 深度版 |
| 08 | 安全与信任边界 | 快速版 | 深度版 |
| 09 | 可观测性与持久化 | 快速版 | 深度版 |
快速版怎么读
- Context：它开始前有没有看对问题。
- Tools / Permissions：它想做事时是不是被约束住。
- Hooks：外部规则能不能及时介入。
- Memory：长期经验怎样进来，但不污染当前任务。
- Query Loop / Observability：任务长了、错了、断了，能不能恢复。
深度版怎么读
深度版每篇都固定回答几类问题：本期要验证的不变量、关键源码入口、主线执行链路、场景插入点、失败路径、延伸设问的回应、工程可迁移经验，以及最后回到本篇机制主线的架构师视角总结。Codex 对比用于拆解设计差异和设计原则，不把未验证实现写成事实。