Claude Code Chrome接続トラブル — 検出されない・切れるときの対処

Claude CodeのChrome連携がうまく動かないとき、原因は大きく3種類に分かれます。拡張機能そのものが検出されない、途中で接続が切れる、そしてWindows環境固有の問題です。Claude Code Chrome接続のトラブルは、/chromeコマンドでの再接続とネイティブメッセージングホストの設定ファイル確認で大半が解決します。この記事は症状別に原因と対処を追えるようにしています。Google Docsへの下書き自動化やGIF録画を試していて動かなくなった場合も、原因の切り分け方は共通です。

症状から原因を逆引きする

まず全体像を掴みたい場合は、この表から該当する症状を探してください。

拡張機能が検出されないとき

chrome://extensionsを開き、拡張機能が実際にインストールされ有効になっているかをまず確認します。次にclaude --versionでClaude Code自体が最新かを確認し、Chromeが起動している状態であることも確かめます。ここまで問題なければ/chromeを実行して「Reconnect extension」を選びます。それでも直らない場合は、Claude CodeとChrome両方の再起動が必要です。

連携を初めて有効にしたとき、Claude Codeはネイティブメッセージングホストの設定ファイルを作成します。Chromeはこのファイルを起動時に読み込む仕組みのため、初回だけは拡張機能が検出されなくても、Chromeを再起動すれば設定を読み直して認識されることがあります。設定ファイルの場所はOSとブラウザの組み合わせで変わります。

Brave・Arc・Vivaldi・Operaなど他のChromium系ブラウザでも同じファイルを、それぞれのブラウザ名を冠したディレクトリから読み込みます。たとえばmacOSのBraveなら~/Library/Application Support/BraveSoftware/Brave-Browser/NativeMessagingHosts/です。

接続を促すタブは、拡張機能を初めてインストールしたときにしか自動で開きません。ビルドや設定ディレクトリの切り替えなどで設定ファイルが後から書き換わった場合でも、Claude Codeはそのタブを再度開かないため、その状況では手動で/chromeから再接続する必要があります。

再接続を試みた後は、/chromeのステータスパネルで「Status: Enabled」「Extension: Installed」の両方が表示されているかを確認してください。この2つが揃っていれば連携は正常に復旧しています。それでも症状が続くなら、原因は検出そのものではなく別の層(ネットワーク経路や組織設定)にあると判断できます。

拡張機能が未検出のとき、Claude Codeは「Claude wants to use your browser」というインストール促しのプロンプトを表示することがあります。選べるのは「Install extension」「Not now」「Don't ask again」の3択で、このプロンプトは1セッションにつき最大1回しか出ません。ここで「Don't ask again」を選んでいると、以降はプロンプト自体が表示されなくなり、逆引き表の「拡張機能が検出されない」の典型原因になります。心当たりがある場合は、chrome://extensionsから手動でインストール状態を確認してください。

ブラウザが反応しなくなったとき

alertやconfirm、promptのようなJavaScriptのモーダルダイアログがページ上に出ていると、ブラウザのイベント自体がブロックされ、Claudeからの操作を受け取れなくなります。まずダイアログを手動で閉じてから、Claudeに続きを指示してください。それでも動かない場合は新しいタブを作らせて再試行するか、chrome://extensionsで拡張機能を一度無効化してから再度有効にします。

長時間セッションで接続が切れるとき

Chrome拡張機能のサービスワーカーは、一定時間操作がないとアイドル状態に入る仕様があります。これが原因で長時間のセッション中にブラウザツールが突然反応しなくなることがあります。しばらく操作していない状態からブラウザツールが動かなくなったら、/chromeを実行して「Reconnect extension」を選ぶだけで復旧します。

Windows特有の問題

Windowsでは3種類の固有の問題が報告されています。1つ目は名前付きパイプの競合(EADDRINUSE)で、別のプロセスが同じパイプを使っている場合に起こります。Claude Codeを再起動し、Chromeを使っている他のClaude Codeセッションを閉じれば解消します。2つ目はネイティブメッセージングホストが起動時にクラッシュするケースで、Claude Codeを再インストールしてホスト設定を作り直すのが対処法です。3つ目は接続用のセットアップページが開かないケースで、これはv2.1.211より前のバージョンで発生していたバグのため、Claude Codeを最新版に更新すれば解決します。

そもそも対応しているブラウザ・環境か確認する

接続トラブルだと思っていたものが、実は仕様上サポート対象外というケースもあります。

Chrome連携が正式に対応するのはGoogle ChromeとMicrosoft Edgeで、加えてBrave・Arc・Vivaldi・Operaといった他のChromiumベースのブラウザも自動で検出・接続を試みます。macOS・Linux・Windowsのデスクトップ環境ではこれらのブラウザで動きますが、WSL(Windows Subsystem for Linux)では、Chrome連携そのものが利用できません。名前付きパイプの問題と混同しないよう注意してください。

