Claude Code 可用脚本串联工具调用
Claude Code v2.1.323 的实验性 Code Mode 允许模型用 JavaScript 在一步内串联 Bash、Read 和 Edit 调用。长命令运行期间,Claude 仍可继续对话。
AI 深度解读
Claude Code 的实验功能 Code Mode,把原先要分几轮发出的工具调用,交给一段 JavaScript 在当前会话里执行。Claude 可以先搜文件,再用搜索结果决定改哪里,最后跑测试。相互独立的命令也能并行,输出还可以先筛一遍,再交回模型。
对前端和全栈开发者,最直接的用处是把批量改动、搜索和验证串起来,少等几轮工具往返。至于能快多少、能省多少 token,Anthropic 没给 Claude Code 版的基准数据。开启之前,更该看的是自己用的入口支不支持,以及团队怎么审查工具调用。
一段 JavaScript 怎么串起搜索、修改和测试?
平时 Claude 会单独请求 Bash、Read 或 Edit,拿到一次结果,再决定下一次调用。打开 Code Mode 后,它可以把多个动作写进同一段 JavaScript,由 Claude Code 在当前会话里执行。前一步的结果可以直接传给后一步。遇到大量搜索结果,也可以在程序里先过滤,只把后续判断用得上的内容交回 Claude。
Anthropic 用调整重试上限举例。这段代码找到定义 retryPolicy 的文件,把最大尝试次数从 3 改到 5,再跑对应的测试。
const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });
先看第二行的 [0]。它直接取搜索结果的第一项,所以这段示例依赖一个前提,第一项就是要改的文件。仓库里有同名实现时,最好先确认匹配范围。最后一行用了 .nothrow(),测试跑完后仍要检查结果,尤其是退出状态。
会话里默认能看到工具调用和 diff。想看 Claude 写的 JavaScript,可以按 Ctrl+O 打开会话记录,再展开折叠的 Code 行。
哪些 Claude Code 会话能开?
Code Mode 默认关闭。Claude Code 原生构建需要 v2.1.323 或更高版本,配合 agent teams 需要 v2.1.326 或更高版本。原文列出的模型是 Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.2,Windows 还需要 Git for Windows。
在 shell 中设置 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1,或写入 ~/.claude/settings.json 的 env 块。首次进入时选择 Yes, turn on Code Mode,Claude Code 会重启并显示 Code Mode (experimental) is on。恢复会话时变量仍须为 1。任意一处设为 0 都会关掉它。管理员可以用托管设置统一禁用,开启仍由用户确认。
入口限定为交互式终端,账号走 Claude 订阅或 Anthropic API(Console)。-p、Agent SDK、VS Code 面板、Desktop 和云端会话都不支持,经网关、Amazon Bedrock、Claude Platform on AWS、Google Cloud 或 Microsoft Foundry 接入也用不了。HIPAA 配置、零数据保留、API key helper、OpenTelemetry 导出和 DISABLE_TELEMETRY 都是限制条件。Remote Control、Claude in Chrome 和 computer use 在这个模式下也不可用。
一次提交整段代码,权限按什么粒度审?
代码里的每次调用仍会经过已有的 deny、ask 规则,以及原工具名下的 PreToolUse hook,比如 Bash。区别在于 auto mode 的分类器会审查整段代码,运行时才算出来的值它看不到,比如从搜索输出里取出的文件路径。其他权限模式下,代码会直接启动,具体工具调用仍按原有规则提示。
如果团队用 hook 检查命令,原文给了一个实际形态,git push 可能出现在 cd 'app' && git push 这样的复合命令里。需要检查 JavaScript 本身时,可以让 hook 匹配 REPL 工具,再读取 tool_input.code。
Claude 在前台等待时,一段代码最多运行 10 分钟,权限确认耗掉的时间也算在内。后台最多跑 2 小时,期间还能继续对话,但会话必须以 auto 或 bypassPermissions 模式启动。
别把其他产品的省 token 数字算到 Claude Code 上
Cloudflare 在 2025 年 9 月 26 日提出 Code Mode,用 Agents SDK 把 MCP schema 转成 TypeScript API,在 V8 isolates 中执行。Claude API 的 Programmatic Tool Calling 于 2025 年 11 月推出,用 Python 编排开发者定义的工具。Claude Code 这一版用 JavaScript,串的是 CLI 内置的 Bash、Read、Edit 等工具。普通工具调用则由模型逐次发出 JSON 请求。
Anthropic 早期的 MCP 代码执行示例里,token 用量从 150,000 降到 2,000,节省 98.7%。Programmatic Tool Calling 在复杂研究任务中则把平均用量从 43,588 降到 27,297,约省 37%。这两组数字对应各自的工具和任务。Claude Code 版只有原文引用的一次第三方测量,系统工具上下文从关闭时的 24.6k tokens 降到开启时的 11.1k。这个指标只覆盖系统工具上下文,无法据此推算整次任务的 token 用量或耗时。
我的判断
我最认同的是让脚本先处理搜索结果。几十个匹配项如果只需要留下文件名或失败摘要,先在本地筛一遍,再交给模型,理由很直接。但批量修改到底能省多少时间,还取决于命令本身要跑多久、要停下来确认几次。原文没有给同一任务开关对照的数据,把它视为经验判断就够了。
单文件修改用普通工具调用已经很顺手,还能让 Claude 先读输出再决定下一步。需要反复执行的固定流程,我会优先用仓库已有的 npm script,因为团队成员和 CI 可以复用同一个入口。Code Mode 更适合临时任务,尤其是步骤彼此相关、又得根据这次搜索结果决定后续动作的时候。团队如果依赖 auto mode 审查,还得考虑分类器看不到运行时路径这一点。
能拿来做什么
- 在前端仓库里批量替换旧配置时,可以让 Claude 先列出匹配文件,再把修改范围限定到指定目录,最后返回改动清单和测试失败摘要。
- 排查 Node 项目时,可以让相互独立的只读搜索和类型检查并行,把依赖修改结果的测试排在编辑之后,并要求保留测试退出状态。
- 想知道自己的仓库能省多少时间,可以拿两项规模相近的例行改动,在权限设置一致的情况下分别用普通模式和 Code Mode,记录总耗时、确认次数和最终测试结果。