软件教程

Claude Code 2.1.323:把一串工具调用打包成一段 JS 再跑

一、Code Mode 到底改了什么

2.1.323 在 11 月 12 日发布,距上一版 2.1.322 只有两天,改动却有三百多处。最显眼的是 Code Mode:以前每一次工具调用都要回到模型问下一步,现在可以打开这个开关,让模型写一段 JavaScript,把几个工具调用打包在一次执行里跑完。它默认关闭,属于实验特性,组织层面可以统一关掉。同类思路在 Docker 的 agent 运行时和 OpenCode 里已经出现过,收益都来自同一个地方——减少多步任务里往返模型的次数,顺带省 token。

因为还是实验特性,先拿低风险任务试。写脚本时不要假设它能访问全部工具,遇到权限拒绝要能优雅退出,而不是在半途留下一个改了半个仓库的工作区。

二、插件和权限的变化

插件现在可以在 plugin.json 里写 engines 字段,声明自己支持的 Claude Code 版本范围。超出范围的插件不会被安装、更新或加载,安装时会自动挑范围内最新的版本。claude plugin validate 会顺带对插件的 TypeScript hooks 模块做类型检查,问题按警告报出,加 --strict 就变成失败——这条对写插件的人最实用,等于把运行时才炸的错提前到发布前。

权限侧也收紧了:Bash 的询问不再对 .git、.claude 这类路径提供别再问的选项;auto 模式不可用时,新会话回落到手动模式;hook 长时间运行时每 30 秒打一次心跳,claude -p 与 SDK 会话不会再把卡住和正在跑混为一谈;OpenTelemetry 的导出超时改成 25 秒。安全修复一批集中在沙箱:符号链接写入绕过、cp 与 mv 目标缺少检查,以及权限判断看错目录导致不弹窗的老问题。

升级日志里最贵的往往不是新功能,而是默认值变了的那几行。

三、升级前先看这三个坑

第一个是不认识的模型 ID 现在按 100 万上下文估算,原来是 20 万。如果你通过网关接的是上下文远小于 100 万的第三方模型,Claude Code 会以为还有大把余量,错过该压缩的时点,等到塞满之后每一轮都失败,只能 /clear。要么提前用 /autocompact,要么设 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 保住旧行为。

第二个是内部 git 与 ripgrep 调用不再带登录令牌和 API key。依赖会话令牌的自定义 git hook 或 credential helper 会突然找不到凭据,升级后第一件事是把这类自动化跑一遍。第三个是子代理的进度摘要可以关掉:设 CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES=1,摘要行为和生成摘要的那次额外请求一起消失,同时跑多个子代理时这笔开销不小。

建议的升级顺序:先在一台机器上升,跑一遍日常最重的仓库;确认 hook 与凭据链路正常;再看要不要开 Code Mode。别在同一天既升级又改工作流,出问题时分不清是谁的锅。