让 Claude 批量调工具写代码
Claude Code 2.1.323·实验性 Code Mode 用 JS 串起多步工具调用
批量改文件、过滤搜索结果、并行跑命令,可以减少逐步往返。Claude 用代码串起多步调用,只读回需要的结果;功能默认关闭,需手动开启。
- 🟢 怎么工作:关闭时,Claude 每次请求一个 Bash、Read 或 Edit。读完结果,再决定下一步。开启后,Claude 用一段 JavaScript 调用这些工具。代码可以并行跑命令,也可以把上一步结果交给下一步。最后只返回需要读取的部分。界面照常显示每次工具调用和 diff。按 Ctrl+O 可在 transcript 里展开查看代码。
- 🟢 适用任务:官方文档列出三类任务。一处改动要重复到很多文件。搜索结果要先过滤,再交给 Claude 读。几条互不相关的命令可以同时跑。
- 🟢 使用门槛:需要 v2.1.323 及以上的原生安装版,该版本于 11-12 发布。需登录 Claude 订阅或 Console 账号。仅支持 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.2。仅限终端内的交互式会话。
-p、Agent SDK、VS Code 面板和桌面端均不支持。网关、Bedrock 或自定义ANTHROPIC_BASE_URL也不支持。 - 🟢 权限照常:代码里的每次工具调用,仍经过你的 deny / ask 规则和 PreToolUse hook。auto 模式下,分类器审核整段代码。因此,它看不到运行时才计算出的路径。需要限制的调用,仍要用规则或 hook 控制。
先用 claude update 升到 2.1.323 以上,再运行 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude。首次确认后,让它「找出所有 Markdown 里指向本地不存在文件的链接」。这个变量写在项目 settings 里无效,只接受 shell 和 ~/.claude/settings.json。
- 实验功能随时可能改动或删除;排障表提示账号可能尚未开放、可改天再试,可能采用分批开放;文档未给出 token 节省量,需用
/context自行对比。 - 前台等待的代码会在 10 分钟后停止;开启后不支持 Remote Control、Claude in Chrome 和后台会话,也不能同时开启 agent teams、OpenTelemetry 或
DISABLE_TELEMETRY;此会话以后 resume 时也必须开启 Code Mode。
核实记录
文档全文存 _raw/fetch/cc-code-mode.html(纯文本 .txt);读到工作方式和示例代码、三类适用场景、限制清单(resume、auto 模式、十分钟、hooks、Remote Control / Chrome / computer use、后台会话)、Requirements(v2.1.323、订阅或 Console、四个模型、只限终端交互式会话、原生安装)、启用变量和项目 settings 无效、Long-running(等待 10 分钟 / 后台最多 2 小时)和 Troubleshooting 表。版本日期取自 api.github.com 的 release:v2.1.323 发布于 2026-11-12T22:12Z;CHANGELOG 第一条 Added 就是 Code Mode。没有实际开启试用