Codex CLI 命令

本页适用于 Codex CLI 用户，内容是交互界面里的 /... 内部命令。

还没有安装 Codex 或还没有配置 UseGoodAI，先看 Codex 接入。要在系统终端里运行 codex exec、codex fork、codex mcp 这类外部命令，看 Codex 进阶。

怎么打开命令菜单

进入项目目录后启动 Codex：

codex

在 Codex 输入框里直接输入：

/

这会打开内部命令菜单。你可以继续输入关键词过滤，例如：

/goal
/fork
/review
/model

看到想用的命令后，按回车确认；不想执行就按 Esc 取消。

最常用的内部命令

新手先固定用这几个入口：多步任务开始先写 /goal；改完文件后用 /review；长期使用 Codex 要开启 /memories；熟练后用 /skills 调用专门工作流。

命令	用途	什么时候用
/goal	设置或查看长期任务目标	多步任务开始就用，写清目标、范围和完成标准
/review	审查当前改动并找问题	改完代码或文档后，用来找 bug、遗漏、链接错误和风险
/memories	配置记忆使用和生成	长期使用 Codex 要开启，让它记住稳定偏好和项目习惯
/skills	使用 skills 改善特定任务表现	熟练后经常用，写作、审查、调试、查文档等任务都能套专门流程
/fork	从当前会话分叉一条新方向	已经读过上下文，但想换一种方案或另开一条试验路线
/resume	恢复一个保存过的聊天	网络中断、退出后重进、切换端点后继续原任务，不想重新解释背景
/model	切换模型和 reasoning effort	重要任务用 gpt-5.5；普通工作用 gpt-5.4；简单操作用 gpt-5.4-mini
/permissions	调整 Codex 允许执行的操作	只读分析、改文件、跑命令前确认权限范围
/status	查看当前会话配置和 token 使用	不确定当前模型、目录、权限、目标或消耗时
/compact	压缩当前会话上下文	长会话快到上限，但还要继续同一个任务
/plan	切换到 Plan mode	只想讨论方案、范围和风险，暂时不让 Codex 改文件
/copy	复制最近一次回复为 Markdown	把 Codex 回复搬到文档、Issue、PR 或聊天里

内部命令不是普通聊天内容。比如你输入 /goal，Codex 会把它当作控制命令；要让 Codex 在文档里写出 /goal 这几个字，明确说“请把 /goal 作为文本写进文档”。

命令菜单

下面这些命令用来认识常见入口。打开 Codex 输入框里的 / 菜单后，可以按场景选择。

命令	菜单含义	用法
/model	选择模型和 reasoning effort	重要任务用 gpt-5.5；普通工作用 gpt-5.4；简单操作用 gpt-5.4-mini
/fast	1.5 倍速度模式，会增加 50% 价格	紧急任务、赶时间时使用；价格变化可在使用记录中确认
/ide	带入 IDE 当前选择、打开文件等上下文	正在编辑某个文件或选中一段代码时，用它让 Codex 直接看当前位置
/permissions	选择 Codex 被允许执行什么	只读分析、改文件、跑命令前先确认；高风险操作不要直接放大权限
/keymap	重新映射 TUI 快捷键	终端快捷键冲突、方向键或复制操作不顺手时再改
/vim	开关输入框 Vim 模式	习惯 Vim 输入的人开启；不熟悉 Vim 就保持关闭
/experimental	开关实验功能	只在明确知道影响、并能接受不稳定时使用
/approve	批准最近一次 auto-review denial 的一次重试	自动审查拦住操作，但你确认这次重试安全时使用
/memories	配置记忆使用和生成	长期使用 Codex 要开启，用来保留稳定偏好、项目习惯和写作规则
/skills	使用 skills 改善特定任务表现	熟练后经常用；写文档、查资料、调试、审查、测试都可切到对应 skill
/import	从 Claude Code 导入 setup、项目和最近聊天	从 Claude Code 迁移过来，想复用旧项目上下文时使用
/hooks	查看和管理 lifecycle hooks	Codex 行为被自动规则影响，或需要控制工具调用、命令、文件编辑流程时
/review	审查当前改动并找问题	改完后、提交前、发给别人前，用它找问题和漏项
/archive	归档当前会话并退出	当前任务结束，但以后还可能翻记录时使用
/delete	永久删除当前会话并退出	确认不要这条会话时才使用
/resume	恢复保存过的聊天	网络中断、退出后重进、切换端点后继续原任务时使用
/fork	分叉当前聊天	保留已读上下文，但换方案、做试验或开支线任务
/init	创建带 Codex 指令的 AGENTS.md	项目有固定规则、验证命令、写作要求时，把它们沉淀下来
/compact	总结会话，避免触及上下文上限	长会话继续推进前使用，压缩前先让 Codex 总结当前状态
/plan	切换到 Plan mode	需求没定、范围不清、只想讨论时使用；明确要实现就不用每次开
/goal	设置或查看长任务目标	多轮任务一定要用，写清完成标准，避免 Codex 跑偏
/copy	复制最近一次回复为 Markdown	需要把回复发到文档、Issue、PR、群聊时使用
/raw	切换 raw scrollback 模式	终端里复制大段输出不方便时使用
/diff	显示 git diff，包括未跟踪文件	需要核对具体文件差异时使用，不放进新手常用流程
/mention	引用文件	明确让 Codex 读取某个文件，减少“看整个项目”的模糊范围
/status	显示当前会话配置和 token 使用	不确定模型、目录、权限、目标、消耗时先看这里
/title	配置终端标题显示项	同时开多个 Codex 窗口时，用来区分任务
/statusline	配置状态栏显示项	想在底部直接看到模型、目录、目标、消耗等信息时使用
/theme	选择语法高亮主题	代码颜色看不清、终端主题不舒服时调整

