Claude Code 的 Code Mode:是什么、怎么开、中转能不能用
一句话结论
Code Mode 是 Claude Code 在 v2.1.323(2026-11-12)加入的实验功能,默认关闭,用环境变量 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 开启。它只能直连 Anthropic 官方:只要设了 ANTHROPIC_BASE_URL(任何第三方中转,包括久连 9Link),或者用 ANTHROPIC_AUTH_TOKEN 登录,启动时都会提示 Code Mode (experimental) isn't available,然后照常用普通模式。这是 Claude Code 客户端在本地做的限制,中转服务器改不了。
Code Mode 是什么
普通模式下,Claude 一次调用一个工具(Bash、Read、Edit 等),读完结果再决定下一步。开了 Code Mode,Claude 会写一段 JavaScript,在一段代码里完成多次工具调用:并行跑命令、把上一步结果用在下一步、只把需要的部分读回来。
官方文档里的例子(把重试上限从 3 改成 5 并跑测试):
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() });
对话里你看到的还是一次次工具调用(比如编辑的 diff)。想看 Claude 写的代码,按 Ctrl+O 打开记录,展开 Code 一行。
适合的任务:同一个改动要改很多文件、搜索结果要先过滤再看、几条互不相关的命令可以同时跑。
开启条件
| 条件 | 要求 |
|---|---|
| 版本 | Claude Code v2.1.323 及以上,原生安装版 |
| 账号 | Claude 订阅(Pro / Max)或 Console 账号直接登录 |
| 不支持 | 网关、自定义 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN / apiKeyHelper、Amazon Bedrock、Google Cloud、Microsoft Foundry |
| 模型 | Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2 |
| 使用方式 | 终端里交互运行 claude;-p、Agent SDK、VS Code 插件、桌面版、云端会话都不支持 |
| 组织 | 没有启用 HIPAA 配置或零数据保留 |
| Windows | 需要安装 Git for Windows |
另外,开着 OpenTelemetry 导出、设了 DISABLE_TELEMETRY 时也启动不了。
怎么开(官方直连账号)
运行
claude --version,低于 2.1.323 就先claude update。带上开关启动:
macOS / Linux:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claudeWindows PowerShell:
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1" claude想每次都开,写进
~/.claude/settings.json的env(项目里的 settings 文件写了不生效):{ "env": { "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1" } }第一次会弹出确认,选 Yes, turn on Code Mode。启动后顶部出现下面这行就说明开好了:
Code Mode (experimental) is on · this session can be resumed only with Code Mode on
关闭:把这个变量删掉,或改成 0,再开新会话。注意 Code Mode 下开的会话,之后也只能在开着 Code Mode 时用 claude --continue / --resume 恢复。
用中转 API(包括久连 9Link)能开吗?
**不能。**我们在 Claude Code v2.1.327、Opus 5.5 上实测:settings.json 里设了 ANTHROPIC_BASE_URL 指向第三方地址,带上 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 启动,客户端直接提示:
⚠ Code Mode (experimental) isn't available: for now it only works directly with
the Anthropic API (not through a cloud provider such as Bedrock, a gateway or
another address in ANTHROPIC_BASE_URL). Starting with the ordinary tools.
原因:
- 是客户端在本地判断的。Claude Code 启动时只看请求发往哪里(
ANTHROPIC_BASE_URL)、用什么身份登录(ANTHROPIC_AUTH_TOKEN),不满足就不开,请求根本没发出去。中转背后接的是不是官方账号,客户端不知道,也不看。 - 所以中转服务器做什么都没用。不管哪家中转,只要你用
ANTHROPIC_BASE_URL接入,结果都一样。
不建议用改 hosts、中间人代理等方式伪装成直连:这是在绕开官方限制,违反使用条款。
两种用法可以同时保留:日常用中转,想试 Code Mode 时用你自己的官方账号单独开一套配置,互不影响:
# 第一次运行后在里面输入 /login,用你自己的 Claude 订阅或 Console 账号登录
CLAUDE_CONFIG_DIR="$HOME/.claude-official" CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
这个目录里没有中转的地址和 Key,所以会直连官方;平时直接运行 claude 仍然走原来的中转配置。
「isn't available」常见原因对照
启动时出现 Code Mode (experimental) isn't available,原因就写在同一行,/status 里也能看到:
| 提示里包含 | 怎么办 |
|---|---|
only works directly with the Anthropic API |
去掉网关、云厂商或自定义 ANTHROPIC_BASE_URL 的设置(用中转时无解,见上一节) |
doesn't work with an API key helper |
去掉 apiKeyHelper、ANTHROPIC_AUTH_TOKEN,改用 /login 或 ANTHROPIC_API_KEY |
only works with Opus 5.5, Sonnet 5.5 and later models |
换成支持的模型,例如 --model opus |
isn't open to your account yet |
先升级到 v2.1.323 以上;已经是新版就过几天再试(官方在分批开放) |
needs settings that Claude Code downloads from Anthropic |
去掉 DISABLE_TELEMETRY 这类关闭功能开关下载的变量 |
OpenTelemetry is on |
不需要时去掉 CLAUDE_CODE_ENABLE_TELEMETRY |
doesn't work in background jobs |
在前台交互启动,不要带 --remote-control |
your organization's settings don't allow it |
组织管理员在托管设置里把它关了,找管理员 |
常见问题
Code Mode 真的能省 37% 的 token 吗?
网上流传的「省 37%」来自 Anthropic 2025 年介绍 API 端 Programmatic Tool Calling 的文章,不是 Code Mode 的官方数据。Anthropic 目前没有公布 Code Mode 的节省比例。它的思路确实能少读一些中间结果,但具体省多少要看任务。
Code Mode 和 API 的 Programmatic Tool Calling 是一回事吗?
不是。Code Mode 是 Claude Code 客户端的功能,代码在你本机的会话里运行;Programmatic Tool Calling 是 Claude API 的服务端功能,代码在 Anthropic 的代码执行环境里运行。
开了 Code Mode 会更危险吗?
每次工具调用仍然走你设置的 deny / ask 权限规则和 PreToolUse hook。区别在 auto 模式:分类器审的是整段代码,而不是每一次调用,运行时才算出来的值(比如从搜索结果里取出的路径)它看不到。要严格管住的操作,继续用权限规则或 hook。
中转以后会支持吗?
取决于 Anthropic。官方把它标为实验功能,可能调整或移除。如果以后放开网关,用中转的用户只需要加上 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 即可,久连 9Link 这边不需要改配置。
相关
最后更新:2026-11-18