Codex CloudとGitHubを接続する手順：リポジトリ連携からPRレビューまで

最終確認日：2026年7月26日

Codex CloudとGitHubを接続すると、ChatGPT上のCodexにGitHubリポジトリを渡して、クラウド上の隔離された環境で調査、実装、テスト、差分作成、Pull Request作成まで進められるようになります。さらにGitHub連携を設定しておくと、Pull Request上で@codex reviewとコメントしてコードレビューを依頼したり、自動レビューを有効化したりできます。

この記事では、Codex CloudをGitHubリポジトリで使い始めるための接続手順と、PRレビュー連携までの流れをまとめます。

できるようになること

全体像

事前に確認しておくもの

• ChatGPT / Codexを利用できるアカウント：Codex画面にアクセスできることを確認します。
• GitHubアカウント：対象リポジトリにアクセスできるアカウントを使います。
• 対象リポジトリへの権限：Organization配下のリポジトリでは、GitHub側で管理者の承認が必要になる場合があります。
• セットアップ方法：依存関係のインストール、テスト、ビルド、lintなどをCodexが再現できるようにしておきます。
• 環境変数・シークレット：APIキーやトークンが必要な場合は、リポジトリに書かずCodexの環境設定で管理します。
• AGENTS.md：プロジェクト固有のコマンド、注意点、レビュー観点をCodexに伝えるために用意しておくと便利です。

手順1：Codexを開く

まず、ChatGPTのCodex画面を開きます。

https://chatgpt.com/codex

chatgpt.com

Codex Cloudでは、クラウド上の隔離された環境でタスクを実行します。ローカルPC上でCodexを動かすのではなく、GitHubのリポジトリをクラウド環境にチェックアウトし、Codexがその中でコマンド実行やコード編集を行うイメージです。

手順2：GitHubを接続する

Codex画面でGitHub接続を求められたら、画面の案内に従ってGitHubアカウントを連携します。このとき、Codexにアクセスを許可するリポジトリを選択します。

ポイントは、すべてのリポジトリを一括で許可するのではなく、まずはCodexで使いたいリポジトリだけを選ぶことです。特に会社やチームのOrganizationリポジトリを使う場合は、GitHub側の管理ポリシーに従って承認を取っておきます。

手順3：Cloud environmentを作成する

GitHubを接続したら、Codexの環境設定画面で対象リポジトリ用のCloud environmentを作成します。

https://chatgpt.com/codex/settings/environments

chatgpt.com

Cloud environmentは、Codexがそのリポジトリをどう動かすかを決める設定です。公式ドキュメントでは、Codexは選択したブランチやコミットをコンテナ内にチェックアウトし、セットアップスクリプトを実行してから作業を始める流れとして説明されています。

設定しておきたい項目は次の通りです。

• 対象リポジトリ：Codexに作業させたいGitHubリポジトリ。
• セットアップスクリプト：依存関係のインストールや初期化コマンド。
• メンテナンススクリプト：キャッシュ済み環境を再利用するときに必要な更新処理。
• 環境変数：通常の設定値。セットアップ中とエージェント作業中に利用されます。
• シークレット：APIキーなどの機密値。公式ドキュメント上では暗号化され、セットアップスクリプトで利用され、エージェント作業前には環境から除かれる設計として説明されています。
• インターネットアクセス：セットアップ時は外部アクセスを使えますが、エージェント作業時のインターネットアクセスは初期状態では無効です。必要な場合だけ限定的に有効化します。

手順4：セットアップスクリプトを整える

Codex Cloudで安定して作業させるには、リポジトリのセットアップが再現可能であることが重要です。たとえばNode.jsのプロジェクトなら、以下のように依存関係のインストールと基本チェックをまとめておきます。

npm ci
npm run lint
npm test

Pythonなら、プロジェクトの構成に応じて次のような形になります。

python -m pip install -r requirements.txt
pytest

