Claude Code 推出实验性 Code Mode:Claude 写 JavaScript 串联工具,长命令运行中也能作答
北京时间 11 月 18 日凌晨(11 月 17 日 21:18 UTC),Anthropic 面向开发者的官方 X 账号 @ClaudeDevs 宣布 Claude Code 上线实验性的 Code Mode:一种与工具协作的新方式。官方称,Claude 在该模式下自己编写脚本,把用户的工具以复杂方式串联起来,并在长命令仍在运行时向用户作答;开启方式是设置环境变量 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1。
帖文附带的官方文档写明了机制:Code Mode 下 Claude 写一段 JavaScript 来完成工具调用,由 Claude Code 在用户的会话里运行这段代码。文档同时列明版本、模型、账户等硬性条件。
从逐个调用工具,到写一段 JavaScript
官方文档解释了差异所在:没有 Code Mode 时,Claude 直接逐个请求 Bash、Read、Edit 等工具调用,读完每个结果再决定下一步;开启后,一段代码就能并行跑命令、把上一步的结果用在下一步,并且只把 Claude 需要读的那部分输出返回给模型。
文档给了一个「提高重试上限」的示例:Claude 先用 rg 在 src 目录里定位 retryPolicy 所在文件,取第一个结果,调用 edit 把 maxAttempts 从 3 改成 5,再跑 npm test,最后一行把文件路径和测试输出交回给 Claude:
会话界面里出现的仍是工具调用本身(比如 edit 的 diff,即改动差异),而不是这段代码;按 Ctrl+O 打开 transcript viewer(会话记录查看器),才能看到每段被折叠的 Code 行。文档建议在三类任务上尝试 Code Mode:同一改动要重复落到很多文件、搜索结果需要过滤后再读、几条互不依赖的命令可以同时跑。
等待还是后台:长命令的两种运行方式
官宣帖承诺长命令仍在运行时也能向用户作答,文档把这一点拆成两种情况:等待模式下,Claude 在代码跑完后才作答,代码在 10 分钟后被强制停止,计时还包括用户停在权限确认上的时间;后台模式下,用户可以继续和 Claude 对话,代码最多运行 2 小时。要用后台模式,会话必须以 auto 或 bypassPermissions 权限模式启动。
并发也有边界:auto 模式下,如果 Claude 在前一段代码仍在运行时又启动新代码,前一段代码会失去分类器审查,Claude Code 会就其中仍需审查的调用弹出确认并显示倒计时,界面提示「Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session」(中文大意:倒计时结束后将自动拒绝该请求,以免无人值守的会话被卡住)。倒计时走完仍未回答,这次调用会被拒绝,此后同类调用不再提示、直接拒绝。
有开发者第一时间欢迎了这个能力。Hudson Griffith 留言说:「早就在试了。长命令跑到一半还能回复,这就是梦寐以求的状态。」
开启门槛:v2.1.323 以上、四款模型、仅限终端
版本要求 Claude Code v2.1.323 或更高;模型限定 Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.2;账户须为 Claude 订阅或 Console 账户,不能经由网关、Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用;所在组织未启用 HIPAA 配置或零数据保留。
入口同样受限:Code Mode 只在终端的交互式 claude 会话里工作,不支持 -p 模式、Agent SDK、VS Code 面板、Desktop 应用和云会话;安装须为原生构建版本,Windows 还需装好 Git for Windows。另有一些设置会直接阻止启动,包括 API key helper、agent teams、OpenTelemetry 导出和 DISABLE_TELEMETRY。
开关的规则也写进了文档:关闭时需从 shell 和 ~/.claude/settings.json 中移除该变量或将其置 0;恢复 Code Mode 会话必须保持变量为 1,否则 Claude Code 拒绝恢复,而未开启时启动的会话即使设了变量也不会进入 Code Mode。组织管理员可以在 managed settings(组织统一管理的设置)里把该变量设为 0,阻止组织内所有人使用;反过来,管理员无法用它替用户强行开启。
权限检查仍在,审查对象从单次调用变成整段代码
代码里的每次工具调用仍要通过用户的 deny(禁止)、ask(询问)权限规则和 PreToolUse 钩子,用户不需要为 Bash 之类的工具改规则。变化在 auto 模式:分类器审查的是每段代码本身,而不是其中每一次调用,而且它看不到运行时才算出来的值,比如从搜索结果里取到的一个路径。文档因此提醒,对必须严格控制的调用,保留规则或钩子。
想审查代码本身的团队,可以写一个匹配 REPL(Code Mode 中运行 Claude 所写代码的工具)的 PreToolUse 钩子,从 tool_input.code 里读出 JavaScript。文档还留了一句注脚:Bash 规则匹配的是命令文本,无论是否开启 Code Mode,Claude 都可能用规则匹配不到的形式运行被禁命令,不依赖命令文本的限制要靠 sandboxing(沙箱)。此外,Code Mode 会话中无法使用 Remote Control、Claude in Chrome 和 computer use,会话也不能转入 Desktop 应用或后台会话,/fork 无法启动后台副本。
官宣之前,已有人提前两天晒出实测
部分用户比官方账号更早谈论 Code Mode。11 月 15 日,开发者 Daniel San(@dani_avila7)发帖称,Code Mode 已在 Claude Code 2.1.325 中实验性可用,并用 Fable 5.2 做了测试:让 Claude 查找 Markdown 文件里的失效链接,据他的描述,Claude 在 2 轮模型交互里执行了 13 次工具调用,正确找出全部 3 个失效链接;按 Ctrl+O 可以看到生成的 JavaScript,权限和钩子仍然生效。官宣之后,他在帖文下回复:「几天前我就发过 Code Mode 了……抱歉,实在没忍住。」
并非所有早期体验者都买账。用户 @fernandoeeu_dev 称用 Fable 测了约 30 分钟,结果与不开启 Code Mode 时差不多,他怀疑实现把全部输出塞回了主上下文窗口,抵消了性能收益。也有人认为做法并不新鲜:David Montgomery(@_DMontgomery40)留言说,自己通过 MCP(Model Context Protocol,模型上下文协议)方案使用 code mode 已超过一年,在他看来这次的区别只是 Anthropic 把它整合进了 Claude Code 本体。
Agent SDK 与桌面应用的支持还悬着
官宣帖的回复区里,被反复问到的两件事是桌面应用支持和 Agent SDK。官宣不到两小时后,t3dotcodes 的 CEO Theo(@theo,粉丝超过 43 万)喊话:「能不能请你们把它开放给 Agent SDK。」而文档的答案目前是否定的:Code Mode 不能配合 Agent SDK、VS Code 面板、Desktop 应用或云会话使用。
文档对功能状态的完整表述是:实验性、默认关闭、可能在任何版本中更改或移除,反馈通过 /feedback 提交。官方帖文与文档都没有给出这一限制何时解除、功能何时转正的时间表。