首页 / / 第28篇

28 · codex exec 非交互模式:脚本与 CI 用法

五 · 28

codex exec 的输入输出、常用参数、结构化结果、恢复会话和退出码,说明如何把 Codex 稳定接入脚本和 CI。

`codex exec` 是 Codex 的「非交互模式」——不用进入对话界面,一条命令进去、结果出来,专门给脚本和 CI 用的。

「输入输出」很直接:你给它一个任务(输入),它执行完给你结果(输出)。整个过程不需要人盯着,适合自动化。

「常用参数」让你能控制它的行为:指定模型、指定权限、控制输出格式等等。这些参数让它在脚本里「可编程」。

「结构化结果」是它对接自动化的关键:你可以让它输出 JSON 之类结构化的结果,方便你的脚本解析后续处理。

「恢复会话」让它能接着上次的上下文继续,适合那些要分多步、但希望保持连续的任务。

「退出码」是脚本判断成败的依据:成功返回什么码、失败返回什么码,你的脚本要能据此做下一步判断。

把它用好的关键,是「稳定」。脚本和 CI 最怕「偶尔成功偶尔失败」,所以你要用参数把它的行为「锁死」:固定的模型、固定的权限、可预期的输出格式。

一旦掌握了 exec,Codex 就从「你手动对话的工具」变成了「你流水线里一个可靠的一环」。这是它从「个人提效」走向「工程化」的标志。

动手试一下:比起看十遍,不如立刻打开 Codex 跑一个小任务验证你理解的概念。比如这一篇讲的概念,你可以找一个一分钟能完成的小需求,让它跑一遍,看实际行为是不是和你理解的一致。

五分钟练习:① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来,你对这一篇的理解会深 3 倍。

延伸阅读:学完这一篇,你可以看本组里的下一篇,把相邻的概念连起来读;也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的,多跳几篇会理解更深。

一页速览:如果只能记三件事,① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。

本教程为原创内容,共 39 篇,覆盖 Codex 从入门到工程实战的全路径。可随时从顶部导航返回目录,或用左侧目录跳转其他章节。