ここで大事なのは、Codexに「何を実行すれば正常と言えるか」を明確にしておくことです。インストール、lint、型チェック、テスト、ビルドが分かれているなら、それぞれのコマンドをAGENTS.mdにも書いておくと、Codexが作業後に適切な確認をしやすくなります。

手順5：Codexに最初のタスクを依頼する

Cloud environmentを作成したら、Codex画面に戻り、対象の環境を選んでタスクを依頼します。

最初は大きな機能追加よりも、次のような小さめのタスクで接続状態を確認すると安全です。

• READMEの誤字修正
• 小さなバグ修正
• lintエラーの確認
• テストが通るかの調査
• 既存コードの構成調査

Codexは作業後に、実行した内容の要約、変更差分、確認結果を提示します。その場で追加修正を依頼することもできますし、内容が問題なければPull Requestとして開くこともできます。

手順6：GitHubのPRレビュー連携を有効化する

GitHub上のPull Requestレビューまで使いたい場合は、Codexの設定で対象リポジトリのコードレビュー機能を有効化します。公式のGitHub連携ドキュメントでは、PR上で@codex reviewとコメントするとCodexにレビューを依頼できると説明されています。

基本の流れは次の通りです。

1. Codex Cloudで対象リポジトリを使える状態にする。
2. Codexの設定画面で、そのリポジトリのコードレビューを有効にする。
3. GitHubのPull Requestで@codex reviewとコメントする。
4. CodexがPRの差分を確認し、重要な指摘がある場合はGitHubレビューとして投稿する。

自動レビューを有効にすると、新しいPull Requestに対してコメントなしでCodexレビューを走らせることもできます。ただし、Codexレビューは人間のレビューやCIを置き換えるものではありません。ブランチ保護、必須レビュー、テスト、セキュリティチェックは引き続き維持するべきです。

AGENTS.mdでレビュー観点を指定する

Codexにプロジェクト固有のレビュー観点を伝えたい場合は、リポジトリ内にAGENTS.mdを置きます。GitHub連携ドキュメントでは、コードレビュー用のルールを## Code Review Rulesセクションとして書けることが説明されています。

例としては、次のような内容です。

## Code Review Rules

- APIのレスポンス形式を変更する場合は、既存クライアントとの互換性を確認する。
- 認証・認可に関わる変更では、未認証ユーザーと権限不足ユーザーの両方のテストを確認する。
- DBマイグレーションを追加した場合は、ロールバック手順または後方互換性を確認する。

レビュー観点は、抽象的な一般論よりも、そのリポジトリで本当に事故につながりやすいルールを書くのが有効です。たとえば「良いコードを書く」ではなく、「請求金額の計算ロジックを変更した場合は丸め処理と税率のテストを確認する」のように、具体的で検証可能な内容にします。

よくあるつまずき

安全に運用するためのチェックリスト

• Codexに許可するGitHubリポジトリは必要最小限にする。
• APIキーやトークンはリポジトリに直接書かず、Codexのシークレット管理を使う。
• エージェント作業中のインターネットアクセスは、必要な場合だけ有効化する。
• セットアップスクリプトで依存関係のバージョンをできるだけ固定する。
• AGENTS.mdにテスト、lint、ビルド、レビュー観点を書く。
• Codexが作った差分は必ず人間が確認する。
• CI、必須レビュー、ブランチ保護は引き続き有効にする。

まとめ

Codex CloudとGitHubの接続は、単に「GitHubを連携する」だけではなく、リポジトリごとのCloud environmentを作り、依存関係や環境変数、シークレット、レビュー観点まで整えることで実用的になります。

最初は小さな修正や調査タスクから始め、セットアップが安定したら、機能追加、リファクタリング、テスト追加、PRレビューへ広げていくのが扱いやすい進め方です。特にチーム開発では、AGENTS.mdにプロジェクト固有のコマンドとレビュー観点を残しておくことで、Codexの出力がチームの運用に近づきやすくなります。

参考資料

• OpenAI: Codex cloud
• OpenAI: Cloud environments
• OpenAI: GitHub integration