CodexとGitHubを連携する方法｜PRレビュー・@codexの使い方を解説

「GitHubにあるコードの確認を、Codexに手伝ってもらえないか」「プルリクエストが溜まって、レビューが追いつかない」と感じている方は多いのではないでしょうか。

CodexはGitHubとつなぐことで、プルリクエスト（変更を取り込んでよいかを確認してもらうための依頼）にコメントを付けるだけで、レビューや修正を頼めるようになります。人が確認する前に、Codexに一度目を通してもらう使い方です。

この記事では、連携でできること、使えるプラン、設定の手順、コメントでの頼み方、レビューの基準の書き方、GitHub Actionsでの自動化、動かないときの対処までを順に解説します。内容は2026年10月時点のOpenAI公式ドキュメントにもとづいています。画面や名称は変わることがあるので、設定の前に公式ページもあわせて確認してください。

CodexとGitHubでできること

「CodexとGitHubの連携」と言っても、使い方は1つではありません。公式ドキュメントに載っているものを整理すると、次の4つに分かれます。

このほか、自分のパソコンでCodexを使い、変更をGitのコミットやプッシュでGitHubに送る使い方もあります。これは連携の設定をしなくても、ふだんのGitの操作として使えます。

プルリクエストとは

GitHubでは、直したコードをすぐ本体に反映するのではなく、「この変更を取り込んでください」というプルリクエスト（PR）を作り、他の人が確認してから取り込むのが一般的です。この確認作業が「コードレビュー」です。

Codexのレビューは、この確認を人に頼む前の「もう1人の目」として使うものです。公式のユースケースでも、人によるレビューの前に、回帰（以前は動いていたものが壊れること）や潜在的な問題を見つける用途として紹介されています。

使えるプランと利用量

GitHubとの連携は、ChatGPTのアカウントでCodexを使う有料プランの機能です。公式の料金ページの機能一覧では、次のように分かれています。

料金ページでは、APIキーでの利用について「GitHubのコードレビューやSlackなどのクラウド機能は使えない」と明記されています。FreeとGoプランは、この機能一覧に列がなく、GitHub連携が使えるかどうかは公式には案内がありません。確実に使うなら、Plus以上を前提にしてください。

プランごとの月額や利用上限は、変わることがあります。最新の金額は「Codexの料金」の記事と、公式の料金ページで確認してください。

GitHub上のレビューは別枠で数えられる

公式の料金ページには、使用量の数え方が書かれています。GitHubの上で行われたレビューだけが「Code Reviewの使用量」になり、自分のパソコンで実行したレビューは、ふだんの利用上限に含まれます。

連携とレビューの設定

GitHubのコードレビューを使うには、リポジトリをCodexにつなぎ、レビューを有効にします。設定には、そのリポジトリの設定に対するGitHubのpush権限かadmin権限が必要です。権限がない場合は、リポジトリの管理者に依頼してください。

1. GitHubのリポジトリをCodexにつなぐChatGPTのWebかデスクトップアプリでクラウド環境を作るときに、GitHubへの接続を求められます。画面の案内に従ってGitHubのアカウントを接続し、対象のリポジトリを選びます。
2. Codexの設定画面を開く公式の案内にあるコードレビューの設定ページ（chatgpt.comの「Settings」内のcode review）を開きます。
3. リポジトリを選んで、自動レビューを入れる対象のリポジトリを選び、「Review code」の下にある「Automatic review」をオンにします。手動だけで使うなら、この設定は不要です。
4. PRでコメントして試すプルリクエストを開き、コメントに@codex reviewと書きます。Codexが目のリアクションを付け、レビューを投稿すれば設定は完了です。

旧クラウドと新クラウドの表記について

公式ドキュメントでは、接続の手順が「Codex Cloud (Legacy)」のページを参照する形で案内されています。新しいクラウドの案内に移行している途中で、旧クラウドには「廃止を予定している」という注記もあります。画面の名称が記事と違って見えるときは、公式の最新ページを確認してください。

