2026/06/08Codex

Skills活用AI活用導入・運用

Codex×GitHub連携｜PR作成・レビュー自動化

「Codexは便利そうだけど、結局チャット画面でコードを生成して、それを手作業でコピペしてプルリクエストを作っている」——そんな運用になっていませんか。せっかくのAIコーディングが、GitHubの開発フローと分断されたままでは効果が半減します。

結論から言うと、CodexはGitHubと正式に連携する仕組みを持っており、Issueへの起票からブランチ作成、PR本文の生成、レビュー、マージまでを開発フローの中で自動化できます。鍵になるのが、GitHubアプリのインストール、PRコメントでの@codexメンション、そしてGitHub Actionの3つです。

株式会社Fyveは中小企業のAI業務効率化を支援しており、代表の田嶋自身もCodexを日々の受託開発で使っています。この記事では、私たちが実際に運用しているCodex×GitHubの連携手順を、機能ごとに整理して解説します。

CodexのGitHub連携で何ができるのか

まず全体像を押さえます。Codexのコーディング能力は同じでも、「どこから呼び出すか」によって体験が大きく変わります。GitHubネイティブ連携では、ブラウザのチャット画面に戻ることなく、普段の開発フローの中でCodexに仕事を任せられます。

具体的には、次のようなことが可能です。これらはすべてGitHub上のIssueやPRから直接トリガーできます。

PRの自動レビュー: PRが開かれた瞬間、または@codex reviewのコメントで、Codexがチームメンバーのようにレビューを投稿する
Issue・コメントからのタスク起票: PRコメントで@codexに指示すると、その文脈を使ってクラウドタスクが起動し、修正を反映する
指摘の自動修正: レビューで挙がった問題に対して@codex fix itとコメントすると、新しいクラウドタスクが走り、PRを更新する
GitHub Actionでの定型タスク実行: ワークフローファイルからcodex execを呼び出し、レビューやリリース準備、マイグレーションをCIに組み込む

機能名や挙動はアップデートが速い領域です。実装前には必ずCodex公式のGitHub連携ドキュメントで最新の仕様を確認してください。

Issueの起票からCodexによるブランチ作成・PR作成・レビュー・マージまでのGitHubワークフローを示した図

準備：CodexのGitHubアプリを連携する

GitHub連携を使うには、CodexのGitHubアプリを対象のアカウントまたはOrganizationにインストールする必要があります。ここはチャット画面のコードコピペ運用と決定的に違うポイントです。

クラウド環境のセットアップ

Codex Cloud（クラウド版）を使うには、ChatGPTのサブスクリプション（Plus / Pro / Business / Enterprise のいずれか）が前提になります。ブラウザでCodexの設定画面を開き、Environments（環境）から新しい環境を作成し、GitHubアカウントを接続します。この接続時にCodexのGitHubアプリがインストールされます。

連携が完了すると、Codexは対象リポジトリのPRを開いてから数分以内にレビューでき、Issueやコメントが投稿された瞬間に作業を開始できる状態になります。最新の接続手順は公式ドキュメントで確認してください。

レビュー方針はAGENTS.mdで管理する

Codexはリポジトリ内のAGENTS.mdを探し、そこに書かれたレビュー方針に従います。変更されたファイルに最も近いAGENTS.mdの指示が適用される仕組みなので、ディレクトリごとに方針を分けることもできます。

たとえば、私たちは次のような指示をAGENTS.mdに書いています。Codexに直接、リポジトリのルールを伝えるイメージです。

「セキュリティに関わる変更は特に厳しくレビューしてほしい」
「日本語でコメントを返してほしい」
「既存のコーディング規約（命名規則・ディレクトリ構成）に沿っているか確認してほしい」

@codexメンションでレビューとタスクを動かす

GitHub連携の中心が@codexメンションです。PRのコメント欄から、まるでチームメンバーに話しかけるようにCodexへ指示を出せます。

PRレビューを依頼する

レビューを依頼したいときは、PRのコメントで次のようにCodexに頼んでください。

@codex review とコメントする

するとCodexが👀（目）のリアクションを付けて反応し、PRにレビューを投稿します。GitHub上では、CodexはP0・P1（最優先・優先度高）の問題だけに絞って指摘するため、ノイズの少ない、リスクの高い箇所にフォーカスしたレビューになります。重箱の隅をつつくような大量のコメントで埋もれる、という事態を避けられるのが実務上ありがたい設計です。

全PRを自動レビューさせたい場合は、Codexの設定でAutomatic reviews（自動レビュー）をオンにします。これで、誰かが新しいPRを開くたびに@codex reviewと書かなくても自動でレビューが付きます。

指摘の修正やタスクを依頼する

レビューで挙がった問題をCodexに直してもらうこともできます。指摘されたコメントに対して次のように返してください。

@codex fix it とコメントする（新しいクラウドタスクが起動し、修正してPRを更新する）

