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

Codex 计划模式中的“清除上下文并执行”有什么作用?新线程从计划中获取什么,旧聊天中保留什么,以及 11 月 13 日的变化 (2026)

你在 Codex 计划模式中花了 20 分钟。Codex 阅读了半个代码库,向你提了三个澄清性问题,而你成功说服它放弃了一个会触及计费代码的方案。随后计划准备就绪,Codex 询问是否执行。其中一个选项是:是的,清除上下文并执行 (Yes, clear context and implement)。

这听起来是个显而易见的选择:为编码工作提供一个干净的上下文。但它也引出了一个合理的问题。如果上下文被清除了,新线程到底知道什么?它会记得关于计费代码的决定,还是只记得计划本身?

这一点最近发生了变化。OpenAI 变更日志中日期为 11 月 13 日的 Codex CLI 0.169.0 版本说明指出:“‘是的,清除上下文并执行’现在会将完整的已批准计划移交给新会话,并在移交失败时保持当前会话开启。”

本指南涵盖了什么是 Codex 计划模式、计划获批后的三个选择、新线程的起始内容、计划聊天中保留的内容、11 月 13 日发布版本中的变化、计划过大时会发生什么,以及如何确保计划背后的决策在移交后依然有效。

什么是 Codex 计划模式

计划模式是一种工作方式,Codex 在编写代码之前先提出一个计划。OpenAI 的最佳实践指南建议在处理复杂、模糊或难以描述的任务时使用它:“计划模式让 Codex 能够在执行前收集上下文、提出澄清性问题并构建更强大的计划。”

在 Codex CLI 中,你可以使用 /plan 将当前聊天切换到计划模式,后面可以选填初始计划请求。同样的指南指出,你可以通过 /plan 或 Shift+Tab 进行切换。当 Codex 已经在工作时,/plan 暂时不可用。

你还可以为计划模式设置专门的推理级别。配置参考将 plan_mode_reasoning_effort 描述为“使用所选模型支持的级别进行计划模式特定的推理覆盖”。未设置时,计划模式使用其内置默认值。

计划模式与目标模式不同。目标模式是在 Codex 工作期间将一个目标挂载到聊天中,我们在什么是 Codex 目标模式指南中介绍过。而计划模式的核心是先就方案达成一致。

Codex 中其他的计划方式

计划模式并非 OpenAI 描述的唯一选择。其最佳实践指南列出了针对需要计划的工作的三种方法。

第一种是计划模式本身。第二种是让 Codex 采访你:如果你有一个粗略的想法但不确定如何描述,先让 Codex 询问你、挑战你的假设,并在编写代码前将想法转化为具体方案。

第三种是存在文件中的计划:“对于更高级的工作流,你可以配置 Codex 遵循 PLANS.md 或执行计划模板,以进行长期运行或多步骤的工作。”

这种区别对本指南很重要。计划模式中的计划属于产生它的聊天,而“清除上下文”选项会将其移交给一个新线程。而 PLANS.md 文件存在于你的代码库中,任何后续线程都可以再次读取它。对于跨越多个会话的工作,保持更新的文件是更持久的记录。

计划获批后的三个选择

当计划在计划模式中获得批准时,Codex CLI 会询问“执行此计划吗?”并提供三个选项。下方的标签和描述来自 OpenAI 公开发布的 Codex 源代码。

是的,执行此计划 (Yes, implement this plan)。 描述为切换到 Default 模式并开始编码。执行在同一个聊天中继续,因此计划对话仍是该聊天的一部分。

是的,清除上下文并执行 (Yes, clear context and implement)。 描述为使用此计划开启新线程。当 Codex 知道当前上下文使用了多少时,描述会显示该数值,以便你在选择前查看计划聊天的占用情况。

不,留在计划模式 (No, stay in Plan mode)。 描述为继续与模型一起制定计划。

有两种情况会禁用中间选项。如果 Default 模式不可用,则两个执行选项都无法工作。如果没有已批准的计划文本,“清除上下文”选项将被禁用,并提示没有可用的已批准计划。

新线程的起始内容

这是关于 Codex 记忆最关键的部分。当你选择清除上下文时,Codex 会启动一个新线程,其任务是执行计划,而该计划是计划对话中唯一移交给它的内容。

11 月 11 日合并到 openai/codex 仓库的 11 月变更背后的拉取请求描述了这一机制。它使该选项能够“将已批准的计划保存为应用服务器附件,并提交一个引用该附件的简短提示词”。

因此,新线程中的第一条指令很简短:读取文件路径下的已批准计划并执行它。在切换之前,Codex 会检查新线程的执行器是否可以读取该文件,以及其内容是否与已批准的计划匹配。

新线程的启动方式与任何新的 Codex 线程相同。OpenAI 的文档指出“Codex 在进行任何工作前都会读取 AGENTS.md 文件”,因此你保存在那里的项目指令也适用于执行线程。同样的文档描述了将全局指南与项目特定覆盖相结合,以便“无论你打开哪个代码库,都可以带着一致的预期开始每项任务”。Codex 仓库中捕获新线程首次请求的测试显示了标准设置、环境上下文以及指向计划文件的提示词。它不包含计划讨论本身的任何内容。

