README

本章深入探讨 Claude Code 的核心技术实现细节。

章节内容

• Query Loop - 基于异步生成器的执行引擎

• 状态管理 - 极简状态管理方案

• 消息流转 - 消息的构建、发送和处理

• System Prompt - 系统提示词的组织和优化

核心执行流程

Claude Code 的执行流程可以概括为：

用户输入 → Query Loop → AI 响应 → 工具执行 → 结果反馈 → 继续对话

关键组件

1. Query Engine - 异步生成器驱动的执行引擎

2. Tool Executor - 并发工具执行和结果收集

3. Context Manager - 动态上下文压缩和管理

4. Permission System - 多层权限检查和审批

技术亮点

1. 流式架构

使用异步生成器实现真正的流式处理：

async function* query(messages, tools, options) {
  // 流式接收 AI 响应
  for await (const event of anthropic.messages.stream(...)) {
    yield { type: 'content', content: event.delta.text };
  }
  
  // 流式执行工具
  for await (const result of executeTools(toolCalls)) {
    yield { type: 'tool_result', result };
  }
}

2. 并发工具执行

多个工具调用可以并发执行：

// 最多 5 个工具并发执行
const results = await Promise.all(
  toolCalls.slice(0, 5).map(call => executeTool(call))
);

3. 智能上下文管理

五层压缩策略自动触发：

if (tokenCount > 180000) {
  await autoCompact(messages, { aggressive: true });
} else if (tokenCount > 150000) {
  await contextCollapse(messages);
} else if (tokenCount > 120000) {
  await microcompact(messages);
}

4. 类型安全

端到端的类型安全：

// 工具输入验证
const input = FileEditInputSchema.parse(rawInput);

// 类型推导
type Input = z.infer<typeof FileEditInputSchema>;

// 运行时检查
if (!input.path.startsWith('/')) {
  throw new Error('Path must be absolute');
}

性能优化

启动优化

• 延迟加载: Skills 和 Plugins 按需加载

• 并行预取: 配置和状态并行读取

• 缓存: System Prompt 缓存，减少重复计算

运行时优化

• 工具并发: 最多 5 个工具同时执行

• 投机执行: 预测性执行可能的工具调用

• 结果缓存: 相同输入的工具调用结果缓存

内存优化

• 上下文压缩: 自动清理旧消息

• 流式处理: 避免大对象在内存中累积

• 弱引用: 缓存使用 WeakMap

错误处理

分层错误处理

工具层错误 → 捕获并格式化
  ↓
服务层错误 → 记录并重试
  ↓
Query 层错误 → 通知用户
  ↓
UI 层错误 → 显示错误信息

错误恢复策略

• 工具执行失败: 返回错误信息给 AI，让其重试

• API 调用失败: 指数退避重试

• 权限拒绝: 提示用户并等待确认

• 上下文溢出: 自动压缩并重试

下一步

• 深入 Query Loop 的实现细节

• 了解 状态管理 的设计

• 探索 消息流转 的机制