主题
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、Shell | codex 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,按严重程度列出问题,不修改文件"建议在自动化场景中做到:
- 输入范围明确,避免无限扫描;
- 默认只读,写入另行授权;
- 日志中不输出 API Key、Token 和客户数据;
- 失败码要让脚本感知;
- 自动生成的结论仍需人工复核。
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 --lastresume 适合继续原任务;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
/compactGoal 保留方向,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 更适合一次性、非交互和脚本化任务。
/review 和 codex review 一样吗
目标相近,但入口不同。/review 在当前交互会话中审查;codex review 是 CLI 子命令,适合非交互流程。具体参数以本机帮助为准。
如何查看全部斜杠命令
进入 Codex 后输入 /。列表会随版本、系统和功能开关变化,这是最可靠的本机清单。
可以把命令直接放进 CI 吗
可以考虑 codex exec 或 codex review,但应先解决凭据、权限、日志脱敏、失败码和人工复核,不要让 CI 对生产仓库无限制写入。
相关教程
- Codex CLI Windows 安装与首次运行排错
- Codex CLI 更新、降级与卸载教程
- Codex 提示词与 Goal 模板
- Codex 模型与推理强度怎么选
- Codex 与 Claude Code 对比
- Codex 多智能体、Subagents 与 /agent 教程
- Codex Permissions、Sandbox 与 Full Access 教程
本文命令清单依据 2026年8月4日 OpenAI 官方 openai/codex 仓库整理。Codex 更新很快,执行前请用本机 --help 与 / 命令面板复核。