GitHub連携の早見
Codexでプライベートリポジトリは使える?ローカルとクラウドの違い
「CodexでGitHubのprivate repositoryを扱いたい」時に、どこで何を設定するかを整理します。PC上で動かす場合とクラウド(Codex cloud)で動かす場合の違い、GitHubの接続とリポジトリの選び方、Secretsの使える範囲を、OpenAI公式の文書(2026年11月13日確認)に沿って説明します。
最初に答え
どこでCodexを動かすかで、設定する場所が変わります。
| 動かし方 | プライベートリポジトリの扱い |
|---|---|
| PC上(デスクトップアプリ・CLI・IDE拡張) | 手元にクローンしたフォルダで作業します。プライベートかどうかを決めるのは、そのフォルダを取得した時のGitの認証です(当サイトの整理) |
| クラウド(Codex cloud) | ChatGPTにGitHubアカウントを接続し、環境でリポジトリを選びます。公式の説明はGitHub.comのリポジトリが対象です |
| プルリクエストのレビュー | GitHubのリポジトリをCodexに接続し、設定にはそのリポジトリのpushまたは管理の権限が要ります |
公式の文書は「接続したアカウントでアクセスできるリポジトリ」という書き方で、公開か非公開かで手順を分けていません。実際に選べるリポジトリは、GitHub側で許可した範囲で決まります。
PC上で使う場合
デスクトップアプリ・CLI・IDE拡張では、Codexは手元のフォルダを作業場所にします。プライベートリポジトリを扱うには、先に自分のPCにクローンしておき、そのフォルダをプロジェクトとして開きます。
- クローンにはGitHubへのログインが必要です。認証はGit側(GitHub CLIや資格情報マネージャーなど)で行います
- Codexに渡すのは作業フォルダです。作業範囲を広げすぎない選び方はCodexの作業フォルダの指定・変更にまとめています
- リポジトリの中に
.codex/config.tomlを置けますが、公式によると信頼したプロジェクトでだけ読み込まれます
クラウドで使う場合:GitHubの接続と環境
クラウドでは、Webまたはデスクトップアプリで Work in > Cloud を選んで作業を始めます。公式の説明で押さえる点は次のとおりです。
- プロジェクトから始める:デスクトップアプリで、既定の環境が、プロジェクトに関連づいたGitHub.comのリポジトリを自動で使います。条件はGitHubアカウントを接続していることです。GitLabのリポジトリはこの自動の設定に含まれません
- 環境を作る:新しい作業で Select environment > Create environment を選び、チェックアウトするリポジトリを選びます。求められたらGitHubを接続します
- プロジェクトなしで始める:リポジトリなしで始めて、必要になったらCodexに「このリポジトリをクローンして」と伝える使い方もできます。クローンできるのは、環境がアクセスできるリポジトリです
リポジトリが選択肢に出ない時は、GitHub側で、接続したアプリのアクセス範囲にそのリポジトリが入っているかを確認します(公式の別の手順で、リポジトリが出ない時の確認として案内されている点です)。組織のリポジトリでは、GitHubの管理者に追加を頼む必要があることがあります。
Secretsと環境変数:使える範囲
プライベートの依存パッケージを入れる時などに、キーを渡したくなる場面があります。クラウドの環境では、公式が次の区別を示しています。
| 種類 | 使える範囲 |
|---|---|
| 環境変数 | チャットの間ずっと。セットアップスクリプトにもエージェントの作業にも見える |
| Secrets | 暗号化して保存され、タスクの実行時にだけ復号されます。使えるのはセットアップスクリプトの間だけで、エージェントの作業が始まる前に取り除かれます |
インターネットへの接続も段階があります。セットアップスクリプトの間は接続でき、エージェントの作業中は既定で止まっています(必要なら限定または制限なしに設定できます)。
APIキーやトークンは、環境変数ではなくSecretsに入れるのが公式の区別に沿った使い方です。リポジトリのファイルに書き込むのは避けてください。
プルリクエストのレビューに使う
GitHubのプルリクエストでCodexにレビューさせるには、リポジトリをCodexに接続し、Codexのコードレビュー設定で対象のリポジトリを選びます。自動レビューをオンにする操作には、そのリポジトリのpushまたは管理の権限が要ります。
プルリクエストのコメントに @codex review と書くと、Codexが反応してレビューを投稿します。Codexが挙げるのは優先度の高い指摘(P0・P1)に絞られます。ワークフローで動かす方法はCodexをGitHub Actionsで動かす方法を見てください。
プライベートでも入れてはいけないもの
プライベートリポジトリは、外から見えないだけで、チーム内や連携したツールからは中身が見えます。次のものは、プライベートでもコミットしない前提で運用します。
- APIキー・トークン・パスワード
.envなどの環境設定ファイル- 顧客の個人情報や、公開できない契約書の本文
除外の書き方と確認の手順はCodex gitignoreとSecrets確認、個人情報の扱いはCodexと個人情報に整理しています。
よくある質問
プライベートリポジトリでもCodexは使えますか。
PC上では、クローンしたフォルダを開いて使います。クラウドでは、GitHubアカウントを接続し、環境でリポジトリを選びます。公式の文書は公開・非公開で手順を分けていないため、選べるリポジトリはGitHub側で許可した範囲で決まります。
リポジトリが選択肢に出てきません。
接続したGitHubアプリのアクセス範囲に、そのリポジトリが入っているかを確認します。組織のリポジトリは、GitHubの管理者に追加を頼む必要があることがあります。
APIキーはクラウドの環境でどう渡しますか。
環境変数はチャットの間ずっと、Secretsはセットアップスクリプトの間だけ使えます。Secretsはエージェントの作業が始まる前に取り除かれるため、作業中にキーを使わせたい場合は設計を見直します。
関連ページ
出典と確認日
- OpenAI Learn: Cloud environments(Work in > Cloud・環境の作成・GitHub.comのリポジトリ・クローンの扱い)
- OpenAI Learn: Codex Cloud (Legacy)(環境変数とSecrets・インターネット接続)
- OpenAI Learn: Codex ドキュメント全体(コードレビューの設定・リポジトリが出ない時の確認)
- 確認日: 2026年11月13日
出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。
