部署 Claude Apps Gateway，先把登录、策略和上游这条链跑通

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 CloudAnthropic2026-06-29Claude apps gateway 文档2026-07-24 核查。