Codex 提供多种自动化方式可以在脚本、流水线和服务端中使用。非交互模式execexec 命令用于脚本和自动化场景不需要打开 TUI。基本用法exec 命令# 执行单次任务codex exec 审查代码并输出报告# 输出到文件codex exec -o review.md 审查 src/auth.py# 使用特定模型codex exec -m gpt-5.4-mini 分析项目结构# 全自动执行codex exec --full-auto 运行测试并修复失败常用参数参数说明-m指定模型-o输出结果到文件--full-auto全自动执行--ephemeral不保存会话文件--jsonJSON Lines 输出格式--output-schema按 JSON Schema 格式输出--sandbox设置沙箱模式从标准输入读取stdin 输入# 从管道读取echo 解释这个错误 | codex exec -# 从文件读取codex exec - task.txt# 多行任务cat EOF | codex exec -分析 src/ 目录找出潜在的 Bug输出修复建议EOF恢复会话恢复执行# 恢复最近会话codex exec resume --last 继续修复 Bug# 恢复指定会话codex exec resume --session abc123 下一步任务默认情况下exec 运行在只读沙箱中不会修改文件。Codex SDKCodex SDK 提供编程接口可以在代码中调用 Agent 能力。安装 SDK安装 SDKnpm install openai/codex-sdk使用示例SDK 基本用法import { Codex } from openai/codex-sdk;// 创建 Codex 客户端const codex new Codex({apiKey: process.env.OPENAI_API_KEY});// 执行任务const thread await codex.run({prompt: 审查 src/auth.py 文件,model: gpt-5.4});// 获取结果console.log(thread.messages);// 继续任务const followUp await codex.run({threadId: thread.id,prompt: 修复发现的 Bug});SDK 适用场景集成到 CI/CD 管道创建自定义 Agent 应用自动化内部工具批量处理任务GitHub Action官方提供 Codex GitHub Action可在 CI 流水线中触发任务。基本工作流GitHub Action 示例span stylecolor: green;name: Codex Reviewon: [pull_request]jobs:codex-review:runs-on: ubuntu-lateststeps:- uses: actions/checkoutv4with:fetch-depth: 0- name: Run Codex Reviewuses: openai/codex-actionv1with:prompt-file: .github/codex-review.mdmodel: gpt-5.4sandbox: workspace-writeoutput-file: review.md- name: Post Reviewuses: actions/github-scriptv7with:script: |const fs require(fs);const review fs.readFileSync(review.md, utf8);github.rest.pulls.createReview({owner: context.repo.owner,repo: context.repo.repo,pull_number: context.issue.number,body: review,event: COMMENT});Action 参数参数说明prompt直接指定任务描述prompt-file指定任务文件路径model使用的模型sandbox沙箱模式output-file输出文件路径codex-args额外 CLI 参数安全配置安全设置span stylecolor: green;- name: Run Codexuses: openai/codex-actionv1with:prompt: 审查变更safety-strategy: drop-sudounprivileged-user: codex-runnerallow-users: [maintainers]使用 GitHub Action 时确保 API Key 作为 Secrets 存储不要硬编码。App ServerApp Server 将 Codex 能力作为服务端 API 暴露。启动 App Server启动服务# 启动 App Servercodex app-server# 指定端口codex app-server --port 3000# 远程访问codex --remote ws://server:3000适用场景团队共享 Codex 能力远程 CI/CD 调用集成到内部平台MCP Server将 Codex 作为 MCP 工具提供给其他 Agent 调用。配置 Codex MCPMCP Server 配置# 其他 Agent 的配置中[mcp_servers.codex]command codexargs [mcp-server]最佳实践安全性使用只读沙箱模式API Key 作为 Secrets 存储限制触发条件仅特定事件审查输出后再应用更改可靠性设置合理的超时时间使用 --ephemeral 避免状态残留验证任务成功后再继续处理失败情况的回滚常见问题Q: exec 和交互模式的区别exec 单次执行后退出适合自动化交互模式持续对话。Q: CI/CD 中如何认证使用 CODEX_API_KEY 环境变量作为 Secrets 存储。Q: GitHub Action 可以修改文件吗可以设置 sandbox: workspace-write。Q: 如何在 Docker 中使用将 Codex 安装到镜像配置好认证后调用。
