Tabbit部落格

Claude Code 顯示瀏覽器擴充功能未連線怎麼辦

逐一檢查 Claude Code 工作階段、帳號與組織、瀏覽器設定檔及網路,再確認連線。

本文目錄
  1. 排查重點
  2. 判斷失敗階段
  3. 核對帳號與組織
  4. 分開檢查瀏覽器與網路
  5. 找到實際使用的視窗
  6. 向 IT 提供可重現的資訊
  7. 重新連線並做最小唯讀測試
  8. 依測試結果決定下一步
  9. 何時適合改用另一個瀏覽器工具

Claude Code 顯示瀏覽器擴充功能未連線時,請在原本報錯的 CLI 工作階段執行 /chrome。偵測不到擴充功能,就查瀏覽器設定檔。狀態顯示 Not connected,先選 Reconnect extension。若瀏覽器工具仍報錯,再比對 CLI 和擴充功能使用的帳號與組織。

一名 r/ClaudeCode 使用者在 Desktop 可以操作擴充功能,CLI 卻一直連不上。重新登入 CLI、重啟 Chrome 和 CLI 後,該使用者恢復連線。側邊欄和 CLI 分別有自己的工作階段。 Reddit 原文。

如果只要讀取獲准的網頁,文末也會說明何時適合使用另一個瀏覽器工具。

排查重點

  • 在 /chrome 分開查看 Status 和 Extension。

  • 除了登入帳號,也要比對目前選取的組織。

  • 首次啟用後重啟瀏覽器。已建立的連線中斷時,使用 Reconnect extension。

  • 用已知的公開頁面驗證最終網址、標題和可見文字。

  • 只有目標網站失敗時先查網站權限。受管理網路上持續發生連線錯誤,再請 IT 查對外出口。

判斷失敗階段

在目前 CLI 工作階段執行 /chrome。官方說明以 Status: Enabled 和 Extension: Installed 表示可用。未偵測到擴充功能時,檢查瀏覽器和設定檔。狀態為 Not connected 表示目前工作階段的連線已中斷。導覽後出現的網站權限或登入畫面屬於後續階段。記下瀏覽器和版本。

錯誤訊號檢查方向
Extension not detected設定檔和安裝狀態
Not connected目前工作階段連線
Browser extension is not connected帳號、組織或出口
Not logged in先在 Claude Code 登入符合資格的直訂帳號
網頁開啟後要求授權檢查該網站的權限或登入狀態

Claude Code · /chrome

依序顯示 /chrome、/status 和瀏覽器網頁的圖
先確認 CLI 連線,再比對組織,最後確認瀏覽器能讀取指定網址。

核對帳號與組織

這項整合需要符合資格的 Claude 直接訂閱和 Claude Code 互動式 /login。API 金鑰、setup token 或第三方供應商都無法開啟官方擴充功能。比較 /status 和擴充功能顯示的組織。同一帳號可能加入多個組織。Anthropic 說明登出擴充功能會失去其中保存的快捷指令和排程任務。

Claude Help Center

用 /status 查 Claude Code 的組織,並在擴充功能的帳號選單確認選取的工作區。個人與公司工作區可能使用同一個電子郵件地址。如果方案要求組織擁有者開啟 Claude in Chrome,請先確認設定。只有 CLI 出錯時,優先重新驗證 CLI 的身分。 官方連線條件。

網站本身的登入狀態由瀏覽器設定檔保留。可參考如何讓代理程式使用已開啟的分頁,以及如何判斷哪個設定檔已登入儀表板。

分開檢查瀏覽器與網路

開啟相容的瀏覽器,在目標設定檔啟用官方擴充功能。Claude Code 文件列出 Chrome、Edge,也提到數個可偵測擴充功能的 Chromium 瀏覽器。WSL 不支援此整合。帳號、組織相同但仍無瀏覽器連線時,請 IT 檢查核准出口可否連到 bridge.claudeusercontent.com,以及是否符合組織 IP 允許清單。連線後只有一個網站失敗時,改查網站權限。

Claude Code · Network

找到實際使用的視窗

