claude-code/docs/jira/UPSTREAM-V2_1_089-V2_1_123-DIFF.md

上游 v2.1.089 → v2.1.123 差异分析

调研日期：2026-04-29 数据源：

• GitHub anthropics/claude-code CHANGELOG.md（WebFetch，主要数据源，覆盖 2.1.97 → 2.1.123）
• 全局二进制 C:\Users\12180\.local\bin\claude.exe（v2.1.123，253MB Bun native binary，编译时间 2026-04-29）字符串反向查阅（telemetry 事件 / FEATURE flag / API endpoint / 注册命令名）
• Fork 自身版本：package.json claude-code-best@1.10.10

注意：v2.1.89 的 changelog 条目在 GitHub 主仓库 CHANGELOG.md 中已被裁剪（Anthropic 滚动保留近 30 个版本），fetch 到该位置返回 truncation 提示。本报告 v2.1.89~v2.1.96 的内容 inferred from binary 字符串和 v2.1.97 的"Fixed"项倒推（标注 [binary-only]）。

---

摘要

• 版本号跨度：v2.1.089 → v2.1.123，共 35 个 patch 版本（实际发布 ≈ 25 个，部分编号跳过：100/102/103/104/106/115）
• 核心新增方向：
  1. Auto Mode（自治执行）从实验性走向正式：v2.1.111 起不再要求 --enable-auto-mode，v2.1.118 加 "Don't ask again"，v2.1.117 起 Pro/Max 默认 effort=high
  2. Ultraplan / Ultrareview / Advisor（新一代深度推理工作流）：v2.1.108~v2.1.120 持续完善，v2.1.120 加 claude ultrareview <target> headless 子命令
  3. TUI/Fullscreen 重构：v2.1.110 加 /tui 命令切换 flicker-free 渲染，v2.1.116 优化滚动，v2.1.121 滚动对话框可键盘+鼠标导航
  4. Native binary 分发：v2.1.113 起 CLI spawn native binary 代替 bundled JS（per-platform optional dep）
  5. Voice Mode / Push Notifications：v2.1.110 push 通知工具，v2.1.122 Caps Lock 报错提示
  6. Skills 体系强化：v2.1.108 起 model 可发现/调用内置 slash 命令；v2.1.117 listing cap 250→1536；v2.1.121 加 type-to-filter；v2.1.120 支持 ${CLAUDE_EFFORT} 模板
  7. MCP / OAuth 大量修复：每版数十条
  8. Plugin 体系：v2.1.117~v2.1.121 依赖解析、版本约束、plugin tag、plugin prune、alwaysLoad 配置
