CodexのGitHub連携 — 自動コードレビューと@codexメンションの設定・使い方

CodexのGitHub連携でできること3つ

CodexをGitHubに接続すると、大きく3つのことができるようになります。

• 自動コードレビュー — プルリクエストが開かれるたびに、Codexが自動でレビューコメントを投稿する
• @codexメンション — プルリクエストのコメント欄で @codex review と書くだけで、その場でレビューや修正を依頼できる
• クラウドタスクとの往復 — Web版（クラウド）のCodexに仕事を任せ、成果物をプルリクエストとして受け取る

セットアップ手順 — リポジトリ接続とレビューの有効化

GitHub連携は、Codexのクラウド機能の一部として提供されています。公式ドキュメントに沿ったセットアップの流れは次のとおりです。

1. 1Codex cloudでGitHubリポジトリを接続する — Codexのクラウド環境設定から対象リポジトリを選んで接続する（初回はGitHub側で連携の承認が必要）
2. 2Codex設定ページで「Code review」を有効にする — レビュー機能はリポジトリごとにオン・オフを選べる
3. 3必要なら「Automatic reviews（自動レビュー）」もオンにする — 有効にすると、プルリクエストが開かれるたびに自動でレビューが投稿される

リポジトリ接続を含むクラウド実行の全体像（何がクラウドで実行され、手元と何が違うのか）はCodexのWeb版・クラウドの仕組みで解説しています。

自動コードレビューの動き方

自動レビューを有効にすると、チームの誰かがプルリクエストを開くたびに、Codexが変更内容を読み、気づいた問題をコメントとして投稿します。人間のレビュアーが見る前に一次チェックが済んでいる状態が自動で作られるため、「レビュー待ちで変更が滞留する」「軽微な見落としが本番に流れる」というもったいない状態を減らせます。

重要なのは、Codexのレビューは人間のレビューの置き換えではなく前処理だという位置づけです。機械的に見つけられる問題（明らかな不具合・危険な書き方・仕様との食い違いなど）をCodexが先に拾い、人間は設計判断や業務知識が要る部分に集中する、という分担が実務的です。

@codexメンションの使い方

自動レビューとは別に、プルリクエストのコメント欄からその場でCodexに依頼することもできます。コメントに @codex を含めると、Codexが反応（リアクション絵文字で受付を表示）し、依頼内容に応じて動きます。

「レビューしてもらう → 指摘を直させる」までがGitHubのコメント欄だけで完結するのがポイントです。依頼文の組み立て方の基本は、通常のCodexへの頼み方と共通です（Codexの使い方 — 頼み方3つの型）。

AGENTS.mdでレビュー観点を組織のルールにする

「指摘が細かすぎる」「うちのチームの観点で見てほしい」という場合は、リポジトリ内のルールファイルAGENTS.mdにCode Review Rules（レビュールール）のセクションを追加して、レビューの観点を指定できます。公式ドキュメントでは、重大度の高い問題（P0・P1）に絞ってレビューさせる書き方が例示されています。

これは「AIに任せる仕事の基準を、ファイルとしてチームで共有する」という仕組み化の型そのものです。AGENTS.mdの書き方と育て方はCodexのAGENTS.md入門で詳しく解説しています。

非エンジニア組織にとってのGitHub連携の意味

「うちにはエンジニアがいないから関係ない」と思われるかもしれませんが、当社が研修・伴走の現場で見ている限り、次のような場面で効いてきます。

• 外注した開発の検品 — 開発会社から納品される変更に対して、発注側でも一次チェックの目を持てる
• 内製ツールの品質担保 — 非エンジニアがCodexで作った社内ツールをGitHubで管理し、変更のたびに自動レビューで守る
• 少人数エンジニアの負荷軽減 — 1〜2名の社内エンジニアにレビューが集中している組織で、一次レビューを自動化する

特に2つ目は、「非エンジニアがAIで作る → AIが検品する」という組み合わせで、内製化の実務的なボトルネックだった品質担保に道筋がつく構図です。

利用条件と料金

GitHubの自動コードレビューを含むクラウド機能は、ChatGPTのPlus以上のプランで利用できます。追加料金の別建てはなく、通常のCodex利用と同じプラン・同じ利用枠の中で動きます（プラン選びと利用枠の仕組みはCodexの料金を参照）。

なお、CI（継続的インテグレーション）のパイプラインにCodexを本格的に組み込む場合は、APIキーによる従量課金という選択肢もあります。個人・チームの通常利用であれば、まずはプラン内のGitHub連携から始めるのが基本です。