会社で使うときの確認点

Enterpriseのワークスペースでは、クラウドが初期設定でオフになっています。使わせる人に「Use Codex in the cloud」の権限を管理者が付ける必要があります。GitHub側でも、Codexに見せるリポジトリを、必要なものだけに絞るのが公式の考え方です。

なお、GitHubの組織（Organization）で外部アプリの利用が制限されている場合に、管理者の承認が必要になるかどうかは、公式ページには書かれていません。会社のGitHubで試すときは、GitHubの管理者に先に相談してください。

PRでレビューを依頼する

設定ができたら、PRのコメントでCodexにレビューを頼みます。方法は簡単で、@codex reviewと書くだけです。

1. GitHubでPRを開くレビューしてほしいプルリクエストを開きます。
2. コメントを書くコメント欄に@codex reviewと書いて投稿します。
3. リアクションを待つCodexが目のリアクション（👀）を付けます。
4. レビューを読むしばらくすると、チームメンバーのレビューと同じ形でCodexの指摘が投稿されます。

GitHub上では、Codexは高優先度の問題（P0とP1）だけを指摘します。レビューのコメントを高優先度のリスクに集中させるため、と公式に説明されています。P0・P1の細かい定義は、公式ページには書かれていません。

見てほしい観点を指定する

コメントに続けて、見てほしい観点を書くこともできます。公式の例は次のとおりです。

公式の例はすべて英語です。日本語での指定については案内がないため、実際のPRで試して、結果を見ながら調整してください。

セキュリティ専用のレビュー

通常のレビューとは別に、セキュリティの問題を深く調べる「Security Review」があります。公式では研究プレビュー（試験提供）とされています。コメントで@codex security reviewと書くと、手動で依頼できます。

反応しないときの確認項目

Codexがリアクションもレビューも付けないときは、公式のトラブルシュートに沿って次を確認します。

指摘の修正とクラウド作業

レビューで見つかった問題は、そのままCodexに直してもらえます。同じPRに、続けてコメントを書きます。

review以外の内容で@codexと書くと、そのPRを文脈にした新しいクラウドのチャットが始まります。権限があれば、Codexは修正をそのブランチにプッシュ（送信）できます。

クラウド環境を作って、PRまで進める

コメントからではなく、ChatGPTの画面から「このリポジトリのこの不具合を直して」と頼む使い方もあります。公式のクラウドの手順は次のとおりです。

1. 環境を作るWebかデスクトップアプリでCodexを開き、「Work in」から「Cloud」を選びます。「Create environment」でGitHubのリポジトリを選び、必要ならGitHubを接続します。
2. 準備を任せる「Get started」を選ぶと、Codexがリポジトリを調べ、必要な道具を入れて、動作を確かめます。足りない情報があれば聞かれます。
3. 公開する設定とテスト結果を確認して保存し、「Publish」を選びます。「Environment published」と出れば完了です。
4. 作業を頼む「Start a new task」から、やってほしいことを書いて送ります。各タスクは独立した作業場所で動き、パソコンがスリープしていても進みます。
5. 結果を確認する変更したファイルとテストの結果を見て、追加の依頼をするか、コミットやプルリクエストの作成に進みます。

自分のパソコンで作業した場合も、流れは似ています。デスクトップアプリの「ワークツリー」（元のフォルダとは別に作る作業用のコピー）で作業したときは、チャットの画面で「Create branch here」を選ぶとブランチになり、コミット、プッシュ、GitHubでのPR作成へ進めます。

パソコンの中で見直すだけなら

PRを出す前に、自分のパソコンで確認したいときは/reviewが使えます。CLI・デスクトップアプリ・IDE拡張のどれでも使え、「ベースのブランチとの差」か「まだコミットしていない変更」を選んでレビューさせられます。作業中のファイルは書き換えられません。Gitのリポジトリの中のプロジェクトでだけ使えます。

