MemoryLake
返回全部文章
News2026 年 11 月 18 日·12 分钟阅读

Claude Code 中的 Code Mode 是什么?Claude 从运行的代码中读取什么,为什么 Code Mode 会话只能在开启 Code Mode 的情况下恢复,以及哪些钩子可以拦截它 (2026)

你在 Claude Code 中开启了 Code Mode 来尝试一项清理任务,效果非常好:Claude 找到了每一个调用点,进行了编辑,并看似在一个步骤中运行了测试。第二天早上,你从一个新的终端运行 claude --resume 准备继续工作,结果 Claude Code 拒绝打开该会话。对话记录没有任何问题,你只是在启动新终端时没有设置环境变量。

这种行为是有文档记录的。Anthropic 关于该功能的页面指出:“在关闭 Code Mode 的情况下,Claude Code 拒绝恢复该会话。”这是决定 Code Mode 如何融入长期工作的几个细节之一,此外还包括 Claude 在代码运行后实际读取的内容,以及哪些钩子可以阻止它。

Anthropic 的 Claude Code 开发者账号在 11 月 17 日宣布了 Code Mode。本指南涵盖了 Code Mode 的定义、Claude 读取内容的变化、如何开启和关闭、为什么会话与其绑定、权限和钩子如何应用、它目前无法实现的功能,以及如何防止长期任务的上下文依赖于单个会话的启动方式。

什么是 Code Mode

Anthropic 的文档用两句话描述了其中的区别。“在没有 Code Mode 的情况下,Claude 直接请求 Bash、Read 或 Edit 等工具调用,并在决定下一步操作之前读取每个结果。在开启 Code Mode 的情况下,Claude 会编写一段执行工具调用的 JavaScript 代码,而 Claude Code 会在你的会话中运行该代码。”

该功能带有一个明确的警告:“Code Mode 是实验性的,默认关闭。它可能会在任何版本中更改或移除。”

文档建议在需要进行多次相关工具调用的任务中尝试使用它:

  • 跨多个文件重复的更改。
  • 搜索结果在 Claude 读取之前需要进行过滤。
  • 可以同时运行的几个独立命令。

早期的文章(如 developersdigest 的演练)解释了如何开启它。对于长期工作而言,真正重要的是 Claude 读取回来的内容,以及随后会话会发生什么。

Claude 从运行的代码中读取什么

这是 Code Mode 中改变 Claude 上下文内容的部分。

在正常操作中,每个工具调用的结果都会在下一次决策前返回给 Claude。在 Code Mode 下,文档称:“一段代码可以并行运行命令,在下一次调用中使用前一个结果,并返回 Claude 需要读取的那部分输出。”

文档中的示例是一个提高重试限制的请求。Claude 编写代码搜索该函数,编辑第一个匹配的文件,运行相关测试,并返回文件路径和测试输出。在这个例子中,搜索输出在代码内部被用于选择文件,而不是单独返回给 Claude。

这种设计带来了三个结果:

  • Claude 选择它读取的内容。 代码的最后一行决定了返回的内容。中间结果可以保留在脚本内部。
  • 过滤发生在读取之前。 拥有数百个匹配项的搜索可以在任何内容到达对话之前在代码中进行缩小范围。
  • 记录存在于两个地方。 你在对话中看到工具调用,而代码本身在对话记录(transcript)中。

文档描述了你所看到的画面:“在对话中,你会看到工具调用(例如编辑的 diff),而不是代码。”要阅读代码,请按 Ctrl+O 打开对话记录查看器,每段代码都会显示为一个折叠的 Code 行。我们在 Claude Code 的对话记录视图 指南中介绍了该查看器显示的内容及其视图差异。

实际后果是,Claude 在一个步骤后了解到的信息取决于代码返回的内容。如果后续问题需要代码过滤掉的细节,Claude 可能需要重新查看。

如何开启 Code Mode

设置过程很短,但每一步都有值得了解的细节。

检查你的版本。 Code Mode 需要 Claude Code v2.1.323 或更高版本,无论哪个发布频道。旧版本启动时不会带有 Code Mode。

