内部机制

Feature Flags、Session 管理、文件历史追踪 — 这些是支撑 Claude Code 运行的内部基础设施。

Feature Flag 系统 (88+)

Claude Code 通过 import { feature } from 'bun:bundle' 实现编译时功能门控。feature() 在构建时由 Bun 解析，通过环境变量 FEATURE_<FLAG>=1 启用。

// 使用方式 — 统一从 bun:bundle 导入
import { feature } from 'bun:bundle';

if (feature('BRIDGE_MODE')) {
  // 仅在 FEATURE_BRIDGE_MODE=1 时启用
}

// Dev 默认启用 6 个 feature:
// BUDDY, TRANSCRIPT_CLASSIFIER, BRIDGE_MODE,
// AGENT_TRIGGERS_REMOTE, CHICAGO_MCP, VOICE_MODE

// Build 默认启用 3 个 feature:
// AGENT_TRIGGERS_REMOTE, CHICAGO_MCP, VOICE_MODE

// 手动启用: FEATURE_PROACTIVE=1 bun run dev
    

88+ Feature Flags (按类别)

Agent / 自动化 (15)

基础设施 (10)

安全 / 分类 (6)

工具 / 能力 (10)

UI / 体验 (8) + 实验性 (10+)

测试 & 代码检查

# 测试命令
bun test                                      # 运行全部测试
bun test src/utils/__tests__/hash.test.ts     # 单文件
bun test --coverage                           # 覆盖率报告

# Lint & Format
bun run lint          # 检查
bun run lint:fix      # 自动修复
bun run format        # 格式化 src/
    

Computer Use (完整实现)

Computer Use 已从 Stub 恢复为完整实现，支持 macOS、Windows 和 Linux 三个平台：

Session 管理

Session 状态通过模块级单例维护（src/bootstrap/state.ts）：

// Session 级全局状态
const sessionState = {
  sessionId: crypto.randomUUID(),   // 唯一会话 ID
  cwd: process.cwd(),                // 当前工作目录
  projectRoot: findProjectRoot(),     // 项目根目录
  totalInputTokens: 0,               // 输入 token 累计
  totalOutputTokens: 0,              // 输出 token 累计
  totalCacheReadTokens: 0,           // 缓存读取 token
  totalCacheWriteTokens: 0,          // 缓存写入 token
};
    

File History 追踪

Claude Code 追踪会话期间所有文件的修改历史，用于：

• 检测意外修改 — FileEditTool 在编辑前检查文件是否被外部修改
• Git Diff 生成 — 显示修改前后的差异
• 回滚支持 — 记录文件的原始内容
• BashTool 集成 — 命令执行后检测文件变更

模块状态表

各模块的当前实现状态：

React Compiler 输出

反编译的组件代码包含 React Compiler 的自动优化产物：

// React Compiler 自动注入的 memoization
import { c as _c } from 'react/compiler-runtime';

function MyComponent(props) {
  const $ = _c(8);  // 分配 8 个缓存槽

  let t0;
  if ($[0] !== props.value) {
    t0 = expensiveComputation(props.value);
    $[0] = props.value;
    $[1] = t0;
  } else {
    t0 = $[1];  // 从缓存中取
  }

  // ... 这种模式在整个代码库中重复出现
}