なお、デスクトップアプリの「Code Review」画面では、PRの説明や変更ファイル、チェックの結果を見ながら、Codexに質問できます。このチャットでの確認では、コメントの投稿、承認、マージは自動では行われません。送るときは「Submit review」で、Comment・Approve・Request changesのどれかを自分で選びます。

AGENTS.mdでレビュー基準を決める

Codexは、リポジトリにあるAGENTS.md（Codexへの指示を書くファイル）を読み、レビューの基準にします。レビューのためのルールは、## Code Review Rulesという見出しの下に書きます。

## Code Review Rules

### 個人情報の取り扱い

- ログに顧客のメールアドレスや電話番号を出力しない。
  安全な方法：ログには顧客IDだけを出力する。

### データベースの移行

- 既存の列を削除する変更は、必ず移行の手順書の更新とセットにする。

上の例は、公式のサンプルをもとに、事務系の読者向けに書き換えた例です。公式のサンプルでは、実験の分析サービスで「結果を見てから比較する集団を絞らない」というルールが書かれています。

置く場所と、書き方のコツ

ルールは、対象のコードに最も近いAGENTS.mdに書きます。リポジトリ全体のルールはいちばん上の階層のAGENTS.mdに、サービスごとのルールはその下の階層のAGENTS.mdに分けて置けます。Codexは、変更されたファイルごとに、該当するルールを適用します。

AGENTS.mdそのものの書き方は、別の記事で詳しく解説しています。

GitHub Actionsで自動化する

GitHub Actions（GitHubの自動実行の仕組み）からCodexを動かす方法もあります。OpenAIは、そのための公式のアクションopenai/codex-action@v1を公開しています。CodexのCLIを入れて、決めた指示を実行し、結果を取り出す部分を担当します。

ここまでで紹介した「GitHub上のコードレビュー」とは別の仕組みです。こちらはワークフローのファイルに、実行する条件や指示を自分で書きます。自社の手順に合わせて細かく作り込みたいときに向いています。

ワークフローの例

公式ドキュメントのサンプルは、PRが作られたり更新されたりしたときにCodexでレビューし、結果をPRのコメントに投稿するものです。要点を抜粋します。

name: Codex pull request review
on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  codex:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v5
        with:
          ref: refs/pull/${{ github.event.pull_request.number }}/merge
          fetch-depth: 0
          persist-credentials: false
      - 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

公式のサンプルでは、このあとに別のジョブを置き、final-messageという出力をPRのコメントとして投稿しています。コメントを書き込むジョブにだけ書き込み権限を与え、Codexを動かすジョブは読み取りだけにしているのがポイントです。

安全に使うための設定

Actionsでは、APIキーを使ってCodexが自動で動きます。公式のチェックリストに沿って、次の点を守ってください。

会社で使うときに決めておくこと

チームで使い始める前に、次のことを決めておくと、運用が安定します。

• どのリポジトリでCodexのレビューを有効にするか（機密性の高いものは外す）
• 自動レビューにするか、依頼したときだけにするか
• Codexの指摘を、誰がいつ確認するか（人の承認は残す）
• Security Reviewを使うか、その指摘をどこまで公開してよいか
• APIキーやクラウドの環境の秘密情報を、誰が管理するか
• AGENTS.mdのレビュー基準を、誰が見直すか

よくある質問

まとめ

Codexのレビューは、人のレビューの代わりではなく、確認の前にもう1人の目を足すものです。まずは1つのリポジトリで、手動の@codex reviewから試し、指摘の質を見ながら、基準や自動化の範囲を広げていくのがおすすめです。

社内に広げる段階では、どのリポジトリで使うか、権限をどう決めるか、レビューの基準をどう書くかなど、決めることが増えます。INTERCREATE JAPANでは、CodexやClaude Codeの導入から、社内で使い続けられる仕組みづくりまでをお手伝いしています。