🔥

Codexのレビューを効率化する方法３選

に公開
2025/11/23
AI
GitHub Actions
自動化
AI駆動開発
Codex
tech

OpenAIによるAI駆動開発ツール「Codex」では、実装だけでなくAIによるPRレビューも可能です。
本記事では、そのPRレビューを開発工程に効果的に組み込むために、実際に私が取り入れている設定を3つ解説します。

これらを取り入れると開発工程がこんな感じに効率化されます👇

Before

  1. コードを書いてプルリクエスト（PR）を作成
  2. @codex reviewを手入力でコメントをして、Codexにレビューを依頼
  3. Codexレビューが完了。GitHub PRを見に行ってレビュー完了を知覚
  4. Codexのレビュー結果を読み、修正して再度プッシュ
  5. 再レビューを依頼するために、もう一度 @codex review とコメント

After

  1. コードを書いてプルリクエスト（PR）を作成
  2. ✨ 自動で@codex reviewが投稿される
  3. Codexレビューが完了。✨ すると、自動でレビュー完了がメール通知
  4. Codexのレビュー結果を読み、✨ 自動でAIが修正〜コミット〜プッシュを行う
  5. ✨ 自動でAIが@codex reviewをコメントするので、勝手に再レビュー実行

① プルリクエストを作成したら自動でAIレビューされるようにしよう！

GitHub Actionsを利用して、プルリクエストを作成すると自動的に「@codex review」とコメントされて、そのコメントを見たCodexが自動でレビューを走らせるように設定をします！

1. GitHubのトークンを生成する

まず、自分のGithubアカウントとしてコメントをさせるための、鍵（パーソナルアクセストークン）を生成します

なぜ「パーソナルアクセストークン」が必要なのか？

Codexは、GitHub Botのコメントを無視する仕様になっています。
つまり、Codexにレビュー依頼をする「@codex review」のコメントは、Botからではなく自分のアカウント権限でコメントを投稿する必要があるため、PERSONAL_ACCESS_TOKENを使うようにしています。

操作手順

  1. 自身のGithubアカウントの設定画面から「Developer settings」を選択
  2. 「Personal access tokens」を選択し、表示された項目の「Fine-grained tokens」を選択
  3. 「Generate new token」を選択
  4. 以下の設定を行う：
    • Token name：トークンの名前（例：「{repository_name}-GitHubActions-PRAutoComment」」）
    • Description
      • トークンの用途が分かる説明を入力（例：「〜のPR自動レビュー用」）
    • Resource owner
      • レポジトリが属するアカウントを選択
    • Expiration
      • トークンの有効期限を設定
    • Repository access
      • 「Only select repositories」を選択し、自動レビューさせたいレポジトリを選択
    • Permissions
      • トークンの権限（permission）を決める。以下のように選択
      • Codespaces：Read-only
      • Issues：Read-and-write
      • Metadata：Read-only（デフォルトで固定）
      • Pull requests：Read-and-write
  5. 「Generate token」をクリック
  6. 確認モーダルが出てくるので、以下のようになっていることを確認して「Generate token」を再度クリック
  7. 生成されたトークンが表示されるので、忘れずにコピー
    （※一度ページを離れると再確認できないので注意）

2. 生成したトークンを設定する

生成したトークンを該当レポジトリに設置して、トークンをGithub Actionsが使えるようにする。

操作手順

  1. Githubの該当レポジトリの設定画面から「Secrets and variables」を選択し、表示された「Actions」をクリック
  2. 「Repository secrets」セクション中の、「New repository secret」をクリック
  3. 先ほど生成したトークンを設定する
    • Name: 「PERSONAL_ACCESS_TOKEN」と入力
    • Secret: github_pat_からはじまる、先ほどコピーしたトークンを貼りつける
  4. 「Add secret」をクリックして適応
  5. 「Repository secrets」内に、「PERSONAL_ACCESS_TOKEN」が登録されていたら成功

3. レポジトリに自動化ファイルを追加する

自動レビュー依頼を行うためのGithubActions用コードをレポジトリに設置します。
ルートディレクトリ直下に/.github/workflowsというディレクトリを作成。（.gitではない）
そこに、pr-auto-comment.ymlというファイルを新規作成し、以下の内容をコピペします。

.github/workflows/pr-auto-comment.yml
name: PR Auto Comment
on:
  pull_request:
    types: [opened]

permissions:
  issues: write
  pull-requests: write

jobs:
  comment:
    if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/github-script@v7
        with:
          github-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
          script: |
            await github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.payload.pull_request.number,
              body: "@codex review",
            });
コード解説
  • 外部のforkやBotが生成したPRでは、自動レビューコメントを送らないようにしています。
    そのために、${{ github.event.pull_request.head.repo.full_name ==github.repository }} で実行条件を絞る記述をしています。

コピペしたら、忘れずにgit commitとgit pushを行います。

4. 設定完了！

以後、該当レポジトリに対してプルリクエストを作成するだけで、自動で「@codex review」コメントが投稿され、プルリクエストの内容をCodexが自動でレビューします。

② レビュー完了通知をメールで受け取り、判断のラグを減らそう！

「レビュー終わってたのに気づかず放置していた！」を無くすために、Codexのレビュー完了通知をメールで受け取るように設定をします！

操作手順

Githubの通知設定を操作します。

  1. 自身のGithubアカウントの設定画面から「Notifications」を選択
  2. 「Email」セクションで、メール通知が有効になっていることを確認する
  3. 下部の「Email notification preferences」セクションで、以下の項目にチェックを入れる：
    • 「Pull request reviews（プルリクエストのレビュー）」
    • 「Pull request comments（プルリクエストのコメント）」

