Codex CLI 常用命令有哪些?开发者高频操作与终端速查指南

Codex CLI 常用命令有哪些?开发者高频操作与终端速查指南 安装 Codex CLI 之后很多开发者第一反应是codex然后直接开始输入任务。其实 Codex CLI 除了普通对话还提供了不少非常实用的命令例如/status /model /permissions /review /mcp /compact /new /resume这些命令分别负责查看 Token 使用情况、切换模型、调整执行权限、代码 Review、管理 MCP、压缩上下文以及恢复历史会话。如果经常使用 Codex 做项目开发熟悉这些命令会比单纯研究 Prompt 更实用。下面整理一套适合日常开发使用的 Codex CLI 命令速查表。一、先从最基础的codex开始进入项目目录cd my-project然后codexCodex 会以当前目录作为项目上下文开始工作。例如请先分析当前项目结构 告诉我入口文件、主要模块和测试命令 暂时不要修改代码。对于真实项目建议始终先 cd 到项目 ↓ 再启动 codex而不是在用户主目录直接启动然后让 AI 自己寻找项目。二、查看 Codex 版本最常见codex --version这个命令特别适合排查CLI 是否安装成功 PATH 是否正常 当前到底是什么版本比如遇到codex: command not found或者 Windowscodex is not recognized第一步就应该运行codex --version三、/status最值得记住的命令之一进入 Codex 后输入/status可以查看当前会话状态。OpenAI 当前 Codex CLI 中/status会显示包括当前模型Approval Policy可写目录当前 Token 使用情况剩余上下文容量等会话信息。对于重度使用 Codex 的开发者我比较推荐养成习惯任务开始前 ↓ /status 长时间开发后 ↓ /status因为你可以很直观地判断当前会话是不是已经变得过大。四、/usage查看账号使用情况新版 Codex CLI 还提供/usage用于查看账号侧的 Token 使用情况。也可以使用/usage daily查看每日使用情况。或者/usage weekly查看周维度数据。以及/usage cumulative查看累计使用。OpenAI 当前文档说明/usage可以在 TUI 内查看 ChatGPT 登录账号对应的 Token 活动如果当前会话没有相应账号认证则会提示先登录。这对于关注 Codex 额度的用户非常实用。五、/model切换模型在 Codex 中输入/model可以查看和切换当前可用模型。例如/model ↓ 选择模型 ↓ 继续任务有些模型还可以进一步选择推理强度。所以不需要每次退出 Codex ↓ 改配置 ↓ 重新启动直接/model即可。实际开发时可以按任务分配简单代码 → 较轻模型 复杂 Bug → 更强推理 大型架构分析 → 更高推理强度不要所有问题都默认使用最高计算强度。六、/plan让 Codex 先规划再执行如果任务比较大可以使用/plan让 Codex 先进入 Plan 模式。例如/plan 把当前认证系统从 Session 迁移到 Access Token Refresh Token。这时候更适合先得到涉及哪些文件 ↓ 修改顺序 ↓ 潜在风险 ↓ 测试方式再进入实际执行。OpenAI 当前 Codex CLI 已将/plan作为内置命令用于在真正实现之前先生成执行方案。对于大型改动我更推荐Plan ↓ 确认 ↓ 修改而不是一句话 ↓ 直接重构整个项目七、/permissions控制 Codex 可以做什么这个命令非常重要/permissions它控制 Codex哪些操作可以直接执行哪些操作需要先询问。例如涉及运行命令 修改文件 访问网络 执行潜在危险操作时权限策略会影响 Codex 的行为。OpenAI 当前将/permissions作为 CLI 内置命令用于调整 Codex 无需再次确认即可执行的操作范围。在重要项目中不建议为了省几次确认就把权限放得特别宽。更合理的是普通代码修改 → 允许 危险系统操作 → 保留确认八、/review直接让 Codex 做代码 Review这是开发者非常值得使用的一个命令/review它会针对当前 Working Tree 做代码审查。例如git status当前有modified: src/payment.ts src/order.ts tests/payment.test.ts进入 Codex 后/reviewCodex 可以针对当前修改检查行为变化 潜在 Bug 遗漏测试 实现风险OpenAI 当前官方说明中/review会对当前 Working Tree 进行 Review并重点关注行为变化和缺失测试。所以一个很实用的工作流是Codex 修改 ↓ 运行测试 ↓ /review ↓ 人工检查 ↓ git commit九、/init快速生成 AGENTS.md如果一个项目经常使用 Codex可以/init它会帮助生成AGENTS.md基础模板。例如再补充# Project Rules ## Stack - Node.js - TypeScript - Prisma ## Rules - 不允许使用 any - 不修改公共 API 返回结构 - 修改以后运行 npm test - 数据库结构修改必须单独说明这样以后 Codex 进入项目就能读取这些长期规则。这比每次重复记住不要用 any 记住要运行测试 记住不要改 API……更适合长期项目。十、/mcp检查 MCP Server如果配置了 MCP/mcp可以查看当前 Codex 能访问哪些 MCP Server 和工具。新版文档中还支持/mcp verbose查看更详细的 Server 诊断信息。例如/mcp可以确认OpenAI Docs MCP Context7 GitHub MCP是否已经加载。如果 MCP 配置以后无法使用排查顺序建议codex mcp list然后进入 Codex/mcp最后才排查具体 Server。十一、终端外也可以管理 MCP除了/mcpCodex CLI 外层还可以使用codex mcp相关管理命令。Codex 当前 CLI 本身就带有独立mcp子命令用于管理外部 MCP Server。例如常见操作codex mcp list查看 Server。添加远程 MCPcodex mcp add openaiDeveloperDocs \ --url https://developers.openai.com/mcp添加本地 STDIO MCPcodex mcp add context7 -- \ npx -y upstash/context7-mcp十二、/compact上下文太长时非常有用长时间使用 Codex 后经常出现讨论需求 ↓ 分析代码 ↓ 修改 ↓ 测试 ↓ 再修改 ↓ 又讨论会话越来越长。这时候可以/compactCodex 会压缩当前对话历史为后面的任务释放更多上下文空间。OpenAI 当前 CLI 提示也明确建议在会话变长时使用/compact对历史进行总结从而释放上下文。所以如果/status发现上下文已经很大可以考虑/compact十三、/new当前任务结束后开一个新会话如果支付 Bug已经解决。接下来要处理管理员权限系统不要一定继续使用之前已经非常长的上下文。可以/new开启新的会话。之前的历史仍然保留。这是减少上下文污染非常实用的方式。推荐同一个问题 → 保持会话 完全不同任务 → /new十四、codex resume恢复之前的会话退出 Codex 后如果想继续以前的任务可以codex resumeOpenAI 当前 CLI 支持从终端恢复历史会话。进入 CLI 后也可以使用/resume从保存的会话列表里继续之前的线程。所以不用担心退出 Codex 整个任务丢失十五、/mention直接指定文件如果项目很大不想让 Codex自己寻找文件可以/mention然后直接指定src/payment/service.tsOpenAI 当前 Codex CLI 将/mention用于向对话附加指定文件或目录。例如/mention src/payment/service.ts 只分析这个文件里的 支付幂等逻辑。这比请搜索整个项目 找到支付代码……更节省上下文。十六、直接执行 Shell 命令!Codex CLI 里还有一个特别方便的功能!可以直接运行 Shell 命令。例如!git status或者!npm test再例如!rg updateOrder src/OpenAI 当前 Codex CLI 明确支持用!执行 Shell 命令。这样很多时候不需要退出 Codex ↓ 执行命令 ↓ 重新进入尤其适合git status git diff npm test pytest rg ls这类日常命令。十七、codex exec非交互模式运行 Codex除了codexCodex CLI 还有codex exec用于非交互执行任务。当前 Codex CLI 源码中exec也是一级子命令并提供别名e。这类模式比较适合脚本 CI 自动化任务 批量处理例如概念上codex exec 检查当前项目的 TypeScript 类型错误和普通codex最大的区别就是codex 交互式开发 codex exec 一次性非交互任务十八、codex review命令行直接 Review除了交互会话中的/reviewCodex CLI 也提供独立codex review子命令。适合不想开启完整 TUI ↓ 直接针对代码执行 Review如果经常做修改 ↓ Review ↓ 提交可以把这一功能加入自己的 Git 工作流。十九、登录与退出Codex CLI 还提供独立登录管理codex login退出codex logout当前 CLI 中Login和Logout都是正式一级子命令。在 Codex 会话中也可以/logout清除当前保存的登录凭据。如果换账号 共享电脑 授权异常这几个命令就比较有用。二十、退出 Codex最简单/quit也可以/exitOpenAI 当前文档说明这两种都可以退出 Codex CLI。在退出之前建议先!git status确认有没有未检查的重要修改。二十一、Codex CLI 高频命令速查表可以直接收藏下面这张表。命令主要用途codex启动 Codex CLIcodex --version查看版本codex resume恢复历史会话codex exec非交互执行任务codex review非交互代码 Reviewcodex login登录codex logout退出账号codex mcp管理 MCP/status查看模型、Token、权限等/usage查看账号使用情况/model切换模型/plan进入规划模式/permissions设置操作权限/reviewReview 当前代码修改/init创建 AGENTS.md/mcp查看 MCP 工具/compact压缩当前上下文/new创建新会话/resume恢复已有会话/mention指定文件或目录!command直接执行 Shell 命令/quit退出 Codex二十二、开发者真正应该优先记住哪几个如果觉得命令太多不需要全部背。先记这几个就行/status查看状态和 Token。/plan复杂任务先规划。/review检查代码。/compact压缩长上下文。/new不同任务重新开始。/mcp检查外部工具。!git status随时检查项目修改。这几个已经能覆盖大部分日常开发。二十三、一个比较实用的 Codex CLI 工作流例如需要修复订单 Bugcd backend codex进入后/status然后/plan 当前问题 支付成功后订单偶尔仍然是 pending。 先分析问题 不要修改代码。需要指定文件/mention src/payment/service.ts确认方案后执行修改。修改完成!npm test再/review最后!git diff整个流程就是启动 ↓ 看状态 ↓ 规划 ↓ 指定上下文 ↓ 修改 ↓ 测试 ↓ Review ↓ Git Diff这比单纯不停和 Codex 对话更加工程化。二十四、命令用得好也能减少 Token 和额度浪费例如一个会话已经持续几个小时。继续聊天旧任务 历史解释 旧代码 新任务上下文会越来越重。这时/compact或者/new通常更合理。如果只是分析一个文件/mention也比让 Codex扫描整个仓库更加聚焦。所以CLI 命令不仅是操作方便的问题。它也关系到上下文管理 Token Codex 使用额度如果还在同时研究ChatGPT Plus / Pro 订阅、GPT 充值、Codex 额度以及不同方案的使用限制例如 aicz123.com 这类中文资料可以作为国内使用环境下的补充参考实际使用量仍建议通过/status、/usage以及账号 Usage 页面判断。总结Codex CLI 真正好用以后你会发现日常操作并不只是codex然后不停输入 Prompt。更高效的使用方式应该是/status → 看状态 /plan → 先规划 /mention → 控制上下文 /review → 检查修改 /mcp → 调用外部工具 /compact → 压缩上下文 /new → 切换任务 !command → 执行本地命令对于刚开始使用 Codex 的开发者来说不需要一次记住全部命令。先掌握/status /plan /review /compact /new /mcp已经可以明显改善日常使用体验。随着项目越来越复杂再逐渐加入AGENTS.md MCP codex exec 自动化 Review最终才能真正把 Codex CLI 从一个“终端聊天工具”变成开发流程中的 AI 编程 Agent。参考来源OpenAI Codex 官方仓库当前 CLI 子命令包括exec、review、login、logout、mcp等。OpenAI Codex CLI Slash Commands 文档/status、/usage、/plan、/model、/permissions、/review、/mcp等命令说明。OpenAI Codex TUI 官方提示/compact、/new、/init、/status、/review、!Shell 命令等使用建议。