AIコーディングガイド

Codex クラウド版で GitHub リポジトリのタスクを任せる:環境設定から PR 作成まで

Codex 公開:

ChatGPT 上で動く Codex クラウド版の使い方を解説します。GitHub リポジトリの接続、環境(依存関係のセットアップスクリプト)の設定、タスクの投げ方、生成された PR の確認、ローカル版との使い分けを紹介します。

検証日 2026年9月7日 仕様変更が早い分野です。最新の公式ドキュメントも併せてご確認ください。
#Codex#クラウド#GitHub#PR#自動化
目次
  1. 前提条件
  2. GitHub を接続する
  3. 環境を設定する
  4. タスクを投げる
  5. 結果を確認して PR にする
  6. AGENTS.md を整える
  7. ローカル版・VS Code 拡張との使い分け
  8. まとめ

Codex のクラウド版は、手元のマシンではなく OpenAI 側のコンテナでリポジトリをクローンし、タスクを実行して結果を PR として返す仕組みです。「Issue を 3 件まとめて渡して、PR が 3 本返ってくる」ような使い方ができ、ローカルの作業と並行して進められます。

この記事では、GitHub の接続、環境の設定、タスクの投げ方、PR の確認までの流れと、うまく使うためのコツをまとめます。

KEY POINT

この記事で分かること

  • GitHub リポジトリの接続と環境(セットアップスクリプト)の設定
  • タスクの投げ方と、生成された PR の確認・修正依頼
  • ローカル版・VS Code 拡張との使い分け

前提条件

項目内容
アカウントChatGPT の対応プラン(Plus / Pro / Team / Enterprise など。対応状況は公式で確認)
GitHub対象リポジトリへのアクセス権。GitHub App のインストールが必要
リポジトリテストやビルドがコマンド 1 つで実行できる状態だと効果が高い

GitHub を接続する

  1. ChatGPT のサイドバーから Codex を開きます。
  2. 初回は GitHub との接続を求められます。案内に従って GitHub App をインストールし、Codex に使わせるリポジトリを選択します。
  3. 接続後、リポジトリの一覧から対象を選び、環境を作成します。

用語解説

環境(Environment): リポジトリごとの実行設定です。使用するコンテナイメージ、環境変数、セットアップスクリプト、ネットワークの許可範囲などを定義します。1 つのリポジトリに複数の環境を作ることもできます。

環境を設定する

環境設定で重要なのは セットアップスクリプトです。コンテナは毎回まっさらな状態から始まるため、依存関係のインストールをここに書きます。

# セットアップスクリプトの例(Node.js プロジェクト)
corepack enable
pnpm install --frozen-lockfile
# Python プロジェクトの例
pip install -r requirements.txt -r requirements-dev.txt

環境変数(テスト用の設定値など)は環境設定の画面から登録します。本番の認証情報は登録しないでください。

セットアップが終わった後のインターネットアクセスは、既定で制限されます。テストが外部 API に依存する場合は、モックにするか、環境設定で必要なドメインを許可します。

セットアップスクリプトが失敗するとタスク全体が失敗する

ロックファイルの不整合や Node.js のバージョン違いで pnpm install が失敗すると、その後のタスクはすべて失敗します。最初に「依存関係をインストールしてテストを実行して」という簡単なタスクを投げ、環境が正しく動くことを確認してください。

タスクを投げる

環境ができたら、テキストで指示を書いて実行します。

Issue #42 の「ログイン後にリダイレクトされない」不具合を修正してください。
再現するテストを先に追加し、修正後にテストが通ることを確認してください。
  • Ask(質問): コードを変更せず、調査結果や提案を返します。
  • Code(実装): 変更を行い、差分と実行したコマンドのログを返します。

複数のタスクは並列に実行されます。互いに依存しないタスク(別々の Issue、別々のモジュール)を同時に投げるのが効率的です。

結果を確認して PR にする

タスクが完了すると、差分、実行したコマンド、テスト結果のログが表示されます。内容を確認して問題なければ「PR を作成」でブランチと PR が作られます。

  • 修正が必要なら、同じタスクに追加の指示を送って続きをやらせます。
  • PR 作成後は、通常のレビューフローに乗せます。CI が走り、レビュアーが確認します。
  • PR のコメントで Codex にレビューを依頼する機能もあります。対応状況は公式ドキュメントで確認してください。

AGENTS.md を整える

クラウド版も、リポジトリの AGENTS.md を読みます。コンテナ内で実行すべきテストコマンド、コーディング規約、触ってはいけない場所を書いておくと、タスクごとに説明する必要がなくなります。書き方は Codex CLI のセットアップと AGENTS.md の書き方 を参照してください。

ローカル版・VS Code 拡張との使い分け

状況向いている方
対話しながら実装や調査を進めたいローカル(CLI / VS Code 拡張)
独立したタスクを複数、時間をかけて進めたいクラウド
ローカルでしか再現しない環境依存の問題ローカル
手元の環境を汚したくない、別マシンから確認したいクラウド

VS Code 拡張からクラウドにタスクを送ることもできるため、「手元で調査 → クラウドに実装を委任 → 手元で PR を確認」という流れが組めます(Codex VS Code 拡張の使い方)。Claude Code で同様の仕組みを作る場合は GitHub Actions で Claude Code を動かす を参照してください。

まとめ

  • ChatGPT の Codex から GitHub App を入れてリポジトリを接続し、環境を作る
  • 環境のセットアップスクリプトに依存関係のインストールを書き、最初に簡単なタスクで動作確認する
  • 独立したタスクを並列に投げ、結果を確認してから PR を作成する
  • AGENTS.md にテストコマンドと規約を書いておくと、タスクごとの説明が不要になる

よくある質問

Codex クラウド版はどこから使えますか?
ChatGPT のサイドバーにある Codex から利用します。VS Code 拡張からクラウドにタスクを送ることもできます。
コンテナ内でテストを実行させられますか?
環境設定でセットアップスクリプト(依存関係のインストールなど)を指定すれば、Codex はコンテナ内でテストやビルドを実行できます。
タスク実行中のネットワークアクセスはどうなりますか?
既定ではセットアップ後のインターネットアクセスは制限されます。必要なドメインは環境設定で許可できます。

参考にした一次情報

この記事は公式ドキュメントを基に AI が下書きを作成し、運営者が内容を確認して公開しています。誤りを見つけた場合はお問い合わせからお知らせください。

関連記事