Claude Code webのトラブルシューティング — リポジトリが出ない・セッション作成失敗の対処法

Claude Code webのエラーは認証経路のどこで詰まっているかで見分ける

Claude Code on the webでつまずくエラーの大半は、GitHub連携かクラウドセッションの起動、そのどちらかの認証段階で起きています。エラーメッセージから原因を逆引きできれば、対処は数分で終わります。次の表がまず見るべき早見表です。

以下、それぞれの原因と直し方を詳しく見ていきます。

GitHub連携でリポジトリやログイン画面の問題が起きたとき

リポジトリが一覧に出ない

クラウドセッションは、Claude GitHub Appがインストールされているかどうかに関係なく、接続したGitHubアカウントが閲覧できるリポジトリすべてを対象にします。目的のリポジトリが表示されないなら、まずGitHub側でそのアカウントに閲覧権限があるかを確認します。Auto-fix(PRの自動修正)も使いたい場合は話が別で、そちらはリポジトリ単位でClaude GitHub Appのインストールが必須です。GitHub.comの「Settings → Applications → Claude → Configure」を開き、対象リポジトリが「Repository access」に含まれているか確認します。プライベートリポジトリもパブリックと同じ認可が必要です。

GitHubログイン画面しか出ない

クラウドセッションの利用にはGitHubアカウントの接続が前提です。ブラウザでのオンボーディングから接続するか、gh CLIを使っているならターミナルから/web-setupを実行します。GitHubを接続したくない場合は、自分のマシンでClaude Codeを動かして遠隔操作するRemote Controlが代わりになります。

「Not available for the selected organization」

Enterpriseプランでは、Owner権限を持つ管理者がClaude Code on the webを有効化していないとこの表示になります。組織のアカウントチームか管理者に、Web版の有効化を依頼します。

/web-setupで詰まったときの対処

/web-setupはシェルではなくClaude Code CLIの中で実行するコマンドです。claudeコマンドでCLIを起動してから、プロンプト内で/web-setupと入力します。

/web-setup

「Not signed in to Claude」と表示される

claude.aiアカウントで有効なサインインがない状態です。過去のサインインが期限切れになっているときにも起こります。/loginを実行してclaude.aiアカウントでサインインし直してから、もう一度/web-setupを試します。

「No commands match」や「Unknown command」になる

コマンドメニューに/web-setupが出てこない、または実行するとUnknown commandになる場合、条件を満たしていないためコマンド自体が隠されています。よくある原因はAPI keyやサードパーティのプロバイダーで認証していることです。/loginでclaude.aiアカウントにサインインし直します。Team・EnterpriseプランではQuick web setupトグルが既定でオフになっており、Owner権限の管理者が「Admin settings → Claude Code」で有効化するまでこのコマンドは使えません。トグルがオフの間は、ブラウザからのGitHub接続を使います。Zero Data Retentionを有効にしている組織では、/web-setupを含むクラウドセッション機能そのものが利用できません。

セッション作成・実行時のエラーへの対処

Session creation failed

新規セッションの起動時に「Session creation failed」と表示される、または起動処理のまま止まる場合、セッション用の仮想マシンを確保できなかった状態です。次の順で確認します。

• status.claude.comでクラウドセッションの障害情報を確認する
• 数分待ってから再試行する(容量はオンデマンドで確保されるため)
• 接続したGitHubアカウントが対象リポジトリにアクセスできるか確認する。Claude GitHub Appの認可か、/web-setupで同期したghトークンのどちらかがあれば十分で、リポジトリへのApp自体のインストールは不要

「Could not create a cloud environment」「No cloud environment available」

--cloud実行時にクラウド環境がなければ自動で作成される仕組みですが、その自動作成に失敗すると「Could not create a cloud environment」になります。「No cloud environment available」は、自動作成に対応する前のバージョンのCLIを使っているときに出ます。どちらの場合も、Claude Code CLI内で/web-setupを実行するか、claude.ai/codeの環境セレクターから環境を手動で追加します。

Unable to get organization UUID

claude --cloudとclaude --teleportはclaude.aiアカウントでのサインインが前提です。API keyで認証している場合や、保存済みのアカウント情報が古い場合に「Unable to get organization UUID」、またはAPI key認証では不十分という趣旨のメッセージになります。セッションIDを指定せずにclaude --teleportを実行したときは、同じ原因で代わりに「Error loading Claude Code sessions」と表示されることもあります。

/login

claude.aiアカウントにサインインし直してから再実行します。エラーメッセージにプロバイダー名が含まれる場合は、サードパーティ認証ではクラウドセッションを使えないことが原因です。Claudeのログイン方法で認証方式ごとの違いを確認できます。

Setup scriptが失敗してセッションが始まらない

Setup scriptが0以外の終了コードで終わると、セッションの開始そのものがブロックされます。よくある原因は3つです。

• パッケージのインストールが失敗する。使っているネットワークアクセスレベルがそのレジストリを許可していない(既定のTrustedは主要なパッケージマネージャーをカバーするが、Noneはすべてブロックする)
• スクリプトが参照しているファイルやパスが、新規クローン直後のリポジトリには存在しない
• ローカルでは動くコマンドが、Ubuntu環境では別の呼び出し方を必要とする

