第 4 章
进阶
14 分钟4 / 8CLI 详解:交互、非交互与脚本
掌握交互 TUI、exec 非交互模式、初始提示与常见工作流命令。
CLI
自动化
exec

CLI 是 Codex 的「全功率」入口:适合复杂推理、多步工具调用,以及写入脚本/CI 的非交互执行。
交互模式
bash·启动方式
# 空会话
codex
# 带任务启动(推荐)
codex "解释 src/ 下的模块边界,并指出循环依赖风险"
# 在特定仓库
cd /path/to/repo && codex交互会话中,你持续补充约束、批准计划、粘贴报错。适合探索未知代码与多轮修 bug。
非交互:codex exec
当你已经把任务写清楚、希望一次性执行并拿到结果时,使用 exec 风格调用(具体子命令以当前 CLI 帮助为准):
bash·脚本化示例
# 一次性任务(示例形态,以 codex --help 为准)
codex exec "Fix all linting errors in src/"
# 把提示放进文件,便于复用
codex exec "$(cat scripts/prompts/fix-lint.txt)"高频工作流模式
| 模式 | 怎么做 | 注意 |
|---|---|---|
| 仓库入职 | codex + 只读总结提示 | 结果写进 AGENTS.md 备忘 |
| 修 CI 红 | 粘贴失败日志 + 指定相关路径 | 先复现再修 |
| 批量风格 | 给出样例文件 + 范围 | 限制路径避免误伤 |
| 生成脚手架 | 输出到新目录再合并 | 人审目录结构 |
永远以本机帮助为准
bash·自助文档
codex --help
codex exec --help
# 关注:认证、权限/沙箱、模型、工作目录相关 flagsCLI 版本迭代快。本教程教的是稳定心智模型;flags 名称以你安装版本的 help 为准。