本文目录

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 分钟生效，是配置和排错的稳定起点。