Claude Code Code Mode 教程:JS链式调用省55%上下文
Anthropic 为 Claude Code 推出实验性 Code Mode(v2.1.323+),允许通过 JavaScript 链式并发调用工具,实测工具上下文直降 55%。附开启方法、限制清单与 Deadweight 审计教程。
目录 · 9 节
Claude Code Code Mode 实战教程:JS 链式工具调用 + Deadweight 省 Token 指南
用过 Claude Code 处理跨文件重构的开发者都有同感:每改一个文件、查一次目录、跑一次测试,模型都要单独发起一轮 Bash、Read 或 Edit 工具调用,来回吞吐大量上下文。2026 年 11 月 19 日,Dataconomy 披露 Anthropic 已在 Claude Code v2.1.323 及以上版本悄然上线了实验性的 Code Mode(代码模式)——允许 Claude 直接编写一段 JavaScript 在当前会话里并行串联多次工具调用,只把最终过滤后的结果返回给模型。
独立实测显示,开启 Code Mode 后,Claude Code 的系统工具上下文开销从 24,600 tokens 降至 11,100 tokens(降幅约 55%)Dataconomy。再搭配同日开源的上下文冗余审计工具 Deadweight Emergent,你可以把日常编程的 Token 账单压下一大截。
一、前置条件与适用边界(开之前先看限制)
Code Mode 目前属于实验性功能(Opt-in),必须满足以下全部前置条件(以官方最新文档为准)Dataconomy:
- 客户端版本:原生构建的 Claude Code
v2.1.323及以上(若配合 Agent Teams 需v2.1.326+,Windows 端需安装 Git for Windows); - 支持模型:
Claude Opus 5.5、Sonnet 5.5、Haiku 5.5与Fable 5.2; - 账号与接口:仅支持 Claude 个人/团队订阅或 Anthropic Console 账户,且仅限交互式终端会话(Interactive Terminal)。
以下场景明确不支持 Code Mode:
- 不支持无头模式
claude -p、Agent SDK、VS Code 插件面板、桌面端 App 或云端会话; - 不支持第三方云网关或托管平台(Amazon Bedrock、Google Cloud Vertex、Microsoft Foundry、Claude Platform on AWS 均不可用);
- 不支持 HIPAA 合规配置、Zero Data Retention(零数据留存)、
API key helper、OpenTelemetry 导出、DISABLE_TELEMETRY,以及 Remote Control / Claude in Chrome / Computer Use。
二、分步骤操作:开启 Code Mode 并配合 Deadweight 瘦身
步骤 1:检查版本并开启环境变量
先确认你的原生 Claude Code 版本号:
claude --version
方式 A(临时在当前 Shell 启用):
export CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1
claude
方式 B(写入 ~/.claude/settings.json 持久化开启):
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
}
}
首次开启时,Claude Code 会弹出确认提示,确认后自动重启会话并显示 Code Mode 已激活。注意优先级规则:只要任意配置层级将 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 设为 0,都会强制关闭该功能,哪怕其他地方写成了 1;企业管理员也可以通过托管策略禁用它 Dataconomy。
步骤 2:在合适的任务中发挥并发优势
Code Mode 最适合以下三类场景:
- 跨多文件重复性修改:用 JS 循环批量读取并替换几十个文件中的旧 API 签名;
- 先过滤再读结果的大规模检索:在 JS 沙盒里先对
grep或测试日志做聚合筛选,只把命中行返回给上下文,避免上千行无用日志撑爆窗口; - 互不依赖的并发检查:同时执行类型检查、Lint 与单测命令。
步骤 3:用开源工具 Deadweight 扫描配置冗余(11 月 19 日新发布)
光靠 Code Mode 压缩工具调用还不够,很多团队在发第一句话之前,就已经因为 .cursorrules、过长 CLAUDE.md 和冗余 MCP Schema 白白烧掉了几千 Token。11 月 19 日开源于 GitHub msertdev 仓库的 Deadweight(MIT 协议)可以在不发任何 API 请求的情况下本地静态核算你的配置开销 Emergent:
# 通过 npm 全局安装或在项目目录运行(也可从 GitHub Releases 下载预编译二进制)
npx deadweight analyze --json
它会将每次请求前的固定开销拆分为 4 个桶:自动载入的工作区文件、自定义指令(如 CLAUDE.md)、MCP 工具 Schema 与扩展注入的系统提示词。早期开发者反馈用它清理掉遗忘的 .cursorrules(高达 4,200 tokens/次)和冗余 MCP 定义(1,800 tokens/次)后,月度账单直接下降 30%–40% Emergent。
三、常见报错与排错指南(Troubleshooting)
-
恢复旧会话(
--resume)时 Code Mode 突然失效- 原因:Claude Code 仅在当前环境依然存在
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1时才会以 Code Mode 恢复历史会话。 - 解决:不要仅靠命令行临时
export,请将该变量写入~/.claude/settings.json的env字段确保每次启动一致。
- 原因:Claude Code 仅在当前环境依然存在
-
Code Mode 执行脚本到一半自动中止(10 分钟超时)
- 原因:Claude 同步等待 JS 脚本返回的最长超时时间为 10 分钟,且你在权限弹窗犹豫确认的时间也算在 10 分钟内。
- 解决:需要长时间跑测试或构建时,请在
auto模式或bypassPermissions模式下启动会话,此时后台任务最长可持续运行 2 小时并支持边跑边继续对话;另外,若在普通权限模式下,每次工具调用仍会逐个弹窗确认(auto模式下则由分类器统一审查整段 JS 程序)Dataconomy。
-
配置了环境变量却提示不支持,或完全没有反应
- 原因:你可能正在通过 AWS Bedrock、Vertex AI、Microsoft Foundry 网关调用,或者使用了
-p管道模式、VS Code 插件侧边栏或开启了DISABLE_TELEMETRY。 - 解决:切换为原生终端
claude命令并直连 Claude 订阅/Console 账户,检查环境变量是否被设为0或被组织管理员策略禁用。
- 原因:你可能正在通过 AWS Bedrock、Vertex AI、Microsoft Foundry 网关调用,或者使用了
常见问题(FAQ)
Q1:Claude Code 的 Code Mode 安全吗?会不会绕过我的 Deny 规则?
JS 脚本内部发起的每一次工具调用,依然受你配置的 deny、ask 规则以及 PreToolUse Hooks 约束;在 auto 模式下,分类器会在执行前审查整段 JavaScript 程序。
Q2:用 AWS Bedrock 或 Google Vertex AI 接 Claude Code 能开 Code Mode 吗?
目前不能。官方限制 Code Mode 仅适用于直接使用 Claude 订阅或 Anthropic Console 账号的原生终端交互会话。
Q3:Deadweight 会把我的源码上传到云端吗?
不会。Deadweight 是纯本地运行的静态命令行分析器,无需配置 API Key 也不会发起网络请求,可安全用于涉密代码库或集成进 CI 预算门禁。
参考来源
转载请注明出处:界智通 · https://www.jieagi.com/aizixun/719.html
暂无评论