Claude Code v2.1.307 发布：新增 /claude-api 命令与安全事件遥测

Claude Code：GitHub Releases· ashwin-ant·2026-10-22 06:17· 2 小时前AI 评分33

v2.1.307

AI 导读

Claude Code v2.1.307 新增 /claude-api 命令，可将 Claude API 代码迁移至 API 版本 2026-10-21，并为每次工具调用新增 claude_code.safety_event OpenTelemetry 事件。

正文 · 原文

变更内容

• 新增 /claude-api api-version，用于将 Claude API 代码迁移至 API 版本 2026-10-21
• 为每次被权限规则、自动模式、安全检查、钩子或沙箱停止、提示或退回的工具调用新增 claude_code.safety_event OpenTelemetry 事件
• 修复了在设置了 CLAUDE_CODE_DISABLE_1M_CONTEXT 且模型是带 [1m] 后缀的别名（例如 opus[1m]）时，请求因模型未找到错误而失败的问题
• 修复了 prompt-caching-scope beta 标头被发送到自定义 ANTHROPIC_BASE_URL 网关之后以及在 Foundry 上（在这些环境中它不起作用）的问题
• 修复了 macOS 上登录钥匙串被锁定时，MCP 服务器在 claude -p 中显示“需要身份验证”的问题；现在它们会说明原因，并且解锁后的下一次运行无需重新登录即可连接
• 修复了 macOS 或 Linux 计算机在 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 用量和空停止原因的问题
• 修复了当 API 确认模型耗时超过 5 秒时，通过 Agent SDK 的 setModel() 以及基于它构建的应用进行的模型切换被拒绝的问题；Claude Code 现在最多等待 15 秒
• 修复了通过已连接应用（例如桌面应用归档空闲会话）停止的后台命令被报告给 Claude 为用户停止的问题；现在通知会指明其输出文件
• 修复了 Cowork 云会话中的 WebFetch 在站点以 4xx 状态或 robots.txt 拒绝响应时报告工具错误的问题；现在与本地会话一样，它是一个正常结果
• 修复了直接配置的 GitHub MCP 服务器上的写入工具在桌面应用的 Code 标签页中显示一个表单，但关闭后未创建任何内容的问题
• 修复了服务器关闭了复用的连接时，Artifact 工具读取因连接重置而失败的问题
• 自托管运行器：修复了带有 --use-anthropic-git-proxy 的会话提交了先前会话遗留在克隆中的 .claude/settings.local.json 的问题
• 自托管运行器：修复了在检出钩子期间归档或重新排队会话，或停止运行器，导致钩子的进程仍在运行且运行器的槽位被占用的问题
• 改进了对无法解析的工具调用的恢复：Claude Code 现在最多重试该调用两次，然后以错误结束该轮次
• 改进后的 fork 子代理同时启动：现在每个子代理都会被告知哪次启动是它自己的，因此 fork 之间尝试启动彼此工作的可能性大大降低
• 改进浏览器登录：登录完成后成功页面立即显示，无需等待账户资料加载
• 改进云端和自托管 runner 会话中的网络搜索错误：因 403 被拒绝并给出原因的搜索现在会显示该原因，而不是通用的“Authentication error”
• 改进云端会话中当桌面应用的某个 MCP 服务器无法连接时首次回复的等待时间
• 改进会话记录中包含大型粘贴图片或 PDF 读取内容时的 Remote Control 连接时间
• 更改 WebSearch 预算用尽时 Claude 收到的提示，同时告知它不要通过浏览器或 computer use 查询搜索引擎
• 更改设置 env 块中的 axScreenReader 设置和 CLAUDE_AX_SCREEN_READER，使其仅从用户、托管或 --settings 设置中生效（自 2.1.305 起）
• 自托管 runner：更改 checkout 钩子默认在 30 分钟后停止，并使会话的设置失败；如果你的钩子需要更长时间，请调高 --checkout-hook-timeout-min 或将其设为 0
• 自托管 runner：更改了为 Anthropic 管理的 git 构建的证书文件，使其像 CLI 一样过滤受信任证书；一行 [runner:warn] 会给出被排除的数量
• [VSCode] 在语音听写自行停止时（15 秒未识别到语音，或达到 2 分钟上限），麦克风按钮上新增提示，说明原因并告知已保留此前的文本
• [VSCode] 修复了用 Show more 展开的长提示覆盖整个聊天面板的问题：固定后的提示现在最多占面板的 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 文件
• [Cloud sessions] 修复了搜索仍在进行时仓库选择器显示“No repositories match”的问题；现在它会显示“Searching…”直到结果返回
• [Cloud sessions] 修复了自托管环境中“Waiting for a runner”状态被截断的问题；使用按需 runner 时，它现在会从你的最后一条消息开始计时，并显示失败的尝试
• [Code Review] 在 Code Review 中新增 @claude review stop（以及 off 和 pause），可在不启动新审查的情况下结束拉取请求上的 @claude review always 订阅

来源：Claude Code：GitHub Releases · github.com