Codex exec模式专为CI自动化设计,支持无交互执行、沙箱权限控制、图片诊断及结构化输出。需注意提示词位置、沙箱风险与文件路径有效性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让Codex在无人值守的CI流水线里自动修复报错、生成测试或更新依赖,必须用codex exec模式——它不进全屏界面、不等你敲回车、执行完立刻退出并把结果吐到终端,适合脚本和自动化场景。
基础执行:一句话搞定简单任务
在终端中直接运行:codex exec 修复src/api/client.ts中fetchUser返回undefined时的类型错误
这一步操作起来很简单,直接把自然语言任务写在命令后面就行。注意【提示词必须放在所有选项之后、且不能加引号】,否则Codex会把它当作文本内容而非指令解析。
指定模型与沙箱权限:让任务更可控
方法一:强制使用gpt-5模型,并允许修改工作区文件codex exec --model gpt-5 --sandbox workspace-write 为src/components/Button.tsx添加loading状态支持
方法二:只读模式下分析代码结构(默认就是只读)codex exec --sandbox read-only 解释package.json中scripts字段的所有命令作用
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法三:完全禁止文件系统访问,仅靠上下文推理codex exec --sandbox none 总结这段正则表达式 /\b(?:[a-z0-9]+(?:-[a-z0-9]+)*)+\b/g 的匹配逻辑
⚠️ 沙箱策略不可逆:一旦设为workspace-write,Codex将获得真实写入权限,【若当前目录不是目标项目根目录,它可能误改其他项目的文件】。
带图片辅助诊断:截图也能喂给exec
第一步:准备好报错截图,保存为./build-error.png
第二步:执行命令→codex exec -i ./build-error.png 解释这个Webpack编译错误并给出修复步骤
第三步:等待输出完成,结果直接打印在终端中
这一步要求图片路径必须是相对或绝对有效路径,不能是URL;如果图片不存在,exec会立即失败并报错“file not found”,不会进入AI推理阶段。
接入CI脚本:把结果存进文件供后续步骤读取
① 只取最终回复内容,跳过中间日志:codex exec --output-last-message "生成本次提交的Conventional Commits格式信息" > COMMIT_MSG.txt
② 同时捕获结构化事件流用于调试:codex exec --json "检查test/目录下所有用例是否覆盖了error边界" 2> events.log
③ 把提示词从stdin传入(适合动态生成的任务描述):echo "重命名所有useXxxHook.ts文件为useXxx.ts" | codex exec -
exec默认把进度信息输出到stderr、最终结果输出到stdout,这个设计就是为了方便管道衔接——比如用grep过滤关键行,或用head -n1取第一行作为变量。

















