AI coding · 二十三次工具调用压成一段脚本,开关文档当天还是 404

十一月十二日,Claude Code 发了 2.1.323。官方 changelog 的第一行只有一句话,却动了 agent 干活的方式:新增 Code Mode,一个实验性的可选功能,Claude 写 JavaScript 来调用自己的工具。后面附了开关文档的链接,并说明可以按组织关掉。

目录
  1. 二十三次往返,压成一次
  2. 门禁卡的形状变了
  3. 插件装了一道版本栅栏
  4. 同一版里其他值得记的收紧
  5. 两个数字上的分歧
  6. 与这几天别的 AI coding 帖分开读

二十三趟并成一趟 · SVG 动画卡

十一月十二日,Claude Code 发了 2.1.323。官方 changelog 的第一行只有一句话,却动了 agent 干活的方式:新增 Code Mode,一个实验性的可选功能,Claude 写 JavaScript 来调用自己的工具。后面附了开关文档的链接,并说明可以按组织关掉。

第二天有人去点那个链接,code.claude.com/docs/en/code-mode 回的是 404,文档导航里也找不到这一页。Code Mode 在 changelog 里的说明,到此为止就是那一行。

二十三次往返,压成一次

先把旧路子看清楚。agent 要读二十个文件、跑三条命令,就得发二十三次工具调用,每调一次,工具结果回灌进上下文,模型再决定下一步。中间夹着二十三来回的等待,也夹着二十三份谁都不需要完整看到的中间结果。

Code Mode 把这一串搬进一段脚本。模型写一段 JavaScript,循环,条件判断,中间变量都在脚本里跑完,工具由脚本去调,最后把合并过的结果交回来。读十个文件并只对符合条件的文件动手,旧路子是十次往返,新路子是一次执行。

省下的是 token 与等待,这两样都好算。真正难算的在下一节。这段机制解释来自逐条读 changelog 的第三方文章,官方并未公开 Code Mode 的实现细节,能触及哪些工具也没有写下来。

门禁卡的形状变了

权限规则原本拦的是「一次工具调用」。一条 allow 规则写清楚可以跑哪条命令,模型每发一次调用,检查就过一次。工具调用被组合进生成的 JavaScript 之后,被检查的对象从一串离散的调用,变成一段会自己循环,自己判断,自己拼接参数的代码。

有篇逐条读 changelog 的文章把这层讲得很实在:一旦 agent 把做法写成脚本,问题就从它调了几次工具,变成脚本到底写了什么;没有哪张 allow 名单回答得了后面这个问题。官方 changelog 同一版里确实动了不少权限检查,但 Code Mode 与权限规则的相互作用,公开材料里没有写。文档页还是 404。

这一版的官方条目里,权限侧的收紧有据可查。启动时会警告变量值里带星号的 Bash allow 规则,例子是 Bash(PORT=* npm run dev),这类写法容易把许可放得过宽。--permission-mode auto 或设置里的 defaultMode: auto 在 auto 模式不可用时,先前会落进一个可能放行更多的模式,现在改成以 Manual 起步、先问。带附加通配符的 allow 规则如 Bash(ls*) 曾在某些情形下跳过权限提示,现在点名变量的规则如 Bash(NODE_ENV*) 会问。经 sudo 与 env 之类包装器执行的命令,deny 与 ask 规则先前会漏掉,这一版补了。Write 与 Edit 工具曾能写进被 Read deny 规则盖住的路径,也补了。

把这些条目并排看,方向是一致的:检查点变多,含糊的放行变少。脚本化的工具调用恰好往相反的方向增加了一次检查要看懂的东西,两件事撞在同一个版本里,值得留个心眼。

插件装了一道版本栅栏

另两条官方 Added 与 Code Mode 同版本落地,管的都是插件生态。

plugin.json 新增 engines["claude-code"] 字段。声明的版本区间之外的插件,不安装,不更新,不加载;安装与更新会挑区间内最新的那个版本。这让插件作者能把自己实际测过的 CLI 版本范围写进清单,尤其插件的 hooks 若依赖命令行内部的事件名,工具 schema 或权限检查流程,版本不合就不再静默加载进一个已经改过行为的 CLI。

claude plugin validate 增加对插件 TypeScript hooks 模块的类型检查,每条发现先算警告,加 --strict 才让它变成失败。同一条命令还增加了对一个 mod 的 engine.create hook 增删替换项的检查。

