Codex CLI 命令速查表
一页纸版本。下次卡住时打开这页,九成你要的命令都在这里。
使用方式
不用背。复制你需要的命令,把中括号里的内容换成自己的项目路径或提示词。凡是会改文件、联网、删除、发布的动作,先看一眼 Codex 要做什么。
安装与升级
| 命令 | 作用 | 什么时候用 |
|---|---|---|
npm install -g @openai/codex | 安装或重装 Codex CLI | 第一次安装,或命令坏了想重装 |
npm update -g @openai/codex | 用 npm 升级全局安装包 | 你是通过 npm 安装的 Codex |
codex update | 检查并应用 Codex CLI 自更新 | 当前安装版本支持自更新时 |
codex --version | 查看当前版本号 | 确认装好了,或排查“是不是版本太旧” |
codex doctor | 生成本地诊断报告 | 登录、配置、Git、终端、线程列表等看起来不正常时 |
codex login | 登录 Codex | 第一次使用,或提示未登录时 |
codex login --device-auth | 用设备码登录 | 浏览器登录打不开、远程机器或 SSH 环境 |
codex logout | 退出登录并清除本机凭据 | 共用电脑、换账号、排查登录问题 |
启动与运行
| 命令 | 作用 | 小白解释 |
|---|---|---|
codex | 在当前目录进入交互式终端 UI | 最常用,像打开一个项目里的 Codex 聊天窗口 |
codex "请总结这个项目结构" | 启动时顺便发第一句话 | 省一步打开后再输入 |
codex -C [项目路径] | 指定工作目录后启动 | 你不想先 cd 到项目目录时用 |
codex --image [图片路径] | 启动时附带图片 | 让 Codex 看截图、设计稿、报错图 |
codex resume | 从最近会话列表里恢复 | 昨天聊到一半,今天接着来 |
codex resume --last | 直接恢复当前目录最近一次会话 | 最省事的“继续上次” |
codex app | 启动 Codex 桌面端 App | 想从终端打开桌面端时用 |
一次性执行:codex exec
codex exec 适合自动化脚本、CI、批处理。它不会打开交互界面,而是执行完把最终结果打印出来。
| 命令 | 作用 |
|---|---|
codex exec "总结这个仓库的结构" | 只跑一次任务,输出最终答案 |
codex exec --sandbox workspace-write "修复这个 lint 错误" | 允许它在当前工作区改文件 |
codex exec --json "检查这个项目" | 输出 JSONL,适合交给别的脚本处理 |
codex exec resume --last "继续实现刚才的计划" | 让非交互任务接着上一次会话跑 |
自动化里权限越小越好
codex exec 默认偏保守。只有确定任务需要改文件时,才加 --sandbox workspace-write。danger-full-access 只适合隔离环境,不要在自己的主力电脑项目里随手用。审批与沙盒
| 命令 / 标志 | 作用 | 建议 |
|---|---|---|
--sandbox read-only | 只读,不能改文件 | 让 Codex 解释、检查、做计划时用 |
--sandbox workspace-write | 可以改当前工作区 | 日常开发最常用 |
--sandbox danger-full-access | 绕过更多限制 | 慎用,只在隔离环境里考虑 |
--ask-for-approval on-request | 需要越界时再请求批准 | 交互式工作推荐 |
--ask-for-approval never | 不弹审批提示 | 脚本化环境才考虑,同时要配好沙盒 |
--search | 启用 live web search | 需要查最新资料时用,结果仍要当作外部信息审慎处理 |
-c key=value | 临时覆盖配置 | 一次性改模型、网络、功能开关等高级设置 |
交互模式里的命令
| 命令 | 作用 | 什么时候用 |
|---|---|---|
/permissions | 调整权限和审批 | 从只读切到可写,或反过来收紧权限 |
/status | 查看当前会话状态 | 确认模型、权限、工作区、上下文用量 |
/diff | 查看当前 Git diff | 接受改动前检查 Codex 改了什么 |
/review | 让 Codex 审查当前改动 | 完工后做一次自查 |
/model | 切换模型 | 任务变难或想省资源时 |
/plan | 进入计划模式 | 大任务先看方案,不急着改文件 |
/goal | 设置或查看长期目标 | 任务很长,怕中途跑偏时 |
/compact | 压缩长对话 | 聊很久后释放上下文空间 |
/mention | 把文件或文件夹点给 Codex | 想让它重点看某个文件时 |
/init | 生成 AGENTS.md 草稿 | 给项目写长期规则 |
/mcp | 列出 MCP 工具 | 排查外部工具有没有接上 |
/skills | 浏览和使用技能 | 让 Codex 按某类专门流程工作 |
/plugins | 查看插件 | 管理可用插件和插件工具 |
/apps | 浏览 app/connectors | 把外部 app 插入提示词里 |
/copy | 复制最新回复 | 把总结、计划、命令复制出去 |
/new | 在同一个 CLI 里开新对话 | 想换一个干净上下文 |
/clear | 清空终端并开始新聊天 | 界面太乱,想重新开始 |
/resume | 恢复已保存会话 | 接着以前的任务 |
/quit / /exit | 退出 CLI | 确认重要改动已保存后再退出 |
| Esc | 取消当前输入或请求 | 发现发错了、想停一下 |
| Ctrl+C | 强制中断 / 退出 | 普通取消没反应时 |
配置和长期规则
| 文件 / 命令 | 作用 | 怎么记 |
|---|---|---|
AGENTS.md | 写项目级长期说明 | 告诉 Codex “这个项目的规矩” |
~/.codex/config.toml | 个人全局配置 | 影响你电脑上的 Codex 默认行为 |
codex features | 查看和开关功能 | 某个功能没出现时先查它 |
codex completion | 生成 shell 自动补全脚本 | 让终端里敲命令更顺手 |
codex mcp | 管理 MCP server | 连接外部工具、私有数据源、服务 API |
codex plugin | 安装、列出、移除插件 | 给 Codex 扩能力包 |
卡住时的"魔法句"
下面这些短句你可以直接对 Codex 说,常常能救场:
- "请用三句话总结你刚才做了什么"
- "刚才那个改动请撤回"
- "请先给我一份计划,我同意了再做"
- "基于现在的状态,你建议下一步做什么?给我三个选项"
- "请帮我提交一次,信息写 [...] "
- "请运行最小必要检查,不要做无关重构"
- "请先只读检查,不要修改文件"
- "请把刚才的失败原因、已尝试方法、下一步建议列成表"
一句话记住
日常用
codex,自动化用 codex exec,排查用 codex doctor,看改动用 /diff,怕跑偏用 /plan 和 /permissions。