本文目錄

Claude 組織可以用 IP 白名單（IP allowlisting） 把受覆蓋請求限制在批准的公網地址或 CIDR 上。Help Center 寫明：Enterprise 套餐與 Claude Platform 組織可開公測。Platform 釋出說明裡，2026 年 11 月 5 日一條介紹了 Console IP 白名單（beta）：可加 IPv4／IPv6 或 CIDR，每組織最多 1,000 條，用來收緊洩露 API key 還能從哪些網路呼叫。

這是配置與排錯說明，不是“今晚剛上線”的快訊寫法。官方把能力拆成 兩套控制面：入口路徑、角色名、覆蓋產品都不一樣。當成同一個開關去配，很容易進錯產品。

步驟與錯誤原文以 Anthropic 文件為準。

先拆開兩套控制面

A：Claude Platform（Console）B：Claude Enterprise（claude.ai）
設定入口Claude Console → Identity and accessclaude.ai → Organization settings → Organization and access
誰能配AdminsOwners／primary owners
介面加項Add entryAdd IP range
防鎖死勾選Allow admins to access this settings page from any IPAllow owners to access this settings page from any IP
官方主要威脅敘事限制洩露 API key 還能從哪呼叫限制被盜 登入 後還能進哪些組織應用
名單外會擋什麼受覆蓋的 Console UI、所列 API／Managed Agents、本組織 Admin／Compliance API受覆蓋的網頁／桌面／移動、Claude Code（用 Claude 賬號登入時）、Chrome／Office／Cowork／Remote Tools，以及本組織 Admin／Compliance API

Help Center 是短頁，詳細配置指向 Platform 文件。排步驟時以文件全文為準，不要只拿 Help 當唯一手冊。

控制面 A：Claude Platform／Console

威脅模型（文件）： key 洩露後，攻擊者更難從名單外呼叫。白名單限制的是 key「從哪來」，不是「還能用多久」。文件仍建議配短過期，或改用 Workload Identity Federation（WIF），不要只靠白名單。

覆蓋範圍（文件）：

  • Claude Console 介面
  • Claude API：Messages、Message Batches、Token Counting、Models、Files、Skills（API key 或 WIF token）
  • Claude Managed Agents：Agents、Sessions、Environments、Vaults、Memory stores（API key 或 WIF token）
  • 本組織 Admin API、Compliance API（僅覆蓋本組織的 key）

不覆蓋（文件 Limitations）：

  • Managed Agents runtime 網路（管到端點 ≠ 管到 agent 執行時出網）
  • Amazon Bedrock 上的 Claude、AWS 上的 Claude Platform、Google Cloud 上的 Claude Models、Microsoft Foundry 上的 Claude

怎麼開

  1. 進入 Claude Console → Identity and access。
  2. 開啟 IP allowlist 開關。不儲存就沒有變化。
  3. 點 Add entry，填公網 IPv4／IPv6 或 CIDR（格式見下）。
  4. 建議保持勾選 Allow admins to access this settings page from any IP address，這是文件推薦的 Console 防鎖死退路。
  5. 儲存。變更最多約 15 分鐘生效；之後觀察受覆蓋應用是否出現 403 permission_error。

名單外表現： 受覆蓋 API 會被拒絕。文件以 Messages API 為例：返回 403 permission_error，message 為 Your IP address isn't in this organization's allowed range.。人不在名單內時，可能看到標題為 Your current network can't access this organization 的頁面。Admin 同樣會被擋；若開啟了“任意 IP 僅回白名單設定頁”選項，則只能進白名單設定。

控制面 B：Claude Enterprise／claude.ai

威脅模型（文件）： 登入被盜後，更難從名單外進受覆蓋的組織應用。名單覆蓋整個 Enterprise 組織（含 owner）。只有 owner／primary owner 能改名單；Enterprise 的 admin 不能改名單。

覆蓋應用（文件）：

  • 瀏覽器、桌面、移動端 Claude
  • Claude Code（使用者用 Claude 賬號登入時）
  • Claude in Chrome、Office 載入項、Cowork、Remote Tools
  • 上述應用裡的 connectors 與 artifacts（使用者分享到組織外的 artifacts 除外）
  • 僅本組織 key 的 Admin API／Compliance API

不覆蓋（文件 Limitations）： Claude Design、Claude in Slack、Claude Academy。使用者被擋時，聊天裡已在跑的任務最長還可約 24 小時，但無法從名單外開啟或控制該聊天。

代理注意： 部分功能走 bridge.claudeusercontent.com（如 Claude in Chrome、Cowork、Remote Tools，以及 Office 載入項跨應用協作）。若該主機出口 IP 與 claude.ai／api.anthropic.com 不同，要把那個出口也寫進名單。

