CodexとGitHubを連携する方法｜リポジトリが見えない原因と権限の確認

最初に、どの「GitHub連携」を使いたいかを決める

ブラウザ上でCodexにリポジトリを選んで作業してもらうなら、クラウドの接続を確認します。ChatGPTにコードを参照させたいだけの接続や、PCに置いたコードをGitで送受信する認証を済ませても、それだけでクラウドの一覧がそろうわけではありません。

たとえば、PCではgit pullが成功するのにCodexの一覧が空という状況なら、最初からPCのGitを入れ直す必要はありません。今開いている画面が、どのアカウントのどの接続を使っているかを先に見ます。

• 出典：Codex cloud（新しいタブ）
• 出典：GitHub Appsのリポジトリアクセス（新しいタブ）

練習用のリポジトリ一つで接続する

初回は、外へ出せないデータや本番の設定がない練習用リポジトリで始めると確認しやすくなります。READMEが一つ入っていれば十分です。READMEはプロジェクトの説明文で、接続テストのためにアプリを完成させる必要はありません。

Codexの公式クラウド画面からGitHubへの接続を開始し、認可画面でログイン先を確かめます。個人用と会社用のアカウントを使い分けているなら、表示された名前をここで見ます。選択できる場合は対象のリポジトリを指定し、戻ったCodexで同じ名前を選びます。

組織が管理するリポジトリでは、本人が許可しても管理者の承認待ちになることがあります。「管理者に承認を依頼する」の表示が出たら、その状態を残して管理者へ確認します。個人アカウントへコードを複製して承認を飛ばす解決にはしません。

見えないときは、三つの名前を照合する

確認するのはGitHubのユーザー名、所有者または組織名、リポジトリ名です。同名のリポジトリを別の組織にも持っていると、末尾の名前だけでは区別できません。「所有者/リポジトリ」の組で比べてください。

GitHubのインストール済みアプリ設定で、そのアプリに目的のリポジトリが許可されているかを確認します。接続後に作ったリポジトリなら、最初の許可範囲に入っていない可能性があります。必要な対象を追加したらCodex側を再表示し、反映を確かめます。

いきなり変更せず、読めることを一度確かめる

対象が表示されたら、まずREADMEの内容を尋ねます。AIがもっともらしい説明を返しただけでは接続の成功としません。実際のファイル名と、そのファイルにしかない短い記述が一致しているかを見てください。

次の依頼文は接続確認用です。会社の秘密を埋め込む必要はなく、自分で作った「接続確認用の説明です」という一文で十分に区別できます。

変更は差分と送り先を見てから取り込む

読み取りが確認できたら、READMEに説明を一行追加する程度の小さな変更を頼みます。差分とは、変更前と変更後の違いです。目的の一行以外が変わっていないか、意図しない設定ファイルが増えていないかを確認します。

プルリクエストは、変更を本流に取り込むための提案です。提案が作れたことと、取り込みが完了したことは別です。送り先のリポジトリとブランチを確認してから取り込みます。本番へつながるブランチなら、既存のテストやレビューも通してください。

接続できた後は、毎回同じ注意点を長く入力するより、AGENTS.mdに作業ルールをまとめる方法を用意すると、変更の範囲を伝えやすくなります。

接続の次に学ぶなら、変更の確認までを一緒に

ここまでの接続確認だけなら、追加の有料サービスは必要ありません。これからCodexで自分のアプリを育てたい場合は、指示の書き方だけでなく、変更の読み方やチーム運用まで扱う入門書を候補にできます。

選ぶときは目次でGitと作業ルールを扱っているかを確認しましょう。画面は更新されるため、接続ボタンの位置はこの記事の公式リンクを優先し、本は開発の進め方を順番に学ぶ用途に使うと無駄がありません。