AI 原生开放教材

外观

驾驭工程：从 Claude Code 源码到 AI 编码最佳实践工程手册·中文原文 ↗原件 ↓仓库 ↗

Claude Code 版本差异报告 ​

v2.1.88 → v2.1.100 ​

生成时间: 2026-04-10

概览 ​

指标v2.1.88v2.1.100变化
cli.js 大小13,047,043 bytes13,468,528 bytes+421,485 bytes (+3.2%)
Source Map有无已移除
Tengu 事件数827882+96 / -41
环境变量数178197+19 / -5
sdk-tools.d.ts基线+3 处变化新增 toolStats, auto mode, staleReadFileStateHint
新增 vendor—audio-capture (6 平台)全新二进制模块

1. Tengu 事件变化 ​

新增事件 (+96) ​

Advisor 系统（全新 — 2 个事件） ​

  • tengu_advisor_command — advisor 命令触发
  • tengu_advisor_dialog_shown — advisor 对话框展示

Dream 系统 / 记忆整合（全新 — 6 个事件） ​

  • tengu_dream_invoked — dream 手动触发
  • tengu_auto_dream_skipped — 自动 dream 跳过（条件不满足）
  • tengu_kairos_dream — 后台定时 dream 任务
  • tengu_extract_memories_skipped_no_prose — 无散文内容跳过记忆提取
  • tengu_memory_toggled — 记忆开关切换

Ultraplan（远程多代理规划 — 6 个事件） ​

  • tengu_ultraplan_config — ultraplan 配置读取
  • tengu_ultraplan_first_launch — 首次启动
  • tengu_ultraplan_keyword — 关键字触发
  • tengu_ultraplan_prompt_identifier — 提示词标识符
  • tengu_ultraplan_stopped — ultraplan 停止
  • tengu_ultraplan_timeout_seconds — 超时配置

Autofix PR（全新 — 2 个事件） ​

  • tengu_autofix_pr_started — 自动修复 PR 启动
  • tengu_autofix_pr_result — 自动修复 PR 结果

Team Onboarding（全新 — 3 个事件） ​

  • tengu_team_onboarding_invoked — 团队入门报告触发
  • tengu_team_onboarding_generated — 报告生成完成
  • tengu_team_onboarding_discovery_shown — 发现引导展示

Bedrock 云平台设置与升级（全新 — 9 个事件） ​

  • tengu_bedrock_setup_started / _complete / _cancelled — 设置向导
  • tengu_bedrock_default_check / _fallback — 默认模型检查/回退
  • tengu_bedrock_probe_result — 模型探测结果
  • tengu_bedrock_upgrade_accepted / _check / _declined / _relaunch / _save_failed — 模型升级流程

Vertex 云平台设置与升级（全新 — 9 个事件） ​

  • tengu_vertex_setup_started / _complete / _cancelled — 设置向导
  • tengu_vertex_default_check / _fallback — 默认模型检查/回退
  • tengu_vertex_probe_result — 模型探测结果
  • tengu_vertex_upgrade_accepted / _check / _declined / _relaunch / _save_failed — 模型升级流程

压缩系统增强（4 个事件） ​

  • tengu_cold_compact — 冷压缩触发
  • tengu_auto_compact_rapid_refill_breaker — 快速回填熔断器
  • tengu_autocompact_command — 手动 /compact 命令
  • tengu_autocompact_dialog_opened — 压缩确认对话框

工具系统（5 个事件） ​

  • tengu_bash_allowlist_strip_all — bash 白名单全清除
  • tengu_bash_rerun_used — bash 命令重跑
  • tengu_tool_result_dedup — 工具结果去重（重复内容引用）
  • tengu_image_resize — 图片自动缩放处理
  • tengu_file_read_reread — 文件重复读取检测

钩子系统（4 个事件） ​

  • tengu_hook_output_persisted — 钩子输出持久化
  • tengu_hook_prompt_transcript_truncated — 钩子提示词转录截断
  • tengu_stop_hook_added / _command / _removed — 停止钩子管理

代理系统（3 个事件） ​

  • tengu_forked_agent_default_turns_exceeded — 代理默认回合超限
  • tengu_mcp_subagent_prompt — MCP 子代理提示词
  • tengu_subagent_md_report_blocked — 子代理 CLAUDE.md 报告阻断

OAuth/Auth（3 个事件） ​

  • tengu_oauth_bedrock_wizard_launched — Bedrock OAuth 向导启动
  • tengu_oauth_platform_docs_opened — 平台文档打开
  • tengu_oauth_vertex_wizard_launched — Vertex OAuth 向导启动

其他功能（6 个事件） ​

  • tengu_api_retry_after_too_long — API 重试等待过长
  • tengu_ccr_session_link — CCR 会话链接
  • tengu_chain_timestamp_fallback — 链时间戳回退
  • tengu_edit_minimalanchor_jrn — 编辑最小锚点
  • tengu_message_rated — 消息评分
  • tengu_noreread_q / tengu_sub_nomdrep_q — 读取优化实验
  • tengu_powerup_lesson_completed / _opened — 学习系统
  • tengu_pre_tool_hook_deferred — 前置钩子延迟
  • tengu_rate_limit_lever_hint — 限速杠杆提示
  • tengu_rate_limit_options_menu_select_team — 限速选项菜单团队选择
  • tengu_resume_return_action — 恢复返回动作
  • tengu_status_line_result — 状态行结果
  • tengu_velvet_anchor — 实验信号