设置环境变量。 Code Mode 由 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 控制。在你的 shell 中将其设置为 1 以进行尝试,或者在用户设置文件的 env 块中设置它,以便为每个新会话开启它。

这里有一个安全细节。文档称 Claude Code 会忽略项目设置文件中的此变量,“因此你克隆的仓库无法为你开启 Code Mode。”只有你的 shell 和用户设置才有效。

确认一次。 在你的第一个 Code Mode 会话之前,Claude Code 会要求你确认。选择开启选项后,Claude Code 会重启,并在会话顶部附近显示一行字,说明 Code Mode 已开启,且该会话只能在开启 Code Mode 的情况下恢复。

尝试一个包含多次工具调用的任务。 文档中的示例提示词要求 Claude 读取项目中的每个 Markdown 文件,并列出指向不存在的本地文件的链接。

为什么 Code Mode 会话只能在开启 Code Mode 的情况下恢复

这就是开头示例背后的细节。

文档包含一个警告:“要在以后恢复 Code Mode 会话,请在运行 claude --continue 或 claude --resume 时保持 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 设置为 1。在关闭 Code Mode 的情况下,Claude Code 拒绝恢复该会话。”

反之亦然:“你在没有 Code Mode 的情况下启动的会话,即使设置了该变量,也会在没有 Code Mode 的情况下恢复。”

因此,模式在会话开始时就固定了。这对于长期工作有几个影响:

  • 在始终能访问的地方设置变量。 如果你只在一个 shell 中设置它,新终端将不会拥有它。用户设置文件是更可靠的地方。
  • 关闭它会影响旧会话。 如果你删除了该变量,你的 Code Mode 会话在重新设置之前将无法恢复。
  • 你无法转换会话。 在没有 Code Mode 的情况下启动的会话将保持该状态。

限制列表还补充了关于 Code Mode 会话去向的更多信息。你只能在终端中恢复它。你不能将其移动到桌面应用或将其转为后台会话,且 /fork 无法启动后台副本。

如何关闭它,以及组织如何拦截它

要关闭 Code Mode,请从 shell 和用户设置中删除该变量,然后启动新会话。你也可以将其设置为 0。文档称:“如果在一个地方设置为 0,即使在另一个地方设置为 1,Code Mode 也会保持关闭。”

管理员可以通过在托管设置中将变量设置为 0 来为所有人拦截它。文档描述了用户的体验:“处于 Code Mode 会话中的用户将保持在该会话中,直到退出或重启 Claude Code。之后,你的用户将在没有 Code Mode 的情况下启动,并且在 0 设置生效期间无法恢复其 Code Mode 会话。”

反向操作不可用:“你无法通过托管设置开启用户的 Code Mode。”

如果你的组织在你使用 Code Mode 后拦截了它,你之前在 Code Mode 中启动的会话将无法恢复,直到拦截解除。

权限如何应用于代码

代码不会绕过你的规则。文档称,当 Claude 运行代码时,其中的每个工具调用都会经过你的 deny 和 ask 权限规则,以及对应工具通常名称(如 Bash)下的 PreToolUse 钩子。

变化之处在于你所处的模式如何审查工作:

  • 在 auto 模式下, 分类器在每段代码运行前进行审查,而不是针对每个工具调用。文档增加了一个提醒:“它看不到运行时计算的值,例如从搜索输出中获取的路径,因此请为必须控制的调用保留规则或钩子。”
  • 在其他权限模式下, 代码在没有审查的情况下开始运行,系统会针对在该模式下会提示你的每个工具调用向你发出提示。

文档还警告了命令匹配问题。在名为 app 的文件夹中执行 git push 可能会作为一个先更改目录的组合命令到达你的钩子,因此允许或拦截 shell 命令的 PreToolUse 钩子应该检查命令的每个部分。要检查代码本身,你可以编写一个匹配 REPL(运行代码的工具)的 PreToolUse 钩子,并从 tool_input.code 中读取 JavaScript。

哪些钩子可以拦截它

钩子也可以停止 Code Mode 中的工作,文档列出了两种情况。

