第27章 · 关键设计模式

27.1 编译时死代码消除

这是Claude Code最核心的工程创新之一。通过Bun打包器的bun:bundle模块，Claude Code在编译时而非运行时进行特性判断：

import { feature } from 'bun:bundle'

if (feature('KAIROS')) {
  // 这段代码在非KAIROS构建中会被完全消除
  const kairosModule = require('./kairos')
}

与传统的运行时特性标志（if-else判断）相比，编译时消除有显著优势：

更小的包体积：未启用的功能代码完全不存在于产物中
无运行时开销：不需要条件判断
安全性：内部功能代码不会泄露到外部构建中（讽刺的是，Source Map绕过了这一保护）
树摇优化：依赖链自动清理

89个特性标志（其中16个主要标志）使Claude Code能从单一代码库构建出多种产品形态：面向消费者的CLI、企业版、KAIROS自主Agent、Bridge服务器、Coordinator编排器等。

27.2 Lazy Require打破循环依赖

大型TypeScript项目的经典问题——模块间循环依赖——在Claude Code中通过延迟require（Lazy Require）解决：

// 不在模块顶层import，而是在需要时才require
function someFunction() {
  const { SomeDependency } = require('./dependency')
  // 使用SomeDependency
}

这种模式打破了循环依赖链：A→B→C→A变成了A→B→C→(lazy)A，因为在C真正需要A时，A已经完成了初始化。

在代码库中，这个模式出现了数百次，主要集中在：

大型模块（main.tsx, query.ts）与其依赖之间
工具实现与工具注册系统之间
UI组件与状态管理之间

27.3 Forked Agent模式

Claude Code开创了一种"状态分叉"的后台任务执行模式：

主Agent的状态（消息历史、文件缓存、prompt cache）被"分叉"
后台Agent在分叉状态的基础上独立执行
后台Agent的结果可以被合并回主状态（或丢弃）

这个模式被用于：

Session Memory提取
Dream记忆巩固
Magic Docs更新
Extract Memories后台提取

关键优势是共享prompt cache——后台Agent不需要重新构建上下文，直接复用主Agent的缓存。在Cache命中的情况下，后台Agent的首次调用成本接近于零。

27.4 故障关闭（Fail-Closed）哲学

Claude Code在安全关键路径上贯彻了"故障关闭"原则：

Bash安全检查：如果检查逻辑本身失败（例如正则匹配出错），默认拒绝执行
权限决策：无法确定时默认询问用户
DXT解压：验证失败时拒绝安装

但在非安全关键路径上采用了"故障开放"（Fail-Open）：

策略限制：API获取失败时不阻塞，继续运行不受限
GrowthBook：特性标志加载失败时使用默认值
分析日志：发送失败时静默丢弃

这种"安全路径关闭、功能路径开放"的双重策略确保了系统在安全性和可用性之间的平衡。

27.5 闭包状态管理

Claude Code大量使用闭包来管理模块级别的可变状态，而非导出可变变量：

// 不是：export let counter = 0
// 而是：
export function createCounter() {
  let count = 0
  return {
    increment: () => ++count,
    getCount: () => count,
  }
}

这确保了状态的封装性和可预测性，避免了模块间的状态泄漏。

第27章 · 关键设计模式