【LLM】Codex

✅ Codex CLI 完整 Slash 指令手册（截至 2026 年 5 月）

使用方式： Slash 指令让你用键盘快速控制 Codex，在 composer 中输入 / 即可打开弹出菜单，选择指令后 Codex 会执行切换模型、调整权限或压缩对话等操作，全程无需离开终端。[1]

任务运行中排队： 当任务正在运行时，你可以输入 slash 指令并按 Tab 将其排入下一轮执行队列，Codex 在当前轮次结束后才会解析和执行它。[1]

Codex CLI Slash 指令速查表

指令	分类	功能简述
`/init`	📁 初始化	生成 `AGENTS.md` 脚手架文件
`/goal`	🎯 目标	设定/查看/暂停/恢复长时间持续目标
`/plan`	🧠 规划	实施前先让 Codex 梳理方案
`/side`	💬 分支	开启临时侧面对话，不影响主线程
`/fork`	💬 分支	克隆当前对话为新线程并行探索
`/agent`	💬 分支	在多个 agent 线程之间切换
`/review`	🔍 审查	代码审查，重点查行为变化和缺失测试
`/diff`	🔍 审查	查看 Git diff，浏览文件改动
`/compact`	🗂️ 上下文	压缩历史对话，释放 Token 空间
`/clear`	🗂️ 上下文	清空终端 + 开启全新对话
`/new`	🗂️ 上下文	开启新对话（不清屏）
`/resume`	🗂️ 上下文	从已保存会话列表中恢复对话
`/model`	⚙️ 模型	会话中途切换模型
`/fast`	⚙️ 模型	切换快速模式（速度优先）
`/permissions`	⚙️ 权限	调整文件读写审批策略
`/approve`	⚙️ 权限	手动放行被拒绝的操作
`/mcp`	🔧 工具	查看 MCP 服务器和工具连接状态
`/apps`	🔧 工具	浏览可用连接器
`/hooks`	🔧 工具	查看生命周期钩子配置
`/personality`	🎨 个性化	切换沟通风格（friendly/pragmatic/none）
`/theme`	🎨 个性化	预览并保存终端主题
`/vim`	🎨 个性化	为当前会话切换 Vim 模式
`/copy`	📋 输出	复制最近一次输出到剪贴板（`Ctrl+O`）
`/raw`	📋 输出	切换原始滚动模式，便于终端复制（`Alt+R`）
`/stop` / `/clean`	🔄 管理	停止当前会话所有后台终端
`/status`	🔄 管理	查看当前模型/权限/上下文状态
`/experimental`	🔄 管理	切换实验性功能并更新 config
`/logout`	🔄 管理	清除本地登录凭据
`/feedback`	🔄 管理	提交反馈和诊断信息
`/exit` / `/quit`	🔄 管理	退出 CLI
`/sandbox-add-read-dir`	🪟 Windows	为指定目录授予沙盒读取权限

💡 小技巧： 在 CLI 中输入 / 后不打任何字符，弹出菜单会列出当前版本所有可用指令，是最准确的参考。

一、📁 项目初始化

`/init`

在你想让 Codex 查找持久指令的目录中运行 /init，它会生成一个 AGENTS.md 脚手架文件，你可以编辑并提交该文件，供未来会话使用。[1]

使用场景： 项目初始化时一次性运行，为整个代码库建立 AI 工作规范，相当于 Claude Code 的 CLAUDE.md。

复制代码

/init

二、🎯 目标管理（Goal Mode）

`/goal` ⚠️ 实验性功能

这是截图右下角 Pursuing goal (9h 21m) 的来源，也是你问题的核心。

在 composer 中使用 /goal 来启动 Goal 模式，Goal 是一个持久目标，Codex 会持续为之努力，直到完成任务、暂停，或需要更多输入为止。[10]

用法：

/goal <目标描述> → 设定目标，例如 /goal Finish the migration and keep tests green
/goal → 查看当前目标
/goal pause / /goal resume / /goal clear → 暂停、恢复或清除目标[1]

Codex 会将目标附加到活跃线程上持续工作。目标描述必须非空且不超过 4000 字符，如果指令较长，建议把细节写入文件并让 goal 指向该文件。[1]