旧聊天中保留的内容

计划中未包含的所有内容都会被留下。这包括:

  • 澄清性问题及你的回答。 如果你告诉了 Codex 某个约束存在的原因,只有在计划中写明时,新线程才会知道。
  • 被拒绝的方案。 除非计划记录了某个方案已被排除,否则新线程不会知道你曾说服 Codex 放弃它。
  • Codex 读取过的内容。 计划阶段的文件内容、搜索结果和工具输出不会被结转。新线程会根据需要重新读取。
  • 你的语气和修正。 你在计划期间给出的微小引导(例如要求 Codex 不要重命名公共函数),只有在进入计划或 AGENTS.md 时才会结转。

这就是该选项的权衡。新线程有足够的空间进行执行,而不会被冗长的计划记录占用上下文。作为交换,计划必须承载所有重要的内容。

计划聊天本身并不会丢失。Codex 会将你切换到新线程,而之前的对话仍作为已保存的聊天保留。CLI 的 /resume 命令文档说明其可以“从会话列表中恢复已保存的聊天”,因此如果需要检查讨论内容,你可以随时返回。

这与 /clear 的作用很接近,但多了一项功能。OpenAI 将 /clear 描述为“当你想要重新开始时,同时重置可见的 UI 和聊天上下文”。计划选项在执行此操作的同时,还将你的计划移交给新线程。我们在Codex 各命令重置内容指南中对比了 /clear 和 /new。

11 月 13 日的变化

0.169.0 变更日志条目描述了两件事:新会话获得完整的已批准计划,以及如果移交失败,当前会话保持开启。

拉取请求解释了实现方式。Codex 现在将计划保存为附件,并且仅在计划准备成功后才清除界面并切换线程。用 OpenAI 的话来说,Codex 将“仅在计划准备成功后清除 UI 并切换线程”。

这种顺序很重要。如果切换前发生错误,你会留在原地,计划聊天保持完好。

计划文件无法读取时会发生什么

附件是常规路径,但不是唯一路径。根据拉取请求:“如果无法写入或读取附件,则在模型的上下文和截断限制内,将完整计划作为 proposed_plan 工具输出注入到模型上下文中。”

在这种情况下,新线程直接在其上下文中获取计划文本,而不是读取文件。第一条提示词随后简单地变为执行该计划。

这存在限制。源代码根据模型的可用上下文窗口限制了此回退方案可以占用的新线程上下文比例。如果整个计划放不下,拉取请求称 Codex 将“报告错误并保留当前会话”。

源代码中的错误消息会告诉你该怎么做:在原始线程中执行计划。实际上,这就是第一个选项“是的,执行此计划”,它保留计划上下文并在同一个聊天中继续。

何时选择哪个选项

在以下情况下选择“是的,执行此计划”: 计划对话包含计划未捕获的上下文,例如约束的原因、Codex 已读取的对工作至关重要的文件,或你在过程中给出的修正。同一个聊天会保留所有这些内容。

在以下情况下选择“是的,清除上下文并执行”: 计划聊天很长,计划完整且自洽,且执行过程需要空间。选项描述中的上下文数值可以帮助你判断计划聊天的占用程度。

在以下情况下选择“不,留在计划模式”: 计划已接近完成,但你想在编写任何代码之前更改某些内容。

一个有用的习惯:在选择清除上下文选项之前,要求 Codex 修改计划,使其陈述你在计划期间做出的决定,包括哪些被排除了以及原因。计划是通往新线程的唯一桥梁,所以要让它承载关键信息。

一个实际案例

假设你正在计划更改发票生成方式。在计划期间,Codex 建议将一个共享助手函数移动到新模块中。你指出另外两个服务直接导入了该助手函数,因此它必须留在原处。Codex 表示同意并修改了方案。它还询问新格式是否应应用于旧发票,你回答不,仅限新发票。

最终计划列出了要更改的文件和步骤。在批准前阅读它。它是否说明了助手函数保持不动及其原因?它是否说明了旧发票不在范围内?

如果说明了,新线程就拥有了所需信息,清除上下文能给执行留出更多空间。如果没有说明,新线程启动时的计划会默默丢弃这两个决定。它很可能会再次建议移动助手函数,因为在它能看到的内容中,没有任何信息禁止这样做。

解决方法只需一条消息:要求 Codex 在计划中添加一小段约束和决定,然后批准修订后的版本。如果助手函数规则适用于此任务之外,也请将其添加到 AGENTS.md 中,以便未来的每个线程都能读取它。

人们最初常犯的错误

假设新线程了解整个讨论过程。 它只获取计划,以及任何新线程启动时都会有的上下文。

期望被拒绝的想法保持被拒绝状态。 如果计划没有说明某个方案已被排除,新线程就不会知道。

认为计划聊天被删除了。 它仍然是一个已保存的聊天,你可以恢复它。

不看计划就批准。 计划是新线程接收到的内容,因此请站在新线程的角度阅读它。

在移交错误后重试。 如果计划对于回退方案来说太大,请改为在原始线程中执行。

