Claude Code 推出 Code Mode 实验功能,让 Claude 用 JavaScript 批量调用工具
来源标题:Run tool calls from code with Code Mode
Claude Code 上线实验性的 Code Mode,Claude 可编写一段 JavaScript 一次性完成多个工具调用,比如批量改文件或并行执行命令。对话中默认只显示工具调用结果而非代码,按 Ctrl+O 可在 transcript viewer 中展开查看。该功能适合跨多文件重复修改、需先过滤搜索结果等场景,但恢复会话仅限终端且需开启 Code Mode。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
试试 Code Mode,这是一项实验性功能,Claude 会在其中编写 JavaScript,一步完成多次工具调用。
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,而不是代码。要查看代码,按 Ctrl+O 打开会话记录查看器。每段代码在那里显示为一行折叠的 Code,并附有如何展开它的提示。
何时使用 Code Mode
在需要大量相关工具调用的任务上试试 Code Mode,例如:
- 跨多个文件的重复性修改
- 搜索结果需要在 Claude 读取之前进行过滤的搜索
- 若干可以同时运行的独立命令
Code Mode 的限制
在开启 Code Mode 之前,请确认你能接受以下限制:
- 恢复会话:只能在终端中、且在 Code Mode 开启的情况下恢复 Code Mode 会话
- 自动模式:自动模式的分类器审查的是代码,而不是每一次工具调用
- 长时间运行的代码:除非代码能在后台运行,否则你需要等待它完成,且它会在十分钟后停止
- Hooks:当 PreToolUse hook 无法运行或超时时,你会看到工具调用被拒绝;被 UserPromptSubmit hook 阻止的代码输出也会显示出来
- 不可用的功能:你无法使用 Remote Control、Claude in Chrome 或 computer use
- 移动会话:你无法将会话移到 Desktop 应用,也无法将其转为后台会话,且 /fork 无法启动后台副本
要求
- 版本:Claude Code v2.1.323 或更高版本,两个发布渠道均可。较旧的版本启动时不带 Code Mode,无论是否说明你的账户尚未开放该功能
- 账户:Claude 订阅或 Console 账户。你无法通过网关、Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 或 Microsoft Foundry 使用 Code Mode
- 组织:你的组织未使用 HIPAA 配置或零数据保留
- 模型:Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.2
- 界面:终端中的交互式 claude 会话。Code Mode 不适用于 -p、Agent SDK、VS Code 面板、Desktop 应用或云会话
- 安装方式:Claude Code 的原生构建版本
- Windows:已安装 Git for Windows
在某些设置开启的情况下,你也无法启动 Code Mode,例如 API key helper、agent teams、OpenTelemetry export 或 DISABLE_TELEMETRY。各项的修复方法见「Code Mode 无法启动」。
试用 Code Mode
开启 Code Mode,给 Claude 一个任务,然后查看 Claude 编写的代码。
1 检查你的版本 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude $env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1" claude 将此 env 块保存到 ~/.claude/settings.json 并启动 claude: "env": { "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1" Claude Code 会忽略项目设置文件中的此变量,因此你克隆的仓库无法替你开启 Code Mode。
3 确认你要使用 Code Mode Code Mode (experimental) is on · this session can be resumed only with Code Mode on 如果你看到的是不同的行或什么都没有,请参阅「Code Mode 无法启动」。
4 给 Claude 一个包含大量工具调用的任务 读取此项目中的每个 Markdown 文件,并列出指向不存在的本地文件的链接。
5 阅读 Claude 编写的代码 "env": { "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0" 处于 Code Mode 会话中的用户会一直留在其中,直到退出或重启 Claude Code。此后,你的用户将在没有 Code Mode 的情况下启动,且在 0 保持不变期间无法恢复他们的 Code Mode 会话。你无法通过托管设置替你的用户开启 Code Mode。
权限与长时间运行的代码
你的权限模式决定了 Claude 的代码如何被检查,以及代码运行期间你能否与 Claude 对话。
权限检查
Claude 代码发起的每次工具调用都会经过你的拒绝和询问权限规则以及你的 PreToolUse hooks。你无需为 Bash 这类工具更改规则或匹配器。除规则和 hooks 之外,分类器会在自动模式下审查代码,而在会询问的模式下由你回答提示:
- 自动模式:分类器在每段代码运行之前审查该代码,而不是每一次工具调用。它看不到运行时计算出的值,例如从搜索结果中取得的路径,因此对于必须控制的调用,请保留规则或 hooks。当前面的代码仍在运行时启动了新代码,你仍可能会收到提示
- 其他权限模式:代码启动时不经审查,而每次在该模式下会向你提示的工具调用都会向你提示
要检查代码本身,请编写一个匹配 REPL(运行 Claude 代码的工具)的 PreToolUse hook,并从 tool_input.code 读取 JavaScript。
Bash 规则匹配命令文本,因此 Claude 可以以规则不匹配的形式运行被拒绝的命令,无论是否使用 Code Mode。对于不依赖命令文本的限制,请参阅 sandboxing。
长时间运行的代码
当代码运行长时间的构建或测试时,Claude 要么等待它,要么让它在后台继续:
- 等待:Claude 在代码完成后回答,代码会在十分钟后停止,包括你在权限提示上花费的时间
- 后台:你可以继续与 Claude 对话,代码最多可运行两小时
对于后台代码,请在 auto 或 bypassPermissions 模式下启动会话。如果 Claude 仍在等待,请检查你当前的模式以及你是如何启动会话的:
- 你切换到了其他模式:按 Shift+Tab,直到回到你启动时的模式
- 你在其他模式下启动,或从 claude --resume 列表中选择会话:如果自动模式对你可用,请退出,然后在 Code Mode 开启的情况下运行 claude --continue --permission-mode auto
- 你向 --tools 传入了工具名称:在自动模式下重新启动,不带该标志
故障排除
Code Mode 无法启动
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。