/goal 的推荐工作流是：先用 /plan 梳理方案，再用 /goal 设定精炼后的目标。[10]

⚠️ 启用方式： 如果 /goal 没有出现在指令列表中，需要在 config.toml 中启用 features.goals，或运行 codex features enable goals。[10]

使用场景： 长时间后台运行任务（如大规模迁移、持续修 bug 直到测试通过），设定后你可以去做其他事，Codex 自主推进。

三、🧠 规划与模式

`/plan`

适合多文件修改、迁移、重构，或任何需要在实施前先规划评审的任务。[7]

使用场景： 动手写代码前先让 Codex 梳理架构方案，可配合行内提示使用，如 /plan Propose a migration plan for this service。

四、💬 会话分支管理

`/side`

用 /side 打开一个临时的侧面对话，不会永久影响主线程。例如：

/side summarize the current plan
/side what are the risks in this migration?
/side explain this error without changing files
OpenAI 将其定义为对话的临时分支。[9]

注意： /side 在另一个 side 对话内部以及 review 模式下不可用。[1]

使用场景： 临时提问、探索风险、查询解释，不想打断主任务流。

`/fork`

输入 /fork 后，Codex 会将当前对话克隆成一个新的线程并分配新 ID，原始记录保持不变，可让你在平行分支中探索另一种实现方式。如果需要 fork 一个已保存的会话而不是当前会话，可在终端运行 codex fork 打开会话选择器。[1]

使用场景： 想尝试另一种实现思路，但不想丢失当前上下文。

`/agent`

输入 /agent 后按 Enter，从弹出的线程选择器中选择目标线程，Codex 会切换到该线程，让你检查或继续那个 agent 的工作。[1]

使用场景： 当你运行并行 agent 时，用于在不同 agent 线程之间切换，Codex 也会自动压缩长对话。[5]

五、🔍 代码审查与变更检视

`/review`

输入 /review，再跟上 /diff 查看精确文件改动。Codex 会在工作树中找到问题，重点关注行为变化和缺失测试，使用当前会话模型（除非在 config.toml 中设置了 review_model）。[1]

使用场景： commit 或 push 前做最后把关。

`/diff`

输入 /diff 查看 Git diff，在 CLI 内滚动查看编辑和新增文件。Codex 会显示已暂存的改动、未暂存的改动以及 Git 尚未追踪的文件，帮你决定哪些要保留。[1]

使用场景： 确认 AI 对文件做了哪些修改，在 review 前快速浏览。

六、🗂️ 上下文与会话控制

`/compact`

对话过长后输入 /compact，确认后 Codex 会用简洁摘要替换之前的对话轮次，释放上下文空间同时保留关键决策。[1]

使用场景： 长时间工作后 Token 消耗过多，或上下文窗口快满时使用。

`/clear`

输入 /clear 会清空终端、重置可见记录并开启全新对话。与 Ctrl+L 不同：/clear 开启新对话，Ctrl+L 只清除终端视图而保留当前聊天。[1]

使用场景： 一个任务彻底完成，开始全新任务时使用。

`/new`

在同一 CLI 会话中开启新对话，让你切换任务而无需退出工具。与 /clear 不同，/new 不会先清除当前终端视图。[1]

使用场景： 快速切换到新任务，但不想关掉终端。

`/resume`

输入 /resume 后从已保存的会话选择器中选择，Codex 会重新加载该对话的完整记录，让你从中断处继续，原始历史保持不变。[1]

使用场景： 恢复昨天中断的任务，继续之前的上下文。

七、⚙️ 模型与权限控制

`/model`

对于大多数任务，gpt-5.5 是推荐模型，它是 OpenAI 最新的前沿模型，适合复杂编码、计算机使用和多步骤任务。ChatGPT Pro 订阅者还可使用 GPT-5.3-Codex-Spark 极速模型（研究预览）。可用 /model 指令在会话中途切换。[4]

使用场景： 简单任务降级用快速模型节省 Token，复杂架构任务升级用高性能模型。

`/fast`

切换到快速模式，牺牲推理深度换取响应速度。

