Codex 自動化とCI/CD

Codex はスクリプト、パイプライン、サーバーサイドで使用できる複数の自動化方式を提供します。


非対話モード(exec)

exec コマンドはスクリプトや自動化のシーンで使用され、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-schemaJSON Schema 形式で出力
--sandboxサンドボックスモードを設定

標準入力から読み取り

stdin 入力

# パイプから読み取り
echo 「このエラーを説明」 | codex exec -

# ファイルから読み取り
codex exec - < task.txt

# 複数行のタスク
cat <<EOF | codex exec -
src を分析/ディレクトリ
潜在的なバグを見つける
修正提案を出力
EOF

セッションの復元

実行の再開

# 最近のセッションを復元
codex exec resume --last 「バグ修正を続行」

# 指定したセッションを復元
codex exec resume --session abc123 「次のタスク」

デフォルトでは、exec は読み取り専用サンドボックスで実行され、ファイルを変更しません。


Codex SDK

Codex SDK はプログラミングインターフェースを提供し、コード内で Agent 機能を呼び出せます。

SDK のインストール

SDK のインストール

npm 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: 「見つかったバグを修正」
});

SDK の適用シーン

  • CI/CD パイプラインへの統合
  • カスタム Agent アプリの作成
  • 内部ツールの自動化
  • タスクの一括処理

GitHub Action

公式の Codex GitHub Action が提供されており、CI パイプラインでタスクをトリガーできます。

基本的なワークフロー

GitHub Action の例

span style="color: green;">
name: Codex Review

on
: [pull_request]

jobs
:
  codex-review
:
    runs-on
: ubuntu-latest
    steps
:
      - uses
: actions/checkout@v4
        with
:
          fetch-depth
: 0

      - name
: Run Codex Review
        uses
: openai/codex-action@v1
        with
:
          prompt-file
: '.github/codex-review.md'
          model
: 'gpt-5.4'
          sandbox
: 'workspace-write'
          output-file
: 'review.md'

      - name
: Post Review
        uses
: actions/github-script@v7
        with
:
          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 style="color: green;">
- name: Run Codex
  uses
: openai/codex-action@v1
  with
:
    prompt
: 「変更をレビュー」
    safety-strategy
: 'drop-sudo'
    unprivileged-user
: 'codex-runner'
    allow-users
: ['maintainers']

GitHub Action を使用する際は、API Key を Secrets として保存し、ハードコーディングしないでください。


App Server

App Server は Codex 機能をサーバーサイド API として公開します。

App Server の起動

サービスの起動

# App Server を起動
codex app-server

# ポートを指定
codex app-server --port 3000

# リモートアクセス
codex --remote ws://server:3000

適用シーン

  • チームで Codex 機能を共有
  • リモート CI/CD からの呼び出し
  • 内部プラットフォームへの統合

MCP Server

Codex を MCP ツールとして他の Agent に提供します。

Codex MCP の設定

MCP Server 設定

# 他の Agent の設定で
[mcp_servers.codex]
command = "codex"
args = ["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 をイメージにインストールし、認証を設定してから呼び出します。

その他の拡張