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 を実行します。

APIキーを使うため、料金はChatGPTのプランとは別にAPI側で計算されます。考え方はCodexの料金と使い分けで整理しています。

用意するもの

  1. APIキーをSecretsに保存する。リポジトリの Settings > Secrets and variables > Actions に OPENAI_API_KEY などの名前で登録し、ワークフローでは ${{ secrets.OPENAI_API_KEY }} と参照します。キーをファイルやログに書かないでください。
  2. 先にチェックアウトする。Codexがリポジトリの中身を読めるよう、アクションの前に actions/checkout を置きます。
  3. 指示文を決める。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-keyAPIキー。入れた時にプロキシが起動します
model / effort使うモデルと思考量。空なら既定
sandboxworkspace-write・read-only・danger-full-access から、Codex自身の権限を選ぶ
output-file最終メッセージをファイルに保存して、後のステップで使う
codex-versionCLIの版を固定する。空なら公開されている最新
codex-args追加の指定。JSON配列(例:["--ephemeral"])か、シェル形式(--profile ci)
safety-strategy既定は drop-sudo。実行前にsudoを外す(ジョブの間は戻せません)
allow-users / allow-bots動かせる人を限る。既定は書き込み権限のあるユーザーだけ

思考量の選び方はCodexの思考量(推論レベル)にあります。

権限を絞る:公式の注意

公式は、GitHubのホストランナー上ではCodexに広い権限があるため、絞る設定を使うよう案内しています。

プロンプトインジェクションとキーの扱い

公式のセキュリティチェックリストから、運用で外せない点を挙げます。

リポジトリに入れてはいけない情報の整理はgitignoreとSecretsの確認、権限の考え方はCodexの設定と作業フォルダを見てください。

CIの失敗を直す案を作らせる使い方

公式は、CIが失敗した時にCodexに修正案を作らせる流れも例にしています。要点は権限の分け方です。

  1. メインのCIが失敗で終わった時に、続きのワークフローを動かす
  2. 失敗したコミットを、読み取り権限だけでチェックアウトする
  3. Codexの前の準備は、OpenAIのAPIキーを渡さずに実行する
  4. Codex GitHub Actionを実行する
  5. Codexが手元で変えた内容を、パッチのファイルとして保存する
  6. 別のジョブでパッチを適用し、プルリクエストを開く

公式の例では、Codexのジョブは contents: read だけで、書き込み権限を持つジョブにはAPIキーを渡しません。「キーを持つジョブは書けない」「書けるジョブはキーを持たない」と分けるのが、この例の考え方です。

うまく動かない時

よくある質問

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 を与えています。

関連ページ

出典と確認日

出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。