工作阶段、接续与分岔

返回 Codex 教学总目录

目标与准备

resume 接续的是先前工作阶段的对话与状态，不是把整个磁碟还原到当时。你在编辑器改了档案，或其他任务做了修改，重新接续时都要确认。也不要把接续与 fork、跨主机 Handoff混成一件事：一个是回到既有任务，一个建立另一条工作线，另一个移动执行位置。

步骤一：建立容易辨认的两个练习

在同一个练习父资料夹建立 codex-session-a 与 codex-session-b，各自新增 note.txt。A 放第一段，B 放第二段，不要把两段放进同一个档案。两个档名都叫 note.txt，但内容标记不同；这让你不能只靠档名猜测目前工作位置。记下父资料夹在哪里，后续每次启动前都先核对目录。

SESSION-A
Revision: 1

SESSION-B
Revision: 100

用编辑器开 A 资料夹，再开整合终端机。PowerShell 用 Get-Location，macOS／Linux 用 pwd，确认末端是 codex-session-a；从该处执行下列命令。进入 CLI 后送出再下一段要求。预期回复 A 的实际路径、SESSION-A、Revision: 1，且档案没有修改。记录这次任务在清单中显示的标题与时间。

codex --cd . --sandbox read-only

Read note.txt from the current directory without changing files. Report the exact directory and both lines. This is a session-resume exercise. Do not search other folders or infer content from the filename.

用 /exit 退出 A，看到系统终端机提示符号后，改从 B 资料夹开相同的唯读工作阶段并送出相同要求。这次应是 SESSION-B 与 Revision: 100。退出后你有两个可辨识的工作阶段；B 较新，但接下来要找回的是 A。这比只有一个任务时按「最近」更能测出选择是否正确。

步骤二：用清单找回 A

回到 A 资料夹的系统终端机执行 codex resume。用画面清单确认专案路径、时间与可看到的内容，再选 A。若目前清单不含想找的目录，可以用 --all 列出其他目录的工作阶段，但必须重新核对选择，不把全域最新项目直接当目标。清单操作键以当前画面提示为准，按 Enter 确认前先看清楚目录。

codex resume

codex resume --all

若启动目录和任务储存的目录不同，CLI 可能询问要用哪个位置；不要为了快点进去随便选。这次要继续 A 就选 A 所在位置，接著用 /status 与新的读档要求确认。已设定 tui.resume_cwd 或明确 --cd 时，行为可能不同；需要理解它们时看设定排错，不要把没有跳询问框当作一定选对。

步骤三：证明接续会读到新磁碟内容

再次退出 A，使用文字编辑器只将 A/note.txt 第二行改为 Revision: 2，B 的档案完全不动。回 A 的系统终端机执行下面命令，这里 --last 依官方规则限定目前目录的最近工作阶段；不要加 --all，因为它会改变搜寻范围。如果该目录还有其他任务，改用清单或已知 ID，不要盲猜最近一笔就是练习。

codex resume --last --sandbox read-only

进入后送出下列要求。预期指出旧对话是 Revision: 1，但目前磁碟是 Revision: 2，且 SESSION-A 没变。这个差异是题目，不是要修复的错误；不要叫它把档案改回聊天记忆中的数字。对正式工作而言，相同方法可用来确认测试纪录、未提交修改与交接笔记是否仍符合现在版本。

Resume by reading note.txt from disk again now. Compare the current revision with the earlier conversation. Report the current directory, the file marker, and any difference. Do not restore an older value or edit any file.

延伸：分岔对话后，档案仍须核对

若要比较另一条思路，先退出目前 CLI，回 A 目录执行下方 fork。从选择清单核对原 A 任务与目录，记录分岔后的新任务 ID；这会建立另一段对话，不等于备份或隔离档案。这次没有 Git，也不使用 worktree，两段对话可能操作相同资料夹，因此都只做唯读。看不到 fork 时先查 codex fork --help 与本机版本，不把其他产品的功能名称当命令。

codex fork --sandbox read-only

This is a read-only alternative branch of the session exercise. Read note.txt from disk now and report its actual path, marker and revision. Describe one different way to verify the file without changing it. Do not assume that forking created a separate file copy or restored Revision: 1. Do not edit files.

分岔后仍应读到目前 A 的 Revision: 2；原 A 对话保留，磁碟不应倒退。若新任务与 A 指向同一完整路径，就记「对话分开、档案共用」。完成后退出分岔，再从清单接续原 A，重新读同一档案确认；退出或删除对话都不能当作档案还原。Worktree篇才处理 Git 工作目录隔离。

常见错误、停止与还原

找不到工作阶段时，先查是否换了 OS、使用者、CODEX_HOME 或主机，再用 --all 核对其他目录；桌面与 CLI 的工作阶段不应只靠标题相同就推定可互换。选错 B 时，先停止送出后续要求，/exit 回终端机重选 A；如果已经有写入，就到被修改的真正目录检查差异，退出对话不会撤销档案。回复仍是 1 时则要求新读取并确认路径，而不是重复同一句「继续」。

如果规则档刚更新，也应先完成目前小步骤并开新的工作阶段验证，不把 resume 当成清空所有旧指示的方法；规则层级篇有专门对照。长对话需要整理时看上下文交接，保留关键决策、真实档案与未完成事项，而不是把摘要当作档案备份。

完成时应保存 A／B 的辨识纪录、A 接续后的新读取，以及为何 --last 和 --all 不能随便互换的说明。还原练习时只把 A 的 Revision 改回 1，再确认 B 仍是 100；不需要删除工作阶段或登入资料。本篇命令依官方文件与本机 help 查证，没有替读者执行互动工作阶段或保证旧任务跨平台自动同步。下一次正式接续也先确认「哪个任务、哪个目录、哪个版本」，再开始修改。

图中 1 是先辨认 A 与 B，2 是选择正确的工作阶段，3 是重新读取磁碟并核对版本。每次续接都保留这三个检查点。

返回 Codex 教学总目录

阅读完整文字说明

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AI 工具
• 教程
• Codex