正文预览
最后核对
官方资料最后核对日期:2026-10-12。本文参考 Codex CLI 概览、Developer commands / CLI Reference 与 Codex CLI 官方仓库。CLI 更新较快,具体参数仍应以当前版本的 codex --help 和子命令帮助为准。
CLI 是 Codex 最适合练基本功的入口。本页按官方教程的逻辑,把交互模式、非交互模式、会话恢复、Slash Commands 和常用启动参数整理成中文实操版。
模式
适合任务
典型命令
交互模式
学习仓库、逐步改代码、需要随时打断
codex
一次性任务
CI、脚本、批量分析、生成摘要
codex exec "任务说明"
恢复会话
延续之前上下文、继续未完成任务
codex resume
上面列出的是三种最常见的使用方式。除此之外,Codex CLI 还提供 review、fork、doctor、features、mcp、plugin、sandbox 等子命令。后文会挑选其中常用的命令进行介绍。
进入项目根目录后运行:
codex
建议第一句话先限定边界:
请先阅读当前仓库,不要修改文件。请告诉我:
1. 项目用途
2. 入口文件
3. 安装、构建和测试命令
4. 你建议优先补齐的 5 个文档或测试任务
交互模式最适合学习 Codex 的思考过程。你可以在它准备执行命令前停下来,确认命令意图,也可以把任务拆成多轮推进。
codex exec 适合把 Codex 放进脚本、CI 或重复任务里。例如:
codex exec "请阅读 README 和 package.json,输出本项目的本地启动命令和测试命令。不要修改文件。"
适合的场景:
- 批量生成仓库摘要。
- 在 CI 失败后自动收集失败原因。
- 为 release notes 生成初稿。
- 从日志中提取排障建议。