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の接続と環境

クラウドでは、Webまたはデスクトップアプリで Work in > Cloud を選んで作業を始めます。公式の説明で押さえる点は次のとおりです。

リポジトリが選択肢に出ない時は、GitHub側で、接続したアプリのアクセス範囲にそのリポジトリが入っているかを確認します(公式の別の手順で、リポジトリが出ない時の確認として案内されている点です)。組織のリポジトリでは、GitHubの管理者に追加を頼む必要があることがあります。

Secretsと環境変数:使える範囲

プライベートの依存パッケージを入れる時などに、キーを渡したくなる場面があります。クラウドの環境では、公式が次の区別を示しています。

種類使える範囲
環境変数チャットの間ずっと。セットアップスクリプトにもエージェントの作業にも見える
Secrets暗号化して保存され、タスクの実行時にだけ復号されます。使えるのはセットアップスクリプトの間だけで、エージェントの作業が始まる前に取り除かれます

インターネットへの接続も段階があります。セットアップスクリプトの間は接続でき、エージェントの作業中は既定で止まっています(必要なら限定または制限なしに設定できます)。

APIキーやトークンは、環境変数ではなくSecretsに入れるのが公式の区別に沿った使い方です。リポジトリのファイルに書き込むのは避けてください。

プルリクエストのレビューに使う

GitHubのプルリクエストでCodexにレビューさせるには、リポジトリをCodexに接続し、Codexのコードレビュー設定で対象のリポジトリを選びます。自動レビューをオンにする操作には、そのリポジトリのpushまたは管理の権限が要ります。

プルリクエストのコメントに @codex review と書くと、Codexが反応してレビューを投稿します。Codexが挙げるのは優先度の高い指摘(P0・P1)に絞られます。ワークフローで動かす方法はCodexをGitHub Actionsで動かす方法を見てください。

プライベートでも入れてはいけないもの

プライベートリポジトリは、外から見えないだけで、チーム内や連携したツールからは中身が見えます。次のものは、プライベートでもコミットしない前提で運用します。

除外の書き方と確認の手順はCodex gitignoreとSecrets確認、個人情報の扱いはCodexと個人情報に整理しています。

よくある質問

プライベートリポジトリでもCodexは使えますか。

PC上では、クローンしたフォルダを開いて使います。クラウドでは、GitHubアカウントを接続し、環境でリポジトリを選びます。公式の文書は公開・非公開で手順を分けていないため、選べるリポジトリはGitHub側で許可した範囲で決まります。

リポジトリが選択肢に出てきません。

接続したGitHubアプリのアクセス範囲に、そのリポジトリが入っているかを確認します。組織のリポジトリは、GitHubの管理者に追加を頼む必要があることがあります。

APIキーはクラウドの環境でどう渡しますか。

環境変数はチャットの間ずっと、Secretsはセットアップスクリプトの間だけ使えます。Secretsはエージェントの作業が始まる前に取り除かれるため、作業中にキーを使わせたい場合は設計を見直します。

関連ページ

出典と確認日

出典は公式の文書です。画面の表示や手順は更新されることがあるため、迷ったら出典を優先してください。

EDITED & REVIEWED

編集・検証情報

編集責任
運営者 ちんあなご編集部
書き方の基準
編集・検証方針
最終確認
(公式の情報と照らした日)
更新履歴
(公開)

公式情報、実際の操作で確かめたこと、運営者の判断を区別して記載しています。サービスの画面、料金、利用上限、提供地域は変わる場合があるため、重要な操作の前に公式資料と現在の画面を確認してください。