实验性代号事件（12 个） ​

  • tengu_amber_lark / _redwood / _sentinel / _swift
  • tengu_basalt_kite / tengu_billiard_aviary
  • tengu_cedar_inlet / tengu_coral_beacon
  • tengu_flint_harbor / _harbor_prompt / _heron
  • tengu_garnet_loom / _plover
  • tengu_gleaming_fair / tengu_gypsum_kite
  • tengu_onyx_basin_m / tengu_pyrite_wren
  • tengu_shale_finch / tengu_slate_finch / _reef
  • tengu_willow_prism

删除事件 (-41) ​

Bridge REPL 子系统重构（16 个事件完全移除） ​

  • tengu_bridge_repl_* 全系列（ccr_v, env_expired, env_lost, env_registered, fatal_error, history_capped, poll_error, poll_give_up, reconnect_failed, reconnected_in_place, session_failed, suspension_detected, work_received, work_secret_failed）
  • tengu_bridge_initial_history_cap
  • tengu_bridge_session_timeout

Tree-Sitter 安全子系统（3 个事件移除） ​

  • tengu_tree_sitter_load / _security_divergence / _shadow
  • tengu_bash_security_check_triggered

其他移除 ​

  • tengu_attribution_header — 归属头
  • tengu_compact_streaming_retry — 压缩流式重试
  • tengu_pid_based_version_locking — PID 版本锁
  • tengu_session_tag_* (3 个) — 会话标签
  • tengu_skill_improvement_survey — 技能改进调查
  • tengu_sm_compact — SM 压缩
  • tengu_snip_resume_filtered — 片段恢复过滤
  • tengu_tool_search_unsupported_models — 工具搜索不支持模型
  • 多个实验代号事件（cobalt_frost, copper_bridge, hawthorn_window, marble_sandcastle, quartz_lantern 等）

2. 环境变量变化 ​

新增 (+19) ​

变量推断用途
CLAUDE_CODE_AGENT_COST_STEER代理成本引导控制
CLAUDE_CODE_DISABLE_CLAUDE_API_SKILL禁用 Claude API 技能
CLAUDE_CODE_EXECPATH可执行文件路径
CLAUDE_CODE_MAX_CONTEXT_TOKENS最大上下文 token 数覆盖
CLAUDE_CODE_MCP_ALLOWLIST_ENVMCP 服务器白名单环境变量
CLAUDE_CODE_PERFORCE_MODEPerforce 版本控制支持
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE插件市场失败保留
CLAUDE_CODE_REMOTE_SETTINGS_PATH远程设置路径
CLAUDE_CODE_RESUME_THRESHOLD_MINUTES会话恢复时间阈值
CLAUDE_CODE_RESUME_TOKEN_THRESHOLD会话恢复 token 阈值
CLAUDE_CODE_SANDBOXED沙箱状态标识
CLAUDE_CODE_SCRIPT_CAPS脚本能力限制
CLAUDE_CODE_SIMULATE_PROXY_USAGE模拟代理用量
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH跳过 Anthropic AWS 认证
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK跳过快速模式组织检查
CLAUDE_CODE_SKIP_MANTLE_AUTH跳过 Mantle 认证
CLAUDE_CODE_TEAM_ONBOARDING团队入门功能
CLAUDE_CODE_USE_ANTHROPIC_AWS使用 Anthropic AWS
CLAUDE_CODE_USE_MANTLE使用 Mantle 认证后端

删除 (-5) ​

变量原用途
CLAUDE_CODE_DISABLE_COMMAND_INJECTION_CHECK命令注入检查禁用（tree-sitter 移除后无需）
CLAUDE_CODE_DISABLE_MOUSE_CLICKS鼠标点击禁用
CLAUDE_CODE_MCP_INSTR_DELTAMCP 指令差异
CLAUDE_CODE_REPLREPL 模式（bridge_repl 重构后移除）
CLAUDE_CODE_SAVE_HOOK_ADDITIONAL_CONTEXT保存钩子附加上下文

3. sdk-tools.d.ts 变化 ​

3.1 新增 toolStats 字段 ​

typescript
toolStats?: {
  readCount: number;
  searchCount: number;
  bashCount: number;
  editFileCount: number;
  linesAdded: number;
  linesRemoved: number;
  otherToolCount: number;
};

会话级工具使用统计，可用于成本估算、行为分析。

3.2 新增 "auto" 权限模式 ​

diff
- mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";
+ mode?: "acceptEdits" | "auto" | "bypassPermissions" | "default" | "dontAsk" | "plan";

Auto 模式：使用 TRANSCRIPT_CLASSIFIER 自动审批工具执行，无需用户确认。

3.3 新增 staleReadFileStateHint 字段 ​

typescript
/**
 * Model-facing note listing readFileState entries whose mtime bumped
 * during this command (set when WRITE_COMMAND_MARKERS matches)
 */
