Claude Code v2.1.307发布：新增API版本迁移命令与安全事件遥测
该版本加入 /claude-api api-version命令，可将Claude API代码迁移至 2026-10-21 版本；同时为每次被权限规则、自动模式、安全检查、钩子或沙箱阻止、提示或退回的工具调用新增claude_code.safety_event OpenTelemetry事件。
AI解读：修复项覆盖多处具体场景：设置CLAUDE_CODE_DISABLE_1M_CONTEXT且模型为带 [1m] 后缀的别名（如opus[1m]）时出现model-not-found；自定义ANTHROPIC_BASE_URL网关与Foundry上无效的prompt-caching-scope beta头被发送；macOS钥匙串锁定时claude -p中MCP服务器误报需要认证。
MCP与网络相关修复包括：macOS/Linux休眠期间MCP连接被误报超时并在无头运行中保持失败；HTTP MCP工具调用在连接中途关闭时被发送两次，现在仅对只读或幂等工具重试；以及Artifact工具读取在复用连接被服务端关闭时出现连接重置。
会话与云环境修复包括：读取大量PDF页面、图像等大结果时的Autocompact is thrashing错误；云会话重启后 /autocompact回到默认窗口；/clear清除的对话在云或自托管运行器会话重启后重新出现。
自托管运行器修复了使用 --use-anthropic-git-proxy时会提交前一会话遗留的 .claude/settings.local.json，以及签出钩子期间归档、重新排队或停止运行器导致钩子进程残留并占用槽位。签出钩子现在默认 30 分钟后停止并判定会话设置失败，可通过 --checkout-hook-timeout-min调高或设为 0 关闭。
其他改动涉及：无法解析的工具调用最多重试两次；并行启动的fork子代理被告知各自所属启动；浏览器登录成功页不再等待账户资料加载；云与自托管会话中带原因的 403 搜索拒绝会显示该原因；VSCode扩展的语音听写、提示折叠与证书过滤；Code Review新增 @claude review stop（以及off、pause）以结束拉取请求上的 @claude review always订阅。
Claude Code发布v2.1.307。版本说明由发布者ashwin-ant在GitHub Releases页面列出，新增 /claude-api api-version命令，用于将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事件。
请求与MCP相关修复
修复了在设置CLAUDE_CODE_DISABLE_1M_CONTEXT且模型为带 [1m] 后缀的别名（如opus[1m]）时，请求以model-not-found失败的问题。
修复了自定义ANTHROPIC_BASE_URL网关与Foundry上仍发送prompt-caching-scope beta头的问题，该头在这些环境中没有效果。
修复了macOS上登录钥匙串锁定时，claude -p中MCP服务器显示“needs authentication”的问题；现在会说明原因，解锁后的下一次运行无需重新登录即可连接。
修复了macOS或Linux电脑在MCP连接过程中休眠时，MCP服务器被报告为超时并在无头运行中保持失败的问题。
修复了HTTP MCP工具调用在连接中途关闭时被发送两次的问题；现在只对只读或幂等工具重试。
修复了后台任务运行时，某一轮次有时在没有SDK MCP服务器最新工具的情况下开始的问题。
会话、云与自托管运行器
修复了读取大量PDF页面、图像或其他大型工具结果时出现的一些“Autocompact is thrashing”错误；云会话重启后 /autocompact回到默认窗口的问题也已修复。
修复了用 /clear清除的对话在云或自托管运行器会话重启后有时重新出现的问题。
自托管运行器方面，修复了使用 --use-anthropic-git-proxy的会话提交前一会话遗留在克隆中的 .claude/settings.local.json的问题。
另一项修复涉及在签出钩子期间归档、重新排队会话或停止运行器时，钩子进程继续运行并占用运行器槽位的问题。签出钩子现在默认在 30 分钟后停止并判定会话设置失败；如需更长时间，可调高 --checkout-hook-timeout-min或设为 0。
重试、子代理与界面调整
Claude Code现在对无法解析的工具调用最多重试两次，之后以错误结束该轮次。
并行启动的fork子代理现在会被告知哪次启动属于自己，以减少它们尝试启动彼此工作的可能。
浏览器登录成功页现在在登录完成后立即显示，不再等待账户资料加载。
云与自托管运行器会话中，若搜索被 403 拒绝并给出原因，现在显示该原因而非通用的“Authentication error”。
WebSearch预算用尽时给Claude的通知增加了一条：不要通过浏览器或计算机使用去查询搜索引擎。
Code Review新增 @claude review stop（也支持off、pause），用于结束拉取请求上的 @claude review always订阅，且不启动新的审查。