/goal：给长任务设定完成标准

/goal 适合多轮任务。它的重点不是“启动一个新工具”，而是让 Codex 在后续工作里一直记住目标、范围和完成标准。

常用写法：

/goal 重写 Codex CLI 内部命令文档，要求讲清常用命令的真实使用场景，写完后运行构建验证。

查看当前目标：

/goal

暂停目标：

/goal pause

恢复目标：

/goal resume

清除目标：

/goal clear

目标写具体：

/goal 修复登录页提交后不显示错误提示的问题。范围只包括 src/pages/login 和相关测试。完成标准是相关测试通过，并说明改动和未验证项。

不要这样写：

/goal 优化项目

“优化项目”太宽泛，Codex 很难判断什么时候算完成。更好的方式是写清楚任务对象、允许范围和验收方式。

/review：在当前会话里做审查

/review 用来让 Codex 审查当前改动。它比直接说“帮我看看”更明确，因为 Codex 会进入审查导向，优先找 bug、风险、回归和缺少验证的地方。

常用写法：

/review

也可以加上审查范围：

/review 只审查 docs/external 下面的文档改动，重点看是否有命令入口混淆、事实不确定却写成确定、链接失效。

适合使用 /review 的场景：

场景	用法
文档改完	让 Codex 检查链接、结构、重复内容和误导性表述
代码改完	让 Codex 优先找 bug、边界条件和缺少测试
准备提交	让 Codex 检查 diff 是否包含无关改动
不确定方案	先让 Codex 做风险审查，不急着继续实现

/review 不是测试替代品。审查结束后，仍然要运行项目自己的构建、测试或预览命令。

/fork 和 /resume：会话分叉与恢复

/fork 适合在当前上下文基础上开一条新方向。比如当前会话已经读完登录模块，你可以分叉出不同任务：

/fork 基于当前分析，只修复登录错误提示，不做其他重构。

/fork 基于当前分析，只写测试计划，不修改代码。

/resume 用来回到之前保存过的聊天。网络中断、误关终端、退出 Codex 后重进、切换端点或模型后继续原任务，都可以用它恢复上下文，避免重新解释背景。

/resume

外部命令里也有 codex fork 和 codex resume。区别是：

你在哪里	应该用什么
已经在 Codex 输入框里	/fork、/resume
还在系统终端里，没有进入 Codex	codex fork、codex resume

已经在内部会话里时，用 /fork 更自然；外部 codex fork --last 更适合从终端直接启动一个分叉会话。

/model、/fast 和 /permissions

/model 用来切换模型和 reasoning effort：

/model

适合在这些时候使用：

场景	用法
重要任务、复杂重构、疑难 bug	用 gpt-5.5
普通代码修改、文档整理、日常工作	用 gpt-5.4
简单问答、小改动、低风险操作	用 gpt-5.4-mini
当前回答质量不稳定	先检查当前模型；不够稳就切到 gpt-5.5

/fast 用来切换更快的响应模式，适合紧急任务和赶时间的场景。开启后会增加 50% 价格，价格变化可在使用记录中确认；复杂方案和高风险改动不要只追求快。

/permissions 用来选择 Codex 允许做什么：

/permissions