失败的 PreToolUse 钩子。 如果 Claude 报告工具调用被拒绝,错误文本会告诉你原因。文档描述了两种消息:钩子失败(意味着它无法启动、被终止或以特定代码退出)以及钩子未完成(意味着它超时了)。在这两种情况下,即使未设置 onFailure,调用也会被拒绝。要让调用在钩子失败或超时时继续进行,文档建议将 onFailure 设置为 continue。

看到代码输出的 UserPromptSubmit 钩子。 当代码可以在后台运行时,文档称该事件上的 command、http 和 mcp_tool 钩子也会在代码输出时运行。如果其中一个拦截,Claude 会在你预期看到输出的地方报告钩子的拦截原因。解决方法是当输入中的 source 为 poll_event 时让钩子通过。

如果你使用 UserPromptSubmit 钩子来添加上下文或过滤到达 Claude 的内容,这第二种情况就很重要。在 Code Mode 下,同一个钩子可以看到比你的提示词更多的内容。我们在 Claude Code 钩子 指南中介绍了哪些钩子可以为 Claude 添加上下文,以及它们的输出在不同会话中如何表现。

关于插件的补充说明。文档的故障排除表将检查工具调用的已安装 mod 列为 Code Mode 无法启动的原因。Claude Code 的 v2.1.327 变更日志称,当安装的 mod 挂载工具调用时,Code Mode 不再拒绝启动,但管理员仍可以在托管设置中保持其关闭。如果你看到旧的消息,请检查你的版本。

长时间运行的代码

运行长时间构建或测试的代码要么让 Claude 等待,要么在后台运行。

  • 等待: Claude 在代码完成后回答,代码在十分钟后停止,包括你在权限提示处花费的时间。
  • 后台: 你可以继续与 Claude 交谈,代码最多可以运行两个小时。

对于后台代码,文档建议在 auto 或 bypassPermissions 模式下启动会话。

Code Mode 目前无法实现的功能

要求和限制非常具体,它们决定了 Code Mode 是否适合你的环境。

  • 界面: 终端中的交互式 claude 会话。文档称它不适用于 -p、Agent SDK、VS Code 面板、桌面应用或云端会话。
  • 账号和提供商: Claude 订阅或 Console 账号。它无法通过网关或 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform 或 Microsoft Foundry 等平台工作。
  • 组织设置: 不适用于 HIPAA 配置或零数据保留(zero data retention)。
  • 模型: Claude Opus 5.5、Sonnet 5.5、Haiku 5.5 或 Fable 5.2。
  • 功能: 你无法使用远程控制(Remote Control)、Chrome 中的 Claude 或计算机使用(computer use)。
  • Agent 团队: 从 v2.1.326 开始支持,团队成员在默认的进程内显示模式下以 Code Mode 运行。

如果 Code Mode 无法启动,Claude Code 会显示一行字说明它不可用及原因,/status 也会显示这一点。

人们首先尝试的操作

在没有变量的情况下从终端恢复。 Claude Code 拒绝在关闭 Code Mode 的情况下恢复 Code Mode 会话。

在项目设置中开启它。 Claude Code 会忽略那里的变量。

期望 Claude 记住代码触及的所有内容。 Claude 只读取代码返回的内容。

假设失败的钩子会让调用通过。 在 Code Mode 下,失败或超时的钩子会拒绝调用,除非你将 onFailure 设置为 continue。

解决方案:让 Code Mode 会话易于继续

第 1 步:在用户设置中设置变量

将 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 放入 ~/.claude/settings.json 的 env 块中,这样每个终端都能以相同的方式恢复。

第 2 步:检查你的钩子

检查 PreToolUse 钩子的超时和失败处理,并让 UserPromptSubmit 钩子在 poll_event 时通过。

第 3 步:要求输出你稍后需要的细节

当某个步骤很重要时,要求 Claude 返回你想要参考的细节,而不仅仅是一个摘要。

第 4 步:记录任务的决定

将长时间 Code Mode 会话的结论记录在不依赖于恢复该会话的某个地方。

在 MemoryLake 中设置

Code Mode 会话保存了 Claude 在工作时学到的内容,但前提是你能够以相同的设置再次打开它。这些工作的结论——例如哪些文件负责某种行为、重构为什么停在那里,或者哪些测试保护了某项更改——是项目上下文,不应依赖于单个会话的设置。

