跳到正文

Codex CLI 常用命令大全:斜杠命令、登录、恢复会话与代码审查速查表(2026)

更新时间:2026年8月4日

安装 Codex CLI 后,真正影响效率的是能不能分清三类命令:终端里的 codex 子命令、交互界面中的 /斜杠命令、以及让 Codex 执行的普通 Shell 命令。它们看起来都在终端里,却属于不同层级。

本文不是重复讲安装,而是提供一张可以收藏的 Codex CLI 常用命令大全。命令会随版本调整,先运行 codex --help 和各子命令的 --help 核对本机版本;安装和 PATH 有问题,回到 Codex 下载、安装、配置主教程

国内开发路径

需要 Codex 国内版、中文开发工作流或高额度 GPT 编程模型时,可以了解第三方平台 ZeoGPT。它不是 OpenAI 官方产品,公开或脱敏代码先试用,敏感仓库与密钥不要直接提交。

Codex CLI 命令分哪三类

类型写在哪里示例用途
CLI 子命令PowerShell、Terminal、Shellcodex exec启动、登录、恢复、自动化
斜杠命令Codex 交互界面/review控制当前会话
Shell 命令终端或由 Codex 受控执行npm test构建、测试、Git 检查

不要在 PowerShell 直接输入 /model,也不要在 Codex 聊天框中把 codex login 当成斜杠命令。先判断自己当前处在哪一层。

最常用 Codex CLI 子命令速查

以下命令来自 OpenAI 官方 openai/codex 仓库当前 CLI 定义。部分功能可能是实验性、受账号或版本限制。

命令作用常见场景
codex打开交互式 CLI进入当前项目开始工作
codex exec非交互执行任务脚本、CI、批处理
codex review非交互代码审查检查当前修改或指定范围
codex login管理登录ChatGPT、设备码或 API Key
codex logout清除登录凭据换账号或排查认证
codex resume恢复历史会话继续上次仓库任务
codex fork分叉历史会话保留上下文尝试另一方案
codex mcp管理 MCP server添加、查看外部工具
codex plugin管理 Plugins浏览或启用能力包
codex app打开桌面 App从 CLI 转到图形界面
codex update更新 Codex升级到当前可用版本
codex doctor检查安装与运行健康配置、登录、运行异常
codex sandbox在 Codex 沙箱中运行命令验证权限与隔离行为
codex completion生成 Shell 补全Bash、Zsh 等命令补全
codex cloud浏览 Codex Cloud 任务实验性云端任务流程
codex features查看功能开关排查版本功能差异

查看版本与帮助

powershell
codex --version
codex --help
codex exec --help
codex review --help
codex login --help

教程中的参数和你的本机不一致时,以本机帮助为准。升级失败可看 Codex CLI 更新、降级与卸载教程

启动 Codex 的常用写法

在当前项目启动

powershell
cd D:\projects\my-app
codex

建议在项目根目录启动,让 Codex 能看到完整的 Git 状态、项目规则和测试脚本。第一次进入陌生仓库,先要求只读分析:

text
先阅读项目结构和 AGENTS.md,不要修改文件。
输出技术栈、关键目录、构建命令、测试命令和风险点。

带初始提示词启动

powershell
codex "先只读分析这个仓库,告诉我如何运行测试,不要修改文件"

复杂任务仍建议进入交互界面后补充边界。提示词模板可参考 Codex 提示词、Goal 与模板大全

codex exec 怎么用

codex exec 适合非交互任务,例如在脚本里检查文档、运行固定审查、生成报告。它不是“默认全自动修改”的同义词,仍应明确范围、权限和验证。

powershell
codex exec "只读检查当前 Git Diff,按严重程度列出问题,不修改文件"

建议在自动化场景中做到:

  1. 输入范围明确,避免无限扫描;
  2. 默认只读,写入另行授权;
  3. 日志中不输出 API Key、Token 和客户数据;
  4. 失败码要让脚本感知;
  5. 自动生成的结论仍需人工复核。

codex review 怎么用

codex review 用于非交互代码审查,适合把“发现问题”与“直接改代码”分开。常见做法是先查看帮助,再选择本机版本支持的审查范围:

powershell
codex review --help
codex review

高质量审查提示应要求:问题优先、文件位置、影响、证据和测试缺口。完整流程可看 Codex 代码审查:Diff、测试与回滚清单

Codex 登录与账号命令

普通登录

powershell
codex login

设备码登录

powershell
codex login --device-auth

设备码适合浏览器回调不方便的环境,但是否可用取决于当前版本和账号。不要把设备码发给其他人。

查看登录状态

powershell
codex login status

退出登录

powershell
codex logout

