Codex CLI Single Prompt：不用进入 TUI 的一次性提问

适用场景

有些问题不值得启动完整 TUI。例如你只是想让 Codex 快速解释一个仓库、总结一个错误、找一下测试命令，就可以直接传入一次性 prompt。

基本形式：

codex "explain this codebase"

Codex 会读取当前工作目录，输出结果后退出。

适合做什么

适合 single prompt 的任务：

• 快速解释当前仓库结构。
• 查找测试、构建或启动命令。
• 总结某个错误日志。
• 让 Codex 给出修改方案但先不改代码。
• 对一个小文件或目录做只读分析。

不适合：

• 需要多轮迭代的修复。
• 需要你审查 diff 的复杂改动。
• 长时间执行的云端任务。
• 需要稳定机器可读输出的 CI 流程。

步骤 1：确认当前目录

先确认你在正确项目里：

pwd
git status

如果想指定目录，可以配合 CLI flags，例如官方文档提到的 --path：

codex --path ./packages/web "请解释这个包的入口文件和测试命令"

步骤 2：写清楚是否允许修改

如果你只想分析，明确写：

codex "请阅读这个仓库，找出本地启动命令和测试命令。先不要修改代码。"

如果允许改动，也要写验收：

codex "请修复 README 里的过期启动命令，完成后说明改了什么。"

single prompt 虽然短，也不能省掉边界。

步骤 3：按任务选择模型或参数

对于简单解释任务，默认模型通常够用。复杂分析可以用 --model 或其他参数提前设定行为：

codex --model gpt-5.1-codex "请分析这个测试失败的根因，先不要修改代码。"

具体可用模型以你的账号和当前官方配置为准。

和 TUI 的选择

用 single prompt：

• 想快速得到一次回答。
• 不需要持续审查步骤。
• 不需要多轮修改。

用 codex TUI：

• 想边看边改。
• 需要审批命令。
• 需要多轮修复和验证。
• 需要看 diff、继续追问和 resume。

常见错误

不要在错误目录运行 single prompt。Codex 会基于当前 working directory 判断上下文。

不要把大任务塞进一句命令。大任务更适合 TUI、cloud task 或拆成多个步骤。

不要省略“先不要修改代码”。如果你只想分析，必须说清楚。

小结

codex "..." 是 CLI 里的快速问答入口。它适合短、清楚、一次性的任务；需要多轮协作、审查 diff 或自动化输出时，再切到 TUI、cloud 或 codex exec。