使用场景： 简单问答或不需要深度推理的任务。

`/permissions`

输入 /permissions 后选择合适的审批预设，例如 Auto（完全自主）或 Read Only（只读审查）。Codex 会宣布更新后的策略，后续操作将遵循新设置直到你再次更改。[1]

使用场景： 需要扩大或缩小 Codex 文件读写权限时调整。

`/approve`

当自动审查器拒绝了某个操作时使用 /approve，确认后 Codex 会在当前会话策略下重试那个被拒绝的操作一次。[1]

八、🔧 工具与集成

`/mcp`

输入 /mcp 查看当前会话可用的 MCP 服务器和工具列表。使用 /mcp verbose 可获取详细的服务器诊断信息，传入其他参数则显示命令用法。[1]

使用场景： 检查第三方工具连接状态，如数据库、外部 API。

`/apps`

在会话内用 /mcp 列出已连接的工具，用 /apps 浏览可用的连接器。[6]

`/hooks`

输入 /hooks 后 Codex 会打开 hook 浏览器，让你查看已配置的生命周期钩子，被管理的 hook 标记为 managed 且无法从用户 hook 浏览器禁用。[1]

九、🎨 个性化与界面

`/personality`

/personality friendly / /personality pragmatic / /personality none，OpenAI 文档列出了这三种个性化模式。[9]

使用场景： 调整 Codex 的沟通风格，不修改 prompt。

`/theme`

用 /theme 预览并保存偏好的终端主题。[4]

`/vim`

在 composer 中继续编辑时，/vim 可为当前会话切换 Vim 模式。[1]

十、📋 输出与复制

`/copy`

输入 /copy 将 Codex 最近一次完成的输出复制到剪贴板。如果轮次仍在运行，则复制最近已完成的输出。该命令在第一次 Codex 输出前和回滚后立即不可用。也可以用 Ctrl+O 快捷键直接复制，无需打开菜单。[1]

`/raw`

输入 /raw、/raw on 或 /raw off 来切换原始滚动模式，该模式使终端选择和复制更直接。也可以用默认的 Alt+R 绑定，或用 tui.raw_output_mode = true 持久化该设置。[1]

十一、🔄 会话管理与退出

`/stop`（别名 `/clean`）

输入 /stop，确认后 Codex 会停止当前会话的所有后台终端。/clean 是 /stop 的别名。[1]

`/status`

当你不确定当前使用的模型、权限或上下文状态时，用 /status 检查。[7]

`/experimental`

用 /experimental 切换实验性功能并更新 config.toml。[5]

`/logout`

输入 /logout 后 Codex 会清除当前用户会话的本地凭据。[1]

`/feedback`

输入 /feedback 后根据提示选择是否包含日志或诊断信息，Codex 会收集相关数据并提交给维护团队。[1]

`/exit` / `/quit`

两者都可退出 CLI，建议在退出前确保已保存或提交重要工作。[1]

十二、🪟 平台专属（Windows）

`/sandbox-add-read-dir`

输入 /sandbox-add-read-dir C:\absolute\directory\path，确认路径是已存在的绝对目录后，Codex 会刷新 Windows 沙盒策略，为该目录授予后续命令的读取权限。[1]

十三、🧩 其他源码中已知但未完整公开的指令

OpenAI 的公开 slash 文档列出了主要 CLI 指令，而当前 CLI 源码中还枚举了额外的指令，包括 /theme、/skills、/memories、/rename、/vim、/hooks、/raw 以及部分调试/平台限定项目。[9]

Learn more:

✅ Codex CLI 完整 Slash 指令手册（截至 2026 年 5 月）

Codex CLI Slash 指令速查表

一、📁 项目初始化

/init

二、🎯 目标管理（Goal Mode）

/goal ⚠️ 实验性功能

三、🧠 规划与模式

/plan

四、💬 会话分支管理

/side

/fork

/agent

五、🔍 代码审查与变更检视

/review

/diff

六、🗂️ 上下文与会话控制

/compact

/clear

/new

/resume

七、⚙️ 模型与权限控制

/model

/fast

/permissions

/approve