登录循环、账号切换和授权失败可继续看 Codex VS Code 登录失败排查Codex API 登录及 config.toml 教程

恢复与分叉会话

恢复最近会话

powershell
codex resume --last

查看并选择历史会话

powershell
codex resume

分叉最近会话

powershell
codex fork --last

resume 适合继续原任务;fork 适合保留原上下文,同时尝试另一种实现。恢复后先运行 /status,确认工作目录、模型、权限和会话是否符合预期。

Codex 常用斜杠命令大全

进入 Codex 交互界面后,输入 / 可以查看本机支持的命令。下面按使用频率分组。

模型、权限与状态

斜杠命令作用
/model选择模型与推理强度
/permissions调整当前允许的操作
/status查看会话配置与 Token 使用
/usage查看账号使用情况或额度重置入口
/debug-config查看配置层与规则来源
/experimental管理实验性功能

项目分析与修改检查

斜杠命令作用
/init为项目创建 AGENTS.md
/review审查当前修改并发现问题
/diff查看 Git Diff,含未跟踪文件
/mention引用文件到上下文
/compact压缩长会话上下文
/plan切换计划模式,适合复杂任务
/goal设置或查看长任务目标

Skills、MCP 与插件

斜杠命令作用
/skills查看与使用 Skills
/mcp查看 MCP 工具,/mcp verbose 看详情
/plugins浏览 Plugins
/apps管理 Apps 或连接能力
/hooks查看和管理生命周期 Hooks

Skills 的安装与写法见 Codex Skills 保姆级教程。四种机制容易混淆时,看 Plugins、Skills、MCP、AGENTS.md 区别

会话管理

斜杠命令作用
/new开始新聊天
/rename重命名当前会话
/resume恢复保存的会话
/fork分叉当前会话
/archive归档当前会话并退出
/delete永久删除会话
/clear清屏并开始新聊天
/app在桌面 App 中继续当前会话
/quit/exit退出 Codex

输出与后台任务

斜杠命令作用
/copy复制上一条 Markdown 响应
/raw切换便于复制的原始滚动模式
/ps查看后台终端
/stop停止后台终端
/feedback向维护者发送反馈和日志

部分命令受系统、版本、功能开关和账号限制。例如 /app 主要面向支持桌面 App 的系统;你的列表没有某个命令时,先更新 Codex,再核对 codex features 与官方说明。

五个高频工作流命令组合

1. 第一次读项目

text
/status
/permissions
/init

先确认环境与权限,再根据需要创建 AGENTS.md。不要在不熟悉的仓库中一开始就开放写入与网络权限。

2. 修复 Bug

text
/plan
/mention
/diff
/review

先计划、补充关键文件、检查实际修改,最后单独审查。

3. 长任务防止上下文膨胀

text
/goal
/status
/compact

Goal 保留方向,Compact 压缩历史,但重要约束仍应放在提示词、AGENTS.md 或 Skill 中。

4. 切换模型处理难题

text
/model
/status

切换后确认模型和推理强度,避免以为已经生效。选型方法见 Codex 模型与推理强度指南

5. 继续昨天的项目

powershell
cd D:\projects\my-app
codex resume --last

进入后执行 /status/diff,先确认工作目录和未提交改动。

常见命令错误

command not found

检查安装、PATH 和是否存在多个同名可执行文件。Windows 可运行 where.exe codex,macOS/Linux 可运行 command -v codex

unknown command

先运行 codex --help。教程可能对应较新版本,或命令受功能开关限制。

斜杠命令没有反应

确认你在 Codex 交互界面,而不是普通 PowerShell。输入 / 查看当前可用命令,不要照搬过期截图。

命令能运行但不能改文件

检查 /permissions、沙箱、工作目录和项目规则。参考 Codex 无法修改文件排查

FAQ

codex exec 和普通 codex 有什么区别

普通 codex 进入交互界面,适合多轮开发;codex exec 更适合一次性、非交互和脚本化任务。

/reviewcodex review 一样吗

目标相近,但入口不同。/review 在当前交互会话中审查;codex review 是 CLI 子命令,适合非交互流程。具体参数以本机帮助为准。

如何查看全部斜杠命令

进入 Codex 后输入 /。列表会随版本、系统和功能开关变化,这是最可靠的本机清单。

可以把命令直接放进 CI 吗

可以考虑 codex execcodex review,但应先解决凭据、权限、日志脱敏、失败码和人工复核,不要让 CI 对生产仓库无限制写入。

相关教程

本文命令清单依据 2026年8月4日 OpenAI 官方 openai/codex 仓库整理。Codex 更新很快,执行前请用本机 --help/ 命令面板复核。

独立中文教程站,不是 OpenAI 官方网站。产品信息请以官方资料为准。