Codex を開発チームに配ると、早い段階で「Pull Request のレビューにも使えないか」という声が上がります。レビュー待ちで止まる時間は多くのチームの悩みですが、AI のレビューをどこまで信じてよいのか、人のレビューとどう分けるのかが決まらないまま使い始めると、指摘が読まれなくなったり、逆に AI の承認を頼りにマージされたりします。

この記事では、株式会社デジライズが導入支援でご案内している Codex のコードレビューのチーム運用を、OpenAI の公式ドキュメントに記載されている範囲で整理します。

結論: Codex のコードレビューは「重大な問題に絞った追加のレビュー」として位置づけ、マージの判断は人に残してください。そのうえで、レビュー観点は AGENTS.md の ## Code Review Rules に書き、どのリポジトリで自動レビューを動かすかを管理者が先に決めておくと、チームに無理なく定着します。

Codex のコードレビューには3つの入口がある

公式ドキュメントでは、コードレビューに関わる機能が複数の場所で説明されています。最初に入口を整理しておくと、チーム内で話がかみ合いやすくなります。(出典: Review GitHub pull requests with Codex、Code review)

入口 何をレビューするか 結果がどこに出るか
GitHub の Pull Request(@codex review または自動レビュー) Pull Request の差分 GitHub に通常のコードレビューとして投稿される
デスクトップアプリの Code Review Pull Request の説明・変更ファイル・コメント・チェック アプリ内のチャット。コメントは自分で選んで投稿する
/review コマンド(デスクトップアプリ・CLI・IDE 拡張) 手元の Git の変更(ベースブランチとの差分や未コミットの変更) チャットやレビューペイン。作業ツリーは変更されない

この記事で中心に扱うのは1つ目の GitHub の Pull Request レビューです。公式ドキュメントは、Codex が Pull Request の差分を読み、リポジトリのガイダンスに従って、重大な問題に絞った標準の GitHub コードレビューを投稿すると説明しています。GitHub 上では P0 と P1 の問題だけを指摘し、レビューコメントを優先度の高いリスクに集中させるとも記載されています。(出典: Review GitHub pull requests with Codex)

「細かい指摘まで全部拾うレビュアー」ではなく「見落とすと痛い問題を拾うもう1人のレビュアー」と理解しておくと、期待値がずれません。

なお、2つ目と3つ目は Pull Request を出す前後に作成者や担当レビュアーが自分で使う道具です。デスクトップアプリの Code Review でチャットしながら確認しても、それだけでは Pull Request にコメントが投稿されたり、承認やマージが行われたりはしないと公式ドキュメントに明記されています。(出典: Code review)

使えるプランと前提条件

公開時点の Codex の料金ページでは、GitHub のコードレビューと自動 PR レビューは Plus、Pro、Business、Enterprise で利用可能とされ、API キーでのサインインでは GitHub のコードレビューなどのクラウド機能は使えないと記載されています。

始める前に必要なものとして、公式ドキュメントは次の3点を挙げています。(出典: Review GitHub pull requests with Codex)

  • Codex に接続された GitHub リポジトリ
  • Codex のコードレビュー設定へのアクセス
  • リポジトリ固有のレビュー観点に従わせたい場合は AGENTS.md

また、自動レビューを設定するには、接続済みのリポジトリに加えて、そのリポジトリの設定に対する GitHub の push 権限または admin 権限が必要です。

設定の流れ

公式ドキュメントに記載されている手順は次のとおりです。(出典: Review GitHub pull requests with Codex)

  1. GitHub リポジトリを Codex に接続する
  2. Codex settings を開く
  3. リポジトリを選び、Review code の下にある Automatic review をオンにする
  4. 自分の Pull Request を自動でレビューさせたい場合は、Personal preferences の Automatic review をオンにし、Review trigger でレビューを走らせるタイミングを選ぶ

自動レビューを有効にすると、コードレビューが有効なリポジトリでは @codex review とコメントしなくてもレビューが走ります。