只解释代码时，尽量保持只读；要修改项目文件时，选择能写当前工作区的模式；只有在你明确知道风险、且环境已经隔离时，才使用更宽的权限。

/status 和 /compact

/status 用来查看当前会话状态：

/status

它适合确认当前模型、工作目录、权限、token 使用等信息。发现 Codex 行为不符合预期时，先看 /status，再排查配置。

/compact 用来压缩长会话上下文：

/compact

当一个会话已经跑了很久、上下文快满时，可以先让 Codex 总结当前状态，再执行 /compact。压缩后适合继续同一个任务，但不要指望它保留每一个细节。

/plan：先讨论，不马上改

/plan 用来切换到 Plan mode：

/plan

适合这些场景：

场景	为什么先用 Plan mode
需求还不清楚	先澄清范围，避免 Codex 直接改错方向
涉及多文件、多模块	先列方案和影响面
只是想讨论	明确告诉 Codex 暂时不要动文件
要做风险评估	先收敛事实、假设、建议和结论

已经明确要 Codex 直接实现时，不需要每次都进 Plan mode；直接描述任务和验收标准即可。

/init、/skills、/hooks、/memories 和 /import

这些命令用于长期配置和能力扩展。长期使用 Codex 时，先把 /memories 打开；任务类型变多后，熟练使用 /skills；项目有固定规则时，再用 /init 写进 AGENTS.md。

命令	用途	用法
/memories	配置记忆使用和生成	保存稳定偏好、项目习惯和写作要求，减少每次重复交代
/skills	查看或使用 skills	写文档、查资料、调试、审查、测试前，切到更匹配的工作流
/init	创建或更新 AGENTS.md	给当前项目写长期规则、验证命令、禁止事项
/hooks	查看和管理 lifecycle hooks	Codex 行为被自动规则影响，或需要控制工具调用、命令、文件编辑流程时
/import	从 Claude Code 导入 setup、项目和最近聊天	从 Claude Code 迁移过来，想复用旧上下文时

/memories 适合保存跨项目都稳定的偏好，例如回复风格、常用语言、长期工作习惯。/init 适合保存只属于当前项目的规则，例如“修改代码后必须运行 npm run build”。两者不要混用。

Hooks、skills、memories 都会影响 Codex 的行为。排查“为什么 Codex 总是这样做”时，要把这些入口也检查一遍。

/copy、/raw、/mention 和显示设置

这些命令主要改善交互体验。

命令	用途
/copy	把最近一次 Codex 回复复制成 Markdown
/raw	切换更适合终端选择复制的 raw scrollback 模式
/mention	在输入里引用文件
/keymap	调整 TUI 快捷键
/vim	开关输入框 Vim 模式
/ide	带入 IDE 当前选择、打开文件等上下文
/title	配置终端标题显示项
/statusline	配置底部状态栏显示项
/theme	选择语法高亮主题

要让 Codex 读某个具体文件，可以用 /mention 或直接在输入里提到文件路径。引用文件比笼统说“看一下这个项目”更稳定，也更省上下文。

/archive 和 /delete

这两个命令会影响当前保存的会话。

命令	作用	风险
/archive	归档当前会话并退出	之后需要从归档里找回
/delete	永久删除当前会话并退出	删除后无法恢复

不确定时不要用 /delete。只是想收起历史会话，用 /archive 更稳妥。

常用工作流

先设目标，再让 Codex 动手

/goal 重写 Codex CLI 内部命令文档，要求讲清常用命令的真实使用场景，写完后运行 npm run docs:build。

然后输入普通任务：

请先阅读 docs/external/codex-advanced.md 和 docs/external/index.md，整理你准备怎么改，不要马上写。

确认方向后再让它实现。

改完后审查当前改动

/review 只审查当前文档改动，重点看命令场景是否贴近新手、模型和价格口径是否明确、内部命令示例是否清楚。

需要先看具体文件差异时，再输入 /diff。

长会话接近上限时压缩上下文

请先总结当前任务状态：已完成什么、还没做什么、关键文件和验证命令是什么。

/compact

常见误区

误区	正确理解
进入 Codex 后还总是敲 codex fork --last	在内部输入框里优先用 /fork
把 /goal 当成外部命令	/goal 是内部斜杠命令，不是 codex goal
以为所有人都有完全相同的命令菜单	命令会随版本、功能开关、插件和环境变化
用 /review 后就不跑测试	审查不能替代构建和测试
不确定权限时直接放大权限	先用 /permissions 查看并按任务选择最小权限