本文内容
Claude Code 开启 Code Mode 后,到底能省多少 token?
从 40 份订单文件里找出付款最多的三位客户,Claude Code 开启 Code Mode 后,输入少了 55,705 个 token。客户名单和排名都一样。坐在终端前等结果的人却多等了一会儿:普通模式耗时 15 秒,Code Mode 耗时 37 秒。Juan Andrés Núñez 的两次终端测试
开启 Code Mode 后,工具调用有什么变化?
Claude 会写一段 JavaScript,在脚本里调用工具,决定哪些结果需要送回模型。以检查 Markdown 链接为例,脚本可以逐个读文件、解析路径,只交回失效链接清单。Claude 拿到清单就能写报告,无须再读一遍每次成功匹配的记录。Anthropic 的 Code Mode 文档
工具读一次文件,算一次调用。模型看过结果、决定下一步,算一轮。脚本可以在一轮里读多个文件。成功匹配的记录留在脚本里,对话就能留出空间继续追问,比如查出哪次提交移动了缺失的文件。如果脚本又把每个文件原样返回,这部分上下文还是会被占用。
普通模式也能通过 Bash 运行脚本。订单测试里,普通模式用的是 Python,两种模式都向模型发了四次请求。按作者的分析,差别主要在于 Code Mode 随请求发送的工具说明更短。如果团队想保留现有的调用方式,也可以用代理压缩过长的工具输出,具体做法见 Caveman 输入压缩评测。
这 55,705 个输入 token 是怎么省下来的?
Núñez 在 2026 年 11 月使用 Claude Code 2.1.323 测试,把 Opus 5.5 的推理强度设为中等,让它汇总 40 个 JSON 文件中的已付款订单,再按实付总额给客户排名。每种模式各跑一次。输入总数包含四次请求里的缓存 token,两次得到的前三名及其顺序完全相同。订单测试设置与会话用量
| 指标 | 关闭 Code Mode | 开启 Code Mode |
|---|---|---|
| 输入 token(含缓存) | 150,364 | 94,659 |
| 输出 token | 1,172 | 1,213 |
| 模型请求数 | 4 | 4 |
| 耗时 | 15 秒 | 37 秒 |
和普通模式相比,输入量减少了 37.0%。缓存读取和新输入的单价不同,输出量还略有上升。给日常任务做预算时,应该算拿到一次正确结果总共花了多少钱。按任务核算成本的方法里也算上了重试开销。
查失效链接的演示,真的把 13 轮缩短到了 2 轮吗?
Daniel San 在 Fable 5.2 上找到全部三处失效的 Markdown 链接。他记录的是两轮模型交互里完成了 13 次工具调用。两个数字出自同一次会话。作者没有给出关闭 Code Mode 时的轮数,拿这组数据还算不出少跑了多少轮。Daniel San 的终端演示
Anthropic 提到的从 150,000 降到 2,000 个 token,出自 2025 年 11 月的模型上下文协议(MCP)示例。智能体把一份会议转录稿从 Google Drive 写入 Salesforce,按需加载用到的工具定义。该示例节省了 98.7%。要看 Claude Code 终端实际跑出来的差别,可以对照上面的订单测试。Anthropic 的 MCP 示例与 token 计算
如何在终端开启 Claude Code 的 Code Mode?
Anthropic 在 2026 年 11 月 12 日发布的 2.1.323 版加入了这项实验功能,默认关闭。使用这个版本或更新版本的原生 Claude Code 命令行客户端,启动交互式会话。在 macOS、Linux 或 WSL 中,第一条命令查看版本,第二条只为本次启动开启 Code Mode。Claude Code 2.1.323 发行说明
claude --version
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude首次启动时确认开启,再看启动提示是否显示已启用。按 Ctrl+O,展开标有 Code 的一行,就能看到实际运行的 JavaScript。如果提示功能不可用,输入 /status 查看原因。先核对账号和客户端。截至 2026 年 11 月 16 日,支持的模型可通过 Claude 直接订阅或 Console 账号使用。经过网关、通过云服务商接入、配置零数据保留或 HIPAA 的组织均不在支持范围内。支持条件与启动故障排查
怎么用自己的 Markdown 文件对比两种模式?
给两种模式同一组文件,也给自己留一份标准答案。漏掉一个失效链接就能少报一行,看起来也会更省 token。下面的小测试专门放了两个容易误判的地方:一个路径中的空格经过 URL 编码,还有一个看似链接的片段其实是行内代码。
在空的测试目录中运行以下命令,创建两个文件。macOS、Linux 和 WSL 均可运行。
printf '# Guide\n' > guide.md
cat > links.md <<'MD'
[Guide](guide.md)
[Install](install.md)
[Release notes](Release%20Notes.md#changes)
`[Example](sample.md)`
MD在这个目录启动新会话。两种模式都用下面这段提示词。
检查 links.md 中指向本地文件的链接。以该文件所在目录为基准解析相对路径,解码 URL 转义,忽略片段标识符和行内代码。每发现一个缺失的目标文件,报告链接所在的源文件行号和解码后的路径。保留所有文件的原始内容。
正确结果有两行。第 2 行指向 install.md,第 3 行指向 Release Notes.md。如果还报了 sample.md,就是把代码示例也算作链接了。这组文件可以反复用来核对结果。上文的耗时和 token 用量来自各自作者的测试。
- 固定代码版本、模型、推理强度和权限。分别启动两个新会话,第一个用
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=0 claude,第二个把值改为1。在每个会话里确认模式。 - 先核对结果是否与预期的两行一致,再打开
/usage,分别记下会话的输入、缓存读取、缓存写入和输出 token 数,并记录耗时和模型请求数。Anthropic 会话用量说明 - 再挑一次真实的文档变更重复测试,轮流让两种模式先跑。如果审核的人还要重新打开文件定位问题,把这段时间也算进去。多用几个 token 写清路径和行号,可能更划算。
哪些任务值得开启 Code Mode?
发布前要读一大批文件,只需要把几处问题交给同事修,我会先拿这种检查试 Code Mode。只要查出的问题一样,实测省下的用量也值得多等这段时间,就把它留给这项任务。只改一个文件时,我会先用普通模式,等记录显示工具调用确实带来了额外开销,再考虑切换。
Claude Code 的 Code Mode 常见问题
如何让我的所有项目默认开启 Code Mode?
~/.claude/settings.json 的 env 中,将 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 设为 "1",再启动新的终端会话。Claude Code 会忽略项目配置里的这个变量。组织管理员可以通过托管设置禁用这项功能。Windows PowerShell 里怎么开启?
$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = '1',接着在同一个窗口中运行 claude。首次启动时确认开启,并检查启动提示。能在 CI 或 VS Code 面板里跑这组测试吗?
claude -p 均不支持 Code Mode。对比两种设置时,都从普通终端启动。关掉 Code Mode 后,还能接着上次的对话聊吗?
0 后另开新会话。一个脚本里有多次工具调用,权限怎么检查?
PreToolUse 钩子。自动模式下,分类器会在执行前检查脚本。届时它还看不到运行时才算出的值,例如搜索返回的文件路径。