Appearance
Codex CLI 常用命令与参数：从启动到排障
安装 Codex CLI 后，真正影响效率的是如何启动任务、限制修改范围和验证结果。本文整理一套不依赖具体版本的命令使用方法；参数名称可能随版本变化，遇到差异时先运行 codex --help 查看当前版本说明。
先确认安装和版本
bash
codex --version
codex --help如果提示找不到命令，先看 Codex CLI 安装与使用，检查 Node.js、npm 全局目录和终端 PATH。版本命令能运行后，再开始配置登录或 Provider。
在项目目录启动
进入仓库根目录后启动：
bash
cd your-project
codex目录很重要。Codex 需要从当前工作区读取代码、测试、package.json 和适用的 AGENTS.md。在错误的父目录启动，可能读不到项目规则，也可能把不相关文件纳入上下文。
第一次可以给一个只读任务：
阅读 package.json 和项目入口，只告诉我启动、测试和构建命令，不要修改文件。
常用操作模式
不同版本的交互命令可能略有区别，下面是稳定的使用意图：
codex --help：查看当前版本支持的启动参数。codex --version：确认实际执行的版本。- 交互会话中的继续功能：在同一上下文中追问、补充约束或要求验证。
- 只读分析：在提示词中明确“不要修改文件”。
- 小范围实现：指定目录、禁止修改的文件和完成标准。
不要从旧文章复制未经确认的短参数。先看本机帮助，再把实际命令记录进团队的 AGENTS.md。
用提示词限制修改范围
命令行只是入口，任务边界仍应写进提示词：
text
请修复登录接口的超时处理。
只允许修改 src/auth 和 tests/auth。
先给出计划，确认后再编辑。
完成后运行受影响测试和 npm run build，并汇报结果。这个写法比一句“修好登录”更容易审查，也能减少 Codex 为了完成目标而修改无关文件。
任务完成后的检查
每次让 Codex 修改代码后，建议按固定顺序执行：
git diff查看改动范围。- 运行受影响的测试。
- 运行类型检查或构建。
- 检查新增依赖、日志和配置文件。
- 用最小场景复现用户路径。
如果 Codex 报告“已完成”但没有给出命令结果，不要把它当成验证通过。让它补跑命令并粘贴关键输出。
常见 CLI 问题
codex: command not found
检查安装是否成功、npm 全局 bin 目录是否在 PATH，以及当前终端是否加载了新的 shell 配置。Windows 用户还要检查 PowerShell 使用的 PATH 是否和安装器一致。
启动后读取了错误的项目
运行 pwd 或 Get-Location 确认当前目录，再检查是否在仓库根目录。必要时用绝对路径重新进入项目。
修改范围过大
中止当前任务，查看 diff，恢复无关修改前先确认没有需要保留的用户改动。下一次任务在提示词中写明允许编辑的目录，并先要求计划。
API 配置不生效
先看 API Key 配置 和 401 排障，分别确认变量、Base URL、模型名和实际读取的配置文件。
FAQ
Codex CLI 支持 Windows 吗？
支持情况取决于当前版本和安装方式。请按 Windows 配置排障 检查 Node.js、PowerShell 和 PATH，并以官方发布说明为准。
可以在 CI 里直接运行交互式 Codex 吗？
交互式 CLI 通常不适合直接放进无人值守流水线。CI 应使用明确的非交互入口、受限凭据、超时和日志脱敏策略，先验证当前版本是否提供所需模式。
如何让 Codex 每次都运行测试？
把真实测试命令写进根目录 AGENTS.md，并在当前任务中再次写出完成标准。规则和任务提示词同时存在时，验证要求更不容易被遗漏。