法人のワークスペースでは、この設定の前にワークスペース側の準備があります。公式の管理者向けロールアウトガイドは、Codex cloud の準備手順(利用者への権限付与、ソースシステム連携の導入、リポジトリへのアクセス範囲の限定、環境の設定)の後に「コードレビューのような任意のホスト型ワークフローを設定する」という順序で整理しています。(出典: Admin rollout guide)また Enterprise のワークスペースでは Codex Cloud が既定でオフであると記載されています。(出典: Roles and workspace permissions)

情報システム部門と開発リーダーの間で「誰がどこまで設定するか」を先に分けておくと、設定待ちで止まりません。ワークスペース全体の初期設定はChatGPT Business で Codex を使い始める初期設定の記事にまとめています。

レビューの頼み方

基本は @codex review

手動で頼む場合は、Pull Request のコメントに @codex review と書きます。Codex が 👀 のリアクションを付け、その後レビューを投稿します。(出典: Review GitHub pull requests with Codex)

1回だけ焦点を絞る

特定の観点を見てほしいときは、コメントにそのまま書き足します。公式ドキュメントには @codex review for issues in the database migration という例が載っています。日本語のチームでも、まずは公式の書式に合わせて @codex review for の後に観点を続けるのが確実です。

マイグレーションや権限まわりのように、いつもより慎重に見てほしい変更のときに使うと効果的です。

セキュリティに絞ったレビュー

セキュリティ上のリスクを深く見たい場合は、research preview として提供されている Security Review があります。Pull Request に @codex security review とコメントすると、指摘が Pull Request に投稿され、関連する Codex のタスクの Security Report タブで全文を確認できます。Code Review の一般的なレビューでもセキュリティ関連の問題は指摘されることがあるため、両者の指摘が重なる場合があるとも記載されています。(出典: Review GitHub pull requests with Codex)

指摘を直してもらう

レビューの後に同じ Pull Request へ @codex fix the P1 issue のようにコメントすると、Pull Request を文脈としたクラウドのチャットが始まり、権限がある場合は修正をブランチへ push できます。review 以外の内容で @codex をメンションした場合も、同様に Pull Request を文脈としたチャットが始まります。(出典: Review GitHub pull requests with Codex)

便利な反面、Codex が作成者のブランチに直接 push する経路でもあります。チームで「修正の依頼は作成者本人だけが行う」のように決めておくと、誰の変更かが曖昧になりません。

AGENTS.md でレビュー観点を伝える

## Code Review Rules を変更の近くに置く

Codex はリポジトリ内の AGENTS.md を探し、該当するコードレビュールールに従います。ルールは、対象のコードに最も近い AGENTS.md に ## Code Review Rules セクションとして追加し、必要に応じて ### の見出しで関連するチェックをまとめます。リポジトリ全体のルールはルートの AGENTS.md に、サービス固有のルールはネストしたファイルに置くと、変更されたファイルごとにルートとより具体的なガイダンスの両方が適用されます。(出典: Review GitHub pull requests with Codex、Custom instructions with AGENTS.md)

たとえば、請求処理を担うディレクトリには次のように書きます。

## Code Review Rules

### 請求金額の計算

- 金額を浮動小数点数で計算している変更は指摘してください。
  安全な書き方: 最小通貨単位の整数で計算し、表示のときだけ整形してください。

### 個人情報

- 氏名やメールアドレスをログへそのまま出力している変更は指摘してください。
  安全な書き方: ID だけを出力するか、マスクしてから出力してください。

ルールの書き方の4原則

公式ドキュメントは、まずレビュアーがよく説明しているチェックを2〜3個の簡潔なルールにすることから始めるよう勧めています。そのうえで、有用なルールの条件として次の4点を挙げています。(出典: Review GitHub pull requests with Codex)

  1. リポジトリ固有の影響の大きい挙動に絞る: 指摘すべき互換性の制約・データの境界・危険な副作用と、それがなぜ重要かを書く
  2. 安全な書き方や例外を書く: 本当の問題と想定どおりの挙動を区別できるだけの文脈を与える
  3. 範囲を絞り長く使える形にする: 変わりやすい関数名より結果で書き、対象コードの近くに置く
  4. 機械的なチェックは CI に任せる: フォーマットや lint のような決定的なチェックはレビュールールに入れない

