Codex CLI 常用命令与高效工作流

发布于 2026年7月17日更新于 2026年7月17日作者：Codex 中文指南

Codex CLI 的核心不是记住大量参数，而是把“进入正确项目、给出边界、观察操作、验证结果”变成稳定习惯。下面的命令覆盖大部分日常场景；具体选项应以本机 codex --help 输出为准。

启动与继续任务

在仓库根目录启动交互界面：

codex

直接附带任务描述：

codex "检查当前分支的改动，找出可能的回归风险"

继续之前的会话可以使用恢复命令：

codex resume

恢复会话前先确认当前仓库和分支是否与原任务一致。旧会话中的上下文不会替你保证工作区没有变化。

非交互执行

codex exec 适合目标明确、输出可被脚本消费的任务：

codex exec "运行 lint，并只报告失败文件和错误原因"

它常用于自动化检查和 CI，但不应在没有权限约束的情况下直接执行模糊任务。自动化场景要明确工作目录、允许的操作、失败退出条件和输出格式。

会话中的斜杠命令

在交互界面输入 / 可以查看当前版本支持的命令。常用入口通常包括：

• /model：查看或切换当前可用模型。
• /permissions：检查或调整当前任务的权限策略。
• /review：对工作区或分支改动执行代码审查。
• /diff：查看当前修改。
• /status：查看会话和上下文状态。
• /compact：在长会话中压缩历史上下文。
• /new：开始一个新会话。

命令名称和可用性可能随客户端版本变化，因此文章不把界面截图当作唯一依据。遇到差异时，以 CLI 内的 / 列表为准。

MCP 管理

Codex 可以通过 MCP 连接外部工具。查看相关子命令：

codex mcp --help

添加 MCP 服务器前，应先理解它暴露哪些工具、会读取哪些数据、是否具有写入能力。详细配置见 Codex 与 MCP。

一个稳定的 CLI 工作循环

1. 先建立上下文

让 Codex 读取项目说明和相关模块，并复述它理解的范围。复杂需求可以先要求计划，不立即写文件。

2. 把任务切小

一次处理一个可验证结果。例如先完成数据层与测试，再处理 UI；不要把迁移数据库、重写接口、改版页面和发布生产混成一条任务。

3. 查看差异

Codex 完成后不要只看总结。使用 /diff 或 Git 检查实际文件：

git diff --stat
git diff

4. 要求验证证据

让 Codex明确列出运行过的命令、测试结果和没有验证的部分。没有执行测试与“测试应该能通过”是两回事。

为第三方 API 准备环境变量

使用 APIBest 时，可先在当前 shell 中设置独立环境变量：

export APIBEST_API_KEY="你的 API Key"
codex

这只影响从该终端启动的进程。长期配置可以写进 shell 的安全凭据加载流程，但不要把明文密钥放入项目脚本。模型提供商配置见 使用 APIBest 为 Codex 配置自定义 API。