これで設定は完了です。
以後、レビューが終わると自動でメール通知が届き、PRページを定期的に確認する必要がなくなります。

③ レビュー指摘への修正をAI駆動で対応しよう！

PRを立てた後のレビューと修正の流れを自動化します。

Codexには、PRレビューに対して@codex fix commentsとコメントすると、CodexCloudが自動で修正を行いプッシュまで実行してくれる機能があります。

ただし、複数の解決アプローチにトレードオフがある場合は、非言語化された要件を理解している人間が最適な方法を選択する必要があります。
そのため、私はこの機能を小規模で単純なタスクのみに限定しています。

一方で、本格的なタスクでは、ローカルのIDEでCodex CLIにIssue内容を渡し、まず「そのIssueが妥当かどうか」を評価させ、妥当と判断された場合のみ、修正処理を実行します。

そこに、GitHub MCPを組み合わせることで、
「Issue評価 → 修正 → コミット → プッシュ → レビュー依頼」までを一気通貫でCodex CLIに自動実行させることができます。

1. GitHubでアクセストークンを作成する

1-1-1の手順と同様に、GitHubでアクセストークンを作成します。

  1. GitHubにログインし、右上のプロフィールアイコンをクリックして「Settings（設定）」を選択。
  2. 左側のサイドバーから「Developer settings（開発者設定）」をクリック。
  3. 「Personal access tokens（個人用アクセス トークン）」を選択し、「Tokens (classic)」をクリック。
  4. 「Generate new token（新しいトークンの生成）」をクリック。
  5. 以下の設定を行う：
    • Note: トークンの用途が分かる説明を入力（例：「GitHub MCP用」）
    • Expiration: 適切な有効期限を設定（セキュリティの観点から推奨）
    • Scopes: repo スコープにチェックを入れる（プライベートリポジトリを含むすべてのリポジトリへのフルアクセス）。パブリックリポジトリだけで十分な場合はpublic_repoでも可。
  6. 「Generate token（トークンの生成）」をクリック。
  7. 生成されたトークンをコピーして安全な場所に保存。

2. Codex CLIにGitHub MCPを登録する

CodexCLIの設定ファイルはホームディレクトリ直下の ~/.codex/config.toml にあります。
その~/.codex/config.toml に以下の内容を追加します。
（github_pat_xxxxxxxxxxxxxxxxxxxxxx の部分は、先ほど作成したアクセストークンに置き換えてください）

[mcp_servers.github]
command = "mcp-proxy"
args = ["--transport", "streamablehttp", "-H", "Authorization", "Bearer github_pat_xxxxxxxxxxxxxxxxxxxxxx", "https://api.githubcopilot.com/mcp/"]

3. 接続確認と利用開始

  1. ターミナルで codex と入力してCodex CLIを起動します。
  2. 起動中に、プロンプト画面で /mcp と入力すると、接続済みのMCPサーバー一覧が表示されます。ここに github（先ほど登録した名前）が「Ready」と表示されていれば成功です。
  3. 動作確認として、Codexのプロンプトで「このリポジトリのIssueを一覧してください」などと入力すると、GitHub MCP経由で操作が実行されます。

4. GitHub MCPを使用して修正〜再レビューを自動化する

実際のワークフローでのGitHub MCPの使用方法は以下の通りです。

まず、PRレビューで指摘された問題点をコピー＆ペーストでCodex CLIに渡し、「その指摘が妥当であるか？」「どう解決すべきか？」の判断を仰ぎます。

実際に使用しているプロンプト例）

{レビュー内容のコピー}。このようなレビューがきています。妥当ですか？妥当であるならば実装アプローチを教えてください。
もしも、複数アプローチがある場合は、それぞれのアプローチについて、メリット・デメリット、
リスク、一般的なアプローチか？あなたは推奨するか？それぞれのアプローチはどういうケースに選ぶか、を教えてください。

そして、複数案提案された場合は、最も良いアプローチを選択して実装を依頼します。

実際に使用しているプロンプト例）

では、アプローチXを実装してコミットして、npm run qualityを実行して問題がなければプッシュして、
問題があったら修正して再度コマンドを実行して、問題がなくなるまで修正してプッシュしてください。
プッシュしたら、GitHubのMCPを使って「@codex review」とコメントしてください。

これにより、「Issue評価 → 修正 → コミット → プッシュ → レビュー依頼」までを、Codexが自動で実行してくれます。

そして、レビューが完了したら②で設定したとおり、メールで通知が届きます。
メールが届いたらPR状態を確認し、問題なければマージして次のタスクへ、もし問題があれば、再度③のワークフローを繰り返します。

まとめ

本記事では、CodexでのAI駆動開発を自動化・高速化するための3つの手法を説明しました。

  1. PR作成時のレビュー依頼の自動化：GitHub Actionsを使用してPR作成時に自動で@codex reviewをコメント
  2. メール通知の設定：レビュー完了を即座に知らせる仕組み
  3. 修正〜再レビューの自動化：GitHub MCPを活用してCodex CLIに一連の処理を自動実行させる

これらの手法を採用することで、人間が行わなくても良い単純操作を自動化させることができ、開発効率が上がります。AI駆動開発では人間の稼働が１番のボトルネックですので、人間の少しの効率化であっても、AI駆動開発全体では数倍の効率化に繋がります。

そして、空いた時間を有効活用することで、さらに開発効率が向上。
Git worktreeを使用して、別機能を実装しても良し、リファクタリングしても良し。
次の機能の要件ドキュメントを書いても良し。デバッグを見ながらUIUXを手直ししても良し。
そもそも他のプロジェクトを進めても良し。

限りある人間のリソースを有効活用し、効率的なAI駆動開発をしましょう！🔥

Discussion