07 · API / SDK / CI-CD 集成

06-安全与沙箱｜下一篇 → 08-高级技能与编排

Codex 的多种「形态」

形态	用途
CLI（终端）	主要交互方式，本地干活
IDE 扩展（VS Code）	在编辑器里直接用 Codex
桌面 App	图形界面
云端（ChatGPT 里）	多智能体云端跑任务
REST API / SDK	嵌进你自己的应用/自动化

REST API vs SDK

REST API：直接发 HTTP 请求，语言无关，灵活。
OpenAI Agents SDK：更高层，封装了智能体循环/工具/会话，少写样板。
Codex SDK：面向把 Codex 能力嵌进自有工作流。

选择：要细控制/非 JS 语言 → REST；要快速搭智能体 → Agents SDK。

VS Code 扩展

在 VS Code 扩展市场搜 "Codex" → 安装 → 登录
→ 在编辑器侧边栏直接给 Codex 下任务，改动直接落到工作区

适合喜欢图形界面 + 即时 diff 的开发者。
与 CLI 共享同一套认证/配置。

CI/CD：用 GitHub Actions 自动化

这是 Codex 工程化的重头戏——让智能体在流水线里自动干活：

# 概念示意：.github/workflows/codex.yml
name: codex-task
on:
  issues:
    types: [labeled]   # 给 issue 打特定标签触发
jobs:
  run-codex:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Codex
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
        run: |
          npm install -g @openai/codex
          codex exec "读取被打标签的 issue，实现需求并开 PR"

典型自动化场景： - issue → PR：打标签自动让 Codex 实现并提 PR。 - 自动修测试：CI 红了，触发 Codex 定位并修。 - 依赖升级 / 批量迁移：定时跑。

要点： - CI 里必须用 API key（订阅登录需交互浏览器，不可用）。 - CI 里跑务必配好沙箱 + 审批策略（一般 Full-Auto，但范围受控、可回滚）。 - 用 secrets 存密钥，别硬编码。

本节实操

装 VS Code 的 Codex 扩展，跑一个小改动
写一个最小 GitHub Actions，用 OPENAI_API_KEY 跑 codex exec
让它在 CI 里把一个失败测试修绿

下一篇 → 08-高级技能与编排