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 「テストを実行して失敗を修正」
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 | セッションファイルを保存しない |
--json | JSON Lines 出力形式 |
--output-schema | JSON Schema 形式で出力 |
--sandbox | サンドボックスモードを設定 |
標準入力から読み取り
stdin 入力
# パイプから読み取り
echo 「このエラーを説明」 | codex exec -
# ファイルから読み取り
codex exec - < task.txt
# 複数行のタスク
cat <<EOF | codex exec -
src を分析/ディレクトリ
潜在的なバグを見つける
修正提案を出力
EOF
echo 「このエラーを説明」 | codex exec -
# ファイルから読み取り
codex exec - < task.txt
# 複数行のタスク
cat <<EOF | codex exec -
src を分析/ディレクトリ
潜在的なバグを見つける
修正提案を出力
EOF
セッションの復元
実行の再開
# 最近のセッションを復元
codex exec resume --last 「バグ修正を続行」
# 指定したセッションを復元
codex exec resume --session abc123 「次のタスク」
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: 「見つかったバグを修正」
});
// 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'
});
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']
- 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 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"]
[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 をイメージにインストールし、認証を設定してから呼び出します。
その他の拡張