Claude Code 2.1.29: 恢复含 saved_hook_context 的 Session 启动更快
本版本修复了恢复含 `saved_hook_context` 的 Session 时的启动性能问题,行为影响集中在这类 Session 的恢复耗时。Runtime Prompt 的唯一差异是账单头中的版本标记;Tool Schema 没有变化。官方证据未提供实现位置或代码样例,无法进一步定位修复方式。
本版本修复了恢复含 `saved_hook_context` 的 Session 时的启动性能问题,行为影响集中在这类 Session 的恢复耗时。Runtime Prompt 的唯一差异是账单头中的版本标记;Tool Schema 没有变化。官方证据未提供实现位置或代码样例,无法进一步定位修复方式。
System Prompt 中的计费头从 `cc_version=2.1.27.f85` 更新为 `cc_version=2.1.28.7a3`,入口仍标记为 `cli`;可观察影响仅限版本标识变化。Tool Schema 无增删改。Static Prompt 和官方发布、代码证据不可用,无法从本 packet 确认其他机制变化。
Runtime Prompt 在 `read` Tool Definition 中补充了用 `offset` 继续读取、直至完整文件读完的操作指引,影响 Agent 处理受截断限制文件时的后续步骤;同时,Workspace 说明明确限定长期 `MEMORY.md` 仅在主 Thread 读取,并区分内部操作与外部操作的确认边界。官方发布说明另列出媒体解析器本地路径提取限制、Subagent 消息路由及多项 Provider、平台和构建修复;这些属于发布说明层面的变化,证据未提供相应源码样本,不能据此补写实现细节。
shell_command 的 Tool Schema 为提权请求补充面向用户的审批问题,并增加可复用的命令前缀规则字段;这使审批请求能同时说明操作目的并表达未来可授权的命令模式。代码与发布说明还显示,Smart Approvals 默认启用且 MCP Tool Call 会触发显式审批,计划输出进入专用 TUI 视图,日志存储转向 SQLite。
本版在 Session 管理中加入按 GitHub PR 编号或 URL 恢复的 `--from-pr`,并使通过 `gh pr create` 创建的 PR 自动关联 Session,便于按 PR 找回工作。官方发布说明还记录了 Tool Call 失败与拒绝进入调试日志,以及 Context 管理、Windows 命令执行和 VSCode OAuth Session 等局部修复。可观察到的 Runtime Prompt 改动仅是版本标识;没有可用的 Static Prompt 对比或源码实现样本。
Gateway 移除 `none` 认证模式,默认要求 token 或 password;Tailscale Serve 身份仍可用于认证。配套改动将 loopback 上带非本地 Host 的连接视为远程连接,并在信任请求头前验证 Tailscale 身份,改变了 Gateway 的访问控制与请求信任边界。发布说明还记录了浏览器控制经 Gateway/node 路由、按 DM 账号隔离 Session,以及压缩时总结被丢弃消息等编排和 Context 改动;这些属于发布说明证据,当前 Runtime Prompt 捕获没有相邻版本基线。
官方发布说明称,Claude Code 2.1.25 修复了 Bedrock 和 Vertex 用户遇到的 beta header 校验错误,并指出设置 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` 可避免该错误。说明中没有提供实现文件或代码样例,因此无法定位修复落点;Runtime Prompt 的差异仅更新版本标识,Tool Schema 未变化。
System Prompt 将安全协助范围改为允许有授权 Context 的安全测试、CTF 与教育场景,同时明确拒绝破坏性技术、DoS、大规模攻击、供应链入侵及恶意规避检测;双用途工具需有明确授权。Skill Tool 的调用说明改为从 Session 中的 system-reminder 获取可用 Skill,并简化 Slash Command 的识别与调用规则。官方发布说明还列出异步 Hook 取消、提示缓存竞态、Agent 与 mTLS 连接、临时目录隔离及搜索超时报告等修复,涉及 Session 生命周期与运行可靠性;源码位置未在本包提供。
官方发布说明称,Claude Code 修复了非交互(`-p`)模式下的 Structured Output。该变化指向命令行非交互执行路径中的输出处理,旨在让该模式正确提供结构化结果;证据未提供具体实现位置或修复细节。相邻版本 Runtime Prompt 仅有版本标识变化,Tool Schema 没有变化;Static Prompt 对比不可用。
TaskList 的 System Prompt 增加了多任务可用时优先按 ID 从低到高处理的规则,Grep 的 Tool Schema 增加 `-C` 作为 `context` 的别名;这让任务领取顺序更可预期,并扩展了搜索 Context 参数的兼容写法。官方发布说明还记录了 Session 恢复、auto-compact 时机、任务 ID 复用及 Shell 补全缓存等修复,以及文件操作工具优先于 Bash 等改进;这些说明提供发布行为信号,但本包没有对应代码变更样本可定位实现。
API v2 Thread 可在启动时注入动态工具,并让调用与响应经过 server 和 core tool pipeline;`thread/unarchive` 则能把归档 rollout 恢复到活跃 Session。Multi-Agent 增加 explorer 角色、改进协作事件映射并设置最大深度保护,配合减少 Subagent 忙等,影响协作流程的覆盖范围与运行负载。Runtime Prompt 的 Tool Schema 新增 `web_search`(`external_web_access: false`),并修改 `view_image`;发布说明还列出 Thread 列表筛选、MCP OAuth scopes 配置及多项可靠性修复。
System Prompt 将安全协助范围收紧为防御性任务,并明确拒绝可能被恶意使用的代码及凭证发现、收集行为;这改变了 Agent 对双重用途安全请求的处理边界。TaskUpdate 的 Tool Schema 为 status 增加 `deleted`,配合任务说明和示例,使任务可以被永久移除。官方发布说明还列出 Session 压缩恢复、后台 Agent 权限提示和 Terminal 交互等修复与改进;没有提供对应源码概览,Static Prompt 比较也不可用。
0.91.0 将允许的 Subagent 数量上限减半至 6,发布说明将此调整指向资源使用与扇出护栏。它改变了 Agent 并行委派规模的配置边界,可能限制高扇出任务可同时使用的 Subagent 数量。Runtime Prompt 与 Tool Schema 的相邻比较显示无变化;证据未提供实现位置或 Static Prompt 差异。
网络访问新增带策略执行的 Sandbox Proxy,WebSocket 连接也支持 Proxy 配置,改变了出站访问与连接配置的控制方式。连接器首阶段落在 app server 与 MCP 集成;TUI 协作模式提供 Plan 到 Execute 的交接,并加入临时 Thread 和 Subagent 数量上限,影响 Agent 协作与任务生命周期。官方发布说明还记录了恢复 Session 时处理乱序事件及工作目录不同时询问用户等可靠性调整;本次 Runtime Prompt 与 Tool Schema 捕获和前一版相同,Static Prompt 比较不可用,且没有源码变更样本可供核对实现细节。
任务工具契约从按 shell 停止转为按 task 停止:新增 TaskStop,以 task_id 标识目标,并将 shell_id 标记为弃用;TaskCreate 则以 allowed_tools 列表表达授予新 Agent 的工具及必要时的用户审批。这使任务生命周期控制和工具授权更直接地围绕任务与权限集合组织;官方说明也提到可用 CLAUDE_CODE_ENABLE_TASKS=false 暂时保留旧系统。
官方发布说明称新增可自定义键盘快捷键,支持按 Context 配置按键绑定和组合键序列,并可通过 `/keybindings` 开始配置。这让用户能按使用场景调整快捷键操作;实现代码位置和具体解析、分发机制未在证据中提供。Runtime Prompt 的差异仅是版本标识更新,未观察到工具增删改;Static Prompt 比较不可用。
Codex 增加 `/permissions` 与 Skill 启停界面,让用户能分别管理审批选项和 Skill;App Server 新增 `thread/read`、归档 Thread 筛选,以及按 cwd 计算生效配置的能力,扩展了交互与客户端集成契约。发布说明还记录了路径展开边界修复、TUI 计时重置和移除 TUI2 实验等变化。Runtime Prompt 与 Tool Schema 相邻版本一致;Static Prompt 对比不可用,且本 packet 未提供源码变更样本,代码实现位置无法从现有证据定位。
本版本修复了不支持 AVX 指令的处理器上的崩溃,改善了 Claude Code 在这类硬件上的启动或运行兼容性。当前可见的 System Prompt 差异仅是计费头中的版本标识更新;官方证据未提供实现位置或代码变更细节。
任务管理从单一 TodoWrite 改为 TaskCreate、TaskGet、TaskList、TaskUpdate 四个 Tool Definition,支持任务依赖与状态跟踪;TaskCreate 的描述还涵盖把任务分配给队友,Task Tool 增加队友名称、团队、权限模式等字段,计划配置加入 launchSwarm 与 teammateCount。这使 Agent 的任务编排具备更明确的结构和 Multi-Agent 扩展入口。官方发布说明另列出 VSCode 原生 Plugin 管理、OAuth 用户浏览和恢复远程 Claude Session,以及恢复重度 Subagent Session 时的内存崩溃修复;这些发布项没有对应的源码变更样本可供定位。
System Prompt 的 Git Safety Protocol 扩大了破坏性命令的明确清单,并加入按文件暂存、提交 Hook 失败后新建提交的规则;这会让 Agent 更明确地避免误删工作或意外纳入敏感文件。官方发布说明另报告了 npm 安装弃用通知、React Compiler 渲染性能改进,以及 `/compact` 提示和 MCP stdio 子进程超时问题的修复,但没有提供对应源码位置或实现细节。
版本加入 collaboration modes,并允许在 turn 上覆盖 collaboration_mode;TUI 改为围绕协作模式提交 UserTurn,同时新增 request-user-input 交互。这让协作策略能进入单次 turn 的控制流程,并让 Agent 可在受支持的模式中向用户请求输入。发布记录还显示,/fork 改为直接 fork 当前 Session,/new 可关闭全部 Thread,headless 环境新增 device-code auth 独立回退;这些 Session 与认证行为变化见发布记录中的对应条目。
Bash 的 Tool Definition 明确改为仅保留跨命令工作目录,shell 其余状态不持久,并从用户 bash/zsh 配置初始化;这让 Agent 不能再依赖变量等 shell 状态跨命令延续。ExitPlanMode 移除了按语义申请 Bash 权限的说明,remote session 元数据补充标题字段;WebFetch 增加 GitHub URL 优先通过 gh CLI 查询的指引。官方发布说明还记录了 Plugin 固定到 Git SHA、Context 阻断阈值回归修复,以及并行 Subagent 与长 Session 内存问题修复。Runtime Prompt/Tool Schema 比较只覆盖上述 Bash、ExitPlanMode、WebFetch 变化;Static Prompt 不可用,发布说明没有附带实现代码位置。
官方发布说明记录了消息渲染 Bug 修复,但没有提供实现位置或修复机制,因此无法判断它改变了哪些代码路径或用户可见行为。Runtime Prompt 与 Tool Schema 的相邻版本比较一致;这只说明捕获到的这一层未变化。
官方发布说明称,2.1.11 修复了 HTTP/SSE 传输中 MCP 连接请求过多的问题,预期影响是减少这类传输下的多余连接请求。证据未提供代码变更概览,因此无法定位具体实现模块;Runtime Prompt 与 Tool Schema 相邻版本相同。
本版本在发布说明中加入可由 CLI 初始化和维护标志触发的 Setup Hook,为仓库设置与维护提供新的 Hook 事件入口。ExitPlanMode 的 Tool Schema 增加远程 Plan 推送状态字段,可表达是否推送以及远程 Session 的 ID 和 URL;Bash 相关 Runtime Prompt 则将默认提交策略收紧为始终创建新提交,除非用户明确要求 amend。
用户消息中的文本元素和字节范围现在经 protocol、app-server 与 core 往返传递,使 UI 注释能在历史重建后保留;协作 wait 请求可同时阻塞等待多个 ID,简化多 Thread 协调。用户 Shell 命令改为在 user snapshot 下运行,因此会应用用户的 alias 和 Shell 配置;TUI 也能展示由派生或未订阅 Thread 发出的审批请求。
官方发布说明显示,Skill 可通过 `SKILL.toml` 声明名称、描述、图标、品牌色和默认 Prompt,并向 app server 与 TUI 暴露这些元数据;同时,客户端可显式关闭 web search,并通过 header 表示资格状态。前者扩展 Skill 的描述与呈现契约,后者提供客户端与服务端 rollout 控制对齐的入口,预计影响 Skill 展示和搜索可用性控制。另有 MCP elicitation 接受时发送空 JSON、Unified exec 清理后台进程等局部可靠性修复;证据未包含对应代码样例或文件路径。
官方发布说明列出 MCP 工具搜索阈值、计划文件目录、PreToolUse Hook Context 和 Skill Session ID 等扩展;这些机制分别作用于工具发现、计划存储和执行 Context,允许 Agent 按 Context 窗口比例启用工具搜索、定制计划文件位置,并让 Hook 与 Skill 获得额外 Context 或当前 Session 标识。发布说明还记录了并行 Tool Call 长 Session、MCP 重连及特定 Terminal 挂起问题的修复。Runtime Prompt 仅将时间估计规则从计划场景扩展为所有任务预测;Tool Schema 未变化。
App-server v2 将协作 Tool Call 作为 turn stream 中的 item events 发出,客户端可在执行期间实时呈现 Agent 协作。协作工具同时支持指定 Agent role preset,并允许 `send_input` 在发送消息前中断正在运行的 Agent,扩展了协作控制方式。发布说明还涉及模型升级指引、Sandbox 回退、resume 工作目录语义和 stdin 编码处理;证据未提供对应源码样本,无法进一步定位实现模块。
Rust 协议与类型增加了文本元素元数据,使客户端能够获得更丰富的文本渲染信息,并为后续 Schema 演进留出空间。发布说明将变化落在 protocol/types,但未提供具体类型、字段或代码样例,无法进一步定位实现细节。发布说明还提到将 Rust 发布构建任务超时从 30 分钟延长至 60 分钟,以减少发布流水线波动。
Claude Code 调整了 Tools 区域 WebSearch 指引中的年份示例:查询最新资料时,示例改为搜索 2026 年并避开 2025 年,意在让最新信息检索使用当前年份。变化位于 Runtime Prompt 的搜索指引示例;证据没有显示官方发布或代码实现信息。
Codex MCP Server 的 `codex` Tool 现在在响应中返回 `threadId`,可将后续 `codex-reply` 连接到对应 Thread;Linux Sandbox 增加只读挂载路径,限制挂载文件被写入。默认 API 模型切换为 gpt-5.2-codex,Headless Session 自动使用 device-code 登录,使无浏览器环境也能完成认证。Runtime Prompt 的 `view_image` 契约改为仅在用户提供完整路径且图片未附在 Thread 中时调用;这些发布变化在本 packet 中没有对应的代码样例或文件路径。
Explore 与 Plan 的 Tool Definition 明确排除 Task、ExitPlanMode、Edit、Write、NotebookEdit,限制这两类 Subagent 直接派生任务、结束 Plan Mode 和编辑文件;MCP Tool 描述超过 Context 10% 时默认延迟加载并通过 MCPSearch 发现,以减少启动时占用。发布说明还记录了复合 shell 命令权限匹配、流式执行中的 orphaned tool_result、有效 Context window 计算等修复,涉及权限判断与执行状态处理。Runtime Prompt 只直接证明 Explore/Plan 的工具范围收窄;MCP 搜索和其他修复来自官方发布说明。
Plan Mode 的 ExitPlanMode 新增 allowedPrompts,让 Agent 随计划提交 Bash 操作的语义描述;Tool Schema 将其约束为包含 tool 与 prompt 的对象数组,获批后匹配的命令可在 Session 内免于再次弹出权限提示。这使计划审批可以同时表达实施所需的权限,但权限范围仍由用户审批,且获批权限在 Session 结束时清除。发布说明还列出 `/config` 搜索、`/doctor` 更新信息、`/stats` 日期范围、嵌套 Skill 发现和 Context 窗口状态字段等更新;现有证据没有对应源码样例,无法展开这些功能的代码实现位置。
Claude Code 2.1.5 增加 `CLAUDE_CODE_TMPDIR` 环境变量,用于覆盖内部临时文件使用的目录。此机制让部署环境可指定临时文件位置,以适配自定义临时目录要求;现有证据未提供具体代码实现位置。Runtime Prompt 与 Tool Schema 的相邻版本比较无变化。
Bash Tool 增加后台运行的使用说明:命令可在后台执行,完成后再接收通知,适用于无需立即取得结果的场景。官方发布说明同时提到新增 `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 环境变量,用于关闭后台任务功能,包括自动后台运行和 Ctrl+B 快捷键;这为后台执行提供了显式开关。另修复“Help improve Claude”设置在 OAuth Token 过期时刷新并重试的行为。
AskUserQuestion 的 Tool Schema 增加可选来源 metadata,Bash Tool Definition 扩展命令描述规则并加入内部 sed 预计算结果字段;这让提问来源可携带追踪信息,也让复杂命令描述能提供更多 Context。官方发布说明还记录了 `/clear` 后重新创建 plan 文件、修正 Subagent 压缩对话和 Web 搜索的模型选择,以及将 tool hook 超时从 60 秒延长到 10 分钟,影响 Session 清理、Subagent 和 Hook 执行行为。官方发布说明未提供对应源码样例,因而这些实现位置无法从本包进一步定位。
协议与 app server 新增 conversation/thread fork 接口,可将 Session 分支为新 Thread;同时提供 requirements 查询和 elevated sandbox 引导,使客户端能读取配置要求并引导用户调整 Sandbox 模式。显式 Skill 调用进入 v2 API 输入,指标能力扩展观测计数;另修复子进程环境变量传递,恢复依赖 GPU 等子进程的运行性能。Runtime Prompt 捕获为首次基线,Static Prompt 未提供,因此不能据此判断相邻版本变化。
Task Tool Definition 新增可选的 `max_turns` 正整数参数,用于限定 Agent 的 API 往返次数,描述特别指出该参数用于 warmup;这为 Subagent 执行增加了显式回合上限。官方发布说明还报告,大型 Bash 与 Tool 输出改为写入磁盘并通过文件引用访问,减少截断造成的信息损失;同一发布说明列出 Bash 命令注入修复、Memory 泄漏修复及其他 Terminal、Plugin 和平台调整。
Skill 和 Subagent 的 frontmatter 增加执行 Context、Agent 类型及生命周期 Hook 配置,Slash Command 与 Skill 可通过 `context: fork` 在独立 Subagent Context 中运行;运行中的 Agent、Bash 任务也统一支持 Ctrl+B 后台执行。MCP 支持 `list_changed` 动态更新 Tool、Prompt 和 Resource,settings.json 与 `--tools` 则提供更细的工具权限控制;这些机制扩展了扩展加载、任务控制和工具发现行为。Runtime Prompt 的 Tool Schema 移除了 LSP;官方发布说明称修复了无 LSP Server 时误启用 LSP Tool 的问题。