Claude Code 用脚本批量编排工具调用
据文中介绍,Claude Code 2.1.323 的实验性 Code Mode 允许模型用 JavaScript 并行或串联工具,并筛选返回内容。作者在失效本地链接检查中,用两轮模型交互完成 13 次工具调用,找出三处问题。
AI 深度解读
Claude Code 的 Code Mode 把逐次调用工具,改成先写一段 JavaScript,再由脚本组织搜索、命令和编辑。它想减少的是模型与工具之间的往返:能并行的同时执行,能在脚本里过滤的结果,就少送回上下文。
作者用 Fable 5.2 检查 Markdown 本地链接,得到 13 次工具调用、2 轮模型交互、找到全部 3 处失效链接的结果。对经常批量改文件、整理搜索结果的程序员,这个方向有用;但它仍是实验功能,收益和权限边界都得分开看。
少的是模型往返,不是工具调用
Claude Code 2.1.323 加入了需要主动开启的 Code Mode。过去 Claude 分别请求 Bash、Read、Edit;开启后,它生成 JavaScript,在当前会话里组织这些调用,可以并行执行独立命令,也能把前一步结果交给下一步,最后只返回模型需要的内容。
下面这段原文代码,把搜索结果直接用于修改文件:
const files = await $`rg -l "function retryPolicy" src`.text();
await edit(files.trim().split("\n")[0], "maxAttempts: 3", "maxAttempts: 5");
要看清第二行的 [0]:它只取第一个匹配文件,并非修改全部结果。脚本减少了中间交接,也把选择文件的逻辑放进了代码。
Code Mode 的价值,是让工具之间的数据流少经过几轮模型。
日常对话仍显示命令输出和编辑 diff,JavaScript 默认不展示。按 Ctrl+O 打开会话记录,才能看到折叠的 Code 行。排查异常时,除了工具结果,还要检查脚本怎样筛选路径、传递参数。
作者的链接检查确实给出了调用数和结果,但没有提供耗时、token 消耗或重复测试。原文把未开启时描述为 13 次往返,这可以解释机制,不能直接算成某个固定加速比例。
开关必须放对位置,还要满足运行条件
开关是 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1,可以在启动会话前 export,也可以放进用户配置 ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
关键是配置层级:Claude Code 忽略项目和本地配置里的这个变量,避免克隆仓库顺带开启实验功能。
作者提供的安装命令是 npx claude-code-templates@latest --setting environment/code-mode。安装器询问合并位置时,要选 User settings;选其他位置可能安装成功,却不生效。这是作者封装的配置入口。

首次确认后,Claude Code 会重启并显示 Code Mode (experimental) is on。若显示 Code Mode (experimental) isn't available,同一行会解释原因,/status 也会重复显示。
按原文列出的条件,它只支持原生构建的交互终端;不支持 -p、Agent SDK、VS Code panel、Desktop app、cloud sessions、Remote Control、Claude in Chrome 或 computer use。
模型限定为 Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2。账号需要 Claude subscription 或 Console account;gateway、Bedrock、Google Cloud、Microsoft Foundry,以及 HIPAA configuration、zero data retention 均不支持。API key helper、agent teams、OpenTelemetry export 或 DISABLE_TELEMETRY 也会阻止启动。
权限检查还在,但自动审查看到的东西变了
脚本里的每次调用仍经过 deny、ask 规则和 PreToolUse hooks。脚本调用 Bash,仍匹配原有 Bash 规则,无须另建匹配器。
变化发生在 auto mode:分类器改为执行前审查整段代码,无法看到运行时才算出来的值,例如从搜索结果中提取的路径。需要明确控制的调用,应写进规则或 hook。若要检查 JavaScript 本身,可以让 PreToolUse hook 匹配 REPL,从 tool_input.code 读取代码。
审查脚本,不等于已经审查了它运行时产生的所有参数。
原文还提醒,Bash 规则匹配命令文本,不同写法可能避开既有匹配;这个问题开不开 Code Mode 都存在。沙箱提供的限制不依赖命令如何拼写。
会话和时限也有约束:以 Code Mode 启动的会话,恢复时仍须开启它,否则 claude --continue、claude --resume 会拒绝恢复。等待执行的代码最多十分钟,权限提示停留时间也算在内;后台代码最多两小时,而且会话必须以 auto 或 bypassPermissions mode 启动。
团队可在 managed settings 中将同一变量设为 0。已有会话直到重启才退出,之后也无法恢复;托管配置只能禁用,不能替用户开启。
我的判断
我认可它把批量操作和结果过滤交给脚本的方向。搜索结果需要加工、多个命令互相独立时,让模型逐次接收再转交,确实有可压缩的交互。
但作者没有给对照数据,当前收益仍是单个任务的经验之谈。原文也承认,两次调用的小任务可能只是多加了一步代码生成。
和固定脚本相比,Code Mode 适合临时任务,不必提前维护所有处理逻辑;固定脚本则更容易复用和检查。遇到持续运行的链接校验,沉淀进 CI 仍有价值。原文转述 Anthropic 的说明称,该功能可能在任意版本改变或移除,因此不宜让关键流程依赖它。
能拿来做什么
- 给前端文档仓库检查 Markdown 本地链接时,可以要求先汇总候选路径,再统一验证存在性,只返回失效链接及位置。
- 批量改配置前,先要求展示匹配文件和筛选条件,尤其检查脚本是否只处理第一个结果。
- 试用时记录模型轮数、实际耗时和结果完整性;频繁重复的任务,再考虑整理成 Node 脚本接入 CI。