这里有个容易被二手文章抹掉的限定。有篇 11 月 13 日的文章去查了插件清单的官方参考页,全文没有出现 engines 这个字段;那篇文章给出的区间写法是作者照 npm 的 engines 拟的示例,并自己声明了这一点。也就是说,到那天的公开规格里,changelog 上那一行就是全部。要往 marketplace 发插件的人,得先验清楚实际接受的语法。

同一版里其他值得记的收紧

官方 2.1.323 段的 Fixed 条目排了很长一串,挑几条与日常使用直接相关的列在这里。

条目改了什么
敏感路径的「不再询问」写 .git 或 .claude 的命令曾提供该选项,存下的规则并不能让下次免问
危险删除判断曾有 rm 从错误目录判断,跳过危险删除提示
沙箱状态修掉沙箱在会话中途被关掉的情形
沙箱例外命令修掉 sandbox.excludedCommands 未点名的命令跑到沙箱外
项目设置读取修掉经符号链接读到与已检查目录不同的另一处
压缩上下文修掉再次运行 /compact 时把一条模型还没回答的消息压掉
工件格式Artifact 工具开始支持 .docx 资产上传
第三方逐条读 changelog 的文章还提到几项更贴身的改动:「不再询问」的 allow 规则若看起来含密钥,或会被写进 git 跟踪的 settings.local.json,就只在本次会话有效、不落盘,源头是 Apiiro 一次普查发现 1,122 个公开仓库在受跟踪的 settings 文件里放了真实密钥;PreToolUse hook 回过 allow 之后,若权限检查报错,现在按「没有 hook 回答过」来判;内部 ripgrep 与多数内部 git 命令不再携带大部分登录令牌与 API key,埋在 git 命令下的钩子读不到这些凭据。这几项属于第三方的归纳,正文里与官方条目分开摆。

两个数字上的分歧

有一处值得单独核。两篇第三方文章都把「未知模型 ID 的假定上下文窗口从 20 万提到 100 万」算进 2.1.323,并给出 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 用来退回 20 万。我把官方 CHANGELOG.md 拉下来逐行看,2.1.323 段里没有这一条,该段从 Added 到 Fixed 也没有出现那个环境变量。官方 2.1.325 段倒是有一条相关改动:CLAUDE_CODE_MAX_CONTEXT_TOKENS 现在也用来设定以 claude- 开头、未被识别的模型 ID 的上下文窗口。这个改动归在 11 月 13 日那一版。

结论只能写到这个程度:上下文窗口的改动确实存在,它在官方 changelog 里属于 2.1.325,第三方把它算进了 2.1.323。转述时把版本号带上,比记住那个数字更要紧。

条目总数也有分歧。一家按第三方计数说这一版有 195 个修复,另一家数出 294 处改动,其中 20 处是破坏性变更或弃用。官方 changelog 是把长版本按类型分组、把长列表折叠起来的,两家的计数口径都没有公开。这类数字只适合说明「这一版动得不少」,不适合引用成精确值。

与这几天别的 AI coding 帖分开读

近七天里,站上已经有拿 200 个真实 PR 比较代码审查工具与 Claude Code 的 token 效率,讲电子表格长出 AI SDK,讲技能评测流水线的几篇。本篇盯着的是一个具体版本里工具调用形状的变化,以及这个变化给权限模型出的题,没有做任何工具之间的成绩对比。

把 2.1.323 压成一句话:agent 从逐个递条子,改成一次递一整段会自己跑的代码;同一版给插件加了版本栅栏,给权限检查补了一串漏洞;而教人怎么开关这个功能的那页文档,当天还没上线。实验性,可选,能按组织关掉,这三个限定词都是官方给的,引用时最好一起带上。

参考文献:Claude Code 官方 CHANGELOG.md 2.1.323 与 2.1.325 段落(2026-11-12 与 11-13,逐行核对);官方 changelog 页面 code.claude.com/docs/en/changelog;逐条读 changelog 的第三方文章(DEV Community,clauding.de,RAXXO Studios,2026-11-12 至 11-13),其中 Code Mode 机制解释,文档 404,Apiiro 普查数字,会话消息数上限,MCP 客户端代际均属第三方转述,已与官方条目分开标注。官方 2.1.323 段未见上下文窗口 20 万到 100 万的条目,正文按查证结果写明。

暂无表态

想参与讨论或点赞?登录后使用完整功能

讨论回复(0)

暂无回复,登录后可参与讨论
合作

智谱 GLM-5 已上线

在智谱开放平台 BigModel.cn 打造 AI 应用。新一代旗舰模型 GLM-5 在推理、代码、智能体综合能力达到开源模型 SOTA。

领取 2000万 Tokens