原因のコマンドを特定するには、スクリプトの先頭にset -xを入れて実行ログを確認します。重要でないコマンドには|| trueを付けておくと、そこで失敗してもセッション開始をブロックしなくなります。

新規セッションがハングする・タイムアウトする

Setup scriptの段階で止まる、または完了前に汎用のコンテナエラーで失敗する場合、スクリプトが環境キャッシュ構築のおよそ5分という時間予算を超えている可能性が高いです。大きなDockerイメージの取得や依存関係ツリー全体の同期、モデル重みのダウンロードなどを連続して実行すると、この上限を超えやすくなります。独立したインストールは&とwaitで並列化し、大きなダウンロードはSetup scriptからSessionStartフックに逃がしてバックグラウンドで進めるようにすると、5分以内に収まりやすくなります。長いリトライのsleepもスクリプトの時間予算を消費するため取り除きます。

Remote Control・セッション期限のエラー

Remote Control session expired / Access denied

--teleportはクラウドセッションと同じRemote Control基盤経由で接続するため、認証エラーやセッション期限切れがRemote Control由来の文言で表示されることがあります。接続トークンは有効期限が短く、アカウントに紐づいています。ローカルで/loginを実行して認証情報を更新してから再接続し、セッションを所有しているアカウントと同じアカウントでサインインしているかも確認します。「Remote Control may not be available for this organization」と出る場合は、組織のOwnerがクラウドセッションを有効化していません。

Environment expired

クラウドセッションは一定時間操作がないと停止し、VMが回収されます。Web版のセッション一覧では「expired」と表示されます。claude.ai/codeからセッションを開き直せば、会話履歴を引き継いだ新しいVMが用意されます。ただし、VM回収時にまだ動いていたサブエージェントやシェルコマンドのようなバックグラウンド処理は復元されません。

会話中に出るAPI Error・529・429は別の原因

API Error: 500や529 Overloaded、429、Prompt is too longのように会話中に表示されるエラーは、ここまでのセットアップ系エラーとは別枠です。これらはCLIやDesktopアプリとも共通のランタイムエラーで、原因と対処はClaude Codeでよくあるエラーにまとめています。

組織のIP許可リストが原因で全セッションが失敗することもある

個別のエラーメッセージが出ず、クラウドセッションがどれも同じように失敗するときは、組織のIP許可リスト設定を疑います。クラウドセッションはAnthropicが管理するインフラからAnthropic APIを呼び出すため、組織側でIPアローリストを有効にしていると、その呼び出しが認証エラーになります。自己ホスト環境にルーティングしているセッションは自組織のネットワークから呼び出すため、この制限を受けません。該当する場合は、Anthropicサポートにクラウドセッションを許可リストの例外にするよう依頼します。

よくある質問

エラーメッセージだけでは原因を特定できないときはどうすればいいですか

まずstatus.claude.comでクラウドセッションの障害情報が出ていないか確認します。障害が出ていなければ、上の早見表でエラー文字列に近いものを探し、GitHub連携・認証・Setup scriptのどの段階で起きているかを切り分けます。

モバイルアプリでも同じエラーが出ますか

出ます。Web版とモバイルアプリは同じクラウドセッション基盤を共有しているため、GitHub連携やセッション作成のエラーはどちらの画面からでも同じ原因・同じ対処になります。

Teamプランで/web-setupが使えないのは不具合ですか

不具合ではありません。Team・Enterpriseプランでは、Quick web setupトグルが既定でオフになっており、Owner権限の管理者が有効化するまで/web-setup自体が隠されています。個人利用のPro・Maxプランでは既定で使えます。

無料プランでもこれらのエラーは起きますか

無料プランはClaude Code on the webの対象外のため、ここに挙げたエラーの前提となるセッション作成自体が始まりません。利用にはPro・Max・Teamプラン、またはEnterpriseのプレミアムシートかChat + Claude Codeシートが必要です。

Setup scriptを毎回書き直さずに済ませる方法はありますか

Setup scriptの実行結果はスナップショットとしてキャッシュされるため、内容を変えなければ2回目以降のセッションは高速に起動します。頻繁に失敗する重い処理だけをSessionStartフックに切り出しておくと、Setup script自体の失敗リスクを減らせます。

まとめ

Claude Code webのエラーは、GitHub連携・claude.aiアカウントでの認証・Setup scriptの3か所のどこで止まっているかを見れば、ほぼ切り分けられます。リポジトリが出ない・ログイン画面しか出ないはGitHub連携の問題、Unable to get organization UUIDやNot signed in to Claudeは認証方式の問題、Setup scriptが失敗する・新規セッションがハングするはスクリプト側の問題です。個別のエラーで直らないときは、まずstatus.claude.comで障害情報を確認し、次に組織のIP許可リストやZero Data Retention設定のような組織単位の制約を疑うと切り分けが早くなります。Web版そのものの使い方や実行環境の仕様はClaude Code Web版とは、ローカルとクラウドの行き来はClaude Code teleportの使い方で扱っています。