CI・自動化の早見
CodexをGitHub Actionsで動かす方法|openai/codex-actionの設定例と権限
GitHub Actionsのワークフローから、Codexにプルリクエストのレビューや修正案づくりをさせる方法です。OpenAI公式が案内している openai/codex-action@v1 の使い方、APIキーの置き方、権限の絞り方、つまずきやすい点を、公式の文書(2026年11月13日確認)に沿って整理します。
最初に答え
GitHub ActionsでCodexを動かす公式の方法は、Codex GitHub Action(openai/codex-action@v1)をワークフローに書くことです。公式の説明では、このアクションがCodex CLIをインストールし、APIキーを渡した時はResponses APIのプロキシを起動して、指定した権限の範囲で codex exec を実行します。
- 用途:プルリクエストのレビュー、リリース前の確認、移行作業など、繰り返す作業をワークフローに任せる
- 必要なもの:GitHubのSecretsに入れたOpenAIのAPIキー(例:
OPENAI_API_KEY) - 実行環境:LinuxまたはMacのランナー。Windowsのランナーでは
safety-strategy: unsafeが必要
APIキーを使うため、料金はChatGPTのプランとは別にAPI側で計算されます。考え方はCodexの料金と使い分けで整理しています。
用意するもの
- APIキーをSecretsに保存する。リポジトリの Settings > Secrets and variables > Actions に
OPENAI_API_KEYなどの名前で登録し、ワークフローでは${{ secrets.OPENAI_API_KEY }}と参照します。キーをファイルやログに書かないでください。 - 先にチェックアウトする。Codexがリポジトリの中身を読めるよう、アクションの前に
actions/checkoutを置きます。 - 指示文を決める。
promptに直接書くか、リポジトリ内のファイルをprompt-fileで指します(どちらか一方)。公式は.github/codex/prompts/に置く例を挙げています。
プルリクエストをレビューさせる設定例
公式の例を短くしたものです。新しいプルリクエストをCodexに読ませ、最終メッセージを codex-output.md に保存します。
name: Codex pull request review
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
codex:
runs-on: ubuntu-latest
permissions:
contents: read
outputs:
final_message: ${{ steps.run_codex.outputs.final-message }}
steps:
- uses: actions/checkout@v5
with:
ref: refs/pull/${{ github.event.pull_request.number }}/merge
fetch-depth: 0
persist-credentials: false
- name: Run Codex
id: run_codex
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt-file: .github/codex/prompts/review.md
output-file: codex-output.md公式の完全な例では、この後に別のジョブを置き、Codexの最終メッセージ(final-message の出力)をプルリクエストのコメントとして投稿しています。Codexを動かすジョブは contents: read だけにして、コメントを書く権限は別のジョブに分けている点が要です。
主な入力項目
| 入力 | 役割 |
|---|---|
prompt / prompt-file | 指示文を直接書くか、リポジトリ内のファイルで指す。どちらか一方だけ |
openai-api-key | APIキー。入れた時にプロキシが起動します |
model / effort | 使うモデルと思考量。空なら既定 |
sandbox | workspace-write・read-only・danger-full-access から、Codex自身の権限を選ぶ |
output-file | 最終メッセージをファイルに保存して、後のステップで使う |
codex-version | CLIの版を固定する。空なら公開されている最新 |
codex-args | 追加の指定。JSON配列(例:["--ephemeral"])か、シェル形式(--profile ci) |
safety-strategy | 既定は drop-sudo。実行前にsudoを外す(ジョブの間は戻せません) |
allow-users / allow-bots | 動かせる人を限る。既定は書き込み権限のあるユーザーだけ |
思考量の選び方はCodexの思考量(推論レベル)にあります。
権限を絞る:公式の注意
公式は、GitHubのホストランナー上ではCodexに広い権限があるため、絞る設定を使うよう案内しています。
- safety-strategy:既定の
drop-sudoは実行前にsudoを外し、メモリ上のシークレットを守ります。unprivileged-userとcodex-userを組み合わせると、特定のアカウントでCodexを動かせます(その場合はチェックアウトの読み書き権限を整える必要があります)。 - read-only:ファイルの変更とネットワークを止めますが、昇格した権限では動くため、これだけでシークレットを守れるとは考えないよう公式が書いています。
- sandbox:Codex自身のファイル・ネットワークの範囲を狭めます。作業に足りる最小のものを選びます。
- 誰が動かせるか:既定は書き込み権限のある人だけです。ほかのアカウントを許すなら
allow-usersに明示します。
プロンプトインジェクションとキーの扱い
公式のセキュリティチェックリストから、運用で外せない点を挙げます。
- プルリクエスト・コミットメッセージ・Issueの本文をそのまま指示文に入れない。HTMLコメントや見えない文字も確認する
- 全員が動かせる設定にせず、信頼できるイベントか明示の承認で動かす
- Codexは、ジョブの最後のステップとして動かす
- 複数の利用者が共有するランナーで
unsafeのまま使わない - キーやアクションの出力から秘密が漏れた疑いがあれば、すぐにキーを再発行する
リポジトリに入れてはいけない情報の整理はgitignoreとSecretsの確認、権限の考え方はCodexの設定と作業フォルダを見てください。
CIの失敗を直す案を作らせる使い方
公式は、CIが失敗した時にCodexに修正案を作らせる流れも例にしています。要点は権限の分け方です。
- メインのCIが失敗で終わった時に、続きのワークフローを動かす
- 失敗したコミットを、読み取り権限だけでチェックアウトする
- Codexの前の準備は、OpenAIのAPIキーを渡さずに実行する
- Codex GitHub Actionを実行する
- Codexが手元で変えた内容を、パッチのファイルとして保存する
- 別のジョブでパッチを適用し、プルリクエストを開く
公式の例では、Codexのジョブは contents: read だけで、書き込み権限を持つジョブにはAPIキーを渡しません。「キーを持つジョブは書けない」「書けるジョブはキーを持たない」と分けるのが、この例の考え方です。
うまく動かない時
- promptとprompt-fileを両方書いた:どちらか一方にします。
- responses-api-proxyの情報が出ない:APIキーが入っているか、有効かを確認します。プロキシはAPIキーを渡した時だけ起動します。
- sudoが外れていない:前のステップでsudoを戻していないか、ランナーがLinuxまたはMacかを確認し、新しいジョブで再実行します。
- drop-sudoの後に権限エラー:アクションの前に書き込み権限を整えるか、unprivileged-userの方式にします。
- 動かせる人として止められた:サービスアカウントを許すなら
allow-usersかallow-botsを調整します。
よくある質問
CodexをGitHub Actionsで使うのにChatGPTのプランだけでよいですか。
公式の手順では、OpenAIのAPIキーをGitHubのSecretsに入れて渡します。APIキーを使う分は、ChatGPTのプランとは別にAPI側で計算されます。料金の考え方はCodexの料金と使い分けを見てください。
Windowsのランナーでも使えますか。
公式は、LinuxまたはMacのランナーを前提にしています。Windowsでは safety-strategy: unsafe にする必要があり、共有のランナーでは使わない設定です。
プルリクエストのレビューだけならどの権限が要りますか。
公式の例では、Codexを動かすジョブは contents: read だけです。コメントを投稿するジョブにだけ issues: write と pull-requests: write を与えています。
関連ページ
出典と確認日
- OpenAI Learn: Codex GitHub Action(前提・設定例・codex exec の設定・権限・セキュリティチェックリスト・トラブルシュート)
- OpenAI Learn: Codex ドキュメント全体(CIで失敗を直す使い方の節)
- openai/codex-action(OpenAI公式リポジトリ)
- 確認日: 2026年11月13日
出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。