在每个计划中重复常规规则。 适用于每个任务的规则应放在新线程都会读取的 AGENTS.md 中。

解决方案:让计划承载关键信息

第 1 步:要求在计划中加入决策

在批准之前,要求 Codex 添加计划讨论中的决策,包括约束条件和被排除的方案。

第 2 步:检查上下文数值

利用选项描述中的数值来判断开启新线程是否值得。

第 3 步:将常规规则移至 AGENTS.md

任何超出此任务范围的内容(如约定和不可触碰的内容)都属于每个线程都会读取的指令文件。

第 4 步:在聊天之外保留原因

记录下做出决定的原因,以便后续线程和其他工具也能使用,而不仅仅局限于此计划。

在 MemoryLake 中设置

计划告诉新线程要做什么。而其背后的原因——例如为什么计费代码是禁区,或者上次哪个方案失败了——是下一个计划、下一个线程和下一个工具同样需要的。

MemoryLake 是此类项目上下文(如决策、约束和早期尝试的教训)的记忆层,统一保存在你维护的一个地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。

你用自己的语言亲自编写条目。你的 Codex 聊天、计划或计划附件、AGENTS.md 文件、会话历史或任何供应商的存储空间都不会被读取、写入或删除。计划模式和清除上下文移交的工作方式与 OpenAI 描述的一致。

第 1 步:创建 API 密钥

登录并在控制面板生成密钥。像对待其他凭据一样,将其保存在代码库之外。

MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用
MemoryLake 控制台显示 API 密钥屏幕,在此创建并复制新密钥以供代理使用

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

从你在解决方案第 4 步中写下的内容开始:近期计划背后的决策、被排除的方案以及反复出现的约束。每个条目一个决策。

MemoryLake 工作区显示已上传的首批文档,列出每个文件变为可搜索记忆的过程
MemoryLake 工作区显示已上传的首批文档,列出每个文件变为可搜索记忆的过程

第 3 步:连接你的 AI 和代理

连接 Codex、Claude Code、ChatGPT 或你使用的其他助手。新线程或不同的工具都可以利用相同的决策。

MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架
MemoryLake 集成屏幕列出了可以连接到记忆层的 AI 客户端和代理框架

这在实践中改变了什么

第一个区别是计划更短,但仍承载了重要的上下文。计划可以说明要构建什么,而常规原因已经记录在案。

第二个区别是反复的情况减少了。你曾经排除的方案不会在下一个线程中卷土重来,因为之前没人记录原因。

第三个区别是跨工具的连续性。当你在一个助手中计划并在另一个助手中执行时,相同的决策依然可用。

Codex 计划模式的最佳实践

规划困难任务。 OpenAI 建议在处理复杂或模糊的工作时使用计划模式。

批准前阅读计划。 这是新线程从计划聊天中接收到的唯一部分。

将原因写入计划。 约束和被排除的方案应当明确化。

在重要时保留计划聊天。 如果讨论中包含计划未捕获的上下文,请选择在同一个聊天中执行。

使用 AGENTS.md 记录常规规则。 每个新线程在开始工作前都会读取它。

长期工作优先使用文件。 PLANS.md 文件会保留在代码库中供后续线程使用。

不要死磕移交错误。 如果计划太大,请在原始线程中执行。

更新至 0.169.0 或更高版本。 更安全的移交功能是在该版本中引入的。

结论

在 Codex 计划模式中,“是的,清除上下文并执行”会启动一个新线程并将已批准的计划移交给它。自 11 月 13 日发布 0.169.0 版本以来,Codex 会将计划保存为附件,检查新线程是否可以读取,并在成功后才进行切换。如果文件无法使用,计划将直接进入上下文;如果计划太大无法进入上下文,Codex 会让你留在原始会话中。

新线程无法获取的是计划对话:你的回答、被拒绝的方案以及 Codex 读取的文件。这些内容保留在旧聊天中,你可以随时恢复。在清除上下文之前,请确保计划、你的 AGENTS.md 以及你自己的笔记承载了下一个线程所需的决策。

常见问题

Codex 中的“清除上下文并执行”有什么作用?

它会启动一个新线程来执行你批准的计划。新线程接收的是计划,而不是计划对话过程。

新线程会记得计划讨论的内容吗?

不会。它像任何新线程一样启动,读取 AGENTS.md 并获取计划。澄清性回答和被拒绝的想法只有在包含在计划中时才会结转。

计划聊天会被删除吗?

不会。它仍作为一个已保存的聊天保留,你可以通过 /resume 返回。

Codex 0.169.0 中有什么变化?

变更日志指出,该选项现在会将完整的已批准计划移交给新会话,并在移交失败时保持当前会话开启。

如果我的计划太大怎么办?

如果计划文件无法读取且完整计划太大无法作为上下文发送,Codex 会报告错误并让你留在原始线程中,你可以在那里执行计划。

如何在 Codex 中开启计划模式?

根据 OpenAI 的指南,在 CLI 中运行 /plan,或使用 Shift+Tab 进行切换。

我应该总是在执行前清除上下文吗?

不一定。如果计划聊天包含计划未捕获的上下文,在同一个聊天中执行可以保留这些内容。