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

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

启动与继续任务#

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

bash

codex

直接附带任务描述：

bash

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

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

bash

codex resume

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

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

bash

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

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

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

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

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

bash

codex mcp --help

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

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

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

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

bash

git diff --stat
git diff

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

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

bash

export APIBEST_API_KEY="你的 API Key"
codex

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