staleReadFileStateHint?: string;

工具执行期间检测文件 mtime 变化，向模型提示陈旧读取状态。

3.4 originalFile 放宽为可空 ​

diff
- originalFile: string;
+ originalFile: string | null;

4. 新增 vendor 二进制：audio-capture ​

v2.1.100 新增 vendor/audio-capture/ 目录，包含 6 个平台的原生音频捕获模块：

  • arm64-darwin, arm64-linux, arm64-win32
  • x64-darwin, x64-linux, x64-win32

文件大小 438KB-510KB 不等。暗示可能的语音输入或音频处理能力。

5. 新增 Mantle 认证后端 ​

从模型映射表中发现 mantle 作为新的认证后端：

  • 部分模型（如 claude-haiku-4-5）支持 mantle 映射
  • 通过 CLAUDE_CODE_USE_MANTLE 环境变量启用
  • 通过 CLAUDE_CODE_SKIP_MANTLE_AUTH 跳过
  • Mantle 使用 anthropic. 前缀的模型 ID（如 anthropic.claude-haiku-4-5）

6. 模型版本更新 ​

从 bundle 中提取的模型映射表显示以下新模型支持：

  • claude-sonnet-4-6 (所有平台)
  • claude-opus-4-6 (所有平台)
  • claude-opus-4-5-20251101
  • claude-opus-4-1-20250805
  • claude-sonnet-4-5-20250929

7. Bridge REPL 子系统重大重构 ​

v2.1.88 到 v2.1.100 之间，bridge_repl 子系统经历了完整重构：

  • 16 个 tengu_bridge_repl_* 事件全部移除
  • CLAUDE_CODE_REPL 环境变量移除
  • 推断：IDE 桥接从 REPL 轮询模型转向更高效的通信机制

8. 关键新功能详细分析 ​

8.1 Advisor 工具（服务端 advisor） ​

从 bundle 中提取的 advisor 工具提示词：

  • 使用更强的 reviewer 模型（如 Opus 4.6 审阅 Sonnet 4.6 的工作）
  • 无参数调用 — 自动转发整个对话历史
  • 规则："在实质性工作之前调用 advisor"、"提交前至少调用一次"
  • 如果 advisor 结果与已有数据冲突，要求"表面化冲突，而非静默切换"

8.2 Dream 系统（记忆整合） ​

v2.1.100 引入完整的 "dream" 记忆整合系统：

  • 手动触发（/dream）+ 自动触发（auto_dream）+ 后台定时（kairos_dream）
  • 两种 dream 类型：修剪（pruning pass）和反思（reflective pass）
  • 支持团队记忆（team/ 目录）与个人记忆的分离
  • 锁机制防止并发 dream 冲突
  • 可通过设置开关（autoDreamEnabled）

8.3 Tool Result Dedup（工具结果去重） ​

新增工具结果去重机制：

  • 检测重复的工具调用结果
  • 用短引用 ID（如 r1, r2）替换重复内容
  • 追踪节省的字节数（savedBytes）
  • 有效减少上下文消耗

8.4 Autofix PR（自动修复 PR） ​

全新的远程代理任务类型：

  • 生成远程 Claude Code 会话监控和自动修复 PR
  • 支持分支重用（reuseOutcomeBranch）
  • 与 ultraplan、ultrareview 并列为远程代理任务类型

8.5 Perforce 版本控制支持 ​

新增 Perforce 工作区检测和支持：

  • 通过 .p4config 文件或 P4PORT 环境变量检测
  • 添加 Perforce 模式提示词（只读文件需要 p4 edit 打开）
  • 与 git、mercurial、svn、jujutsu、sapling 并列

增量分析: v2.1.92 → v2.1.100 ​

新增事件 (+45) ​

主要新增领域：

  1. Bedrock/Vertex 完整设置与升级向导（18 个事件）— 云平台设置从手动配置转向交互式向导
  2. Dream 系统扩展（auto_dream_skipped, dream_invoked, kairos_dream）
  3. Autofix PR（2 个事件）
  4. Team Onboarding（3 个事件）
  5. Ultraplan 扩展（first_launch）
  6. 多个新实验代号

删除事件 (-21) ​

  1. Bridge REPL 完全移除（16 个事件）— v2.1.92 仍在，v2.1.100 完全清除
  2. 多个短命实验代号移除

新增环境变量 (+8) ​

  • CLAUDE_CODE_MAX_CONTEXT_TOKENS — 用户可覆盖最大上下文
  • CLAUDE_CODE_MCP_ALLOWLIST_ENV — MCP 白名单
  • CLAUDE_CODE_PERFORCE_MODE — Perforce 支持
  • CLAUDE_CODE_SANDBOXED — 沙箱标识
  • CLAUDE_CODE_TEAM_ONBOARDING — 团队入门
  • CLAUDE_CODE_USE_MANTLE / SKIP_MANTLE_AUTH — Mantle 认证

sdk-tools.d.ts 增量变化 ​

  • 新增 toolStats 统计字段（v2.1.92 没有）
  • originalFile 从 string 改为 string | null