Claude Code WebのGitHub認証 — GitHub Appと/web-setupの選び方

このTipsでできること

GitHub認証は「GitHub App」と「/web-setup」の2方式です。

Claude Code on the webがクラウドセッションでGitHubリポジトリをclone・pushするには、GitHubへのアクセス許可が必要です。この許可は「GitHub App」と「/web-setup」という2つの方式のどちらかで与えます。どちらを選ぶかで、ブラウザーだけで完結するか、既存のgh CLIログインを使い回せるかが変わります。組織で運用しているなら、Quick web setupという管理者トグルの有無でメンバーが選べる選択肢そのものが変わる点も押さえておく必要があります。

GitHub Appと/web-setupは何が違うか

GitHub Appは、claude.ai/codeの初回オンボーディング中にブラウザーでClaude GitHub Appを認可する方式です。ブラウザーの操作だけで完結し、リポジトリへのAppインストールも同じ流れで行えます。

/web-setupは、ターミナルのClaude Code CLIで実行するコマンドです。ローカルのgh CLIトークンを読み取り、そのままclaude.aiアカウントに同期します。すでにgh auth login済みの開発者なら、ブラウザーを開かずに接続が終わります。

/web-setup

実行が成功するとConnected as <GitHubユーザー名>と表示され、claude.ai/codeがブラウザーで自動的に開きます。クラウド環境がまだ無ければ、Trusted network accessでsetup scriptなしのDefault環境もこのタイミングで作成されます。

どちらの方式でリポジトリへのアクセスを与えても、クラウドセッションが到達できるリポジトリの範囲は同じです。接続したGitHubアカウントがGitHub上で見られるリポジトリなら、Claude GitHub Appがインストールされていないリポジトリにもアクセスできます。Appのインストールが有効にするのはAuto-fix用のPR webhookだけで、セッション単位のアクセス制御ではありません。チームでアクセスできるリポジトリを絞りたいときは、GitHub側でチームやリポジトリのメンバーシップを制限します。

このアクセス範囲は、定期実行タスクを組む/scheduleがリポジトリへ触れられるかどうかの判定にも使われます。GitHub App・/web-setupのどちらで接続していても、スケジュール登録時のリポジトリアクセス確認は同じ基準で通ります。

GitHub Appでの接続手順(ブラウザーオンボーディング)

claude.ai/codeを開くと、まずSign in with GitHubのステップが表示されます。個人のアカウントならそのままサインインに進めますが、Team・Enterpriseプランの組織では話が違います。OwnerがAdmin settings > ConnectorsでGitHub connectorをオンにするまで、このステップは「GitHub access is required for Claude Code on the web」という表示のまま先に進めません。

GitHub connectorがオンになった後、Quick web setupが無効(Team・Enterpriseの既定)であれば、claude.ai/codeはリポジトリへのClaude GitHub Appインストールを求めてきます。CI失敗やレビューコメントに自動対応するAuto-fixを使いたいならインストールし、不要ならSkipを選べます。インストールしてもしなくても、セッションが到達できるリポジトリの範囲は変わりません。

/web-setupでの接続手順

/web-setupを使うには、ローカルにClaude Code CLIが入っていて/loginでclaude.aiアカウントにサインイン済みであることが前提です。ターミナルでclaudeを起動し、プロンプト内で/web-setupを実行します。シェルのghコマンドと混同してターミナルのシェル側で/web-setupと打つと、コマンドとして認識されずエラーになります。Claude Codeのプロンプト内で正しく打っていても、認証要件を満たしていない場合はコマンド自体が候補に出てこず、結果として「No commands match」と表示されることがあります。

Team・Enterpriseプランでは、/web-setupコマンド自体がQuick web setupが有効になるまで表示されません。個人開発者がAPIキーやサードパーティプロバイダーで認証している場合も同様にコマンドが隠れるため、/loginでclaude.aiアカウントに切り替えてから再実行します。GitHub CLI(gh)が未インストール、または未認証の状態でも/web-setupは使えますが、この場合はgh auth loginの代わりにブラウザーオンボーディングが開き、claude.ai/code側でのGitHub認可に切り替わります。

組織管理者はQuick web setupで何を制御できるか

