Code Mode 文档上线了:用一段 JavaScript 一次跑完多步工具调用
平时 Claude 调工具是一步一步来的:搜一下、看结果、再改文件、再跑测试。Code Mode 换了一种做法——Claude 先写出一段 JavaScript,由 Claude Code 在当前会话里执行。一段代码里可以并行跑命令、把上一步的结果交给下一步,最后只把 Claude 真正需要看的那部分输出返回来。
这是 2.1.323 引入的实验性功能,默认关闭,官方文档页现在已经上线。2.1.326 起,开着 Agent Teams 也可以同时打开 Code Mode。功能还可能改,也可能会被拿掉,适合先在熟悉的项目里试用。
怎么打开
- 先确认版本:
claude --version至少是 2.1.323。要和 Agent Teams 一起用,请升到 2.1.326 或更高。 - 把环境变量
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE设为1再启动。只想试一次,在当前 shell 里带上这个变量即可;想每次新会话都开,写进用户设置~/.claude/settings.json的env里。项目目录里的设置文件会被忽略,克隆来的仓库不能替你打开这个开关。
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}- 第一次会先问你确认。同意之后 Claude Code 会重启,会话顶部出现类似
Code Mode (experimental) is on的提示。
对话里你看到的还是工具调用本身,比如编辑的 diff,而不是那段 JavaScript。想看代码,按 Ctrl+O 打开 transcript,展开折叠的 Code 行即可。
恢复会话时必须继续带着这个变量。关掉 Code Mode 再去 --resume 或 --continue,会被拒绝。反过来,当初没开 Code Mode 的会话,即使后来设了变量,也不会突然变成 Code Mode 会话。
适合什么,不适合什么
比较适合工具调用又多又相关的活:同一处改动要铺到很多文件、搜索结果要先过滤再读、好几条互不依赖的命令可以一起跑。
开之前先接受这些限制:
- 只能在终端的交互式
claude会话里用;-p、Agent SDK、VS Code 面板、桌面应用和云会话都不行,也需要原生安装包。 - 账号得是 Claude 订阅或 Console;走网关、Bedrock、Vertex 等托管通道开不了。组织如果开了 HIPAA 配置或零数据保留,同样不能用。
- 模型目前支持 Opus 5.5、Sonnet 5.5、Haiku 5.5 和 Fable 5.2。
- 不能同时使用 Remote Control、Claude in Chrome 或 computer use,也不能把会话搬到桌面端或转成后台会话。
- Auto mode 下,分类器审的是整段代码,而不是里面每一条工具调用。运行时才算出来的路径,分类器事先看不到,该用权限规则和 hook 的地方还是要写。
- 前台等待的代码最多跑十分钟(含你在权限提示上花的时间);要跑得更久,需要在 auto 或
bypassPermissions下走后台,最长大约两小时。
2.1.326 起可以和 Agent Teams 一起开:如果你已经打开了 Code Mode,带着 Teams 的会话会直接以 Code Mode 启动。队友在默认的进程内显示模式下会按 Code Mode 跑,分屏(split panes)里则不会。
关掉,或者组织要禁用
从 shell 和用户设置里去掉这个变量,或把它改成 0,再开新会话即可。两处有一处是 0,就算另一处写了 1 也不会开。
管理员可以在托管设置的 env 里把 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 设为 0,组织里就没人能再打开。已经在跑的 Code Mode 会话会持续到退出或重启;之后这些会话也无法恢复。托管设置不能替用户打开 Code Mode。
如果顶部出现 Code Mode (experimental) isn't available,同一行会给出原因,/status 里也能看到。常见原因包括走了网关、开了 API key helper、开了 OpenTelemetry 导出、设了 DISABLE_TELEMETRY,或者版本还不够。对症改完再开一个新会话。
试用过程中有想法,可以用 /feedback 反馈给官方。