• 新增/移除命令：见下方矩阵（净新增 ≥ 7 个：/tui、/focus、/recap、/undo(alias)、/proactive(alias)、/ultrareview、/team-onboarding、/less-permission-prompts、/usage(合并 /cost+/stats）；移除 0 个，但 /cost /stats 已合并）
• 新增 API endpoint（v123 binary 反向查阅）：/v1/agents、/v1/skills、/v1/code/triggers、/v1/code/sessions、/v1/code/upstreamproxy/ws、/v1/environments/bridge、/v1/memory_stores、/v1/security/advisories/bulk、/v1/ultrareview/preflight、/v1/vaults、/v2/ccr-sessions/
• 新增 telemetry 事件：v123 binary 共 1081 个 tengu_* 事件（包含 tengu_advisor_* 6、tengu_ultraplan_* 13、tengu_kairos_* 9、tengu_amber_* 10、tengu_teleport_* 17、tengu_ccr_* 5、tengu_brief_* 3、tengu_powerup_* 2、tengu_skill_* 4 等成簇出现）
• 新增 feature flag：v123 binary FEATURE_* 字符串多为 Bun runtime 内置（FEATURE_FLAG_DISABLE_*），Anthropic 业务 feature flag 在 v2.1.x 已切换到运行时配置/环境变量（CLAUDE_CODE_*），不再使用 FEATURE_<NAME> 命名空间——这一点与 fork 当前的 bun:bundle feature() 模式存在分歧

---

详细变更

新增命令

命令	何时引入	描述	fork 是否已有
/tui	2.1.110	切换 fullscreen / inline 渲染（/tui fullscreen 进入 flicker-free 模式，可在同一对话中切换）。设置项 tui	❌ 无
/focus	2.1.110	单独的 focus view 切换（之前与 Ctrl+O 复用），仅显示 prompt+工具摘要+最终响应	❌ 无
/recap	2.1.108	返回 session 时提供上下文回顾，可在 /config 配置或手动调用，CLAUDE_CODE_ENABLE_AWAY_SUMMARY 可强制启用	❌ 无
/undo（alias /rewind）	2.1.108	rewind 别名	⚠️ 需确认 /rewind 实现
/proactive（alias /loop）	2.1.105	/loop 别名	⚠️ 需确认 /loop 实现
/ultrareview	2.1.111	云端并行多 agent 代码审查；无参审查当前分支，/ultrareview <PR#> 拉 GitHub PR 审查；v2.1.120 加 claude ultrareview headless	❌ 无（cloud-only，需 /v1/ultrareview/preflight endpoint）
/team-onboarding	2.1.101	从本地 Claude Code 使用情况生成 teammate ramp-up guide	❌ 无
/less-permission-prompts	2.1.111	扫描历史 transcript，提议 .claude/settings.json 的优先级 allowlist	❌ 无
/usage	2.1.118	合并 /cost + /stats，两者保留为别名	⚠️ 需确认 fork 状态
/effort（无参 slider 模式）	2.1.111	无参时打开交互 slider，xhigh 介于 high 和 max 之间（仅 Opus 4.7）	⚠️ fork 有 /effort 但 slider/xhigh 未确认
/branch	≤2.1.116	从当前 session 分叉新对话（v2.1.116/v2.1.122 持续修 fix）	⚠️ 需确认 fork 状态
/fork	≤2.1.118	类似 branch（与 branch 关系待查）	⚠️ 需确认
/extra-usage	2.1.113	远程客户端可调用的额外用量信息	❌ 无
/insights	2.1.101 / 2.1.113	报告生成（v2.1.113 fixed Windows EBUSY）	❌ 无
/loops（注：复数，与 /loop 不同）	binary v123	命令名在二进制中独立出现	⚠️ 需对比
/powerup	binary v123	tengu_powerup_lesson_* 教学/onboarding	❌ 无
/stickers	binary v123	description 残留	❌ 无
/btw	binary v123 / 2.1.101 fix	"by the way" 类回顾命令；2.1.101 fix /btw 不再每次写整段对话到磁盘	❌ 无
/teleport（含 tp alias）+ --print 模式	2.1.108~2.1.121 持续增强	session resume from claude.ai；17 个 tengu_teleport_* 事件覆盖 first_message/source_decision/print/bundle_mode/interactive_mode 等分支	✅ fork 已恢复（src/utils/teleport.tsx + 第二批 stub recovery），但 --print 模式和 17 事件全覆盖待对比
/setup-bedrock	2.1.111 改进	显示 CLAUDE_CONFIG_DIR 实际路径，re-run 时 seed pin 候选，加 "with 1M context" 选项	⚠️ 需确认 fork 状态
/setup-vertex	2.1.98 加交互式 wizard	login 屏选 "3rd-party platform" 时 Vertex AI 配置向导	⚠️ 需确认
/team 系列（tengu_team_mem_*, tengu_team_artifact_*, tengu_team_onboarding_*, tengu_teammate_*）	2.1.101+	团队记忆同步 / artifact tip / onboarding 发现	❌ 无（v2.1.101 binary 字符串确认）
/heapdump、/sharp、/pyright	binary v123	诊断/类型工具命令	❌ 无
/keybindings /keybindings-help	2.1.101	加载 ~/.claude/keybindings.json 自定义按键	⚠️ 需确认

移除/合并命令

命令	何时变更	处置
/cost /stats	2.1.118	合并为 /usage，二者保留为快捷别名打开对应 tab
/cost 直返 plain-text（VSCode）	2.1.120	VSCode 改为打开原生 Account & Usage dialog
Glob / Grep 工具（macOS/Linux native build）	2.1.117	替换为 Bash 内嵌 bfs + ugrep（Windows 与 npm 版不变）

新增 endpoint（binary v123 反向查阅）

Endpoint	推测用途	fork 是否已有调用
/v1/agents、/v1/agents/	Agents Platform（订阅可用，已确认）	✅ 已恢复（agents-platform.tsx）
/v1/skills、/v1/skills/	Skills 上传/同步	❌ 无
/v1/code/triggers、/v1/code/triggers/	Trigger（schedule cron-style 后端）	⚠️ fork 有 cron.ts 本地实现，未确认远端
/v1/code/sessions、/v1/code/sessions/	Session list（teleportFromSessionsAPI 用）	✅ teleport 用到
/v1/code/github/import-token	GitHub App 安装 token 导入	❌ 无
/v1/code/slack/	Slack App 集成	❌ 无
/v1/code/upstreamproxy/ca-cert、/v1/code/upstreamproxy/ws	上游代理 WS 隧道（企业代理/CCR）	❌ 无
/v1/environments、/v1/environments/、/v1/environments/bridge、/v1/environment_providers/cloud/create	Cloud environment / Bridge（环境 provisioning，BYOC runner 关联）	⚠️ fork 有 BYOC runner 入口，远端未对接
/v1/memory_stores、/v1/memory_stores/	共享记忆存储（团队记忆）	❌ 无
/v1/security/advisories/bulk	安全公告批量	❌ 无
/v1/ultrareview/preflight	Ultrareview 预检	❌ 无
/v1/vaults、/v1/vaults/	凭据保险库	❌ 无
/v1/session_ingress/session/、/v2/session_ingress/shttp/mcp/	Session ingress（远端 session 接入）	❌ 无
/v2/ccr-sessions/	CCR session（Cloud Code Runner / cross-region）	❌ 无
/v1/feedback	反馈提交	✅ fork 已恢复 /feedback
/v1/toolbox/shttp/mcp/	MCP toolbox 转发	❌ 无

新增 telemetry 事件（v123 binary 簇）

簇	事件数	代表事件	fork 状态
tengu_teleport_*	17	_started、_resume_session、_first_message_success、_source_decision、_bundle_mode、_interactive_mode、_print	✅ fork 第二批 stub recovery 已发 17 事件覆盖
tengu_ultraplan_*	13	_launched、_dialog_choice、_plan_ready、_approved、_failed、_awaiting_input、_first_launch、_keyword、_prompt_identifier、_timeout_seconds	❌ fork 无
tengu_kairos_*	9	_brief、_cron、_cron_durable、_dream、_input_needed_push、_loop_dynamic、_loop_prompt、_push_notifications、_brief_config	❌ fork 无
tengu_amber_*	10	_anchor、_flint、_lark、_lynx、_prism、_redwood、_sentinel、_stoat、_wren、_json_tools	❓ 内部代号（动物名），可能是新一代 agent 工具集
tengu_advisor_*	6	_command、_dialog_shown、_strip_retry、_tool_call、_tool_interrupted、_tool_token_usage	❌ fork 无（v2.1.117 加 experimental 标签）
tengu_ccr_*	5	_bridge、_bundle_max_bytes、_bundle_seed_enabled、_bundle_upload、_session_link、_unsupported_default_mode_ignored	❌ fork 无
tengu_powerup_*	2	_lesson_completed、_lesson_opened	❌ fork 无
tengu_brief_*	3	_mode_enabled、_mode_toggled、_send	❌ fork 无
tengu_skill_*	4	_loaded、_file_changed、_tool_invocation、_tool_slash_prefix	⚠️ fork 有 SkillTool 但事件覆盖未确认
tengu_extract_memories_*	5	_extraction、_coalesced、_skipped_*、_error	✅ fork 有 EXTRACT_MEMORIES feature flag
tengu_team_*	14	_artifact_tip_shown、_created、_deleted、_mem_*（accessed/edits/sync_pull/sync_push/secret_skipped/entries_capped/file_*）、_onboarding_*、_memdir_disabled、_teammate_default_model_changed、_teammate_mode_changed	❌ fork 无

新增 feature flag

v123 binary 中 FEATURE_* 字符串全部为 Bun runtime 内部 flag（FEATURE_FLAG_DISABLE_DNS_CACHE、FEATURE_FLAG_EXPERIMENTAL_BAKE、FEATURE_NOT_SUPPORTED 等），业务 feature 已迁移到环境变量+设置项命名空间：

新增的业务开关（按 changelog 统计）：

名称	引入版本	作用
CLAUDE_CODE_ENABLE_AWAY_SUMMARY	2.1.108	强制启用 recap（telemetry 关闭时）
CLAUDE_CODE_FORK_SUBAGENT	2.1.117 / 2.1.121	外部 build 启用 forked subagent，2.1.121 起在非交互 session 也生效
CLAUDE_CODE_USE_POWERSHELL_TOOL	2.1.111	Win/Linux/macOS 启用 PowerShell tool
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS	2.1.123	关闭实验 beta（v123 唯一 fix 围绕该项的 OAuth 401 循环）
CLAUDE_CODE_HIDE_CWD	2.1.119	启动 logo 隐藏 CWD
CLAUDE_CODE_CERT_STORE	2.1.101	bundled 仅用 bundled CA
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB	2.1.98	Linux PID namespace 子进程隔离
CLAUDE_CODE_SCRIPT_CAPS	2.1.98	每 session script 调用上限
CLAUDE_CODE_PERFORCE_MODE	2.1.98	Edit/Write 在只读文件上失败并提示 p4 edit
ENABLE_PROMPT_CACHING_1H	2.1.108	1 小时 prompt cache TTL
FORCE_PROMPT_CACHING_5M	2.1.108	强制 5 分钟 TTL
OTEL_LOG_RAW_API_BODIES	2.1.111	完整 API 请求/响应作为 OTEL 日志
OTEL_LOG_USER_PROMPTS OTEL_LOG_TOOL_DETAILS OTEL_LOG_TOOL_CONTENT	2.1.101+	OTEL 敏感字段 opt-in
ANTHROPIC_BEDROCK_SERVICE_TIER	2.1.122	Bedrock service tier 选择
DISABLE_UPDATES	2.1.118	严格于 DISABLE_AUTOUPDATER，连手动 claude update 也阻断
wslInheritsWindowsSettings	2.1.118	WSL 继承 Windows managed settings

配置项

Key	引入	说明
tui	2.1.110	fullscreen / inline 切换
autoScrollEnabled	2.1.110	fullscreen 自动滚动开关
prUrlTemplate	2.1.119	footer PR badge 自定义 URL
sandbox.network.deniedDomains	2.1.113	黑名单覆盖 allowedDomains 通配
MCP server.alwaysLoad	2.1.121	跳过 ToolSearch 延迟，永远可用
autoMode.allow / soft_deny / environment 中的 "$defaults"	2.1.118	在内置 list 之上叠加，不替换
spinnerTipsOverride.excludeDefault	2.1.122	抑制 time-based spinner tips

---

与 fork 差异

Fork 应该跟进的

P0（订阅用户能直接受益、本地能力可实现，且与 fork 已恢复的方向一致）：

1. /usage 合并（v2.1.118）—— 把 fork 现有 /cost+/stats 合并为 /usage，保留 alias。零远端依赖，纯 UI 重构。
2. /recap + CLAUDE_CODE_ENABLE_AWAY_SUMMARY（v2.1.108）—— 返回 session 时给摘要。fork 有 AWAY_SUMMARY feature flag 但未实现命令。
3. /tui 命令 + flicker-free 渲染（v2.1.110）—— 当前 fork 用 Ink，且 fork CLAUDE.md 里设计原则强调"考究"。flicker-free 切换是 high-impact UX 改进。
4. /focus 单独命令（v2.1.110）—— Ctrl+O 解耦 verbose 和 focus 两个职责。代码量小、收益清晰。
5. /effort 无参 slider + xhigh 等级（v2.1.111）—— fork 已有 /effort，加 slider 是 UI 升级。

P1（需要后端但用户已订阅，对接到 /v1/agents 模式可行）：

1. /team-onboarding（v2.1.101）—— 从本地 JSONL 生成 ramp-up guide，零远端依赖。
2. /less-permission-prompts（v2.1.111）—— 扫 transcript 推 allowlist，纯本地逻辑。
3. /branch 增强（v2.1.116/v2.1.122）—— fork 需先确认 /branch 现状。
4. /extra-usage（v2.1.113）—— 远程查询用量。

P2（依赖云端 endpoint，订阅可达但工程量大）：

1. /ultrareview（v2.1.111+）—— 需 /v1/ultrareview/preflight 后端，订阅应可达。
2. Auto Mode 不再要求 --enable-auto-mode（v2.1.111）—— fork 需对齐入口。
3. MCP alwaysLoad、auto-retry 3 次（v2.1.121）。
4. Plugin 体系（plugin tag、plugin prune、依赖解析）（v2.1.117~v2.1.121）。

Fork 不需要跟进的

1. tengu_amber_* 系列（10 个）—— 内部代号（动物名），strong indicator 是 Anthropic 内部 dogfood agent / 实验工具集，订阅版本不会暴露给最终用户。
2. Vertex/Bedrock 边角 fix（如 application inference profile ARN、thinking.type.enabled is not supported）—— fork 用户主要通过 firstParty / OpenAI / Gemini / Grok provider，这些 fix 不影响。
3. tengu_ccr_*（CCR session bundle）—— 内部 cross-region session 链路，fork 无对应基础设施。
4. Native binary 分发改造（v2.1.113）—— fork 已用 Bun build，无必要切到 per-platform optional dep。
5. tengu_ultraplan_* 直接对齐—— fork CLAUDE.md 里 ULTRAPLAN 是 P1 feature flag，但 13 个事件覆盖（dialog/keyword/identifier/timeout/awaiting_input）是云后端流水线，本地实现性价比低。
6. Stickers / heapdump / sharp / pyright 命令—— 内部诊断/营销，无业务价值。
7. /install-github-app /install-slack-app—— 依赖 Anthropic 后端 OAuth callback。

---

推荐 fork 接下来做的事

P0（一周内）

1. 合并 /cost + /stats 为 /usage（保留 alias）—— 与上游 v2.1.118 对齐，纯 UI 改造，~150 行
2. 实现 /recap 命令 + 启用现有 AWAY_SUMMARY feature flag—— fork 已有 flag，缺命令实现
3. 新增 /tui 命令—— Ink fullscreen 切换，fork 已有 fullscreen 渲染基础

P1（两周内）

1. /effort 无参 slider + xhigh 等级—— fork 已有 /effort，UI 增强
2. /focus 单独命令（拆分 Ctrl+O）
3. /team-onboarding + /less-permission-prompts（纯本地 transcript 扫描，与 fork 已恢复的 /perf-issue /debug-tool-call 思路一致）
4. /branch /fork 现状审查 + 对齐到 v2.1.122 fix（rewound timeline tool_use_id 配对）

P2（长期）

1. MCP alwaysLoad + 自动重连 3 次（v2.1.121）—— 配置项扩展
2. Auto Mode 默认开启路径对齐（v2.1.111）+ "Don't ask again"（v2.1.118）
3. Plugin 依赖解析增强（v2.1.117~v2.1.121 的所有 plugin fix）
4. Skills ${CLAUDE_EFFORT} 模板替换（v2.1.120）+ 描述上限 1536 字符（v2.1.105）

---

调研方法回顾

方法	是否 work	备注
WebFetch GitHub CHANGELOG.md	✅ work	最佳数据源。覆盖 v2.1.97v2.1.123 完整条目；v2.1.89v2.1.96 已被 Anthropic 滚动裁剪，需通过 binary 字符串补
Binary string grep tengu_* 事件	✅ work	1081 事件覆盖所有 feature surface；簇分析（_advisor_*、_kairos_*、_ultraplan_*）能识别新功能
Binary name:"...",description 命令名	✅ work	133 个命令名，与 fork commands.ts 直接对比
Binary /v[0-9]+/... endpoint	✅ work	65 个 endpoint，识别新后端 surface
Binary FEATURE_* 字符串	⚠️ 部分 work	Anthropic 业务 flag 已迁出 FEATURE_<NAME> 命名空间，binary 命中的全是 Bun runtime；业务 flag 走 CLAUDE_CODE_* env 与 settings key
WebFetch npm changelog	未尝试	优先级低于 GitHub CHANGELOG，因主仓库一般同步
WebFetch changelog.anthropic.com	未尝试	同上

关键限制：v2.1.89~v2.1.96 的具体条目无公开来源，本报告对该段是"通过 v2.1.97 fix 列表反推 + binary 字符串"两层间接推断，置信度低于 v2.1.97+。如需精确，可：

1. 查 npm view @anthropic-ai/claude-code@2.1.89 获取发布元数据
2. git log Anthropic 公开 SDK / docs 仓库相关提交
3. 反向查阅更早版本的 binary（用户机器无 v2.1.89 二进制）