Codex CLI 命令速查表
一页纸版本。下次卡住时打开这页,九成你要的命令都在这里。
使用方式
不用背。复制你需要的命令,把中括号里的内容换成自己的项目路径或提示词。凡是会改文件、联网、删除、发布的动作,先看一眼 Codex 要做什么。
安装与升级
| 命令 | 作用 | 什么时候用 |
|---|---|---|
npm install -g @openai/codex | 安装或重装 Codex CLI | 第一次安装,或命令坏了想重装 |
npm update -g @openai/codex | 用 npm 升级全局安装包 | 你是通过 npm 安装的 Codex |
npm install -g @openai/codex@0.161.0 | 安装本教程 2026-10-08 核对的稳定版 | npm 安装用户使用;新增 MCP 会话内登录、语音设备设置,详见 最新变化 |
codex update | 检查并应用 Codex CLI 自更新 | 当前安装版本支持自更新时 |
codex --version | 查看当前版本号 | 确认装好了,或排查“是不是版本太旧” |
codex doctor | 生成本地诊断报告 | 登录、网络/代理、终端防护软件、桌面端状态或更新连接不正常时 |
codex login | 登录 Codex | 第一次使用,或提示未登录时 |
codex login --device-auth | 用设备码登录 | 浏览器登录打不开、远程机器或 SSH 环境 |
codex logout | 退出登录并清除本机凭据 | 共用电脑、换账号、排查登录问题 |
启动与运行
| 命令 | 作用 | 小白解释 |
|---|---|---|
codex | 在当前目录进入交互式终端 UI | 最常用,像打开一个项目里的 Codex 聊天窗口 |
codex "请总结这个项目结构" | 启动时顺便发第一句话 | 省一步打开后再输入 |
codex -C [项目路径] | 指定工作目录后启动 | 你不想先 cd 到项目目录时用 |
codex --image [图片路径] | 启动时附带图片 | 让 Codex 看截图、设计稿、报错图 |
codex --model gpt-6-astra | 指定 GPT-6 Astra 启动 | 要处理代码、网页、研究或文件交付串在一起的复杂任务 |
codex --worktree | 用 Worktree 启动隔离会话 | 想让新任务在独立 Git 工作目录中进行;0.156 起默认开启支持 |
codex resume | 从最近会话列表里恢复 | 昨天聊到一半,今天接着来 |
codex resume --last | 直接恢复当前目录最近一次会话 | 最省事的“继续上次” |
codex app | 启动 Codex 桌面端 App | 想从终端打开桌面端时用 |
codex agents | 打开交互式 Agent dashboard | 搜索、启动、打开、重命名或停止本地和远程任务 |
codex queue | 向已有本地或远程会话发送排队消息 | 任务还在运行,但你想先安排下一条方向 |
一次性执行:codex exec
codex exec 适合自动化脚本、CI、批处理。它不会打开交互界面,而是执行完把最终结果打印出来。
| 命令 | 作用 |
|---|---|
codex exec "总结这个仓库的结构" | 只跑一次任务,输出最终答案 |
codex exec --sandbox workspace-write "修复这个 lint 错误" | 允许它在当前工作区改文件 |
codex exec --json "检查这个项目" | 输出 JSONL,适合交给别的脚本处理 |
codex exec -m gpt-6-astra "审查当前改动" | 用 GPT-6 Astra 跑一次非交互复杂任务 |
codex exec resume --last "继续实现刚才的计划" | 让非交互任务接着上一次会话跑 |
codex exec fork --help | 查看从旧会话分叉新路线的参数；0.148.0 起可用 |
自动化里权限越小越好
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 | 不弹审批提示 | 脚本化环境才考虑,同时要配好沙盒 |
--approve-for-me | 让支持版本自动审查审批请求 | 会改变审批流程；新手先不用，熟悉边界后再考虑 |
--search | 启用 live web search | 需要查最新资料时用,结果仍要当作外部信息审慎处理 |
-c key=value | 临时覆盖配置 | 一次性改模型、网络、功能开关等高级设置 |
交互模式里的命令
| 命令 | 作用 | 什么时候用 |
|---|---|---|
/permissions | 调整权限和审批 | 从只读切到可写,或反过来收紧权限 |
/status | 查看当前会话状态 | 确认模型、权限、工作区、上下文用量 |
/diff | 查看当前 Git diff | 接受改动前检查 Codex 改了什么 |
/review | 让 Codex 审查当前改动 | 完工后做一次自查 |
/model | 切换模型 | 任务变难或想省资源时 |
/fast on / /fast off | 打开或关闭 Fast mode | 愿意多消耗额度来换取更快速度时 |
/fast status | 查看 Fast mode 状态 | 不确定当前是否处于加速模式时 |
/agent | 查看或切换子智能体线程 | 并行任务运行时检查各自进度 |
/plan | 进入计划模式 | 大任务先看方案,不急着改文件 |
/goal | 设置或查看长期目标 | 任务很长,怕中途跑偏时 |
/compact | 压缩长对话 | 聊很久后释放上下文空间 |
/mention | 把文件或文件夹点给 Codex | 想让它重点看某个文件时 |
/init | 生成 AGENTS.md 草稿 | 给项目写长期规则 |
/mcp | 列出 MCP 工具 | 排查外部工具有没有接上 |
/mcp login <name> | 在当前会话登录已配置的 MCP 服务 | 0.161.0 新增;把 name 换成实际服务名,在 Codex 输入框使用,按提示授权后先测试读取 |
/skills | 浏览和使用技能 | 让 Codex 按某类专门流程工作 |
/plugins | 查看插件 | 管理可用插件和插件工具 |
/worktree | 创建或浏览 Worktree | 让新任务或分叉任务在隔离目录里工作;先核对分支和未提交改动 |
/experimental | 管理实验功能开关 | 只启用自己要试的功能,按提示重启;不建议一次全部打开 |
F8 / /voice | 切换语音会话 | 0.156 起默认开启支持;先检查终端麦克风权限,不是先找实验开关 |
/voice settings | 调整语音声音和本机音频设备 | 0.161.0 可选麦克风、扬声器和输入通道;更换耳机后没声音时先检查这里 |
/usage daily | 查看每日 token 活动 | 只看用量;无需领取或使用重置,详见 官方命令说明 |
/tui | 选择终端界面 | 全屏体验和复制习惯不同,按当前版本提示设置下一次启动 |
/daemon | 管理本地后台服务 | 先确认现有会话和服务状态,再决定是否更新 |
/import | 从 Claude Code 或 Cursor 导入支持设置和近期聊天 | 只在空闲的本地会话中使用；最多导入最近 30 天的 50 条聊天 |
/export | 把完整 TUI 会话导出到剪贴板或 Markdown 文件 | 交接、复盘或保留工作记录 |
/cd [路径] | 切换当前 TUI 会话的工作目录 | 要继续处理另一个文件夹时 |
/pwd / /cwd | 查看当前工作目录 | 动手前确认自己没有进错项目 |
/apps | 浏览 app/connectors | 把外部 app 插入提示词里 |
/copy | 复制回复、状态或单项会话信息 | 把结果复制出去;0.154.0 对富文本格式和状态字段支持更完整 |
/new | 在同一个 CLI 里开新对话 | 想换一个干净上下文 |
/clear | 清空终端并开始新聊天 | 界面太乱,想重新开始 |
/resume | 恢复已保存会话 | 接着以前的任务 |
| Resume picker 中 Archive / Restore | 归档或恢复会话 | 整理长会话列表;0.148.0 起可用 |
/quit / /exit | 退出 CLI | 确认重要改动已保存后再退出 |
| Esc | 取消当前输入或请求 | 发现发错了、想停一下 |
| Ctrl+C | 强制中断 / 退出 | 普通取消没反应时 |
配置和长期规则
| 文件 / 命令 | 作用 | 怎么记 |
|---|---|---|
AGENTS.md | 写项目级长期说明 | 告诉 Codex “这个项目的规矩” |
~/.codex/config.toml | 个人全局配置 | 影响你电脑上的 Codex 默认行为 |
codex features | 查看和开关功能 | 某个功能没出现时先查它 |
codex completion | 生成 shell 自动补全脚本 | 让终端里敲命令更顺手 |
codex mcp | 管理 MCP server | 连接外部工具、私有数据源、服务 API |
codex mcp-server | 0.154.0 已移除,不要再使用 | 需要嵌入 Codex 时改用 Codex App Server |
codex plugin | 安装、列出、移除插件 | 给 Codex 扩能力包 |
卡住时的"魔法句"
下面这些短句你可以直接对 Codex 说,常常能救场:
- "请用三句话总结你刚才做了什么"
- "刚才那个改动请撤回"
- "请先给我一份计划,我同意了再做"
- "基于现在的状态,你建议下一步做什么?给我三个选项"
- "请帮我提交一次,信息写 [...] "
- "请运行最小必要检查,不要做无关重构"
- "请先只读检查,不要修改文件"
- "请把刚才的失败原因、已尝试方法、下一步建议列成表"
一句话记住
日常用
codex,自动化用 codex exec,排查用 codex doctor,看改动用 /diff,怕跑偏用 /plan 和 /permissions,并行任务用 /agent 查看。