本章总览

底层原理 本章聚焦它在 Claude Code 中的职责、主要数据流与源码入口。先看主线，再按源码引用进入实现细节。

本章导读

底层原理章节提炼五个设计范式，贯穿全书。适合学完架构后回来做理论升华。

学完本章你应该能

• 能解释 AsyncGenerator 协程模型
• 理解 feature() 编译期门控
• 说出 Prompt Cache 的经济意义

核心概念（先读懂这些）

范式比 API 更持久

API 字段会变，但「流式 + 工具循环 + 权限 gate」范式稳定。学 Claude Code 也在学现代 Agent 架构通用模式。

建议学习步骤

1. 逐条读五大原理
2. 每条找对应章节验证

5 大核心原理

1. AsyncGenerator 协程

query() 是 async generator，yield StreamEvent 给 UI。每轮 turn 是一个 iteration。

2. Bun feature() DCE

feature("KAIROS") 编译期求值。内部 true 保留，外部 false 消除。108 模块不在 npm 包。

3. Ink = React for Terminal

React 组件 → ANSI 序列。Terminal resize 触发 re-render。

4. MCP 开放协议

stdio/SSE/HTTP 连接外部工具服务器，动态发现 tools/resources。

5. Prompt Cache 经济

system prompt + tools 描述 cache_control。cache break detection 避免意外计费。

Message 流转

UserMessage → messages[]
AssistantMessage → messages[]
ToolResultMessage → messages[]
→ normalizeMessagesForAPI() → Anthropic API

本章小结与延伸

原理章是索引页。遇到不懂的实现，回来对号入座。 继续学习：

• 技术难点