CodexにPRレビューを任せる方法｜GitHub連携設定
Codexは、GitHubのプルリクエストに対して自動でコードレビューを行い、セキュリティ上のリスクやテスト不足、危険な変更をコメントとして指摘してくれます。この記事では、リポジトリでCodexのコードレビューを有効にする設定手順から、@codex reviewメンションでの依頼方法、レビュー結果を実際の開発フローにどう活かすかまでを解説します。読み終える頃には、自分のリポジトリでCodexレビューを動かせる状態になります。
前提・動作環境
Codexのコードレビュー機能は、リポジトリでCodex cloudの設定が済んでいることが前提です。Codex cloud自体の使い方は「Codexクラウドの使い方」で解説していますので、まだ設定していない場合は先にそちらを確認してください。またCodex全体の概要や料金体系は「Codexの使い方完全ガイド」にまとめています。
対象はGitHub上のリポジトリで、Codexの管理画面からリポジトリ単位で機能を有効化する形になります。機能名や設定画面のUIはアップデートで変わる可能性があるため、手元の画面と異なる場合は公式サイト(developers.openai.com/codex)で最新情報を確認してください。
Codexのコードレビュー機能とは
CodexのGitHub連携によるコードレビューは、プルリクエストの差分を読み取り、リポジトリのガイドラインに沿った形で通常のGitHubコードレビューとしてコメントを投稿する機能です。具体的には以下のような観点をチェックします。
- セキュリティ上の後退: 認証処理やシークレット管理に関わる懸念
- テストの不足: 変更範囲に対してカバレッジが足りていない箇所
- ドキュメントの不備: 変更内容に説明が追いついていない箇所
- リスクのある挙動変更: 既存の動作を壊しかねない実装
重大度の高い問題(P0・P1)が優先的に強調される仕組みになっており、些末な指摘で埋もれないよう配慮されています。人間のレビュアーを置き換えるものではなく、マージ承認の前段階で追加のレビュー観点を提供する位置づけの機能です。
セットアップ: GitHub連携とレビュー有効化
Codexのコードレビューを使うには、まず対象リポジトリでCodex cloudの連携が済んでいる必要があります。連携済みであれば、Codexの設定画面からリポジトリを選び、「Code review」のトグルをオンにします。これでそのリポジトリのプルリクエストに対してCodexがレビューできる状態になります。
新しいプルリクエストが作成されるたびに自動でレビューを走らせたい場合は、同じ設定画面にある「Automatic reviews」も合わせてオンにしておきます。オフのままにしておくと、次に説明する@codex reviewメンションによる手動依頼のみでレビューが動く形になります。チームの運用に応じて、常時自動レビューにするか、必要なときだけ呼び出すかを選んでください。
使い方: 自動レビューと@codexメンション
Automatic reviewsを有効にしている場合、プルリクエストを作成した時点でCodexが自動的にレビューを開始し、しばらくすると通常のGitHubレビューと同じ形式でコメントが投稿されます。
手動でレビューを依頼したい場合は、プルリクエストのコメント欄に次のように書き込みます。
@codex review書き込むとCodexが👀の絵文字でリアクションを返し、レビューの準備が始まったことがわかります。しばらく待つとレビューコメントが投稿されます。特定の観点を重点的に見てほしい場合は、依頼内容を具体的に書くこともできます。
@codex review for security regressions, missing tests, and risky behavior changesレビューで指摘された問題をCodexに直接修正してもらうことも可能です。該当のレビューコメントに対して返信する形で依頼します。
@codex fix the P1 issueこのように依頼すると、Codexが修正内容を作成してプルリクエストに反映してくれます。指摘から修正まで一連の流れをGitHub上のコメントだけで完結できるのが特徴です。
レビュー結果の見方と活かし方
Codexのレビューは、通常のGitHubコードレビューと同じ表示形式でPR上に現れるため、人間のレビュアーが行うコメントと並べて確認できます。ただし、Codexのレビューはあくまで「人間によるマージ承認の前段階の、追加のレビューシグナル」として位置づけられています。指摘内容をそのまま鵜呑みにしてマージするのではなく、次のような運用を意識するとよいでしょう。
- 指摘された問題が実際にリスクとして妥当かを人間が判断する
- 修正を依頼する場合も、
@codex fix itで終わらせず差分の内容を確認する - 誤検知や過剰な指摘があれば、AGENTS.mdのレビュールールを調整して精度を上げる
リポジトリのAGENTS.mdに「## Code Review Rules」というセクションを追加すると、Codexが参照するレビュー基準をカスタマイズできます。ルールは実装の細かい手段ではなく、期待する結果(何をフラグすべきか、安全な代替案は何か)を簡潔に書くことが推奨されています。ルールは対象コードの近くに置くほど反映されやすくなります。
CIとの関係・料金と使用量の扱い
Codexのコードレビューは、Lintやテストの実行結果そのものを保証するCIパイプラインとは役割が異なります。CI側で行っているフォーマットチェックやテスト実行のルールをAGENTS.mdに書いておけば、Codexのレビューでもそれを踏まえた指摘をさせることができますが、CIの代替にはなりません。両方を組み合わせ、CIで機械的なチェックを、Codexレビューでより文脈を踏まえた観点のチェックを行う形が現実的です。
料金や使用量の消費についての詳細は、記事執筆時点の公式ドキュメントには明記が見当たりませんでした。プランによって扱いが変わる可能性もあるため、正確な情報は公式サイトで最新情報を確認してください。
つまずきポイント/よくあるエラー
@codex reviewと書いても反応がない: リポジトリでCode review設定がオンになっているか確認してください。Codex cloudの連携自体が済んでいない場合もあります。連携手順は「Codexクラウドの使い方」を参照してください。- 自動レビューが走らない: Automatic reviewsのトグルがオフになっている可能性があります。手動で試したい場合は
@codex reviewを使ってください。 - トリガー文言を書いたのに認識されない:
@codex reviewのように正確な形式で記述する必要があります。表記ゆれがあると反応しないことがあります。 - 指摘が的外れに感じる: AGENTS.mdにレビュールールを追加していないと、汎用的な観点でしかチェックされません。プロジェクト固有のルールを追記すると精度が上がります。
- 修正依頼後の差分を確認せずマージしてしまう:
@codex fix itは便利ですが、生成された修正が意図通りかは必ず人間が確認してからマージしてください。
よくある質問
Codexのレビューは無料で使えますか?
料金・使用量の扱いはプランによって変わる可能性があり、記事執筆時点の公式ドキュメントには明確な記載が見当たりませんでした。正確な情報は公式サイトで最新情報を確認してください。
自動レビューと@codex reviewメンションはどちらを使うべきですか?
すべてのPRに毎回レビューを走らせたいならAutomatic reviewsをオンにするのが手軽です。特定のPRや特定の観点だけレビューしてほしい場合は、@codex reviewで都度依頼する運用が向いています。両方を併用し、自動レビューに加えて追加の観点だけ手動で依頼することもできます。
Codexのレビュー指摘はそのまま信用してマージしてよいですか?
おすすめしません。Codexのレビューは人間による最終判断の前段階を補助するシグナルという位置づけです。指摘内容の妥当性や、@codex fix itで生成された修正差分は、必ず人間が目を通してからマージする運用にしてください。
まとめ
Codexのコードレビュー機能は、Codex cloudの連携済みリポジトリでCode reviewを有効化し、Automatic reviewsか@codex reviewメンションでプルリクエストのレビューを走らせる仕組みです。指摘の重大度はP0・P1が優先的に強調され、@codex fix itのようなコメントで修正まで依頼できますが、最終的なマージ判断はあくまで人間が行う運用が前提です。AGENTS.mdにCode Review Rulesを追記すればプロジェクト固有の観点でチェックさせることもできます。Codexのインストールがまだの方は「Codex CLIのインストール手順」を、Codex全体の使い方を体系的に知りたい方は「Codexの使い方完全ガイド」もあわせてご覧ください。