在要用的設定檔開啟擴充功能管理頁。個人設定檔可能有安裝,公司設定檔可能受政策限制。若 /chrome 提供瀏覽器選擇,請選對應的項目並保留該視窗。初次啟用後,完整結束瀏覽器再重開,讓它載入原生訊息設定。 官方安裝說明。

另一位 r/ClaudeAI 使用者確認擴充功能已啟用,也重啟了 Chrome,仍收到未連線錯誤。這種情況應接著檢查帳號、工作階段和網路。 Reddit 原文。

向 IT 提供可重現的資訊

請 IT 核對瀏覽器與 CLI 核准的對外出口,以及組織 IP 允許清單。一般網站能開啟,並不能確認橋接已成功。保留公司代理和瀏覽器政策。回報時附上原始錯誤、時間與時區、瀏覽器、擴充功能和 CLI 版本,以及 /chrome 顯示的狀態。省略憑證和私人瀏覽資料。

重新連線並做最小唯讀測試

在 /chrome 選 Reconnect extension 並重查狀態。Anthropic 說明從 Claude Code 2.1.290 開始,這個操作會重啟工作階段連線。較早版本只會開啟重新連線頁,依賴此步驟請先更新。使用選定的瀏覽器開啟已知公開或本機測試頁,回報完整網址、頁面標題和可見標記。保持唯讀,核對工具回執。

舊的工作階段仍缺少瀏覽器工具時,用 claude --chrome 開新工作階段。參考瀏覽器代理程式的首次任務清單,選擇內容已知的公開頁面。獨立工具則可依 agent-browser 工作階段教學隔開命名工作階段。

請使用瀏覽器工具開啟 https://example.com。
回報最終網址、頁面標題和可見主標題。
只讀取頁面,不要提交或修改資料。

這個頁面的主標題應是 Example Domain。若瀏覽器已到頁面但要求存取,請參考 Claude Code 的網站權限。如果進入登入頁,確認設定檔後,依網站要求自行登入。

依測試結果決定下一步

結果下一步
網址、頁面標題、可見主標題都正確保留目前的工作階段與設定檔,再處理目標網站
公開頁面可讀,只有目標網站失敗查看網站權限、重新導向和登入狀態
比對帳號與設定檔、重連後仍報錯提供版本、原始錯誤和測試結果給 IT 或 Anthropic 支援
工作流程可改用其他工具明確選取工具,重新驗證它的工作階段與權限

何時適合改用另一個瀏覽器工具

工作流程需要 Claude in Chrome 時,請繼續走 Anthropic 的排查流程。若只要開啟獲准的網頁並讀取文字,可參考 Tabbit Browser 與 Claude Code 整合。完成獨立瀏覽器設定後,用同一段唯讀提示測試 Tabbit 工具,確認它使用的工作階段。必要時仍要登入網站。

自行開發整合功能時,可以比較 Claude Agent SDK 的瀏覽器工具和透過 API 或 MCP 存取資料。先確認任務是否需要沿用現有的瀏覽器工作階段。

常見問題

相同的 Claude 帳號就能連線嗎?

還要比對所選組織。即使兩邊的電子郵件地址相同,Claude Code 和擴充功能也必須在同一個組織。

為什麼 /chrome 偵測不到擴充功能?

請在預期使用的瀏覽器設定檔安裝並啟用官方擴充功能,保持該視窗開啟。第一次啟用整合後,重開瀏覽器以載入原生訊息設定。

公司網路可能造成未連線嗎?

可能。請 IT 查核獲准的網路出口能否存取 bridge.claudeusercontent.com,以及對外 IP 是否符合組織允許清單。

Reconnect extension 會做什麼?

從 Claude Code 2.1.290 起,會重啟目前失敗的工作階段連線。舊版本只開啟重連頁面,如果瀏覽器工具還是沒出現,請先更新。

為什麼 Claude 側邊欄正常,CLI 卻失敗?

側邊欄有自己的工作階段。請在報錯的 CLI 裡執行 /chrome,比對帳號、組織和瀏覽器。

如何確認 Claude Code 可以讀取網頁?

請瀏覽器工具回報已知公開頁面的最終網址、標題和可見主標題。三項都符合後,再確認目標網站自己的權限。

下一步

讓 Tabbit 與你並肩工作。

跨分頁調研、自動化重複的瀏覽器工作,讓每一處上下文都觸手可及。