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 时也启动不了。

怎么开(官方直连账号)

  1. 运行 claude --version,低于 2.1.323 就先 claude update。

  2. 带上开关启动:

    macOS / Linux:

    CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude
    

    Windows PowerShell:

    $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
    claude
    

    想每次都开,写进 ~/.claude/settings.json 的 env(项目里的 settings 文件写了不生效):

    {
      "env": {
        "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
      }
    }
    
  3. 第一次会弹出确认,选 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