Codexクラウドの使い方 ChatGPTからGitHubにPRを作る方法

監修者_SD以外

監修者プロフィール

森下浩志

日本最大級のAI情報プラットフォーム「romptn ai」編集長。著書に「0からはじめるStable Diffusion」「0からはじめるStable Diffusion モデル・拡張機能集編」など、AmazonベストセラーのAI関連書籍を多数執筆。AIにおける情報の非対称性を解消するための社内研修や出張講義も行う。

まずは流れをつかむ

ここでは、ChatGPTからCodexを開いてGitHubのrepoをつなぎ、タスク実行後にPRを作るまでの流れを先にそろえます。

Codex cloudの強みは、ローカルPCを開きっぱなしにしなくても、クラウド側の作業環境でタスクを進めてあとから差分を確認できることです。OpenAIのQuickstartでも、おおまかな順番は「Codexを開く → 環境を作る → タスクを実行する → 差分を見てPRを作る」で整理されています。

迷いにくい進め方は次の5段階です。

コードベースについて質問したいだけならAsk、実際に変更を作らせるならCodeと覚えておくと操作がぶれません。次の章から、最初につまずきやすいGitHub接続と環境設定を順番に見ていきます。

GitHub接続を準備する

ここでは、Codexにrepoを渡す前提になるChatGPT側のGitHub接続を整理します。

最初に押さえたいのは、GitHub connectorの接続とCodex環境でそのrepoを使う設定は別工程だということです。SettingsからGitHubをつなぐ段階では、どのリポジトリへのアクセスを許可するかを決めます。一方で、同期対象の指定やCodexの作業環境への接続は後続の操作です。

準備で見るポイントは3つです。

Help Centerでも、GitHubまわりの表示はプランや利用中の画面差分で見え方が変わる前提になっています。メニュー名が少し違っても焦らず、Settingsの連携一覧とrepo accessの許可状況を先に確認するのが近道です。

環境を作ってrepoをつなぐ

ここからは、実際にCodex cloudが作業する環境を用意する段階です。

Quickstartの流れでは、Codexを開いたあとに対象repoを含む環境を作り、その中でタスクを走らせます。つまり、GitHubアカウントを接続しただけではまだ不十分で、どのrepoをこの環境で触らせるかをもう一段指定する必要があります。

進め方はシンプルです。

この確認を飛ばすと、あとで『接続したはずなのにrepoが見えない』という混乱が起きやすくなります。次の章でタスクを投げる前に、repo名と作業対象が一致しているかだけは必ず見ておきましょう。

タスクを投げて進捗を見る

ここでは、実際にCodeへ作業を依頼して進み方を確認します。

Codex webはクラウド環境でタスクをバックグラウンド実行できるので、ローカルPCを占有せずに待てるのが大きな利点です。複数タスクを並列で回せる一方、最初は依頼文を欲張りすぎず、1回で1テーマに絞ったほうが差分確認もやりやすくなります。

最初の依頼は、次のように具体化すると失敗しにくくなります。

このrepoで〇〇ページの文言を修正し、関連テストがあれば実行して結果もまとめてください。
変更理由は△△です。

進捗画面では、何を読んで何を変更したか、どこで止まっているかを順に追えます。確認したいのは、対象ファイルが依頼と合っているか、想定外の大きな変更が混ざっていないか、テストやチェックが実行されたかの3点です。ここで怪しい動きがあれば、PR作成前に追加で指示を返しましょう。

差分を見てPRを作る

ここでは、Codexが返した変更をそのまま流さずに確認してからPRへ進めます。

Quickstartでも、完了後はdiffを見てPRを作る流れが前提です。見るべき順番は、まず変更ファイル一覧、次に差分の中身、最後にPR本文です。特に、依頼していないファイルまで触っていないか、削除が多すぎないか、説明文が作業内容を正しく要約しているかは必ず見てください。

PR作成前の最小チェックは次の通りです。

Communityの実例でも、PRを作ったあとにbranchをローカルへpullして追加テストや微修正を入れてからマージする流れが一般的です。クラウドで変更を作り、最終判断は自分で行うという役割分担にすると、実務でもかなり扱いやすくなります。

承認と安全設定を決める

ここでは、Codexにどこまで任せるかを決める安全設定をまとめます。

混同しやすいのですが、approval mode、sandbox、internet accessは同じ設定ではありません。approvalは『どの操作で人の確認を入れるか』、sandboxは『環境内で何が許されるか』、internet accessは『外向き通信を開けるか』を分けて制御します。

OpenAIのsecurity docsでは、cloud実行はsetup phaseとagent phaseで扱いが分かれています。依存関係の準備をするsetup phaseとは別に、agent phaseはデフォルトでオフラインです。外部通信が必要な時だけ環境ごとにinternet accessを有効化し、allowlistで最小権限に寄せる考え方を守ると、便利さと安全性を両立しやすくなります。

詰まりやすい点を確認する

ここでは、初回セットアップで止まりやすいポイントだけ先に潰します。

一番多いのは、GitHubを接続したつもりでも対象repoが見えないケースです。この場合は、connector自体の接続状態だけでなく、repo accessの許可範囲とCodex環境側でのrepo選択を見直してください。どちらか片方だけ済んでいても、作業対象としては表示されません。

設定画面へ戻されるループが起きる時は、ChatGPT側のGitHub連携をいったん確認し直すと復旧することがあります。Communityでも、再接続でrepo一覧が見えるようになった報告があります。

PR前後で迷いやすいのは、『作れたからすぐマージしていいのか』という判断です。ここは急がず、差分確認、必要なテスト、ローカルでの最終確認の順に切り分ければ十分です。困ったら、接続と対象repoの一致確認に戻るだけでも原因をかなり絞れます。

よくある質問

まとめ

ここでは、ChatGPTからGitHubにPRを返すまでの流れを最後に整理します。

次にやることは、まず小さな修正タスクを1件だけ投げて、実際にdiffとPR画面まで触ってみることです。最初から大きな改修を任せるより、変更範囲が読めるタスクで一連の操作に慣れたほうが安全に進められます。

クラウドで変更を作り、最後は自分で確認してPRを育てる。この流れに慣れると、Codex cloudは日常の開発作業をかなり軽くしてくれます。