变更内容

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