GitHubとCodexの使い方

🤖 Codexの担当 / 👤 人間の担当

👤 Codexは「招待されたcollaborator」ではない

GitHubのprivateリポジトリは「自分と招待した人（collaborator）だけが見られる」設定です。ここで初心者がよく迷うのが、「Codexを招待する必要があるのか」という点です。答えは不要です。

Codexは、あなたのGitHubアカウントに対して発行された認証（トークンやSSHキー）を使って、「あなた自身として」リポジトリを操作します。collaborator一覧にCodexが表示されることはなく、commitやpushの記録も「あなたの操作」として残ります。つまり、外部の人にリポジトリを見せる時のような「招待」の手続きは、AIツールには当てはまりません。

このことが実務的に意味するのは、AI連携で管理すべきは「誰を招待するか」ではなく「どの認証情報に、どこまでの権限を与えるか」だということです。トークンの権限範囲を必要最小限にし、定期的に見直すことが、collaborator管理の代わりの安全対策になります。招待の仕組み自体は「招待する人」って誰のこと？で詳しく整理しています。

🔄 統合アプリ（2026年7月9日〜）での作業の流れ

ChatGPTとCodexが1つのアプリに統合されて以降、アプリを行き来せず同じ画面内で作業が完結します。

統合で減ったのは「アプリを開き直す手間」で、「確認する工程」は変わらず必要です。

✅ 実際に確認すべき4つのポイント

渡す前に範囲を絞る

コードを扱わせる時、対象の範囲を決めずに始めると、意図しない場所まで変更されます。

1. 作業するディレクトリを限定する
2. 変更してよいファイルを伝える
3. 触ってほしくない場所を明示する — 設定ファイル、認証情報の置き場所

3番目を先に伝えてください。「ここは触らないで」は、後から言っても間に合いません。作業を始める前に範囲を確定させるほうが、確認の手間が減ります。

変更を確認する順番

できあがった変更は、次の順で見ると見落としが減ります。

• 変更されたファイルの一覧 — 想定外のファイルが混ざっていないか
• 削除された行 — 追加より削除のほうが影響が大きい
• 設定ファイルの変更 — 動作が変わります
• 個別のコードの中身

1番目を必ず先に見てください。ファイル単位で想定外があれば、中身を読む前に方針から見直す必要があります。いきなり中身を読み始めると、範囲のずれに気づけません。

記録に残しておくこと

後から「なぜこうなっているか」を辿れるよう、次を残してください。

• 何を頼んだか — 変更の説明に1行
• 参照した資料 — 公式ドキュメントのURLと確認日
• 確認していない部分

3番目が効きます。「動作は確認していない」と書いておけば、後で問題が出た時に原因を絞れます。すべて確認済みのように見せると、調べ直す範囲が広がります。

一度に頼む量を決める

まとめて頼むと、確認が追いつかず手戻りが大きくなります。

• 1つの目的に絞る — 「修正とリファクタリングを同時に」は分ける
• 確認できる大きさにする — 自分が読み切れる量
• 依存する作業は分けて頼む — 途中を確認できます

1番目が効きます。目的が混ざった変更は、どこまでが意図したものか判断できません。後から履歴を読む人にも伝わりません。

codexguide.jpと一緒に確認する

Codexで実際にGitHub PRを作る流れや、作業報告書の読み方はcodexguide.jp側にも整理しています。GitHub側では差分・Secrets・rollbackを中心に確認すると安全です。