メインコンテンツへスキップ
見出し画像

CodexやClaude Codeは，GitHubとどうやってやりとりしているのか

    さとけさま

    気になったので調べた．

    確認日: 2026年7月9日．公式ドキュメントを中心に確認した情報をもとにしている．機能名や利用条件は変わる可能性があるため，導入時点の管理者設定と契約条件を別途確認する必要がある．

    結論

    CodexやClaude CodeをGitHub repositoryと組み合わせるとき，AIサービスへのログインとGitHubへの認証は別物である．ChatGPTやClaudeにログインできることは，private repositoryを読めること，branchへpushできること，pull requestを作れることを意味しない．

    ローカル実行では，GitHub認証は自分のPC側に依存する．SSH鍵，HTTPS credential，GitHub CLI，credential storeが，`git push`や`gh pr create`で使われる．クラウド実行では，OpenAIまたはAnthropic側の環境にGitHub accessを許可する．そのため，ローカルの未push変更，SSH鍵，`gh auth login`状態は，明示的に同期または送信される機能を除き，クラウド側へ自動では移らない．

    認証の対象を分ける

    画像

    認証は4層に分ける．第一に，OpenAIやAnthropicを使うAIサービス認証がある．CodexではChatGPTログインとAPI keyログインがあり，Codex cloudはChatGPTログインが必要である．第二に，GitHub上のrepository accessがある．public repositoryは読める範囲が広いが，private repositoryにはユーザー，team，GitHub App，tokenのいずれかにreadまたはwrite accessが必要である．

    第三に，`git clone`，`git fetch`，`git push`のようなGit transportの認証がある．第四に，PR作成，PRコメント，レビュー投稿のようなGitHub API操作の認証がある．読む，編集する，pushする，PRを作る，PRでAIレビューを依頼する，Actionsで動かす，では必要な権限が違う．organization policyがGitHub App，PAT，OAuth，Actionsを制限している場合もある．

    ローカル実行で起きていること

    CLI，VS Code拡張，デスクトップアプリのLocal実行では，AIエージェントは作業ディレクトリを読み，編集し，許可された範囲でコマンドを実行する．GitHubへの認証は，AIサービスのログインではなく，その端末のGit設定に依存する．SSH remoteなら端末上の秘密鍵と`ssh-agent`，HTTPS remoteならcredential helperやGitHub CLIが保存した認証情報が使われる．

    作業前後の確認とPR作成は，通常のGit workflowで行う．秘密情報そのものをプロンプトへ貼る必要はない．

    git status