運用としては、代表的な Pull Request で @codex review を試し、指摘と反応を見てルールを直し、ノイズを生むルールは絞るか削ります。AGENTS.md 全体の書き方はAGENTS.md の書き方の記事で解説しています。

人のレビューとの役割分担

公式ドキュメントには「コードレビュールールは Codex を導くものであり、テスト、ブランチ保護、必須の承認を置き換えるものではない」と明記されています。(出典: Review GitHub pull requests with Codex)この一文を、そのままチームのルールの土台にしてください。

デジライズでは、役割を次のように分けることをおすすめしています。

担当 主に見るもの 判断の重さ
CI フォーマット、lint、テストの合否 機械的に合否を決める
Codex のレビュー 重大な不具合、Code Review Rules に書いた観点、セキュリティ上のリスク 指摘を出す。承認はしない
人のレビュアー 仕様どおりか、設計として妥当か、指摘が本当に問題か 承認・差し戻し・マージを決める

ポイントは、Codex の指摘を「そのまま正しいもの」と扱わないことです。公式ドキュメントも、デスクトップアプリでは指摘を最新の差分、期待される挙動、テストと照らし合わせてから修正が必要か判断するよう案内しています。(出典: Code review)

逆に、Codex が指摘しなかったことを「問題がない証拠」とも扱いません。GitHub では P0 と P1 に絞って指摘する設計のため、軽微な改善点や設計の好みは人のレビューで扱う前提になります。

作成者側の使い方も決めておくと、レビューの往復が減ります。Pull Request を出す前に /review で「ベースブランチとの差分」をレビューさせ、作業ツリーを変えない形で指摘を確認してから出す、という流れです。(出典: Code review)

管理者が先に決めること

チームに広げる前に、次の5点を決めて文書にしておいてください。

  1. 対象リポジトリ: 自動レビューを有効にするリポジトリを決める。設定には GitHub の push 権限または admin 権限が必要なため、誰が設定するかも決める
  2. 自動か手動か: 全 Pull Request を自動でレビューさせるのか、@codex review で頼んだときだけにするのか。自動にする場合は Review trigger の選び方をそろえる
  3. 利用量の見込み: 料金ページでは、Code Review の利用量は GitHub 経由で動くレビュー(@Codex でのレビュー依頼や自動レビュー)にだけ適用され、ローカルや GitHub 以外で動かしたレビューは通常の利用上限に数えられると説明されている。自動レビューを広げる前に、利用量の確認方法を決める(出典: Codex pricing)
  4. 修正の push を許すか: @codex fix で Codex にブランチへの push をさせてよいか、させる場合は誰の Pull Request に限るか
  5. 効果の見方: Enterprise などで管理コンソールの Insights を使える場合、Code review の画面でレビューした PR 数や見つかった問題の数を確認できる。ただし公式ドキュメントは、レビューされた PR が必ずしもマージやデプロイされたわけではないこと、どの指摘が役に立ち対応されたかはレビュアーに確認することを注意している(出典: Usage Insights)

5点目は数字だけで判断しないことが大切です。指摘数が多いことは、良いレビューの証拠にも、ノイズの多いルールの証拠にもなります。月に1回、レビュアーに「役に立った指摘」と「不要だった指摘」を聞き、Code Review Rules を見直す場を用意してください。管理者が利用状況をどこまで把握できるかは管理者が Codex の利用状況を把握する方法の記事で整理しています。

まとめ

Codex のコードレビューは、GitHub 上では重大な問題に絞って指摘する「もう1人のレビュアー」です。テストやブランチ保護、必須の承認の代わりではありません。チームで使うときは、入口(GitHub・デスクトップアプリ・/review)を分けて理解し、AGENTS.md の ## Code Review Rules で観点を2〜3個から伝え、人のレビュアーが承認とマージを決める役割分担を先に合意しておくことが定着の近道です。

なお、この記事の内容は公開時点の OpenAI 公式ドキュメントで確認した範囲です。画面の名称、対象プラン、利用量の扱いは変わることがあるため、社内ルールに落とし込む前に最新の記載をご確認ください。デジライズでは、コードレビューの運用設計を含めた導入支援のご相談を承っています。