Anthropic 在 2026 年 6 月 29 日发布 Claude Apps Gateway，并提供了完整部署文档。它解决的不是“给 Claude Code 再加一层反向代理”，而是把企业身份、模型权限、客户端设置、用量归属和上游路由放进一个由企业自行运行的控制面。
官方给出的最小形态是一个无状态网关容器加 PostgreSQL。开发者通过企业 OIDC 登录，客户端以 Anthropic Messages API 与网关通信，网关再把请求转发到 Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry 或 Anthropic API。组件不多，但登录回调、数据库、策略和上游任何一段没接好，用户看到的都可能只是“Claude Code 启动失败”。
先画清四段请求链，不要从容器是否存活开始验收
第一段是身份链。企业需要一个符合 OIDC 的身份提供方，例如 Google Workspace、Microsoft Entra ID、Okta、Keycloak 或其他标准 OIDC 服务。网关使用标准发现流程和授权码流程。回调地址包含网关域名，因此域名、HTTPS 和 OIDC 应用配置必须一致。只看到容器健康，并不能说明登录已经可用。
第二段是会话链。登录后，开发者获得短期 bearer token。官方文档称默认会话期限为一小时。客户端不再同时携带个人 API Key、旧的 claude.ai 登录或本地apiKeyHelper凭据；网关令牌是该会话唯一凭据。验收时应确认旧凭据确实不会旁路企业策略。
第三段是策略链。管理员可把身份提供方中的组映射到模型白名单和托管设置。客户端请求未获授权的模型时，网关会返回 400。若配置了遥测目的地，网关下发的 OTLP 设置会覆盖本地OTEL_*变量。这里要测的是“服务端是否拒绝”，不是界面里是否隐藏了某个选项。
第四段是上游链。客户端始终向网关发送 Messages API 请求，网关根据上游做模型映射和协议处理。多上游可以配置故障转移，但不同提供方的区域、模型和功能并不完全相同。连通一个模型，只能证明一条路径成功，不能代表全部模型和备用路径都可用。
最小部署要验证六项，而不是只跑一次登录
官方快速部署以 Docker Compose、PostgreSQL 和一个上游为起点。数据库要求 PostgreSQL 14 或更高版本；网关启动时运行自己的 schema migration，因此数据库账号需要建表权限。未配置支出上限时，数据库主要保存短期认证状态和限流计数；启用支出控制后，还会出现需要备份的持久支出、审计和身份表。
一个可复核的首轮验收可以保留这六项结果：
- OIDC 回调能从浏览器回到正确的网关域名，错误回调会被拒绝。
- 新用户可登录，未授权组不能获得不属于它的模型。
- 允许模型能完成一次 Messages API 请求，禁止模型返回预期的 400。
- 移除本地 API Key 后会话仍能工作，放回本地 Key 也不能绕过策略。
- OTLP/HTTP 收集端能看到带用户身份、模型、token 数和延迟的指标；日志与 trace 是否开启要按目的地单独确认。
- 主上游不可用时，备用上游按照配置接管；模型映射不一致或备用区域无模型时，失败要可见，不能被“已配置 failover”四个字掩盖。
这些结果应连同网关版本、配置版本、OIDC 应用版本和测试用户组一起保存。否则后续策略改动后，很难判断故障来自代码、身份组还是配置漂移。
启动失败和撤权延迟要在上线前演练
Apps Gateway 默认选择不静默降级。官方文档说明，已登录会话在启动时若约 10 秒仍无法连接网关，会带错误退出，而不是绕过网关继续使用本地设置。这是策略保证，也是可用性依赖：网关、数据库、DNS 或证书故障都可能阻断开发者启动 Claude Code。
撤权也不是“在 IdP 删除账号后，所有已签发会话瞬间消失”。官方给出的边界是，停用用户后，访问权限会在会话期限内到期，默认最多约一小时。安全团队如果有分钟级封禁要求，不能把短期会话自动理解为即时吊销；需要针对当前版本设计并实测额外处置路径。
上线前至少做三次演练：网关不可达、PostgreSQL 不可用、IdP 用户被停用。每次记录用户端表现、服务端事件、恢复步骤和最长影响时间。对这个产品而言，容器启动只是部署完成的一小部分。真正的完成标准，是身份、策略、上游和失败行为都能被另一位工程师重复验证。
官方来源：Introducing the Claude apps gateway for Amazon Bedrock and Google Cloud（Anthropic，2026-06-29）；Claude apps gateway 文档（2026-07-24 核查）。