git remote -v
gh auth status
git checkout -b feature/update-auth-doc
git diff
git add .
git commit -m "docs: clarify GitHub authentication flow"
git push -u origin feature/update-auth-doc
gh pr create --base main --head feature/update-auth-doc

    ここで効くのは，GitHub側のrepository roleとbranch protectionである．Write権限がなければprivate repositoryにはpushできない．branch protectionがある場合，CI，review，署名済みcommit，linear historyなどの条件も通常どおり適用される．

    クラウド実行で起きていること

    Codex Web / CloudやClaude Code Webでは，サービス側のクラウド環境がrepositoryを取得して作業する．Codex cloudはcontainerを作り，選択したbranchまたはcommit SHAでrepoをcheckoutし，setup scriptを実行し，agentが編集やテストを行う．Claude Code WebはAnthropic管理のVMでrepositoryをfresh cloneし，setup script，network設定，作業，branch pushへ進む．

    この構成では，ローカルPCの状態は前提にならない．PC上の未push変更，`~/.ssh`の秘密鍵，`~/.gitconfig`，ローカルだけにある.envや個人設定は，自動ではクラウド側に存在しない．必要な設定は，repositoryへcommitする設定ファイル，cloud environmentのsetup script，environment variables，secretsなどで渡す．secretがagent phaseで使えるか，setup phaseだけか，誰に見えるかはサービスごとに異なる．network accessも，依存関係取得とprompt injection，secret exfiltrationの両面から制限する．

    Codexの使い方別整理

    • Codex Web / Cloudは，ChatGPT側のCodex画面でGitHub accountを接続して使う．repositoryのコードを扱い，作業結果からpull requestを作成できる．Codex cloudはChatGPTログインが必要であり，API keyだけで使える範囲はローカルのCodex app，CLI，IDE extension中心である．

    • Codex Desktop Appは，Local，Worktree，Cloudのmodeを選べる．LocalとWorktreeはPC上で動き，WorktreeはGit worktreeで変更を分離する．公式のApp featuresでは，LocalとWorktreeのtaskについて，アプリ内からcommit，push，pull request作成ができると説明されている．PR feedbackを扱う場合は，GitHub CLIをinstallし，`gh auth login`で認証する必要がある．

    • Codex VS Code extensionは，VS Code互換editor上でCodexにchat，編集，コマンド実行をさせるUIである．CLIと同じagentと設定を共有し，ローカル作業に加えてCodex cloudへ作業を委譲できる．Desktop Appと同じ内蔵Git toolsでcommit，push，PR作成ができるとは公式features上で確認できなかったため，PR作成はGit，GitHub CLI，エディタ標準機能，またはGitHub画面を使う整理にする．

    • Codex CLIはterminalで動くローカル実行の入口である．CLI featuresでは，`codex cloud`でterminalからCodex cloud taskを起動し，結果をローカルに適用できると説明されている．

    • GitHub上の`@codex`，`@codex review`，`@codex fix`は，通常チャットやローカル実行とは別のGitHub連携である．PRのdiffやコメントをcontextにし，Codex cloudが動く．

    Claude Codeの使い方別整理

    • Claude Code Webはresearch previewである．Claude.ai/codeまたはmobile appからtaskを作り，Anthropic管理のcloud VMでGitHub repositoryをcloneして作業する．GitHub accessは，Claude GitHub Appの認可，またはterminalで`/web-setup`を実行してローカルの`gh` CLI tokenをClaude accountへ同期する方法がある．GitHub AppはAuto-fixのPR webhookにも必要である．

    • Claude DesktopのCodeタブでは，EnvironmentとしてLocal，Remote，SSHを選べる．Localは自分のPC上のproject folder，RemoteはClaude Code Webと同系統のcloud session，SSHはSSH先machineで実行する形である．Desktop appにはClaude Codeが含まれるが，terminalで`claude`を使う場合はCLIが必要である．

    • Claude Code VS Code拡張は，IDE内でClaude Codeを使うためのUIであり，standalone CLIをterminalで起動するだけのものではない．認証や設定の一部はCLI系のsurfaceとして扱われる．Remote tabではClaude.aiで始めたcloud sessionをresumeできるが，会話履歴はローカルに読み込まれ，変更はclaude.aiへ同期し直されないと説明されている．

    • Claude Code CLIはローカルterminalで動き，コードを読み，編集し，コマンドを実行する．`claude --cloud`のようにcloud sessionを作る入口もあるが，ローカルGit操作は端末側のGitHub認証に依存する．

    • GitHub上の`@claude`やClaude GitHub Actionsは，issue，PR，workflow runner上で動く連携であり，ローカルsessionとは実行場所と認証が違う．workflowでは`GITHUB_TOKEN`やsecretを使うため，Actions permissionsを最小化する必要がある．

    画像

    pushとpull request作成の流れ

    ローカルでpushする場合，AIは作業ディレクトリの変更を作るだけであり，Git操作は通常の開発と同じである．差分を確認し，commitし，`git push`する．PRは`gh pr create`またはGitHubの画面で作る．この経路では，端末のGitHub認証とrepository権限が結果を決める．

    クラウドからPRを作る場合，サービス側のGitHub連携がrepositoryをcloneし，branchをpushし，PRまたはPR作成導線を作る．private repositoryでは，接続したGitHub account，GitHub App installation，organization policy，repository roleを確認する必要がある．PR上の`@codex review`，`@codex fix`，`@claude`は，通常のチャットではなくGitHub連携のtriggerであり，push先branch，workflow permissions，branch protectionによって結果が変わる．

    GitHub認証方式の使い分け

    `gh auth login`は，GitHub CLIを使うための標準的な導線である．HTTPSを選ぶと，GitHub CLIがGit credentialを保存し，`git push`や`git pull`でも同じcredentialを使える場合がある．`gh pr create`は，未push branchのpush先を尋ね，base branchとhead branchをもとにPRを作成する．

    SSH鍵は，ローカルmachineからGitHubへGit transportで接続する方法である．秘密鍵はPC側に置き，公開鍵をGitHubへ登録する．クラウド実行環境に秘密鍵をコピーする前提で設計してはいけない．PATはpassword同等に扱うべき機密情報であり，AIへのプロンプト，PRコメント，ログ，スクリーンショットに含めない．

    GitHub Appはinstallation単位でrepositoryやpermissionを絞れる．GitHub Actionsではworkflowごとに`permissions`を指定し，`contents: read`や`pull-requests: write`など必要な権限だけを与える．個人の長期tokenより，GitHub CLI，GitHub App，Actionsの`GITHUB_TOKEN`，必要最小限のfine-grained PATを優先する．

    会社やprivate repositoryで使う場合の注意点

    会社のprivate repositoryでは，誰がどのrepositoryをどのサービスへ接続できるかを決める．GitHub organizationのApp install policy，PAT policy，OAuth policy，Actions policy，SSO，MFA，audit log，branch protectionを確認する．AIサービス側でも，workspaceのdata retention，RBAC，管理者設定，外部送信の扱いを確認する．Claude Code WebではZero Data Retention organizationで`/web-setup`やcloud sessionsを使えないと説明され，Codex cloudではEnterprise workspaceでadmin setupが必要な場合がある．

    secret管理は別に設計する．`.env`，SSH private key，PAT，cloud credentialをrepositoryへcommitせず，promptやPRコメントにも貼らない．Actions secretや環境変数を使う場合は，編集権限，ログ露出，fork PRからの参照可否，setup scriptとagent phaseの扱いを確認する．導入時は，read-onlyで探索し，低リスクrepositoryで検証し，PR作成は人間のreviewを必須にし，ActionsとGitHub Appのpermissionを絞るとよい．

    まとめ

    CodexとClaude Codeは，どちらもrepositoryを読み，編集し，テストし，PRへつなげる機能を持つ．ただし，実行場所と認証の所在はUIごとに違う．ローカル実行では，GitHub認証は実行端末側に依存する．クラウド実行では，OpenAIまたはAnthropic側にGitHub連携を許可し，repositoryを取得できる状態にする必要がある．

    最初はローカルで小さな修正に使い，差分確認，commit，push，PR作成を従来のGit workflowで行うと構造を理解しやすい．その後，クラウド実行，GitHub mention，Actions連携を導入する場合は，repository access，organization policy，secret管理，最小権限，network制限を設計してから使う．

    参考文献

    確認日: 2026年7月9日．一次情報として公式ドキュメントを優先し，記事本文では公式情報で確認できた範囲だけを断定した．URLは確認日時点のもの．

    OpenAI / Codex

    Anthropic / Claude Code

    GitHub

     
     

    さとけさま

     
     
    会社員，気ままに興味があったことを記録しています．

    あなたへのおすすめ