Anthropic 在最新发布的 Claude Code v2.1.323 中引入了一项名为 Code Mode 的实验性功能。该模式允许 Claude 编写并执行一段 JavaScript 代码,从而在单次交互中串联多个工具调用(如 Bash、Read、Edit)。这一创新旨在减少智能体在处理复杂多步骤任务时的往返次数(round-trips),显著提升执行效率并降低 Token 消耗。
核心机制:从“逐步请求”到“脚本编排”
在传统模式下,Claude 需要逐个请求工具调用,等待每个结果返回后才能决定下一步操作。而在 Code Mode 下:
- JavaScript 编排:Claude 生成一段 JavaScript 脚本,利用内置的异步 API(如
$用于 Bash 命令,edit用于文件修改)来 orchestrate 多个操作。 - 并行与链式执行:脚本可以并行运行独立命令,或将一个命令的输出直接作为下一个命令的输入,无需经过 LLM 的中间推理层。
- 精简输出:代码可以过滤掉无关日志,仅向 Claude 返回关键结果,进一步节省上下文窗口。
示例代码:
// 查找包含特定函数的文件,修改重试次数,并运行测试
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() });
性能与优势
虽然 Anthropic 未公布官方基准数据,但独立测试显示 Code Mode 能显著优化资源使用:
- Token 节省:系统工具上下文可从 24.6k tokens 降至 11.1k tokens,降幅超过 50%。相比之下,Anthropic API 的 Programmatic Tool Calling 在复杂研究中平均节省约 37% 的 Token。
- 时间效率:通过并行执行和减少往返延迟,复杂任务的完成速度大幅提升。
- 后台持久化:在自动模式下,后台代码可运行长达 2 小时,允许用户在此期间继续与其他任务交互。
启用方式与限制
如何启用
用户需通过环境变量显式选择加入:
export CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1
# 或在 ~/.claude/settings.json 中设置
首次启动时,Claude Code 会要求用户确认开启该实验性功能。
主要限制
- 平台限制:仅支持原生终端会话(CLI),不支持 VS Code 插件、Desktop 应用、Agent SDK 或云会话。
- 账户限制:仅限 Anthropic 直接 API 或 Claude 订阅用户,不支持 Amazon Bedrock、Google Cloud Vertex AI 或 Microsoft Foundry。
- 功能缺失:在此模式下,远程控制、计算机使用(Computer Use)及部分高级集成不可用。
- 超时机制:若代码在等待用户权限确认时超过 10 分钟,执行将终止。
安全与审查
Code Mode 引入了新的安全审查逻辑:
- 自动模式:分类器会对整段 JavaScript 代码进行审查,而非逐个审查内部的工具调用。这意味着审查粒度更粗,且无法看到运行时动态计算的值(如搜索得到的具体文件路径)。
- 钩子兼容:
PreToolUse钩子仍会被触发,但开发者需注意检查命令字符串的完整性(例如cd 'app' && git push)。
行业对比
| 特性 | Claude Code Code Mode | Claude API Programmatic Tool Calling | Cloudflare Code Mode |
|---|---|---|---|
| 编排语言 | JavaScript | Python | TypeScript |
| 运行环境 | 本地 CLI 会话 | Anthropic 云端执行环境 | Cloudflare V8 Isolates |
| 适用工具 | 内置 CLI 工具 (Bash/Edit/Read) | 开发者自定义 MCP 工具 | MCP 服务器 (转为 TS API) |
| 状态 | 实验性 (默认关闭) | GA (2025.11 推出) | 封闭测试 |
Code Mode 是 Anthropic 在提升 AI 智能体执行效率方面的一次重要尝试。通过将控制权部分交给本地执行的 JavaScript 脚本,它不仅减少了 LLM 的推理负担,还实现了更灵活、更快速的工具链整合。尽管目前仍处于实验阶段且存在平台限制,但对于需要在本地环境中高效处理多步开发任务的开发者而言,这是一个极具潜力的功能。建议用户在非生产环境中先行体验,并密切关注其安全性与稳定性表现。(官方介绍)
© 版权声明
文章版权归作者所有,未经允许请勿转载。