また、review以外の内容で@codexにメンションすると、Codexはそのプルリクエストを文脈としてクラウドタスクを開始します。「このPRにテストを追加して」「この関数のエラーハンドリングを改善して」といった指示を、PRの会話の流れの中で渡せるわけです。指示はできるだけ具体的に書くと、期待した結果に近づきます。

PRコメント欄で@codex reviewとメンションし、Codexが目のリアクションとレビューコメントを返している画面イメージ

PR作成までを含めた開発フロー

Codexは単なるレビュー担当ではありません。コードを書き、ブランチを切り、PRを作るところまでをカバーします。Issue起点で考えると流れが分かりやすくなります。

Issueからタスクを起こす

バグや機能要望をIssueやコメントとして書き、Codexに作業を依頼すると、Codexはリポジトリに対してクラウドタスクを起動します。タスクの中でコードを変更し、ブランチを作成し、変更をプッシュし、PRをドラフトする、という一連の流れを担います。

Codex CLI（コマンドライン版）やCodexアプリにもGitツールが組み込まれており、差分の確認、ファイルやhunk単位のステージング、コミット、プッシュ、PR作成までをレビュー画面から直接実行できます。「変更して」「コミットして」「ブランチを切ってPRを出して」と段階的に頼める設計です。

PR本文の生成も任せる

PRを作るとき、変更内容の要約や背景説明を書くのは地味に手間がかかります。ここもCodexに任せられます。「この差分の内容をPR本文としてまとめて。変更点・背景・テスト方法を含めて」と頼めば、レビュアーが読みやすいPR説明文を生成してくれます。

私たちの運用では、コードの変更そのものよりも、この「変更を人間に説明する」部分でCodexの価値を強く感じます。レビュアーの理解コストが下がり、PRが滞留しにくくなるからです。

GitHub ActionでCI/CDに組み込む

定型的なタスクを繰り返し自動化したいなら、openai/codex-actionというGitHub Actionを使います。ワークフローファイルからcodex execを呼び出し、レビューやリリース準備、マイグレーションといったタスクをCIパイプラインに組み込めます。

基本的なセットアップ

セットアップの大枠は次の通りです。CIの中でCodexを安全に動かすための定番構成です。

APIキーをシークレットに登録: OpenAIのAPIキー（例：OPENAI_API_KEY）をGitHub Actionsのシークレットとして保存する
ワークフローのトリガー設定: pull_request イベントなどで起動するように設定する
prompt / prompt-file の指定: Codexへの指示をインラインまたはファイルで渡す
sandbox モードの設定: Codexに必要な権限に合わせてサンドボックスのモードを選ぶ
final-message の活用: Codexの最終メッセージを出力として受け取り、後続ステップで利用する

その他、model（モデル）やeffort（推論の強さ）、codex-args（追加のCLIフラグ）、output-file、codex-version（CLIバージョンの固定）といった入力も指定できます。フォークからのPRで動かす場合はシークレットの扱いに注意が必要なので、安全な構成についてはopenai/codex-actionの公式リポジトリを確認してください。

どこまで自動化するか線引きする

GitHub Actionで全自動化できるからといって、すべてを無人運用するのが正解とは限りません。私たちは、レビューや本文生成は自動化しつつ、マージの最終判断は人間が行う運用にしています。AIの提案を確認・取捨選択するゲートを必ず残す、という線引きが実務では重要です。

中小企業の開発チームでこの仕組みを導入する場合、「どのリポジトリに」「どこまで権限を渡すか」を最初に設計しておくと、後の運用がスムーズになります。

中小企業がCodex×GitHub連携を導入する手順

初めて導入する場合は、いきなり全社展開せず、小さく始めるのがおすすめです。私たちが支援するときも、次の順序で進めます。

ステップ1: 1つのリポジトリにCodexのGitHubアプリをインストールする
ステップ2: AGENTS.mdにレビュー方針（日本語・最優先項目）を書く
ステップ3: 既存のPRで@codex reviewを試し、指摘の精度を確認する
ステップ4: 慣れてきたら自動レビューをオンにする
ステップ5: 定型タスクが見えてきたらGitHub Actionで自動化する

この順で進めると、チームがCodexの挙動に慣れながら、徐々に自動化の範囲を広げられます。最初から完璧な自動化を目指すより、小さな成功体験を積む方が定着します。

よくある質問

CodexのGitHub連携を使うには何が必要ですか？

クラウド版（Codex Cloud）を使う場合、ChatGPTのサブスクリプション（Plus / Pro / Business / Enterprise）と、対象アカウントへのCodex GitHubアプリのインストールが必要です。GitHub Actionで動かす場合は、OpenAIのAPIキーをGitHubのシークレットに登録します。最新の前提条件は公式ドキュメントで確認してください。

@codex reviewと自動レビューはどう違いますか？

@codex reviewはPRコメントで都度レビューを依頼する方法です。一方、設定でAutomatic reviews（自動レビュー）をオンにすると、新しいPRが開かれるたびに自動でレビューが付きます。まずは手動の@codex reviewで精度を確かめ、納得できたら自動レビューに切り替えるのがおすすめです。