MemoryLake 是此类项目上下文(如决策、规范及其背后的原因)的记忆层,保存在你维护的一个地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

你用自己的语言编写条目。不会从你的 Claude Code 会话、对话记录、设置文件、钩子、CLAUDE.md 文件或任何供应商的存储中读取、写入或删除任何内容。Code Mode 按照 Anthropic 描述的方式工作。

第 1 步:创建 API 密钥

登录并从控制面板生成密钥。像对待任何其他凭据一样,将其存储在仓库之外。

The MemoryLake console showing the API keys screen, where a new key is created and copied for use in an agent
The MemoryLake console showing the API keys screen, where a new key is created and copied for use in an agent

第 2 步:上传你的第一条记忆

从你在解决方案第 4 步中写下的内容开始:后续会话应该开始的结论。每个条目一个决策。

The MemoryLake workspace with the first documents uploaded, listing each file as it becomes searchable memory
The MemoryLake workspace with the first documents uploaded, listing each file as it becomes searchable memory

第 3 步:连接你的 AI 和智能体

连接 Claude Code、Codex 和你使用的其他助手。无论是否处于 Code Mode,新会话都可以利用相同的决策。

The MemoryLake integrations screen listing the AI clients and agent frameworks that can be connected to the memory layer
The MemoryLake integrations screen listing the AI clients and agent frameworks that can be connected to the memory layer

这在实践中改变了什么

第一个区别是减少了对恢复会话的依赖。如果会话无法打开,结论仍然可用。

第二个是更简洁的上下文。Claude 读取代码返回的内容,而你需要的决策来自简短的条目,而不是冗长的历史记录。

Code Mode 的最佳实践

将其用于多次相关的工具调用。 重复编辑、过滤搜索和并行命令最适合。

将变量保留在用户设置中。 这使得恢复会话变得可预测。

使用 Ctrl+O 阅读代码。 对话显示的是工具调用,而不是代码。

为必须控制的调用保留规则。 在 auto 模式下,分类器审查的是代码,而不是运行时数值。

检查钩子失败行为。 失败或缓慢的 PreToolUse 钩子会拒绝调用。

写下结论。 不要依赖恢复单个会话来找回它们。

结论

Code Mode 让 Claude 能够编写 JavaScript,在一个步骤中执行多次工具调用,并且 Claude 只读取代码返回的那部分输出。它是实验性的,默认关闭,且仅限于较新模型上的交互式终端会话,最低版本要求为 v2.1.323。

模式在会话开始时固定。Code Mode 会话仅在设置了变量的情况下恢复,在没有变量的情况下启动的会话将保持原样,而组织范围的拦截会使之前的 Code Mode 会话无法恢复。权限规则和 PreToolUse 钩子仍然适用于每次调用,失败或超时的钩子会拒绝调用。请将变量保留在用户设置中,检查你的钩子,并写下长会话得出的结论。

常见问题

Claude Code 中的 Code Mode 是什么?

这是一个实验性功能,Claude 可以编写 JavaScript 在一个步骤中执行多次工具调用,而 Claude Code 会在你的会话中运行该代码。

如何开启 Code Mode?

在 Claude Code v2.1.323 或更高版本中,在你的 shell 或用户设置中将 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE 设置为 1,并在提示时确认。

为什么我无法恢复我的 Code Mode 会话?

Claude Code 拒绝在关闭 Code Mode 的情况下恢复 Code Mode 会话。在运行 claude --resume 之前,请将变量设置为 1。

项目可以开启 Code Mode 吗?

不可以。Claude Code 会忽略项目设置文件中的该变量。

我在哪里可以看到 Claude 编写的代码?

按 Ctrl+O 打开对话记录查看器并展开 Code 行。

权限规则在 Code Mode 中适用吗?

适用。代码中的每个工具调用都会经过你的 deny 和 ask 规则以及 PreToolUse 钩子。

Code Mode 在 VS Code 或桌面应用中可以使用吗?

不可以。它仅适用于终端中的交互式 claude 会话。