GITHUB / CLOUD TASKS / DIFF / PULL REQUEST
GitHubから、並列タスク、PRへ。
Codex Cloudは、GitHubリポジトリを接続し、複数の開発タスクを分離されたクラウド環境で進め、差分確認後にPRを作成できるCodexの利用入口です。最初は範囲の小さい独立タスクを1つだけ渡し、要約と差分を確認してから並列化へ進むのが本記事の推奨です。
- GitHub上の作業をブラウザから任せたい人
- 並列にしてよいタスクの分け方を知りたい人
- PR前に確認すべき権限・差分・データ条件を整理したい人
RESULT
独立したGitHubタスクをバックグラウンドへ渡し、後から差分を確認できるならCloudが候補です。ローカルの未保存状態を見ながら連続して直す作業は、CLIやIDE拡張機能へ残します。
Codex Cloudはどんな作業に使うべき？
Codex Cloudは、GitHub上の作業をバックグラウンドへ任せ、差分を確認してからPRへ進めたい場合に選ぶ利用入口です。Cloudを選ぶかどうかは、機能数ではなく「作業を独立した単位で切り離せるか」で判断します。
バックグラウンドへ渡しやすい3条件
Cloudへ渡しやすいのは、対象リポジトリ、完了条件、確認方法をタスク単位で切り分けられる作業です。OpenAIはCodex Cloudについて、分離されたクラウド環境でタスクを実行し、複数の作業を並行して進められると説明しています。Codex Cloud公式ドキュメント
筆者の判断基準は、①GitHub上の対象が明確、②別タスクの完了を待たずに始められる、③返された差分を人が確認できる、の3点です。3点がそろわない場合は、並列化する前に作業を小さく分けます。
CLI・IDE拡張機能へ残した方がよい条件
未保存の変更やローカルの実行状態を見ながら、短い往復で修正したい作業はCLIまたはIDE拡張機能へ残す方が自然です。これはOpenAIの優劣評価ではなく、作業場所と確認タイミングを基準にした筆者の判断です。
端末内で進める場合は、Codex CLIのWindows・macOS別の導入手順を確認できます。Codex以外も含めて入口を選び直す場合は、Claude Code・Cursor・Codexを用途・料金・権限で比較する記事へ進んでください。
Cloud・CLI・IDEの入口判断
TABLE / 横に動かせます
| 判断項目 | Cloud | CLI | IDE拡張機能 |
|---|---|---|---|
| 作業場所 | 分離されたクラウド環境 | 端末とローカルリポジトリ | エディター内の作業文脈 |
| 向く進め方 | 独立タスクを預け、後から確認 | 端末で対話しながら連続修正 | 開いているコードを見ながら修正 |
| 並列化 | 独立タスクを同時に進める候補 | 本記事では主用途にしない | 本記事では主用途にしない |
| 選ばない条件 | 別タスクの結果が前提になる作業 | ブラウザへ預けて離れたい作業 | エディター外で完結させたい作業 |
Codex Cloudとは？Codexのどの入口？
Codex Cloudは、OpenAIのコーディングエージェントCodexを、分離されたクラウド環境で動かす提供面です。製品名、実行場所、モデル名を分けて理解すると、APIやローカル版との混同を避けられます。
OpenAIのCodexとCloudの関係
CodexはOpenAIのコーディングエージェントで、CloudはCodexを利用する入口の1つです。Cloudそのものをモデル名として扱ったり、ChatGPTの月額契約をAPI利用料と同一視したりしません。OpenAI Codex公式ページ
Codex全体の料金、CLI・IDE・Cloudの入口、最初の使い方を俯瞰したい場合は、Codexの料金・入口・始め方をまとめた総合ガイドへ戻れます。
タスクごとに分かれる実行環境
Cloud環境とは、Codexがコードを取得し、セットアップを実行して作業する分離された環境です。公式ドキュメントでは、選択したブランチのコミットをチェックアウトし、セットアップ後にエージェントがコード変更やテストへ進む流れが説明されています。Codex Cloud環境の公式ドキュメント
分離されていることは、変更が自動的に安全になるという意味ではありません。対象ブランチ、依存関係、秘密情報、インターネット接続を環境ごとに確認する必要があります。
完了後に返る要約とコード差分
Cloudタスクの完了後は、作業の要約とコード差分を確認して次の行動を決めます。公式Quickstartは、必要なら追加変更を依頼し、準備が整った段階でプルリクエストを開く流れを示しています。Codex Cloud Quickstart
要約は判断の入口であり、差分そのものの代わりではありません。本記事では「要約を読む→差分を見る→追加修正かPRかを選ぶ」を人間側の確認工程として扱います。
Codex Cloudはどのプラン・端末で使える？
Codex Cloudの利用可否は、ChatGPTプランへのCodex掲載だけでなく、現在のアカウントとワークスペースでCloudが表示・利用できるかを分けて確認します。プラン、認証、API課金、既定モデル、端末対応は、それぞれ別の条件です。
Codex掲載プランとCloud利用可否を分ける
OpenAIの現行料金ページとプラン別ヘルプは、2026年8月2日時点でFree、Go、Plus、Pro、Business、Edu、EnterpriseをCodexの対象として掲載しています。ただし、これはCodex全体への掲載であり、すべてのプラン・アカウントでCloudを利用できるという意味ではありません。Cloudの利用可否は現在のアカウントとワークスペースで確認します。Codex公式料金ページ、ChatGPTプラン別のCodex公式ヘルプ
課金判断まで行う場合は、Codexの無料範囲とChatGPT各プランの料金比較を参照してください。残量やリセットを確認したい場合は、Codexの残量・リセット・追加クレジットの仕組みで分けて整理しています。
APIキーではCloudを利用できない
Codex Cloudを利用する認証はChatGPTサインインであり、APIキーはCloud機能への代替ログインになりません。APIキーを使う利用とChatGPTプラン内のCloud利用は、認証経路と課金経路が別です。Codex認証の公式ドキュメント、OpenAI API公式料金ページ
Cloudの既定モデルは変更できない
Codex Cloudチャットでは、2026年8月2日時点で利用者が既定モデルを変更できないと公式モデルページに記載されています。Codex全体のモデル一覧を、Cloud画面で選択できるモデル一覧として読み替えてはいけません。Codexモデルの公式ドキュメント
Cloudの既定モデル名は公式に明記されていません。本記事ではモデル名を推測せず、既定モデルが変更不可という確認可能な条件だけを扱います。
初回設定はWebから始める
本記事は、公式Quickstartが示すWeb上のGitHub接続と環境作成を標準手順にします。これはWebだけが利用可能という意味ではなく、端末ごとの未確認の画面差を作らないための編集上の選択です。Codex Cloud公式Quickstart
OpenAIの料金ページにはiOSでのCodex利用に関する記載がありますが、Androidを含む全端末でGitHub接続からPRまで同じ操作ができるとは公式に明記されていません（2026年8月2日確認）。Codex公式料金ページ。そのため、初回はWebで準備し、ほかの端末は現在の公式表示を確認して使います。
Cloudへ進めるかを確認する表
TABLE / 横に動かせます
| 確認項目 | 2026年8月2日の公式記載 | 本記事での判断 |
|---|---|---|
| Codexのプラン掲載 | Free、Go、Plus、Pro、Business、Edu、EnterpriseがCodex全体の対象として掲載 | Cloudの可否は現在のアカウントとワークスペースで確認する |
| 認証 | CloudはChatGPTサインインを使用 | APIキーを代替ログインにしない |
| モデル | Cloudチャットの既定モデルは利用者が変更不可 | 非公表の既定モデル名を推測しない |
| 初回端末 | 公式QuickstartはWebでの手順を案内 | 本記事もWebを標準にする |
Codex Cloudを始める前に何を準備する？
Codex Cloudを始めるには、ChatGPT認証、GitHubのリポジトリ権限、実行環境に必要な設定を先に確認します。Cloud画面を開けることと、対象リポジトリで安全にタスクを動かせることは別の条件です。
ChatGPT認証とMFAを確認する
Cloudを使う前に、CodexへChatGPTアカウントでサインインできる状態を確認します。OpenAIは、メールアドレスとパスワードでCloudを利用する場合にMFAを有効にするよう案内しています。Codex認証の公式ドキュメント
MFAとは、多要素認証によってパスワード以外の確認を追加する仕組みです。サインインで止まっている段階では、GitHub接続や環境設定へ進まず、先に認証を解決します。
GitHubで対象リポジトリへの権限を確認する
GitHub接続では、Codexへ許可するリポジトリを選び、利用者自身が対象リポジトリへアクセスできる必要があります。組織の設定によってはGitHub管理者の承認が必要です。GitHubとChatGPTを接続する公式ヘルプ
ChatGPTワークスペースでCodexを有効にしても、GitHub側のリポジトリ権限やブランチ保護は回避されません。組織利用では、ワークスペース管理者とGitHub管理者を同じ役割だと考えず、両方の設定を確認します。Codex管理者向け公式セットアップ
依存関係・ツール・環境変数を整理する
環境を作る前に、セットアップコマンド、必要なランタイム、依存関係、環境変数、シークレット、外部通信の要否を整理します。公式ドキュメントでは、環境変数とシークレットでエージェントから見えるタイミングが異なります。Cloud環境設定の公式ドキュメント
値そのものをタスク文へ書く必要はありません。何が必要で、どの段階だけに必要かを先に分類し、具体的な制御は「安全に任せる」章で確認します。
開始前の6項目チェック
- ChatGPT認証Cloudへサインインでき、必要な場合はMFAが有効になっている
- 対象リポジトリ作業対象と選択するブランチを説明できる
- GitHub権限本人または組織管理者がCodex接続を許可できる
- セットアップ依存関係と必要なコマンドを把握している
- 秘密情報環境変数とシークレットを分けて準備している
- 外部通信エージェントにインターネット接続が必要か判断している
GitHub連携から最初のタスクをどう開始する？
Codex Cloudの初回手順は、GitHub接続、環境作成、タスク開始、差分確認、PR判断の順に進めます。画面表記を固定して覚えるより、各段階の完了条件と止まる条件を理解する方が変更に対応しやすくなります。
Codexを開きChatGPTでサインインする
最初にCodexをWebで開き、ChatGPTアカウントでサインインします。APIキーではCloudへ入れないため、認証方法を取り違えないことが最初の分岐です。Codex Cloud公式Quickstart
GitHubを接続し、許可するリポジトリを選ぶ
GitHub接続では、Codexへアクセスを許可するリポジトリを必要な範囲に限定します。組織リポジトリが候補に出ない場合は、Codexの操作を繰り返す前にGitHub権限と管理者承認を確認します。GitHub接続の公式ヘルプ
Cloud環境を作成する
Cloud環境では、対象リポジトリとブランチを基準に、セットアップ、依存関係、環境変数、シークレットを準備します。エージェントが外部サービスへ接続する必要がある場合は、インターネット接続の条件もこの段階で決めます。Cloud環境の公式ドキュメント
望む結果と完了条件を1タスクで伝える
最初のタスクは、対象、望む変更、変更しない範囲、完了条件を1つに絞って伝えます。これは公式の必須テンプレートではなく、返された差分を判断しやすくするための筆者の運用基準です。
たとえば「認証機能を改善する」のように範囲を広げず、「対象モジュールの入力検証を修正し、関連テストを更新する」のように成果物と確認方法が対応する単位へ切ります。具体的なファイルやテストが分からない場合は、推測で固定せず調査範囲をタスクへ含めます。
ログを確認するか、バックグラウンドで進める
タスク開始後はログを確認するか、バックグラウンドで実行し、完了後に要約と差分を確認します。タスクが完了したことと、変更を採用できることは同じではありません。Codex Cloud公式ドキュメント
GitHub接続から差分確認までの5ステップ
-
01
ChatGPTでサインイン
Cloudへ入れる認証状態を確認します。
STOP / 認証できない -
02
GitHubリポジトリを許可
作業対象だけを接続し、組織承認の要否を確認します。
STOP / 対象が表示されない -
03
Cloud環境を作成
依存関係、変数、シークレット、外部通信を設定します。
STOP / 秘密情報の範囲が不明 -
04
独立した1タスクを開始
対象、望む結果、完了条件を対応させます。
STOP / 別タスクの完了待ち -
05
要約と差分を確認
追加修正またはPR作成のどちらへ進むか決めます。
STOP / 差分を説明できない
並列タスクはどう分ければよい？
Codex Cloudの並列実行は、互いに前提を共有しない独立タスクへ分けるときに使うのが筆者の判断基準です。公式に公開されていない最大並列数を目標にせず、衝突せずにレビューできる数へ抑えます。
独立して完了できる作業は同時に渡す
別のタスク結果を待たずに開始でき、変更範囲と完了条件を個別に説明できる作業は並列候補です。OpenAIはCloudで複数タスクを並行実行できると説明していますが、具体的な分け方は利用者側で決めます。OpenAI Codex公式ページ
筆者の例では、別ディレクトリのドキュメント更新と、依存しないモジュールのテスト追加は候補になります。ただし共通設定や同じファイルを変更する可能性が分かった時点で、並列前提を見直します。
前後関係がある作業は順番に進める
タスクBがタスクAの仕様や差分を前提にする場合は、Aを確認してからBへ進めます。データ構造の変更と、その新構造を使う機能追加を同時に渡すと、各タスクが異なる前提で変更する可能性があります。
同じファイルを触る可能性が高い、完了条件を共有している、片方の判断で他方の実装が変わる、のいずれかに当てはまる場合は順番に進めるのが本記事の基準です。
1タスクにつき1つの完了条件を置く
各タスクには、人が差分を見て達成を判断できる完了条件を1つ置きます。「品質を上げる」ではなく、「対象の入力条件を変更し、関連テストを更新する」のように成果と確認方法を対応させます。
完了条件を1つにするのはタスク文を短くするためではありません。並列で返ってきた複数の差分を、採用・追加修正・保留のどれにするか早く判断するためです。
並列にするか、順番にするか
TABLE / 横に動かせます
| 判断軸 | 並列にする | 順番にする |
|---|---|---|
| 前提 | 互いの結果を待たず開始できる | 片方の結果で実装方針が変わる |
| 変更範囲 | 対象ファイルや領域が分かれている | 同じファイル・共通設定を触る可能性が高い |
| 完了条件 | タスクごとに単独で判定できる | 2タスクを合わせないと判定できない |
| 次の行動 | 同時に開始し、差分を別々に確認 | 先行タスクを確認後、後続を開始 |
タスク完了後はいつPRを作る？
Codex Cloudの結果は、要約と差分を確認し、必要なら追加修正を依頼してからPR作成へ進めます。タスクが完了したという状態だけでPRを開くのではなく、変更を説明できるかを判断基準にします。
最初に要約と差分を確認する
タスク完了後は、Codexの要約で変更目的をつかみ、コード差分で実際の変更範囲を確認します。公式Quickstartも、結果の要約とdiffを確認してから追加変更またはプルリクエストへ進む流れを示しています。Codex Cloud公式Quickstart
diffとは、変更前後のコード差分です。要約に書かれていないファイルが変更されている、依頼していない範囲まで広がっている、削除理由が分からない場合はPRへ進まず確認します。
追加修正を依頼する条件
完了条件を満たしていない、変更範囲が広すぎる、テスト結果を判断できない場合は同じタスクで追加修正を依頼します。修正依頼では「もう少し良くする」ではなく、未達の条件と残すべき変更を分けて伝えます。
筆者の判断基準では、差分の目的を一文で説明できない状態も停止条件です。コード量が少ないことではなく、採用理由と影響範囲を説明できることを優先します。
PRへ進める3つの確認条件
PRへ進めるのは、依頼した完了条件、差分の説明、リポジトリ側の確認手順がそろった後です。テストやレビューの要否はリポジトリごとに異なるため、Codexの完了表示だけで代替しません。
PR作成は変更を統合するための提案であり、自動的なマージではありません。ブランチ保護、必須レビュー、CIなど、GitHub側のルールはそのまま適用されます。
PR作成と@codex reviewを分ける
CloudタスクからPRを開くことと、既存PRで@codex reviewを使ってコードレビューを依頼することは別機能です。後者はGitHub側のCodex code review設定と対象条件を確認して使います。CodexのGitHub code review公式ドキュメント
自動レビューを利用できるプランやワークスペース条件は変わり得ます。FreeやGoで利用できると推測せず、2026年8月2日時点の公式ページと現在のワークスペース設定を確認してください。GitHub code review公式ドキュメント
追加修正かPRかを決めるフロー
依頼内容と実際の変更範囲を照合する
未達条件、想定外変更、テスト状態を確認する
追加修正またはPR作成へ進む
未達条件または説明できない差分が残っている
完了条件・差分説明・リポジトリ側の確認がそろっている
Codex Cloudへコードを安全に任せるには？
Codex Cloudでは、GitHub権限、シークレット、エージェントのインターネット接続を別々に制御する必要があります。Cloudが分離環境で動くことを、すべての権限を渡してよい理由にはしません。
GitHubでは必要なリポジトリだけを許可する
Codexへ接続するGitHubリポジトリは、現在の作業に必要な範囲へ限定します。ChatGPTワークスペースの有効化は、GitHubのアクセス権やブランチ保護を上書きしません。GitHub接続の公式ヘルプ、Codex管理者向け公式セットアップ
筆者の判断基準では、「将来使うかもしれない」リポジトリまで先に許可しません。必要になった時点で追加する方が、権限の目的を説明しやすくなります。
環境変数とシークレットの見える時間を分ける
Cloud環境の環境変数はセットアップとエージェント実行の両方で利用されますが、シークレットはセットアップ中だけ利用され、エージェント実行前に削除されます。Codex Cloud環境の公式ドキュメント
したがって、エージェント実行中に秘密値が必要な設計を、シークレットへ登録すれば自動的に解決すると考えてはいけません。値の用途をセットアップ時とエージェント時に分け、不要な値は渡さないようにします。
インターネット接続を必要最小限にする
セットアップスクリプトはインターネットへ接続できますが、エージェント実行中のインターネット接続は既定で無効です。必要な場合は環境ごとに有効化します。Codex Cloudのインターネット接続公式ドキュメント
ライブラリ取得と、エージェントが任意の外部情報へアクセスすることを同じ設定として考えないでください。筆者の基準では、外部通信の目的と接続先を説明できないタスクでは有効化しません。
個人向け・組織向けのデータ利用条件
個人向けサービスでは、「Improve the model for everyone」が有効な場合にコンテンツがモデル改善へ使われる可能性があります。Business、Enterprise、Edu、APIのデータは既定では学習に使用されないとOpenAIは説明しています（2026年8月2日確認）。OpenAI Data Controls公式FAQ、OpenAI Enterprise Privacy
契約区分だけで入力可否を決めず、勤務先やプロジェクトの情報管理ルールも確認します。学習利用の既定値と、業務コードを入力してよいかという組織判断は別です。
出力の権利と人間の確認責任を分ける
OpenAIの利用規約では、利用者とOpenAIの間では、適用法で認められる範囲で出力の権利が利用者へ帰属する形が示されています。一方で、出力の正確性や利用目的への適合を人が評価する必要があり、第三者権利を侵害しないことが保証されるわけではありません。OpenAI個人向け利用規約、OpenAI Business Terms
「出力を利用できること」と「そのまま商用コードへ統合して問題ないこと」を連続させず、ライセンス、セキュリティ、レビューを別々に確認します。
Cloudへ渡す前のリスク管理表
TABLE / 横に動かせます
| 管理対象 | 公式情報から確認できる条件 | 進める前の判断 |
|---|---|---|
| GitHub権限 | 接続しても既存のリポジトリ権限を回避しない | 必要なリポジトリだけを許可する |
| 環境変数 | セットアップとエージェント実行で利用される | エージェントに見えてよい値だけを置く |
| シークレット | セットアップ中だけ利用され、実行前に削除される | セットアップ専用の秘密値に限定する |
| インターネット | エージェント実行中は既定で無効 | 目的と接続先を説明できる場合だけ有効化する |
| データ利用 | 個人向けと組織向けで既定条件が異なる | 契約と組織ルールの両方を確認する |
Codex Cloudが動かないときは何から確認する？
Codex Cloudが動かない場合、本記事ではリポジトリ権限、機能設定、アカウント、公式障害情報の順に切り分けます。架空のエラー文から原因を決めず、現在確認できる層を1つずつ狭めます。
対象リポジトリが表示されない場合
対象リポジトリが表示されない場合は、GitHub接続で許可したリポジトリ、本人のアクセス権、組織管理者の承認を確認します。ChatGPT側だけを再操作しても、GitHub側で未許可なら対象は追加されません。GitHub接続の公式ヘルプ
組織リポジトリでは、ChatGPTワークスペース管理者とGitHub管理者のどちらに確認が必要かを分けます。リポジトリが見えない原因を、料金不足だけに結び付けないことが重要です。
@codex reviewに反応しない場合
@codex reviewへ反応しない場合は、GitHub code reviewの設定、対象リポジトリ、プランまたはワークスペース条件を確認します。CloudタスクからPRを作れることだけでは、既存PRの自動レビュー設定が完了したことになりません。GitHub code review公式ドキュメント
公式ページで現在の対象条件を確認できないプランについては、利用できると推測しません。まず設定と権限を確認し、その後にプラン差を切り分けます。
アカウント・ワークスペース・障害情報を確認する
リポジトリ設定に問題が見つからない場合は、ChatGPT認証、ワークスペースのCodex設定、OpenAI Statusの順に確認します。障害発生中は設定変更や再課金を先に行わず、公式の復旧情報を待つ選択肢もあります。Codex認証の公式ドキュメント、OpenAI Status
認証だけを深掘りする場合は、Codexへログインできないときの認証別の確認順を参照できます。プラン・権限・環境を横断して確認する場合は、Codexが表示されない・使えない場合の切り分けへ進んでください。
設定変更や課金の前に確認する順番
許可リポジトリ、本人権限、組織承認
Cloud環境、code review、ワークスペース設定
ChatGPT認証、対象プラン、OpenAI Status
Codex Cloudの日本対応・AGENTS.md・削除条件
Codex Cloudの地域対応、指示ファイル、チャット削除は、開始手順とは別の利用条件として確認する必要があります。公式に書かれている範囲と、書かれていない範囲を分けて回答します。
Codex Cloudは日本から使えますか？
日本はChatGPTの対応国ですが、Codex Cloudの利用可否は現在のプラン、ワークスペース設定、アカウント表示を確認する必要があります（2026年8月2日確認）。ChatGPTの対応国一覧だけでは、日本のすべてのアカウントでCloudを利用できるとは断定できません。ChatGPT対応国の公式ヘルプ
ChatGPTの表示言語には日本語が用意されていますが、Codex Cloudの各ボタンに対応する固定の日本語表記は公式に一覧化されていません。画面表記が異なる場合は、この記事の架空ラベルではなく現在の公式画面とドキュメントを基準にしてください。ChatGPT言語設定の公式ヘルプ
Codex Cloudを使うにはAGENTS.mdが必須ですか？
AGENTS.mdは、Codex CloudのGitHub接続と環境作成を始める必須ファイルとして公式Quickstartには明記されていません（2026年8月2日確認）。Codex Cloud公式Quickstart
これはAGENTS.mdが不要という断定ではありません。筆者の運用判断では、リポジトリ固有の指示を継続して伝える必要がある場合に別途検討し、初回接続の必須条件とは分けて扱います。
削除したCodexチャットは復元できますか？
Codexチャットは、削除後に元へ戻すことを前提にせず、必要な会話は削除前に残すべき情報を確認してください。OpenAIは、削除したCodexチャットを原則30日以内の永久削除対象と説明し、復元手順は案内していません（2026年8月2日確認）。Codexチャットのアーカイブと削除に関する公式ヘルプ
法的・セキュリティ上の理由や、すでに匿名化されたデータなどには例外があります。削除までの期間を、利用者が30日間自由に復元できる期間とは解釈しません。
Codex Cloudを始める次の一手は？
Codex Cloudは、範囲の小さい1タスクで差分確認まで通してから並列作業へ広げるのが筆者の推奨です。GitHub接続、環境作成、タスク開始を一度に複雑化せず、人が確認できる最小単位から始めます。
最初の一手は、対象リポジトリから依存関係の少ない変更を1つ選び、完了条件を一文で書くことです。そのタスクの要約と差分を説明できた後に、独立する2件目を追加してください。
Cloudが合わないと分かった場合は失敗ではありません。ローカルで連続して直す必要がある作業はCLIまたはIDEへ戻し、作業の性質に合わせて入口を変えます。
引用元・参考情報
OpenAIの公式一次情報は、本文で実際に根拠として使用したページだけを2026年8月2日の確認日付きで掲載します。第三者のまとめページは引用元へ混ぜません。
あわせて読みたい
Codex Cloudの関連記事は、全体像、料金、利用上限、CLI、認証、表示問題の順に読むと次の判断へ進みやすくなります。現在必要な分岐だけを選んでください。
コメント