またAmazon Bedrock・Google CloudのAgent Platform・Microsoft Foundryといったサードパーティ経由でClaudeを使っている場合も、Chrome連携は使えない仕様です。APIキーやclaude setup-tokenで発行した長期トークンでの認証セッションも同様に、Chrome連携を有効にできません。

組織側でdeniedMcpServersによってclaude-in-chromeのMCPサーバーがブロックされている場合は、接続を促すインストールダイアログ自体が表示されなくなります。管理者に確認するのが早道です。拡張機能の権限モードや対応プランの前提はClaude Chrome拡張機能の使い方で詳しく扱っています。

タブが勝手に閉じるのは接続切れとは限らない

Claudeが開いたタブは、セッションに紐づいたタブグループとしてまとめられ、セッションの終わり方によって扱いが変わります。/clearを実行すると、実行中の永続タスクがない限り、開いていたページごとタブグループが閉じられます。この挙動を接続断だと勘違いして再接続を試みるケースがありますが、これは仕様どおりの動作です。一方/resumeでセッションを切り替えたりClaude Codeを終了したりする場合は、中身が空の新規タブしか無いときだけグループが閉じられるため、作業中のページが急に消えたときは、直前に何のコマンドを打ったかをまず思い出すのが切り分けの近道です。

起動時にフリーズするとき

/chromeで「Enabled by default」を選び、--chromeフラグを付けずに毎回連携を有効にしている場合、Claude Code自体の起動が固まって見えることがあります。原因はChrome連携が有効なのにChromeが起動していない状態で、v2.1.211より前のバージョンではこの組み合わせで起動処理がハングするバグがありました。Chromeを先に起動してからClaude Codeを立ち上げる、またはClaude Codeを最新版に更新することで解消します。毎回この手順を踏むのが面倒なら、既定有効化をやめて必要なときだけ--chromeを付ける運用に戻すのも選択肢です。

拡張機能のバージョンを確認する

Chrome連携にはClaude in Chrome拡張機能のバージョン1.0.36以降が必要です。chrome://extensionsを開き、拡張機能の詳細ページでバージョン番号を確認できます。デベロッパーモードを有効にすると、拡張機能一覧のカードにもバージョンが表示されます。古いバージョンのままだと、Claude Code側は最新でも接続や一部機能が正しく動かないことがあるため、接続トラブルの切り分けでは拡張機能側のバージョンも見落とさないようにします。

組織のIPアローリストが原因のとき

「Browser extension is not connected」というエラーが繰り返し出る場合、組織でIPアローリストを設定している環境では、bridge.claudeusercontent.comへの接続がそのアローリストで拒否されている可能性があります。この場合はChromeとClaude Codeの再起動だけでは直りません。プロキシの経路をclaude.aiやapi.anthropic.comと同じ経路に揃えるか、プロキシが使う送信元アドレスを組織のIPアローリストに追加する必要があります。ネットワーク経路の設定は情報システム部門との連携が必要な作業なので、まず自分の手元だけの問題ではないと切り分けることが重要です。

よくある質問

拡張機能を再インストールすれば大抵の問題は直りますか

検出されない・クラッシュするといった症状には有効な場合が多いですが、IPアローリストによる遮断やWSLのような対応外の環境が原因の場合は再インストールしても解決しません。まず本記事の逆引き表で原因の種類を絞り込んでから試すほうが早道です。

複数のClaude Codeセッションを同時に開いても大丈夫ですか

同じ拡張機能を複数セッションで共有するため、Windowsでは名前付きパイプの競合(EADDRINUSE)が起きることがあります。同時に使う場合は、片方のセッションを閉じてから残りを起動し直すと安定します。

管理者に確認してもらうべき項目は何ですか

deniedMcpServersでclaude-in-chromeがブロックされていないか、組織のIPアローリストにbridge.claudeusercontent.com向けのプロキシ送信元アドレスが登録されているかの2点です。この2つは利用者の手元では確認できません。

まとめ

Chrome連携のトラブルは、拡張機能の検出失敗・セッション中の接続断・Windows固有の問題という3系統にほぼ集約されます。いずれの場合も/chromeでの再接続とChrome・Claude Code両方の再起動が最初に試す対処です。それでも直らないときは、ネイティブメッセージングホストの設定ファイルの有無や、組織のIPアローリスト設定まで疑う必要があります。そもそもWSLやサードパーティプロバイダー経由では対応外という仕様上の制約も、遠回りする前に確認しておく価値があります。