Anthropic 为 Claude Code 推出 Code Mode:让 AI 用 JavaScript 批量调用工具
实验性功能随 v2.1.323 上线,自动模式的安全审查从逐个工具调用改为审查整段脚本

Anthropic 为 Claude Code 推出了 Code Mode。这是一项实验性功能,让模型编写简短的 JavaScript 程序,在一次 REPL 运行中执行多个工具调用,而不是一个一个地发出。该功能随 Claude Code v2.1.323 于 2026 年 11 月 12 日上线,11 月 17 日才有了正式的博客公告。
核心的行为变化很直接:Code Mode 下的 Claude 不再逐个调用工具、等一个返回再发下一个,而是可以写一段 JavaScript 程序,交给新的 REPL 工具执行,等运行结束后再从对应的 Poll 工具取回结果。这样,一批读文件、搜索之类的操作可以并行运行,中间结果留在脚本的执行环境里,不必每一步都回流到模型。
一个运行模型所写 JavaScript 的新执行环境
Code Mode 开启后,Claude 在原有工具之外多了两项能力:一个接收并执行 JavaScript 程序的 REPL 工具,和一个取回后台脚本输出的 Poll 工具。模型可以写程序,以编程方式调用自己的整套工具(读文件、搜索、shell 命令),并用普通的 JavaScript 控制流遍历结果,全部在一次 REPL 执行中完成。
运行时是 node:vm,跑在 Bun 里,也就是 Anthropic 目前为 Claude Code 使用的 JavaScript 执行环境。开发者 Rhys(@RhysSullivan)在一篇公开帖子中证实了 node:vm 这个运行时选择。Claude Code 本身以 Bun 可执行文件的形式发布,所以 Code Mode 的沙箱就在同一个进程里运行,而不是另起一套独立环境。
架构上的一个结果是:程序执行期间,模型的上下文不会像普通模式那样不断累积中间的工具调用结果。REPL 的边界把中间状态隔在里面,i10x.ai 对 Code Mode 的分析发现,这道边界能明显减少回流到模型的 token 量,不过效果因任务结构差别很大。
延伸阅读:Claude Code 桌面版新增嵌套会话与保存的环境,面向并行智能体工作
REPL 和 Poll 工具与其他 Claude Code 工具列在一起,所以会出现在工具调用日志里,也会出现在 Claude Code 会话过程中的显示里。某个任务要不要用 Code Mode,由模型自己决定;开发者无法直接指示 Claude 写脚本而不是逐个调用,不过可以在组织层面开启或关闭这项功能。
后台任务,以及自动模式如何处理脚本
Code Mode 按会话的运行方式设了两档超时。Claude 需要等待的脚本,也就是用户在终端前、执行会阻塞会话的情况,最长允许十分钟。在自动模式或 bypassPermissions 模式下作为后台任务运行的脚本,最长可以跑两小时,并在到期前 1 分 59 秒时弹出警告通知。
使用自动模式时,安全模型发生了一个影响深远的变化。在标准的 Claude Code 运行方式下,自动模式会在执行前逐个审查工具调用,套用拒绝规则和 PreToolUse 钩子,决定拦下还是放行。而在 Code Mode 中,自动模式的分类器改为在执行开始前,对整段 JavaScript 程序审查一次。
这个设计意味着,分类器评估的是程序的静态文本,而不是它在运行时可能算出的值。如果脚本用其他变量动态拼出一个文件路径,或者在循环里把计算出来的值传给某个工具调用,分类器只能检查写出来的程序,看不到这些值在执行时会变成什么。Anthropic 的官方发布说明明确承认了这个局限:依赖检查具体参数值的拒绝规则,对动态构造的调用可能无法像在标准模式下那样生效。
延伸阅读:Codex 用户破 2000 万,Claude Code 在 AI 编程上的领先正在收窄
一个广为流传、却属于另一项功能的基准数字
网上广泛流传一个「token 减少 37%」的数字,被当作 Code Mode 高效的证据。这个数字既不来自 Claude Code,也不来自 Code Mode。
它出自Anthropic 2025 年 11 月的一篇工程博客,讲的是程序化工具调用(Programmatic Tool Calling)。那是另一项 API 层面的功能,让 Claude 编写 Python,在沙箱环境中调用工具。当时测得的结果是:在复杂研究任务上,输入 token 平均从 43,588 降到 27,297。这描述的是那项 API 功能在一个特定基准上的表现,而不是 Claude Code 新的基于 REPL 的执行方式。两者有共同的思路,即由模型编写的程序可以减少每一步的上下文累积,但它们用的语言不同、运行时不同,处在技术栈的不同层级。
开发者对真正的 Code Mode 做的测试,结果确有成效但并不稳定。一位开发者用 Opus 5.5 跑一个类似任务,看到输入 token 下降约 37%,从 150,364 降到 94,659,但总运行时间从 15 秒增加到 37 秒。另一位开发者用 Sonnet 5.5 跑了八个任务,短任务的输入 token 减少约 40%,一次涉及 30 个文件的重构减少约 55%(从 48.6 万降到 21.8 万)。早期测试呈现出的规律是:在批量操作多的工作上,Code Mode 能减少上下文累积,但有时会拉长实际耗时,因为模型在执行开始前要多花时间写脚本。
安全模型变了,需要有意识地做配置
安全审查从逐个调用改为按整段程序进行,这改变了依赖拒绝规则或 PreToolUse 钩子的组织在部署 Code Mode 前需要核实的内容。例如,一条为拦截特定 shell 参数而写的拒绝规则,面对在运行时动态拼出这些参数的 Code Mode 脚本,可能会放行。
Anthropic 建议部署操作系统层面的沙箱,常见做法是使用限制了文件系统挂载的 Docker 容器,适用于任何安全要求不能完全依赖命令文本规则的环境。组织可以通过托管设置在所有实例上禁用 Code Mode。
这项功能不能通过项目级设置文件开启。必须在 shell 或系统层面设置环境变量 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1。这样设计是为了防止某个代码仓库的配置在开发者克隆它时,在他们不知情的情况下悄悄开启 Code Mode。
上线范围、要求与当前限制
Code Mode 需要 Claude Code v2.1.323 或更高版本,支持 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.2。Anthropic 随后发布了修复版本 v2.1.325;使用 Code Mode 的多智能体工作流需要 v2.1.326 或更高版本。
以下场景无法使用这项功能:VS Code 扩展面板、Claude Desktop 应用、云端托管的 Claude Code 会话、使用 -p 参数的运行、Claude Agent SDK、部署在 Amazon Bedrock、Google Cloud 或 Microsoft Azure AI Foundry 上的实例、符合 HIPAA 要求的组织,以及配置了零数据保留的环境。
在 Windows 上,Git for Windows 提供 Bash 支持;没有它,Claude Code 会退回用 PowerShell 执行 shell 命令。除了 Claude Code 已在使用的运行时,Code Mode 本身不需要额外的系统依赖。
Code Mode 目前仅限原生的交互式终端会话。Anthropic 还没有公布把它扩展到上述被排除环境的时间表。
这种做法与其他 AI 编程工具的思路相近。OpenAI 的 Codex 和开源智能体 OpenCode 都支持由模型驱动编排编程任务;Earendil 开发的极简终端编程智能体框架 Pi,则用 QuickJS 沙箱让 Claude 执行自己的脚本层。Claude Code 的实现与众不同之处在于,它把执行嵌入了自己本来就在用的 Bun 运行时,使 Code Mode 成为现有执行环境的延伸,而不是一个独立的子进程。



