Claude Code 发布新版本,改动清单很长。最值得盯的是两处新增:一个叫 /claude-api 的命令,一个叫 claude_code.safety_event 的遥测事件。
先说后者。这个 OpenTelemetry 事件会在每一次工具调用被拦下时上报——被权限规则拦、被自动模式拦、被安全检查拦、被钩子拦、被沙箱拦,或者被要求确认、被退回,都算。以前这些动作散在各处,现在统一进遥测管道。
对天天看日志的 SRE 来说,这相当于给“AI 到底想干什么、又被什么挡住了”装了个计数器。工具调用被拦不是故障,是策略在生效;但策略生效的频率、位置、原因,过去很难量化。
另一处新增是 /claude-api api-version,用来把 Claude API 代码迁到 API 版本 2026-10-21。命令本身不复杂,指向很明确:版本迁移这件事,官方希望你在编辑器里一步做完,而不是翻文档手动改。
修复项里挑几条有信息量的:
- 设置了 CLAUDE_CODE_DISABLE_1M_CONTEXT、模型又是带 [1m] 后缀的别名(比如 opus[1m])时,请求会报 model-not-found,已修。
- 自定义 ANTHROPIC_BASE_URL 网关和 Foundry 上,prompt-caching-scope 这个 beta 头被无意义地发送,已修。
- macOS 登录钥匙串锁着时,claude -p 里的 MCP 服务器会显示“需要认证”,现在会说明原因,解锁后下一次运行无需重新登录即可连上。
- macOS 或 Linux 机器在 MCP 连接过程中休眠,服务器会被误报超时并在无头运行中一直保持失败状态,已修。
- HTTP MCP 工具调用在连接中途关闭时会被发两次,现在只重试只读或幂等工具。
- 读大量 PDF 页、图片或其他大体积工具结果时出现的 “Autocompact is thrashing” 报错,修了一部分。
还有一条改动值得单独拎出来:通过 Agent SDK 的 setModel() 切换模型,以及基于它构建的应用,在 API 确认模型耗时超过 5 秒时会被拒绝;现在 Claude Code 最多等 15 秒。5 秒到 15 秒,是给慢网关留的余量。
自托管 runner 侧也有动作:checkout 钩子默认 30 分钟后停止并判定会话 setup 失败,需要更久就调 --checkout-hook-timeout-min,或者设成 0 关掉限制。另外,带 --use-anthropic-git-proxy 的会话曾把上一个会话留在克隆目录里的 .claude/settings.local.json 一起提交,已修。
VSCode 插件这边,语音听写自己停下时会说明原因——15 秒没识别到语音,或到了 2 分钟上限,并保留已识别的文字。长提示词用 Show more 展开后不再铺满整个聊天面板,固定后最多占 40%,超出滚动。
云会话里,仓库选择器在搜索进行中不再显示“没有匹配的仓库”,而是显示“搜索中…”;自托管环境的“等待 runner”状态不再被截断,按需 runner 会从你最后一条消息开始计时,并显示失败尝试次数。
Code Review 新增 @claude review stop,也可以写 off 或 pause,用来结束某个 PR 上的 @claude review always 订阅,且不会顺带启动一次新审查。
整体看,这个版本的重心不在新功能,而在把“被拦下”和“被中断”这些边缘路径变成可观测、可解释的状态。工具调用被拦要上报,连接断了要说明原因,等待要有上限。修锅的人最怕的不是报错,是报错不说话。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.