ChatGPTとGitHubの連携は、ChatGPTの設定にある「プラグイン」からGitHubを選び、GitHub側でChatGPT用のアプリをインストールして、読ませるリポジトリを選ぶ方式です。接続後に「バックエンドのどこでファイルアップロードを処理しているか」と聞くと、ChatGPTがリポジトリを検索し、該当コードを引用して答えます。
このGitHubアプリは読み取り専用です。コードの修正、プルリクエスト（PR）の作成、PRレビューはCodexが受け持ち、同じGitHub連携でも入口と権限が分かれています。この記事では、OpenAIの公式ヘルプ「Connecting GitHub to ChatGPT」とCodexの公式ドキュメント（いずれも2026年10月25日に確認）をもとに、できること・できないこと、接続とプライベートリポジトリの設定、プラン別に使える範囲、表示されないときの確認順を整理します。
まとめ：ChatGPT×GitHub連携の要点
- 接続は「設定＞プラグイン＞GitHub」。GitHub側でアプリをインストールし、読ませるリポジトリを選ぶ
- できるのはコード・README・ドキュメントの検索と要約。push・PR作成はできず、書き込みはCodexで行う
- 同期索引は作らず、質問のたびにGitHubを検索して取りに行く。新しいリポジトリは一覧に出るまで約5分
- プライベートリポジトリも、アプリのインストール先と選択リポジトリに入っていれば読める
- PRの自動レビューなどCodexのクラウド連携はPlus以上。FreeとGoのCodexはデスクトップアプリでの利用に限られる
- CIに組み込むならCodex GitHub Action（APIキー）、Codexから課題やPRを操作するならGitHub公式のMCPサーバー
2024年に終了した旧「ChatGPTプラグイン」と、いまの「プラグイン」は別の仕組みです。違いは次の章で説明します。
ChatGPTからGitHubにつなぐ4つの経路
「ChatGPTとGitHubを連携したい」という目的は、コードを読ませたいのか、書き換えさせたいのか、CIに組み込みたいのかで使う機能が変わります。OpenAIとGitHubが公式に案内している経路は次の4つです。
| 経路 | できること | 書き込み | 認証 |
|---|---|---|---|
| GitHubアプリ | コード検索・質問応答・調査 | 不可 | ChatGPTアカウント |
| Codex Cloud | 修正・テスト・PR作成・PRレビュー | 可 | ChatGPTアカウント |
| Codex GitHub Action | CIでのレビュー・パッチ適用 | 設定次第 | OpenAI APIキー |
| Codex＋GitHub MCPサーバー | Issue・PRの検索と操作 | トークンの権限次第 | GitHubのトークン |
リポジトリの中身を聞きたいだけならGitHubアプリ、修正からPRまで任せたいならCodex Cloud、プルリクエストのたびに決まった検査を走らせたいならGitHub Actionです。カスタムGPTのActionsでGitHub APIを呼ぶ方法も以前は使われましたが、いまから選ぶ経路ではありません。OpenAIのGPTsのヘルプでは、Free・Go・Plus・Proの個人アカウントはGPTの新規作成と公開ができず、対象のEnterpriseワークスペースでは2026年12月11日にカスタムGPTを廃止する予定です。既存のGPTの扱いはGPTs（カスタムGPT）の解説を参照してください。
旧「ChatGPTプラグイン」と現在の「プラグイン」の違い
「ChatGPT プラグイン GitHub」で検索すると、2023年当時のプラグインストアの情報が出てきます。この旧プラグインは2024年3月19日に新規インストールと新規会話を止め、2024年4月9日に既存の会話も含めて終了しました（OpenAIヘルプ「Winding down the ChatGPT plugins beta」）。
いまの「プラグイン」は、外部サービスにつなぐ「アプリ」と、作業手順をまとめた「スキル」を束ねる単位で、ChatGPTとCodexの両方で使います。GitHub連携もこの画面から接続します。名前は同じでも、旧プラグインストア時代の記事に書かれた手順はいまの画面に当てはまりません。
GitHubアプリでできること・できないこと
質問のたびにリポジトリを検索して答える仕組み
GitHubを接続すると、ChatGPTは質問から検索クエリを作ってGitHubに送り、該当するコードやファイルを取得して答えます。公式ヘルプの例では、ファイルアップロードの処理箇所を尋ねると file upload handler backend のようなクエリで検索し、必要なら検索を数回繰り返します。
ChatGPT側でリポジトリを同期して索引を作るわけではありません。ヘルプは「GitHubの同期や、リポジトリ個別の索引設定は提供していない」と明記しています。作ったばかりのリポジトリはGitHub自身の検索索引に入るまで見つからないことがあり、これがChatGPTの不具合と誤解されやすい点です。
リポジトリ選択画面で検索できるのはリポジトリ名だけで、ファイル名は探せません。特定のファイルを読ませたいときは、プロンプトにリポジトリ名とファイルパス、分かれば関数名やエラーメッセージを書きます。
チャット・deep research・エージェントでの違い
GitHubアプリは通常のチャット、deep research、エージェントの各モードで使えます。ただし使える範囲はプラン・ワークスペース・利用画面で変わり、公式ヘルプは「deep researchやエージェントでは使えるのに、通常のチャットには出てこない」場合があると説明しています。チャットでGitHubが見当たらないときは、deep researchのソース一覧に出ていないかを先に確かめると切り分けが早くなります。
deep researchは接続済みアプリの読み取り操作だけを使います。複数のリポジトリと公開Web情報を突き合わせ、「依存ライブラリを移行するなら何を直す必要があるか」を出典付きでまとめさせる、といった重めの調査に向いています。deep research自体の動き方はDeep Researchの仕組みにまとめています。
GitHubアプリの書き込み制限
公式ヘルプのFAQは、ChatGPTのGitHubアプリは「リポジトリの読み取りだけを提供し、分析と検索に使う」と答え、コードの生成・編集・pushはCodexを使うよう案内しています。
GitHubを接続する手順とプライベートリポジトリの設定
設定＞プラグインからのGitHub接続手順
- ChatGPTの設定を開き、プラグインを選ぶ（アカウントによっては「アプリ」と表示される）
- 一覧からGitHub、またはGitHubを含むプラグインを選び、接続を押す
- GitHubの画面に移るので、ChatGPT用のGitHubアプリをインストールして認可する
- インストール先のアカウントか組織を選び、読ませるリポジトリを指定する
接続後は、入力欄で @ を付けてGitHubを指定するか、＋メニューから選ぶと、そのリポジトリを前提に答えさせられます。指定しなくても、関連する質問ではChatGPTがインストール済みのプラグインを自動で使います。
プライベートリポジトリを読ませる条件
プライベートリポジトリも読めます。接続するGitHubアカウント自身に閲覧権限があることを前提に、アプリ側では次の2点を確認します。GitHubアプリがリポジトリを持つアカウントまたは組織にインストールされていること、そしてそのインストールで対象リポジトリが選択されていることです。個人アカウントにだけアプリを入れていると、組織のプライベートリポジトリは一覧に出ません。
組織がOAuthアプリのアクセスを制限している場合は、組織オーナーの承認も要ります。公式ヘルプは「GitHubアプリのインストール」と「リポジトリへのアクセス付与」を別の手順として扱っており、インストールだけ済ませても承認待ちのリポジトリは読めません。
読めるリポジトリの変更と切断
読ませるリポジトリを変えるには、設定＞プラグイン＞GitHubを開き、リポジトリ管理の項目からGitHubのアプリ設定画面へ移ります。特定のリポジトリを外す操作もGitHub側で行います。連携をやめるときは、同じ画面で切断を選びます。
プラン別に使える範囲（Free・Go・Plus・Pro・Business）
「Plusなら使えるのか」「無料で使えるのか」は、GitHubアプリとCodexで答えが分かれます。2026年10月25日時点の公式情報では次のとおりです。
| プラン | GitHubアプリ | Codexのクラウド連携 |
|---|---|---|
| Free・Go | 画面とプランで異なる | 不可（デスクトップアプリのみ） |
| Plus・Pro | 画面とプランで異なる | 可（自動レビュー・Slack連携など） |
| Business・Enterprise・Edu | 管理者の設定次第 | 管理者の設定次第 |
GitHubアプリについて、OpenAIはプランごとの可否を一覧にしていません。ヘルプにあるのは「プラン・ワークスペース・利用画面で変わる」という説明だけで、通常のチャットに出ない場合は自分のプランの詳細を確認するよう案内しています。
CodexはCodexの料金ページで線引きが明記されています。FreeとGo（月額8ドル）はデスクトップアプリでGPT-6 Lunaを使えるだけで、順次提供です。Webやクラウドで動くCodex、自動コードレビューやSlack連携といったクラウド連携は、Plus（月額20ドル）以上に含まれます。PRレビューまでGitHubで回したいなら、Plusが最低ラインです。組織でBusinessとEnterpriseのどちらを選ぶかはChatGPT EnterpriseとBusinessの違いで比較しています。
認可画面に書き込み権限が並ぶ理由
ChatGPTのGitHubアプリは読み取り専用なのに、接続時にGitHubが表示する認可画面には書き込み権限が並びます。ChatGPTのGitHub連携とCodexが同じGitHubアプリを使っているためです。
公式ヘルプがリポジトリ設定の確認先として案内するURLは github.com/apps/chatgpt-codex-connector です。GitHub APIでこのアプリを引くと、名前は「ChatGPT Codex Connector」、所有者はopenai、作成日は2025年2月14日、最終更新日は2026年9月23日で、権限は次のとおりでした（2026年10月25日取得）。
| 権限 | レベル |
|---|---|
| contents（コード） | write |
| pull_requests | write |
| issues | write |
| actions・workflows | write |
| checks・statuses | read |
| metadata・emails | read |
コードとPRへの書き込み権限は、Codexがコミットを積んでPRを作り、レビューを投稿するためのものです。ChatGPTの会話からは読み取りしか行いませんが、GitHub上ではこの権限がアプリに付与されます。業務のリポジトリをつなぐなら、インストール時に「All repositories」ではなく「Only select repositories」を選び、読ませるものだけに絞ってください。組織では、オーナーがインストール済みGitHubアプリの一覧で対象リポジトリを定期的に見直します。
リポジトリが表示されない・連携できないときの確認順
公式ヘルプは、リポジトリがChatGPTで使えるようになるまで約5分かかるとしています。接続直後に見えないだけなら、まず5分待ちます。それでも出ないときは、次の順で確認します。
- GitHubアプリのインストール先が、リポジトリを持つアカウント・組織になっているか
- インストール設定で対象リポジトリが選択・承認されているか
- 組織がOAuthアプリを制限していて、オーナーの承認待ちになっていないか
- GitHub側でIP許可リストを有効にしている場合、OpenAIの送信元IP帯を追加したか
- Business・Enterpriseで「管理者により無効化」と表示されていないか
「接続済みなのにリポジトリが1件も出ない」場合も、公式ヘルプは再接続より先に1と2を見るよう案内しています。
Codexで「GitHubを接続できない」ときは、ChatGPTアカウントの多要素認証（MFA）も確認します。Codexの認証ドキュメントによると、メールアドレスとパスワードでログインしているアカウントは、Codex cloudを使う前にMFAの設定が必須です。ログイン方法の1つでもメールアドレスとパスワードなら、別の方法でサインインしていても同じ扱いです。Google・Microsoft・Appleのソーシャルログインなら必須ではなく、SSOの組織ではSSO管理者がMFAを強制する前提です。
Codexによるコード修正とPRレビュー
Codex Cloudによる修正からPR作成までの手順
書き込みが必要な作業はCodexに任せます。Codex Cloudのドキュメントでは、ChatGPTのWebかデスクトップアプリで「Work in」から「Cloud」を選び、環境を作ってGitHubリポジトリを選ぶと、Codexが依存関係とツールを入れてテストの流れを確かめます。環境を公開したあとにタスクを出すと、タスクごとに独立した作業領域で修正が進み、変更とテスト結果を見てコミットやPRの作成に進めます。始め方と料金はCodexの使い方で詳しく解説しています。
なお、コードレビューとGitHub連携が使う環境は、10月時点のドキュメントでは「Codex Cloud (Legacy)」の設定画面で管理します。
@codex reviewとSecurity Reviewの使い方
Codexのコードレビューのドキュメントによると、PRのコメントに @codex review と書くと、Codexが反応してからレビューを投稿します。GitHub上で指摘するのは優先度P0とP1の問題だけで、細かな好みで埋まらない設計です。自動レビューは、Codex設定でリポジトリのコードレビューを有効にし、Personal preferencesのAutomatic reviewをオンにして、実行タイミングをReview triggerで選びます。設定にはそのリポジトリのpushか管理者の権限が要ります。
コメントの書き方で動きが変わります。
@codex review for issues in the database migration：観点を絞ったレビュー@codex security review：脆弱性に絞った詳しいレビュー（リサーチプレビュー）@codex fix the P1 issue：指摘の修正を依頼し、権限があればブランチへpush- review以外の
@codexコメント：PRを文脈にしたクラウドの作業を開始
AGENTS.mdによるレビュー観点の指定
レビュー観点はリポジトリの AGENTS.md に ## Code Review Rules の節を作って書きます。リポジトリ全体のルールはルート直下、サービス固有のルールはそのディレクトリの AGENTS.md に置くと、変更されたファイルを覆うルートと下位のルールが適用されます。公式の推奨は、レビュアーがよく説明している確認事項を2〜3個から始め、整形やlintはCIに残すことです。
ChatGPT WorkによるPRイベント起点のタスク実行
ChatGPTのWorkでは、「PRが開かれた」「レビュー可能になった」「クローズされた」などのGitHub上の出来事をきっかけに動くタスクを作れます。対象はgithub.comのリポジトリで、自社サーバーで運用するGitHub Enterpriseはこのイベント起点のタスクに対応していません。こうしたタスクは共有できますが、共有リンクにGitHubの接続や認証情報、リポジトリのアクセスは含まれず、受け取った人は自分のGitHubアカウントをつなぎ直します。指示文はリンクから見えるので、機密のコードやリポジトリ情報は共有前に消してください。Workの全体像はChatGPT Workとはを参照してください。
GitHub Actions・MCPによるCodex連携
Codex GitHub ActionによるPRごとのレビュー
ChatGPTのアカウントではなくAPIキーで動かしたいときは、Codex GitHub Action（openai/codex-action@v1）を使います。ActionがCodex CLIを入れ、指定した権限で codex exec を実行します。APIキーはリポジトリのシークレットに置きます。ランナーはLinuxかmacOSが前提で、Windowsでは safety-strategy: unsafe の指定が必要です。次の例は公式例からレビュー結果を取り出す部分を抜粋したもので、事前にレビュー指示を書いた .github/codex/prompts/review.md をリポジトリへコミットし、YAMLは .github/workflows/codex-review.yml に保存します。
name: Codex pull request review
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
codex:
runs-on: ubuntu-latest
permissions:
contents: read
outputs:
final_message: ${{ steps.run_codex.outputs.final-message }}
steps:
- uses: actions/checkout@v5
with:
ref: refs/pull/${{ github.event.pull_request.number }}/merge
fetch-depth: 0
persist-credentials: false
- name: Run Codex
id: run_codex
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
prompt-file: .github/codex/prompts/review.md
sandbox: read-onlyレビューを投稿するのは、final_message を受け取って issues: write と pull-requests: write だけを持つ別のジョブに分けるのが公式例の形です。Codexを動かすジョブに書き込み権限を渡さないためです。既定でActionを起動できるのは書き込み権限のあるユーザーだけで、広げるときは allow-users と allow-bots で明示します。PR本文やコミットメッセージをそのままプロンプトに流すとプロンプトインジェクションの入口になるので、公式のチェックリストどおり入力を整えてから渡してください。
CodexへのGitHub公式MCPサーバーの追加手順
CodexからIssueやPRを検索・操作したいときは、GitHubが運営するMCPサーバー（https://api.githubcopilot.com/mcp/）を追加します。GitHubの導入ガイドの手順どおり、次のコマンドで登録します（codex-cli 0.164.0で実行を確認）。
export GITHUB_PAT_TOKEN=ghp_xxxxxxxx
codex mcp add github --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PAT_TOKEN実行すると ~/.codex/config.toml に次の設定が追記されます（確認用の表示で、シェルでは実行しません）。
[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"
bearer_token_env_var = "GITHUB_PAT_TOKEN"codex mcp list を実行すると、登録済みの認証方式と有効状態を確認できます。ただしトークンが無効でも「enabled」と表示されるので、認証できたかどうかはCodexを起動してMCPのツールが並ぶか、リポジトリ一覧を取得できるかで確かめます。設定ファイルにはトークン本体でなく環境変数名だけが入るので、トークンをリポジトリにコミットせずに済みます。ここで使うトークンの権限がそのままCodexの操作範囲になるため、読み取りだけで足りる用途ならfine-grained tokenで対象リポジトリと権限を絞ってください。MCPの仕組み自体はMCPとはで解説しています。
業務で使うときのデータの扱いと管理者設定
ChatGPTのプラン別の学習利用条件
ChatGPT Business・Enterprise・Eduでは、送った内容は既定でモデルの学習に使われません。Free・Plus・Go・Proでは、設定の「すべての人のためにモデルを改善する」がオンだと学習に使われる可能性があります。社外秘のコードは、組織が認めるプランと接続範囲を確認してから扱ってください。学習利用の停止と、データの保存や外部送信の条件は別の話なので、両方を確認します。
見落としやすいのが、ChatGPTが作った検索クエリはGitHubに送られる点です。GitHubに送った情報はGitHub側の保存・処理・データ所在地の条件に従い、ChatGPTのデータレジデンシー（保存地域の指定）を契約していても、GitHub側の扱いは変わりません。
ワークスペースでの有効化と自社GitHub Enterprise
Businessでは多くのアプリが既定で有効で、管理者がワークスペース単位で無効化できます。Enterprise・Eduの新規ワークスペースは、選ばれた一部のアプリだけが有効な状態から始まります。プラグインの利用可否、アプリのアクセス、ロールの権限、GitHubアカウントの認可は別々の設定で、どれか1つが欠けても使えません。
自社サーバーでGitHub Enterpriseを運用している組織向けには、管理者が自社のGitHub Appを作ってChatGPTに登録する「GitHub Enterpriseアプリテンプレート」があります。GitHub Enterprise側でGitHub App（OAuthアプリではない）を作り、ChatGPTのコールバックURL、クライアントIDとシークレット、秘密鍵、Webhookシークレットを相互に設定します。読み取りの検索だけにするか、PRやIssueの操作まで許すかを、ここで組織として決めます。
Codexのスレッドを共有リンクで渡すときの公開範囲
macOS版のChatGPTデスクトップアプリでは、ローカルのCodexスレッドを読み取り専用のスナップショットとして共有できます。PRの説明に作業の経緯としてリンクを貼る使い方がありますが、公開範囲はアカウントで違います。個人アカウントのリンクはURLを知っていれば誰でも開け、ワークスペースのアカウントでは、同じワークスペースの認証済みメンバー全体、または招待したメンバー・グループに公開範囲を限定できます。管理者が共有リンクを無効化している場合もあります。スナップショットには差分とファイルパスが含まれ、Codexは既知の秘密情報の形式を伏せますが、伏せ漏れは起こりえます。公開リポジトリのPRに個人アカウントのリンクを貼るのは避け、貼った後に取り消すときはデータコントロールの「共有リンク」から行います。
GitHub連携を使うべきでない場面
次の条件に当てはまるなら、接続を見送るか範囲を絞ってください。
1つ目は、APIキーや接続文字列がリポジトリにコミットされたまま残っている場合です。ChatGPTは質問に応じてファイルを取得するので、秘密情報を含むファイルが回答の材料になります。コミット済みの認証情報は先に失効・再発行し、ファイルから消すだけでなく履歴や複製に残っていないかも確認してから接続します。
2つ目は、モノレポ全体の網羅的な調査を期待する場合です。このアプリは索引を持たず、GitHub検索で見つかった範囲を読むため、検索語に引っかからない古いコードは回答から漏れます。「影響範囲を漏れなく洗い出す」用途では、ChatGPTの回答は手掛かりにとどめ、grepやIDEの参照検索、テストで確かめます。
3つ目は、書き込みまで1つの画面で終えたい場合です。チャットのGitHub連携は読み取り専用なので、修正を反映させたいなら最初からCodexで始めたほうが、指示の出し直しが起きません。社内でChatGPTとCodexをどう使い分け、どこまでの権限を渡すかの設計から決めたい場合は、生成AI導入支援で相談を受け付けています。IDEの中で補完とチャットを使いたいなら、GitHub側の製品であるGitHub Copilotも比較対象になります。
ChatGPTとGitHub連携に関するよくある質問
ChatGPTとGitHubを連携すると何ができますか？
接続したリポジトリのコード・README・ドキュメントを検索し、内容についての質問に答えたり、構成を要約したりできます。deep researchでは複数リポジトリとWeb情報を突き合わせた調査レポートも作れます。コードの修正やPR作成はできず、それらはCodexで行います。
プライベートリポジトリも読ませられますか？
読ませられます。GitHubアプリをリポジトリの所有者（個人または組織）にインストールし、インストール設定でそのリポジトリを選択してください。組織がOAuthアプリを制限している場合は、組織オーナーの承認も必要です。
GitHubが接続済みなのにリポジトリが出てこないのはなぜですか？
表示までは約5分かかります。それ以上たっても出ない場合は、GitHubアプリのインストール先と選択リポジトリを確認します。新しく作ったリポジトリは、GitHub側の検索索引に入るまで見つからないこともあります。
ChatGPTのGitHubプラグインはまだ使えますか？
2023年の旧プラグインストアは2024年4月9日に終了しています。現在は設定の「プラグイン」からGitHubアプリを接続する方式で、名前は同じでも別の仕組みです。
無料プランやPlusでもGitHubと連携できますか？
GitHubアプリの可否はプランと利用画面で変わり、OpenAIはプラン別の一覧を出していません。Codexの自動コードレビューなどGitHubのクラウド連携はPlus以上で、FreeとGoのCodexはデスクトップアプリでの利用に限られます。