Quick web setupは組織単位の設定で、OwnerがAdmin settings > Claude Codeのトグルで切り替えます。オンにすると次の3つが同時に変わります。

• メンバーが/web-setupでGitHubを接続できるようになる(既定ではコマンド自体が非表示)
• ブラウザーオンボーディングでのClaude GitHub Appインストール確認をスキップする
• 環境設定フォームを表示する代わりに、Default環境をメンバーごとに自動作成する

Team・Enterpriseプランではこのトグルは既定でオフです。オフのままだと、メンバーは全員ブラウザー経由のGitHub App認可を通ることになります。CLIに慣れた開発者が多いチームでは、Quick web setupをオンにするだけで/web-setup経由の接続が選べるようになり、オンボーディングの摩擦が減ります。

Zero Data Retentionを有効化している組織は、/web-setupを含むクラウドセッション機能そのものを使えません。この制限はQuick web setupの設定に関わらず適用されます。

さらに、組織のOwnerがAdmin settingsでClaude Code on the web自体を無効化している場合も、/web-setupコマンドはメンバーのターミナルに表示されません。Quick web setupがオンでも、Claude Code on the webの機能自体が無効なら/web-setupは隠れたままになります。

どちらを選ぶべきか

リポジトリが表示されないときの確認順序

接続後にリポジトリの一覧に目的のリポジトリが出てこない場合は、まず接続したGitHubアカウントがGitHub上でそのリポジトリにアクセスできるかを確認します。Claude GitHub Appのインストール有無はここでは関係ありません。Auto-fixも使いたい場合だけ、github.comのSettings > Applications > Claude > Configureを開き、Repository accessに対象リポジトリが含まれているか確認します。プライベートリポジトリもパブリックリポジトリと同じ手順で認可が必要です。

GitHubをそもそも接続したくない場合は、Remote Controlを使う選択肢もあります。ローカルのClaude Codeセッションをブラウザーやスマートフォンから監視・操作する機能で、GitHub接続を経由しません。

よくある質問

GitHub Appと/web-setupを両方設定するとどうなりますか

どちらの方式で得るアクセスも、接続したGitHubアカウントがGitHub上で見られるリポジトリ全体という同じ範囲に及びます。両方を設定した場合の内部的な優先順位や競合の扱いについては、公式ドキュメントに明記された記載が見当たらないため、本記事では断定を避けます。挙動を正確に把握したい場合は、実際に両方を設定した環境で接続状態を確認することをおすすめします。

Auto-fixを使わないならGitHub Appのインストールは不要ですか

不要です。オンボーディング画面でSkipを選んでも、接続したGitHubアカウントが見られるリポジトリへは通常どおりアクセスできます。GitHub Appのインストールが追加するのはPRのCI失敗やレビューコメントに反応するAuto-fix用のwebhookだけです。

gitの認証情報はクラウドセッションの中に直接置かれますか

Anthropicがホストする環境では置かれません。gitクレデンシャルや署名鍵はサンドボックスの外にあるセキュアプロキシが保持し、スコープ付きのクレデンシャルを使って認証を仲介します。自社インフラで動かすself-hosted environmentでは、認証情報の扱いは組織のデプロイ設定に委ねられます。

自社インフラにセッションをルーティングしている組織では、ここまで説明したGitHub App / /web-setupという2方式に加えて、デプロイ側が用意したクレデンシャルでgit認証が行われる構成もあります。仮想マシンの隔離やネットワーク到達範囲も自社の設定次第になるため、self-hosted環境を使っているチームは、Anthropicホスト環境を前提にした本記事の手順だけで判断せず、社内のデプロイ担当者に認証設定の詳細を確認します。

まとめ

GitHub App(ブラウザーオンボーディング)と/web-setup(gh CLIトークン同期)は、どちらもクラウドセッションに同じ範囲のリポジトリアクセスを与える手段です。個人開発者はすでにログイン済みのgh CLIがあるかどうかで選べばよく、組織管理者はQuick web setupのオン・オフでメンバーの選択肢を決められます。Auto-fixを使うかどうかはGitHub Appインストールの判断材料であって、認証方式そのものの選択とは別の軸です。Zero Data Retentionを運用している組織だけは、どちらの方式も対象外になる点を先に確認しておきます。