怎麼開

  1. 開啟 claude.ai → Organization settings → Organization and access。
  2. 開啟 IP allowlist 開關。不儲存無變化。
  3. 點 Add IP range，加入公網地址或 CIDR。
  4. 建議勾選 Allow owners to access this settings page from any IP address，降低鎖死風險。
  5. 儲存。最多約 15 分鐘生效；已開啟的連線、Office／Remote Tools 會話可能更慢才反映新名單。

名單外表現： 網頁／桌面看到 Your current network can't access this organization。Claude Code 側是 403 API error，message 同樣是 Your IP address isn't in this organization's allowed range.。

條目格式、上限、只寫公網

文件示例：

  • 單地址：203.0.113.5
  • IPv4 CIDR：203.0.113.0/24
  • IPv6 CIDR：2001:db8::/32

文件規則：

  • 每條是單地址，或不超過 IPv4 /8、IPv6 /32 的 CIDR
  • 每組織最多 1,000 條
  • 只要公網——寫流量離開你網路時的出口；不要寫 10.0.0.0/8 這類私網
  • 可逗號分隔多項後回車；未儲存的修改不會生效
  • Changes can take up to 15 minutes to apply

沒有單獨的 anthropic-beta 請求頭用來“開啟白名單”。白名單是組織設定，不是某些 Claude API beta 那種按請求帶的頭。

別把自己鎖死

儲存時，Anthropic 校驗的是當前操作者的地址，不會替你核驗所有伺服器、同事電腦、CI，或明天換掉的 VPN 出口。

文件裡的防鎖死要點：

  1. 儲存前把要用的出口都寫上：辦公網、VPN、CI、雲 NAT；Enterprise 還要考慮 bridge.claudeusercontent.com 的獨立出口。
  2. 保留 Allow admins／Allow owners 退路勾選。
  3. 最好另有一位 Console admin 或 Enterprise owner，名單寫錯時還能進設定。
  4. 已經鎖死、又沒有退路時，不要從名單外清空列表。

若已鎖死

  1. 先回到名單內網路重連。
  2. 請另一位 admin（Console）或 owner／primary owner（Enterprise）改名單。
  3. 若勾選了退路，該角色可從任意 IP 只進白名單設定，補上缺失網段或關閉白名單。
  4. 否則聯絡 Anthropic support 關閉白名單。
  5. 修復後，訪問恢復也可能要最多 15 分鐘。

403 與“無法訪問組織”排查順序

開完或改完名單後若像被擋，按這個順序查：

  1. 先確認組織型別。 Console 的 Identity and access ≠ claude.ai 的 Organization and access。
  2. 確認已 Save。 只撥開關不夠；未儲存條目不生效。
  3. 最多等約 15 分鐘。 Enterprise 上已開啟的 Office／Remote Tools 等可能更久。
  4. 查看失敗客戶端的公網出口（本機、CI、VPN、反代、NAT）。私網地址不要寫進名單。Enterprise 若 bridge.claudeusercontent.com 出口不同，一併列入。
  5. 對上錯誤原文。 把 403 permission_error 且 message 為 Your IP address isn't in this organization's allowed range.（以及 UI 標題 Your current network can't access this organization）當作白名單拒絕。其它 401／429／賬單類錯誤另案處理。
  6. 若自己被鎖，走上面的防鎖死步驟；沒有退路時，不要從名單外清空名單。

文件給出了 Messages 示例裡的 permission_error 型別與 message 原文，但該頁沒有完整 error JSON 樣例。

白名單做不到什麼

  • 不是 GA。 按 beta／公測理解；beta 期間設定與行為可能改。
  • 不能當成“key 絕不會被濫用賬單”或徹底防洩露保證，也替代不了短過期／WIF。
  • 把共享代理出口寫進名單後，持有洩露 key 或被盜會話的攻擊者也可能經同一代理打到受覆蓋服務。
  • 官方材料沒有單獨公佈白名單價表。
  • 同日（2026-11-05）Admin API「把成員從各處簽退」是另一項 Enterprise 能力，最多一句旁及，不是白名單主線。

實操清單

  1. 選控制面 A（Console）或 B（Enterprise），不要當成同一個開關。
  2. 用對應角色開啟對應設定頁（Admin vs owner／primary owner）。
  3. 只加公網 IP／CIDR，遵守寬度與 1,000 條上限。
  4. 保留 admin／owner 設定頁退路勾選。
  5. 儲存後最多等 15 分鐘，再從每個關鍵出口驗證。
  6. 遇到帶文件原文的 403 permission_error，先修出口是否在名單，再查別的鑑權問題。
  7. Platform 側把白名單與短過期或 WIF 一起用，別只靠名單。

之後若介面文案有變，以當日 Claude Platform IP allowlisting 文件與 Help Center 為準。Console 與 Enterprise 分開、403 permission_error 原文、1,000 條上限、以及最多約 15 分鐘生效，是配置和排錯的穩定起點。