Claude Code 推出 Code Mode:Claude 用 JavaScript 批量调用工具

Anthropic 推出了 Code Mode,这是 Claude Code 的一项实验性功能,改变了编程智能体使用工具的方式。Claude 不再一次只请求一个工具调用——Bash、Read 或 Edit——并在决定下一步之前先读取结果,而是编写一段 JavaScript,一次完成多个工具调用,Claude Code 则在会话中运行这段代码。该功能随 2.1.323 版本于 2026 年 11 月 12 日发布,默认关闭。

Code Mode 的工作原理

实际使用中,用户仍然用自然语言描述任务。Claude 随后编写代码:一段脚本可以并行运行命令、将一个调用的结果用于下一个调用,并且只返回 Claude 需要读取的那部分输出。文档中的一个例子是要求提高重试上限:代码会找到文件、完成修改并运行测试,返回文件路径和测试输出。

在对话中,用户看到的是工具调用——例如一次编辑的 diff——而不是代码。要查看 Claude 编写的代码,按 Ctrl+O 打开转录查看器,每段代码都会以折叠的 Code 行形式出现。

适用场景

Anthropic 建议在涉及大量相关工具调用的任务中使用 Code Mode:需要在多个文件中重复的修改、结果需要先过滤再让 Claude 阅读的搜索,或者可以同时运行的多个独立命令。其思路针对的是智能体的一项已知成本:每次工具调用之间都需要模型做出一次响应,把调用打包可以减少这些往返。

如何启用

启用方法很简单,使用环境变量 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 启动 Claude Code 即可。也可以在用户设置(~/.claude/settings.json)中设定该值;其中任何一处为 0,该模式都会保持关闭。组织可以通过托管设置,为所有用户屏蔽这一功能。

要求与限制

Code Mode 要求 Claude Code 2.1.323 或更高版本、原生构建、在交互式终端会话中运行,并拥有 Claude 订阅或 Console 账号,同时使用 Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.2 模型之一。它不能通过 Amazon Bedrock、Google Cloud、Microsoft Foundry 或 Claude Platform on AWS 等网关使用,也不能与 -p、Agent SDK、VS Code 面板、桌面应用或云端会话一起使用。在 Windows 上需要安装 Git for Windows。

启用该模式后,一些功能也不可用:Remote Control、Claude in Chrome 和计算机操作。会话不能移至桌面应用,也不能转为后台会话,/fork 也无法启动后台副本。Code Mode 会话只能在终端中、且在该模式开启的情况下恢复。

权限与长时间运行的代码

Claude 的代码发起的每次调用仍会经过用户的权限规则(deny 与 ask)和 PreToolUse 钩子——无需为 Bash 等工具修改规则。在自动模式下,分类器会在代码运行前审查代码本身,而不是逐个审查调用;因此文档建议,对需要控制的调用保留规则或钩子。想要审计代码的用户可以为执行 JavaScript 的 REPL 工具编写 PreToolUse 钩子,并在 tool_input.code 中读取代码。

当代码运行较长的构建或测试时,Claude 可以等待,也可以让代码在后台继续运行:等待时,代码会在十分钟后停止;在后台运行时,最长可运行两小时,前提是会话以自动模式或 bypassPermissions 模式启动。

11 月 13 日发布的 2.1.325 版本已经修复了该功能的第一批错误,包括忽略 worktree 的脚本,以及恢复会话后 Claude 自行开始工作的情况。该功能发布于 Claude Code 2.1.319 一周之后,后者将 MCP 任务移至后台,相关报道见这篇 Geekiki 文章。Anthropic 明确表示,Code Mode 属于实验性功能,可能在任何版本中更改或移除——官方文档是了解当前行为的权威参考。

作为背景,Code Mode 把 Anthropic 在 2025 年 11 月面向 API 提出的“程序化工具调用”思路带到了 Claude Code:模型不再逐个请求工具,而是编写代码来编排调用。Code Mode 的文档没有承诺任何节省数字——在日常采用之前,值得先用自己的任务测试一下。

图片来源:Anthropic 的 Claude 标志,来自 Wikimedia Commons。

来源

透明度说明:本文在人工智能的协助下,基于公开报道和网络资料编写,并经过编辑审核。请查阅原始来源以确认相关信息。

作者:Muse