Codex CLI 常用命令与日常工作流

Codex CLI 的使用重点，是把进入正确项目、明确目标、观察操作和验证结果变成稳定习惯。本文整理常见工作流；具体参数与命令是否可用，应以你安装的版本和 codex --help 输出为准。

一、检查 Codex CLI 环境

codex --version
codex --help
git status --short

先记录版本并确认当前工作区。遇到问题时，版本号、系统与错误原文比“用不了”更便于排查。尚未安装的读者先阅读 Codex 安装与入门。

二、启动 Codex CLI 任务

在目标仓库根目录进入交互界面：

codex

也可以携带初始任务：

codex "阅读 README，说明项目如何运行测试，先不要修改文件"

路径应限制在当前任务所需的项目中。不要为了省一步切换目录，就从包含大量无关文件的父目录启动。

三、恢复已有会话

codex resume

恢复前再次检查仓库与分支。旧上下文不保证当前文件与上次一致；如果期间做过改动，主动说明变化，让 Codex 重新读取关键文件。

把互不相关的任务放在独立会话中，更容易定位需求与结果。长期规则应写入项目的 AGENTS.md，不要依赖某段历史对话一直存在。

四、非交互执行

codex exec 可用于目标明确的非交互任务。例如：

codex exec "阅读项目说明，只总结构建与测试命令，不修改文件"

接入自动化前，先理解该版本的鉴权、权限、输出和退出状态。在无人值守环境中还要明确超时与失败处理，不能仅根据有文字输出就判定成功。本文示例不包含生产写入或发布操作。

五、查看帮助与改动

交互界面输入 / 查看当前版本支持的命令。不要假设旧文章中的每个斜杠命令都仍然存在；使用本机菜单比机械照抄更可靠。

任务后使用 Git 检查变更范围：

git diff --stat
git diff

确认实现符合要求，再检查测试证据。提示词中可以明确要求“列出运行过的命令、结果和未验证事项”，详见 Codex 提示词。

常见问题

恢复会话后为什么需要重新检查项目？

因为分支、文件和依赖可能已经变化。旧会话可提供历史背景，但不能替代读取当前代码。

CLI 参数与教程不同怎么办？

记录 codex --version，查看 codex --help 和对应官方文档。不要为了匹配一篇旧文章随意降低安全设置。

掌握这些 Codex CLI 命令后，把注意力放回任务范围与验证，逐步建立自己的开发工作流。