CLI 命令与斜线命令

返回 Codex 教学总目录

读完能做到什么

本篇以 Codex CLI 为范围。桌面版和 ChatGPT 网页也可能有斜线选单，但命令集合不相同。不要把 Claude Code 的命令、网路上的旧截图，或桌面快捷键直接当成 CLI 语法；先查你正在使用的介面与版本。

开始之前

先完成CLI 安装及登入，下载待办练习材料，用 expected 副本建立 codex-practice。这一篇主要读取档案和规划，不需要 GitHub 或付费外部服务。若 codex 命令找不到，先完成安装排错，不要把登入问题和路径问题混在一起。

Windows 在练习资料夹开 PowerShell；macOS 开 Terminal；Linux／WSL 开该环境自己的终端机。WSL 中的 /home 路径与 Windows 的 C:\Users 路径不同，命令要在真的装有 CLI 的环境执行。确认完位置，再开始以下步骤。

五种输入要分清楚

终端机通常显示路径与提示符号；Codex 互动介面则有自己的对话输入区。在 PowerShell 输入 /plan 会被 shell 当成命令或路径，不能开启 Codex 的 Plan 模式。反过来，把多行安装命令贴进 Codex 对话，也可能变成请代理执行的要求，与你直接执行不同。

第一步：查版本与说明

codex --version
codex --help
codex resume --help

三行可以逐行执行。第一行显示版本，第二行列出此版本的子命令与选项，第三行只看接续工作阶段的说明。它们不会开始新的代理工作。本次 Windows 实际查得 codex-cli 0.154.0-alpha.6.2；这是验证环境纪录，不是要求你安装这个预览版本。

说明中的方括号表示选用内容，角括号通常代表要替换的值。不要照抄 SESSION_ID 之类的占位文字，也不要把文件展示的所有旗标一起加上。查不到选项时，先确认拼字、子命令与版本，再判断是否需要更新。

第二步：启动并检查状态

codex

进入互动介面后，在输入框打 /，使用弹出的清单搜寻 status，再执行 /status。应看到目前工作阶段的设定资讯，例如模型、权限与上下文状态；显示栏位依版本而异。它不是购买额度或兑换重置信用的指令。

/status

请同时用唯读自然语言核对工作位置。若路径不符，离开这个工作阶段，回终端机进入正确资料夹再启动。不要试图用切换模型来修正工作目录。

Report the current working directory and list the five Small Steps source files.
Do not edit anything. If this is not the practice folder, stop and explain.

第三步：使用 Plan 模式做一次规划

Plan 模式适合在实作前检查需求、影响范围与验收方式。在互动输入框执行下面的内容，要求设计一个「清除已完成」功能。这个功能不在初始需求中，所以要保留未完成资料并考虑空清单；本篇只产生计划。

/plan Plan a Clear completed button for this todo website. Do not implement it yet. Preserve active tasks and explain how to verify an empty list, mixed completion states, and reload behavior.

合格计划应指出相关档案、按钮位置、资料操作、储存方式与测试案例，不能只有「修改、测试、完成」三个空泛步骤。检查是否误提不存在的 React 元件或资料库。发现不符就补充限制，直到你能用计划判断成果。之后要实作，依目前介面的模式控制与提示交付；计划本身不代表已改好网站。

如果 Codex 正在工作，/plan 暂时无法使用。先等这次工作结束；确实需要中止时再使用目前介面的停止功能，核对已完成的修改后才送出规划要求。不要重复传送多次 /plan，或以为切换模式会撤销先前操作。

第四步：退出并找到同一个工作阶段

完成计划后，先记下任务名称或工作阶段识别资讯，再在互动输入框执行 /quit。回到系统终端机后，执行 codex resume，从选择器核对时间、内容与路径，选回刚才的任务。刚入门先用选择器，比直接假定最后一个就是目标更容易核对。

/quit

codex resume

官方文件也提供 codex resume --last 接续目前目录最近的工作阶段；加 --all 会扩大搜寻范围。这些选项先查 resume --help 再使用。接续后请它摘要刚才的计划和未完成事项，并核对路径。能说出功能不表示档案就在正确位置，两项都要查。

续接时，启动位置与原工作阶段的储存位置若不同，CLI 可能要求选择要使用哪个目录；tui.resume_cwd 设定也会影响选择。对这份练习先核对 codex-practice 的完整路径，不要只靠对话标题。明确的 --cd 覆写会优先于该设定；新手先不要加覆写，详见工作阶段与续接。

常用指令索引

需要挑模型看模型选择，调整授权看权限与沙盒，脚本流程看codex exec。使用 /compact 前先保留需要逐字重现的错误与完成条件，可参考上下文交接。总目录的指令搜寻可用 /plan、AGENTS.md 或 resume 找到相关篇章。

验收、常见问题与还原

正常验收：版本与说明可读、工作位置正确、计划没有修改档案、退出后能接续同一任务。边界验收：在 / 选单输入不存在的名称，确认它没有变成你以为的功能；取消输入并回文件查证，不要因此提高权限或安装来路不明的补充工具。

「不是内部或外部命令」或 command not found：这是 shell 找不到 codex，先检查安装位置与新的终端机环境。若 codex --help 能跑而 /plan 不能，通常是输入介面不对，不是 CLI 没装好。

参数不接受：确认一般半形连字号 --，不要使用文章排版的长破折号；空格与引号也要保留。不同子命令支援的旗标可能不同，主程式接受不表示每一个子命令都接受。

resume 找不到或接错：回想是否在不同目录、主机或 CLI 环境启动，先看选择器与说明。不要用删除历史来处理找不到的任务。这篇没有修改原始码，退出即可结束；退出或重开对话不会撤销先前已经完成的档案操作。

图中的 01 是系统终端机，02 是 Codex 互动输入，03 是需要核对的结果。

小练习与查证纪录

自己做一张四列备忘：查说明、查状态、提出唯读需求、接续工作。每列写「贴在哪里」与预期结果，再亲自各做一次。能解释 codex resume 和 /resume 的介面差异，就比背下大量旗标更接近实际使用。

查证日为 2026-09-14，依官方 CLI 指令文件及本机 --help 核对。Windows 实测包含版本、主命令与 resume 说明；互动斜线、模型选单、macOS／Linux 依官方文件查证，未宣称全部实测。需要完整操作范例可继续Skills与测试及审查。

返回 Codex 教学总目录

阅读完整文字说明

Shell to Interactive / to Result

• AI 工具
• 教程
• Codex