第 4 章
进阶
14 分钟4 / 8

CLI 详解:交互、非交互与脚本

掌握交互 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
# 关注:认证、权限/沙箱、模型、工作目录相关 flags

CLI 版本迭代快。本教程教的是稳定心智模型;flags 名称以你安装版本的 help 为准。