Claude Code v2.1.307 发布

## 变更内容

- 新增 `/claude-api api-version`，用于将 Claude API 代码迁移到 API 版本 `2026-10-21` - 新增 `claude_code.safety_event` OpenTelemetry 事件，在每次工具调用被权限规则、自动模式、安全检查、hook 或沙箱停止、提示或退回时触发 - 修复了在设置了 `CLAUDE_CODE_DISABLE_1M_CONTEXT` 且模型是带 `[1m]` 后缀的别名（例如 `opus[1m]`）时，请求因 model-not-found 错误而失败的问题 - 修复了 `prompt-caching-scope` beta 头在自定义 `ANTHROPIC_BASE_URL` 网关之后以及在 Foundry 上被发送的问题，在这些环境中该头没有效果 - 修复了 macOS 上登录钥匙串被锁定时，`claude -p` 中 MCP 服务器显示“需要认证”的问题；现在它们会说明原因，并且解锁后的下一次运行无需重新登录即可连接 - 修复了 macOS 或 Linux 计算机在 MCP 服务器连接期间进入睡眠时，MCP 服务器被报告为超时并在无头运行中持续处于失败状态的问题 - 修复了连接在调用中途关闭时 HTTP MCP 工具调用被发送两次的问题；现在仅重试只读或幂等的工具 - 修复了后台任务运行时，某一轮次有时在没有 SDK MCP 服务器最新工具的情况下启动的问题 - 修复了读取大量 PDF 页面、图像或其他大型工具结果的轮次中出现的部分“Autocompact is thrashing”错误 - 修复了云会话中 `/autocompact` 在会话重启后恢复为默认窗口的问题 - 修复了使用 `/clear` 清除的对话在云或自托管运行器会话重启后有时会恢复的问题 - 修复了 Claude 应用网关会话中 `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` 被忽略的问题 - 修复了设置了 `OTEL_EXPORTER_OTLP_HEADERS` 时，Claude 应用网关之后的 Claude Desktop 会话遥测被拒绝的问题 - 修复了 `/permissions` > 最近拒绝未显示被拒绝的 shell 命令， 以及自动模式的本地分类器在检查重试命令时忽略来自该处的批准的问题；现在批准某一行会显示命令名称，而不是其描述 - 修复了 `/help` 和 `/` 命令菜单对捆绑技能（例如 `/claude-api`）显示面向模型的长描述而不是其简短描述的问题 - 修复了子代理记录为流式响应记录占位符 token 用量和空停止原因的问题 - 修复了通过 Agent SDK 的 `setModel()` 以及基于它构建的应用进行模型切换时，在 API 确认模型耗时超过 5 秒的情况下被拒绝的问题；Claude Code 现在最多等待 15 秒 - 修复了通过已连接应用（例如桌面应用归档空闲会话）停止的后台命令被报告给 Claude 为用户停止的问题；现在通知会指明其输出文件 - 修复了 Cowork 云会话中的 WebFetch 在站点以 4xx 状态或 robots.txt 拒绝作答时报告工具错误的问题；现在与本地会话一样，它是一个正常结果 - 修复了直接配置的 GitHub MCP 服务器上的写入工具在桌面应用的 Code 标签页中显示一个表单，但关闭后未创建任何内容的问题 - 修复了服务器关闭了复用的连接时，Artifact 工具读取因连接重置而失败的问题 - 自托管运行器：修复了使用 `--use-anthropic-git-proxy` 的会话提交了先前会话遗留在克隆中的 `.claude/settings.local.json` 的问题 - 自托管运行器：修复了在检出 hook 期间归档或重新排队会话，或停止运行器时，导致 hook 的进程继续运行并占用运行器槽位的问题 - 改进了对无法解析的工具调用的恢复：Claude Code 现在最多重试该调用两次，然后以错误结束该轮次 - 改进了同时启动的 fork 子代理：现在每个子代理都会被告知哪次启动是它自己的， 因此 fork 尝试启动彼此工作的可能性大大降低 - 改进了浏览器登录：成功页面现在会在登录完成后立即显示，无需等待账户资料加载 - 改进了云和自托管运行器会话中的网络搜索错误：因 403 被拒绝并给出原因的搜索现在会显示该原因，而不是通用的“Authentication error” - 改进了当桌面应用的一个 MCP 服务器无法连接时云会话中首次回复的时间 - 改进了转录包含大型粘贴图像或 PDF 读取内容的会话的 Remote Control 连接时间 - 更改了 WebSearch 预算用尽时 Claude 收到的通知，现在还会告知它不要在浏览器中或通过计算机使用查询搜索引擎 - 更改了设置 `env` 块中的 `axScreenReader` 设置和 `CLAUDE_AX_SCREEN_READER`，使其仅从用户、托管或 `--settings` 设置中生效（自 2.1.305 起） - 自托管运行器：更改了检出 hook 默认在 30 分钟后停止，并使会话的设置失败；如果你的 hook 需要更长时间，请提高 `--checkout-hook-timeout-min` 或将其设为 `0` - 自托管运行器：更改了为 Anthropic 管理的 git 构建的证书文件，使其像 CLI 一样过滤受信任的证书；一行 `[runner:warn]` 会给出被排除的数量 - [VSCode] 在语音听写自行停止时（15 秒未识别到语音，或达到 2 分钟限制），在麦克风按钮上新增了通知， 说明原因，并保留目前已有的文本 - [VSCode] 修复了长提示词在展开“显示更多”后会覆盖整个聊天面板的问题：现在固定提示词的高度上限为面板的 40%，并支持滚动 - [VSCode] 修复了在富文本编辑器中粘贴包含 LaTeX 数学公式的列表项或表格单元格时，部分内容被粘贴为新的列表或表格的问题 - [VSCode] 修复了当 `NODE_EXTRA_CA_CERTS` 仅在 `~/.claude/settings.json` 中设置时，语音听写在 TLS 检查代理后失败的问题；现在它也会遵循 `CLAUDE_CODE_CERT_STORE` - [VSCode] 更改了“仍在其他地方打开”的提示，使其也涵盖扩展重启后遗留的 Claude 进程，该进程通常会在约 10 分钟内自行结束 - [VSCode] 更改了语音听写，使其像 CLI 一样过滤受信任的证书 - [VSCode] 更改了扩展自身的请求，使其像 CLI 一样过滤受信任的证书，并信任在环境变量或用户设置中指定的 `NODE_EXTRA_CA_CERTS` 文件 - [云会话] 修复了搜索仍在进行时仓库选择器显示“没有匹配的仓库”的问题；现在它会显示“正在搜索…”直到结果返回 - [云会话] 修复了自托管环境中“等待运行器”状态被截断的问题；对于按需运行器，现在它会从你最后一条消息开始计时，并显示失败的尝试 - [代码审查] 为代码审查新增了 `@claude review stop`（以及 `off` 和 `pause`），可在拉取请求上结束 `@claude review always` 订阅，而不会启动新的审查