Amazon Bedrock、Claude Platform on AWS、Google Cloud 和 Microsoft Foundry 的 Claude 应用网关

通过自托管网关在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 或 Microsoft Foundry 上运行 Claude Code，支持 SSO 登录、按组模型访问和 OTLP 遥测。

Claude 应用网关是一个自托管服务，位于开发人员的 Claude Code 客户端和模型提供商之间。开发人员使用您的企业身份提供商 (IdP) 登录，而不是持有 API 密钥或云凭证。网关持有上游凭证，按 IdP 组强制执行模型访问和托管设置，并将使用情况遥测转发到您自己的可观测性堆栈。

它包含在 claude 二进制文件中，因此在笔记本电脑上运行 Claude Code 的同一可执行文件可以使用 claude gateway --config gateway.yaml 运行网关服务器。

本页涵盖：

• 为什么使用 Claude 应用网关，它相比自己运行的优势，以及何时其他解决方案更合适
• 一个快速入门，包含前置条件，可将网关从零配置到已登录的开发人员
• 连接开发人员，包括通过托管设置设置网关 URL
• 可用性和限制，涵盖哪些 Claude Code 功能可通过网关工作以及服务器支持什么

配套页面深入讲解。配置参考涵盖快速入门编写的 YAML 文件中的每个选项，部署指南涵盖每个 IdP 的设置、Kubernetes 和 Cloud Run 部署以及操作。

为什么使用 Claude apps gateway

网关概述涵盖网关的功能以及为什么要运行它。Claude apps gateway 是 Anthropic 自己的网关，内置于 claude 二进制文件中，并与每个 Claude Code 版本一起测试，因此它转发 Claude Code 发送的标头和请求字段，无需操作员维护单独的允许列表。部署后，它为您提供：

• 凭证：上游 API 密钥或云凭证仅存在于您的基础设施中。开发人员使用公司 SSO 进行身份验证并接收短期的持有者令牌，因此离职发生在您的 IdP 中。取消配置用户，其网关访问权限在会话生命周期内过期，默认为一小时。
• 访问控制：您的 IdP 组映射到模型允许列表和托管设置策略。网关在服务器端强制执行模型访问，拒绝非授予模型的请求，并选择每个组的托管设置策略，CLI 在托管设置层应用该策略。不同的团队获得不同的模型、工具和权限，开发人员无法覆盖其策略锁定的内容。
• 设置交付：网关本身将托管设置交付给已登录的客户端，取代来自 claude.ai 管理员控制台的服务器管理设置。
• 遥测：每个配置的目标接收OpenTelemetry Protocol (OTLP) 指标，默认包含令牌计数、模型、用户身份和延迟，日志和跟踪作为按目标的选择加入。
• 上游路由：客户端向网关发送 Anthropic Messages API，网关为每个上游进行转换，无论是 Amazon Bedrock、AWS 上的 Claude Platform、Google Cloud 的 Agent Platform、Microsoft Foundry 还是 Anthropic API，并在它们之间进行故障转移。您可以更改区域、提供商或故障转移顺序，而开发人员无需注意或重新配置。

有关哪些 Claude Code 功能通过网关工作以及服务器本身支持什么，请参阅下面的可用性和限制。有关成本、绕过、运行多个网关和无服务器平台等决策，请参阅部署指南。

其他网关实现

如果您已经运行满足您需求的 LLM 网关或 API 网关，请继续使用它；其他 LLM 网关涵盖针对它配置 Claude Code。

网关兼容性指南记录了 Claude Code 期望从任何网关获得的内容：它调用的端点、要转发的标头和正文字段，以及删除它们时停止工作的内容。运行中的 Claude apps gateway 在 GET /protocol 处提供其自己的协议参考，该参考描述了它向 Claude Code 客户端公开的端点：SSO 登录、推理、托管设置交付、模型发现和遥测。使用 curl https://claude-gateway.internal.example.com/protocol 从任何已部署的网关（例如下面快速入门生成的网关）获取它。协议的重大更改会提前宣布，但不保证无限期的向后兼容性。

快速入门

本快速入门演示最小路径：在您的 IdP 中注册 OAuth 客户端，编写 gateway.yaml，使用 Docker Compose 运行网关和 Postgres，并端到端验证登录。它使用 Amazon Bedrock 上游；Claude Platform on AWS、Google Cloud 的 Agent Platform、Microsoft Foundry 和 Anthropic API 同样受支持，只需交换配置参考中所示的 upstreams 块。最后，您有一个开发人员可以 /login 的网关。

前置条件

在开始之前，请准备好以下内容：

步骤

listen:
host: 0.0.0.0
port: 8080
# 除非主机是环回地址，否则必需。用于 IdP
# redirect_uri 和发现文档。
public_url: https://claude-gateway.internal.example.com

oidc:
issuer: https://login.example.com        # 必须提供 /.well-known/openid-configuration
client_id: 0oa1example2
client_secret: ${OIDC_CLIENT_SECRET}
allowed_email_domains: [example.com]        # 拒绝组织外的 id_tokens
userinfo_fallback: true                  # 对于 id_token 省略 email/groups 的 IdP；否则无害

session:
jwt_secret: ${GATEWAY_JWT_SECRET}        # openssl rand -base64 32
ttl_hours: 1                             # 也限制 IdP 取消配置时的撤销延迟

store:
postgres_url: ${GATEWAY_POSTGRES_URL}    # 为托管 Postgres 添加 ?sslmode=require

upstreams:
- provider: bedrock
region: us-east-1
auth: {} # 空：AWS 默认凭证链
# (IRSA, EC2/ECS task role, env vars, ~/.aws)

# 模型会自动按上游转换。内置目录
# 将 claude-opus-4-8 映射到 us.anthropic.claude-opus-4-8 等，
# 对于每个 Bedrock 支持的 Claude 模型。设置为 false 并添加 `models:` 列表以
# 仅公开特定模型。
auto_include_builtin_models: true

services:
gateway:
image: registry.example.com/claude-gateway:2.1.198
ports: ["8080:8080"]
volumes: ["./gateway.yaml:/etc/claude/gateway.yaml:ro"]
environment:
OIDC_CLIENT_SECRET: ${OIDC_CLIENT_SECRET}
GATEWAY_JWT_SECRET: ${GATEWAY_JWT_SECRET}
GATEWAY_POSTGRES_URL: postgres://gw:pw@postgres/gateway
# AWS 凭证：在生产中，省略这些并使用实例
# 角色。对于本地 Compose 测试，传递您自己的：
AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID}
AWS_SECRET_ACCESS_KEY: ${AWS_SECRET_ACCESS_KEY}
AWS_SESSION_TOKEN: ${AWS_SESSION_TOKEN}
depends_on:
postgres:
condition: service_healthy
postgres:
image: postgres:16-alpine
environment: { POSTGRES_USER: gw, POSTGRES_PASSWORD: pw, POSTGRES_DB: gateway }
healthcheck:
test: ["CMD-SHELL", "pg_isready -U gw"]
interval: 5s
volumes: ["pgdata:/var/lib/postgresql/data"]
volumes: { pgdata: }

{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}
[gateway] 2026-06-10T17:03:21.395Z info waiting for migration lock (another replica may be migrating; check pg_locks for key 6775156 if this persists)
[gateway] 2026-06-10T17:03:21.408Z info migration 1 applied
…
[gateway] 2026-06-10T17:03:21.431Z info migration 6 applied
[gateway] 2026-06-10T17:03:21.512Z info claude gateway listening on http://0.0.0.0:8080

curl -s https://claude-gateway.internal.example.com/.well-known/oauth-authorization-server | jq

{
"issuer": "https://claude-gateway.internal.example.com",
"device_authorization_endpoint": "…/oauth/device_authorization",
"token_endpoint": "…/oauth/token",
"grant_types_supported": ["urn:ietf:params:oauth:grant-type:device_code", "refresh_token"]
}

curl -s -X POST https://claude-gateway.internal.example.com/oauth/device_authorization | jq

{
"device_code": "…",
"user_code": "WDJB-MJHT",
"verification_uri": "https://claude-gateway.internal.example.com/device",
"verification_uri_complete": "https://claude-gateway.internal.example.com/device?user_code=WDJB-MJHT",
"expires_in": 600,
"interval": 5
}

连接开发人员

开发人员从自己的笔记本电脑使用一次浏览器登录进行连接，使用他们的公司工作账户。他们不需要 claude.ai 账户、API 密钥或订阅，因为对模型的请求通过网关使用组织的上游凭证。连接由您通过 MDM 推送的客户端托管设置驱动，因此开发人员端没有手动设置；本部分涵盖管理员配置的内容。

CLI 在首次连接时对网关的 TLS 叶证书进行指纹识别，并按主机名固定它。它在登录期间、静默会话刷新期间和托管设置获取期间再次检查该固定，而推理请求使用标准 TLS 验证而不使用固定。通过 HTTPS 代理路由的请求跳过固定检查，因此将网关主机添加到 NO_PROXY 以保持它们直接连接。

发布预期的 SHA-256 指纹以及网关 URL，以便开发人员有东西可以比较。/login 提示显示指纹的前 16 个字符作为小写十六进制，无冒号。要从证书文件以该形式打印完整指纹，请运行：

openssl x509 -noout -fingerprint -sha256 -in cert.pem | cut -d= -f2 | tr -d : | tr 'A-F' 'a-f'

当证书轮换时，每个开发人员都会再次看到信任提示，因此将轮换视为计划事件并重新发布指纹。如果您的网关策略包含需要批准的设置，开发人员在接受新证书后也会再次看到该批准对话框，因为 Claude Code 将批准记忆关键到固定的证书。

网关可以在其令牌响应中返回可选的 email 字段，以命名登录使用的账户。当它这样做时，开发人员在 Claude Code 保存凭证之前确认账户。确认登录后，/status 显示账户。

确认需要开发人员机器上的 Claude Code v2.1.275 或更高版本；低于该版本的客户端忽略该字段。claude 二进制文件中的网关服务器不返回该字段，因此其登录完成时没有确认。

开发人员登录后，模型选择器显示其 availableModels 允许列表中的模型。托管设置在启动时应用并每小时刷新一次，遥测路由到您的收集器。

会话在 ttl_hours 过期前静默刷新。当 IdP 取消配置后刷新失败时，Claude Code 会提示开发人员重新登录。

设置网关 URL

三个密钥进入您通过 MDM 或直接在磁盘上部署的每个操作系统托管设置文件。forceLoginMethod 和 forceLoginGatewayUrl 在Cloud gateway 屏幕上直接打开 /login，URL 已填入，parentSettingsBehavior: "merge" 让 Claude Desktop 将网关的出口允许列表传递给它启动的 Claude Code 会话，在将策略传递给 Claude Desktop 会话中解释：

{
  "forceLoginMethod": "gateway",
  "forceLoginGatewayUrl": "https://claude-gateway.internal.example.com",
  "parentSettingsBehavior": "merge"
}

开发人员按 Enter 连接。首次连接 TLS 指纹提示仍然出现。文件在机器上后，未完成网关登录的开发人员会看到管理员策略需要 Cloud 网关登录下描述的消息之一。通过环境变量（如 CLAUDE_CODE_USE_BEDROCK）选择云提供商的开发人员不需要网关登录。

开发人员无法手动设置此项。登录选择器中没有网关选项，forceLoginGatewayUrl 在开发人员自己的设置文件中被忽略。单独的 forceLoginMethod，没有 URL，将开发人员留在"联系您的 IT 管理员"消息处。登录密钥属于您推送到机器的文件中，而不是网关的 managed.policies[].cli 块中，该块仅到达已连接的客户端。

在您拥有的公共地址空间上允许网关

某些组织从他们拥有的公共 IPv4 块对其内部网络进行编号，例如运营商自己的地址空间或遗留的 /8，因此他们的网关不能有私有地址。在 gatewayInternalNetworks 托管设置中列出这些块。当开发人员的机器从同一块内的地址连接到它时，/login 然后接受列出块内的网关。这需要开发人员机器上的 Claude Code v2.1.268 或更高版本；早期版本忽略该密钥并应用私有地址规则。

将密钥添加到与登录密钥相同的托管设置源：托管设置文件、MDM 配置文件或注册表策略。Claude Code 在用户、项目和服务器托管设置中忽略它。

此示例声明一个块。将 203.0.113.0/24 替换为您自己的块。它是文档范围，Claude Code 拒绝这些。

{
  "gatewayInternalNetworks": ["203.0.113.0/24"]
}

Claude Code 在 /login 处验证列表，然后再联系任何网关：

• 每个条目是一个 IPv4 块，写成其第一个地址和从 /8 到 /32 的前缀。
• 列表最多包含四个块，没有两个重叠。
• 没有块与私有地址空间重叠：10.0.0.0/8、172.16.0.0/12、192.168.0.0/16、127.0.0.0/8、169.254.0.0/16 和 100.64.0.0/10。/login 已经在没有此密钥的情况下接受那里的网关。
• 没有块与从不是组织网络的空间重叠：198.18.0.0/15 和 192.0.0.0/24，VPN 和 NAT64 客户端将其作为本地地址；文档范围 192.0.2.0/24、198.51.100.0/24 和 203.0.113.0/24；以及保留范围 0.0.0.0/8、192.88.99.0/24 和多播 224.0.0.0/4。您可以声明 240.0.0.0/4 内的块，某些大型网络将其用作内部单播空间。

来自 managed-settings.json 及其 managed-settings.d/ 插入文件的块合并为一个列表，这些限制适用于合并列表。要缩小块，请替换其条目而不是在插入中添加第二个重叠的；/login 拒绝重叠。

如果条目违反规则，或值不是字符串列表，Claude Code 拒绝该机器上的每个新网关登录并在消息中命名问题。登录到私有地址上的网关也失败，现有登录继续工作。在部署前在一台机器上尝试该值。Claude Code 还在它报告的无效托管设置中列出错误类型的值。

使用有效列表，/login 对地址在列出块内的网关应用三个检查：

• 网关主机名解析到的每个地址都在该块内。Claude Code 拒绝也在块外有记录的名称，包括私有和 IPv6 地址。
• 开发人员的机器从同一块内连接。Claude Code 拒绝 NAT 后面、容器或 WSL2 内或 VPN 上的机器，其地址池位于块外，并命名机器连接的地址。
• 连接是直接的。如果 HTTPS_PROXY 适用于网关主机，/login 拒绝并命名要添加的 NO_PROXY 条目。

当所有三个通过时，信任提示添加一行命名机器的地址、网关的地址和包含两者的声明块。

该密钥对其他网关不改变任何内容：登录到私有地址上的网关像以前一样工作，登录到每个列出块外的公共地址上的网关像以前一样被拒绝。

声明的块缩小了谁可以登录但不证明机器在哪里，因此仅声明您的组织控制的地址空间。与其他租户共享的块，例如云提供商的公共范围，让其中的任何人通过相同的检查。

将策略传递给 Claude Desktop 会话

Claude Desktop 在嵌入式 Claude Code 会话上运行其 Cowork 和 Code 选项卡，以及启用时的 Chat 选项卡，并通过网关发送其模型请求。它将策略传递给每个会话，从网关在 /user/bootstrap 处提供的配置构建：模型允许列表、禁用的工具和从匹配策略的 cli 块派生的出口允许列表，加上desktop 覆盖。

其他 cli 密钥，例如 hooks、env 和作用域权限规则（如 Bash(npm *)），仅到达通过 /login 登录的客户端。Claude Desktop 从其自己的托管配置读取网关 URL，并使用其自己的流程登录，与设置网关 URL中的 forceLoginMethod 和 forceLoginGatewayUrl 密钥分开。

由启动过程传递的设置是父设置。Claude Code 在任何具有管理员部署的托管源的机器上忽略父设置，除非传递策略的源设置 parentSettingsBehavior: "merge"。

哪些机器需要选择加入

仅运行 Claude Desktop 的机器需要它。Claude Desktop 将模型列表和禁用工具列表应用于嵌入式会话本身，但出口允许列表仅作为父设置到达它们，形式为 WebFetch 域规则和沙箱网络规则。没有选择加入，这些会话运行时没有出口限制，没有任何警告。网关仍然拒绝策略未授予的模型的推理请求。

开发人员通过 /login 登录的机器不需要它；每个 Claude Code 会话从网关获取其策略。

其policyHelper提供托管设置的舰队无法使用它：Claude Code 从不在这些舰队上合并父设置，因为它仅从助手的输出读取托管设置。

设置选择加入

从设置网关 URL部署托管设置片段，将其镜像到任何优先于文件的客户端源，然后验证。

限制父设置

一旦您部署 parentSettingsBehavior: "merge"，任何启动 Claude Code 的主机进程都可以提供父设置，不仅是 Claude Desktop，还有 Agent SDK 应用程序或 IDE 扩展。

Claude Code 根据限制性密钥的允许列表过滤父设置，但某些允许的密钥可以授予访问权限而不是限制它。除非您设置 allowManaged*Only 锁，主机提供的权限允许规则和沙箱允许列表仍然适用。您的策略的拒绝和询问规则无论如何都保持有效；它们在任何允许规则之前被评估。

Claude Code 以剥离形式转发父提供的 sandbox.credentials 条目：

• deny 条目：仅使用其 path 或 name 和模式转发。
• 具有 mode: mask 的文件条目：转发为仅哨兵，作为整个文件掩码，其 injectHosts 是空列表，因此代理从不在任何平台上用真实值替换父提供的条目。所有结构化掩码字段也被删除，因此父提供的提取模式无法替代另一个源为同一路径设置的更严格掩码。
• 具有 mode: mask 的 envVars 条目：不转发。deny 是父通道可以通过 envVars 条目表达的唯一限制。
• awsPairs 和 sigv4：仅转发限制。从 sigv4，仅保留 deny 值，定义 sigv4 块的父将所有三种请求形式 streaming、presigned 和 sigv4a 固定到 deny。awsPairs 对从不以可以重新签名的形式转发；命名常规 AWS 变量之一的对被替换为保持 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_SESSION_TOKEN 自动配对被抑制的惯性条目。

部署锁

要将父设置保持尽可能接近仅限制，将所有五个 allowManaged*Only 锁和它们管理的允许列表添加到与合并选择加入相同的源：

{
  "forceLoginMethod": "gateway",
  "forceLoginGatewayUrl": "https://claude-gateway.internal.example.com",
  "parentSettingsBehavior": "merge",
  "allowManagedPermissionRulesOnly": true,
  "allowManagedMcpServersOnly": true,
  "allowManagedHooksOnly": true,
  "allowedMcpServers": [{ "serverUrl": "https://mcp.internal.example.com/*" }],
  "sandbox": {
    "network": {
      "allowManagedDomainsOnly": true,
      "allowedDomains": ["github.com", "*.npmjs.org"]
    },
    "filesystem": {
      "allowManagedReadPathsOnly": true,
      "denyRead": ["~/"],
      "allowRead": ["~/projects"]
    }
  }
}

操作系统策略（例如 HKLM 注册表策略或托管首选项 plist）优先于此文件，因此通过它而不是文件传递整个片段。网关的远程托管设置优先于操作系统策略和文件源，但仅到达已连接的客户端。将锁、允许列表和合并选择加入镜像到策略的 cli 块中，并保持此文件部署，因为从不连接的机器（包括仅运行 Claude Desktop 的机器）仅从文件获取其策略。

跨源的锁行为

设置一个锁不会限制其他锁；每个密钥都在设置参考中记录。

从赢家下方的管理员源，两个沙箱锁仍然适用，allowManagedPermissionRulesOnly 仍然阻止父提供的允许规则和 additionalDirectories。在 Claude Code v2.1.273 或更高版本上，MCP 服务器锁也从赢家下方的源应用，当它打开时，托管 allowedMcpServers 列表来自设置一个的最高优先级管理员源。

hooks 锁和 allowManagedPermissionRulesOnly 对开发人员自己规则的影响默认需要赢家源；在Claude Code 如何组合托管源中的 managedSourcesBehavior 合并选择加入下，Claude Code 应用任何源为每个锁设置的最严格值。在 policyHelper 舰队上，锁仅从助手的输出读取。

每个锁使 Claude Code 忽略开发人员对该设置的自己条目，因此在锁旁边包含您组织的允许列表：

• 网络域：使用空托管域列表锁定会阻止所有沙箱出站流量。
• MCP 服务器：使用任何管理员源或父提供的设置中都没有 allowedMcpServers 的锁会加载 deniedMcpServers 不阻止的每个服务器。
• 读取路径：allowRead 条目仅重新允许 denyRead 区域内的路径，因此将它们与托管 denyRead 配对。

锁不涵盖的设置

即使设置了所有五个锁，四个父提供的设置也会通过过滤器。在默认的先赢设置下，阻止父设置的管理员值是最高优先级管理员源中的值，除了 allowedMcpServers 当MCP 服务器锁打开时。在 managedSourcesBehavior 合并选择加入下，Claude Code 如何组合托管源说明哪个源的值改为适用。

• forceLoginOrgUUID：当最高优先级管理员源未设置组织 UUID 时，Claude Code 尊重父提供的值。网关登录不检查此密钥，因此它仅对也使用第一方 Anthropic 登录的舰队重要。最高优先级管理员源中的组织 UUID 阻止父的值，是 Claude Code 强制执行的值，因此在那里设置 forceLoginOrgUUID。
• allowedMcpServers：当最高优先级管理员源未设置允许列表时，Claude Code 尊重父提供的允许列表，allowManagedMcpServersOnly 不阻止它，因为锁强制执行任何赢家列表作为托管值，包括当最高优先级管理员源未设置时的父提供列表。最高优先级管理员源中的列表阻止父的并是 Claude Code 强制执行的列表，因此在那里设置 allowedMcpServers，在锁旁边。在 v2.1.223 之前，任何管理员源中任一密钥的值都阻止父的。
• availableModels：当赢家托管源未设置模型列表时，Claude Code 尊重父提供的模型列表。如果您的舰队限制模型，在赢家源中设置 availableModels。
• strictPluginOnlyCustomization：此密钥无论任何锁都通过过滤器，它使 Claude Code 忽略开发人员的自己定制，包括保护性 hooks。没有锁阻止它。

连接 Claude Desktop

Claude Desktop通过不同的 MDM 密钥连接到同一网关：在 Claude Desktop 的托管配置中设置 bootstrapUrl 为 <listen.public_url>/user/bootstrap，并使用 desktop 密钥选择加入用户的策略。Claude Desktop 覆盖涵盖两个部分。需要网关服务器上的 Claude Code v2.1.203 或更高版本。

Claude Desktop 通过网关的身份提供商使用相同的浏览器 SSO 步骤对开发人员进行签名，然后从网关而不是从 Anthropic 获取其配置。模型访问和策略遵循与 CLI 相同的每组规则。同时使用 CLI 和 Claude Desktop 的开发人员分别登录到每个；网关会话不在它们之间共享。

连接后，Claude Desktop 从每个启用的选项卡通过网关发送模型请求。它默认显示 Cowork 和 Code 选项卡。要同时打开 Chat 选项卡，在 Claude Desktop 的托管配置中设置 chatTabEnabled 为 true，或在运行 Claude Code v2.1.227 或更高版本的网关上的策略的 desktop 块中。

CI 管道和远程机器

没有用于无人值守管道的服务令牌流。网关登录始终运行浏览器设备流，因此没有开发人员批准登录的 CI 作业无法进行身份验证；针对您的提供商直接配置这些。

开发人员登录后，该机器上的每个 Claude Code 会话都使用网关会话，包括非交互式 claude -p 运行和由 Agent SDK 启动的会话。Claude Code 将网关策略应用于每个会话。

设备流将轮询 CLI 与批准浏览器分开，因此没有显示的远程开发框仍然有效：开发人员通过 SSH 在远程机器上运行 /login，并在笔记本电脑上的浏览器中打开验证链接。

对开发人员强制执行的内容

这些保证适用于每个通过 /login 登录的会话。Claude Desktop 启动的嵌入式会话按将策略传递给 Claude Desktop 会话中所述获取其策略，遥测项目说明其导出的去向。

• 模型访问：对策略未授予的模型的请求返回 400，/model 选择器被过滤到策略的 availableModels 允许列表。在策略中设置 enforceAvailableModels: true，以便 Default 选项解析为 availableModels 内的模型，而不是 Claude Code 的内置默认值；没有它，Default 保持可选，如果该模型未被授予，则在请求时被拒绝。
• 遥测目标：在通过 /login 登录的会话中，CLI 将其 OTLP/HTTP 导出发送到网关，而不是任何本地设置的 OTEL_EXPORTER_OTLP_ENDPOINT，除非策略将您的收集器命名为端点。网关将它接收的导出中继到 telemetry.forward_to 中的目标。
  • 在Claude Desktop 启动的嵌入式会话中，CLI 将其导出发送到配置的 OTEL_EXPORTER_OTLP_ENDPOINT。CLI 仅当该端点指向网关本身时才将网关会话令牌附加到这些导出。
  • 没有为信号配置目标时，网关接受并丢弃它。
  • 如果您已直接收集 Claude Code 遥测，将您的收集器添加为 forward_to 目标，或在策略中命名它以跳过中继。
• 凭证：网关令牌是会话的唯一凭证。Anthropic 配置文件和任何早期的 claude.ai 登录在登录时被忽略，因此开发人员不需要首先从 claude.ai 注销。对于配置的 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或 apiKeyHelper 凭证，请参阅管理员策略需要 Cloud 网关登录。
• 托管设置：锁定的密钥无法在本地覆盖。CLI 在启动时应用策略，并在每个小时轮询时应用更改，除了仅在下一次启动时应用的更改。
• 启动时网关无法访问：已登录的会话在启动时约 10 秒后以错误退出，而不是在没有其设置的情况下启动。
• 启动后网关结束会话：请参阅强制执行故障关闭启动，了解哪些启动从网关登出打开，哪些在网关以 401 应答时退出。
• 取消配置：用户在 IdP 中被禁用的会话在下一次刷新失败时在 ttl_hours 内过期。
• 登出：/logout 从开发人员的机器删除网关凭证。
  • 当网关的发现文档在网关 URL 自己的方案、主机和端口上宣传 revocation_endpoint 时，/logout 也将存储的令牌发送到该端点，以便网关可以在其端结束会话。请求是尽力而为的，因此登出在开发人员的机器上完成，无论端点是否应答。撤销需要开发人员机器上的 Claude Code v2.1.275 或更高版本。
  • claude 二进制文件中的网关服务器不宣传任何，因此从它登出仅在开发人员的机器上结束会话。要强制会话从服务器端退出，请参阅 JWT 密钥轮换。

组织可以看到什么

使用情况遥测携带开发人员的身份、令牌计数、模型和延迟到组织的收集器。网关不记录或存储提示或完成内容。是否收集更丰富的遥测（如日志和跟踪），可能包括命令和文件路径，是组织的按目标选择。

可用性和限制

该表涵盖当开发人员通过网关连接时哪些 Claude Code 功能有效，以及网关服务器本身支持什么。如果不支持某些内容，Notes 列给出替代方案。

网关交付 CLI 发送给每个上游的 anthropic-beta 值，因此操作员不维护 beta 允许列表。对于忽略标头的 Amazon Bedrock，网关将值移到请求正文的 anthropic_beta 字段中；其他上游按发送的方式接收标头。

后续步骤

快速入门让您在 Docker Compose 下运行最小配置。要进一步进行：

• 扩展 gateway.yaml 超越最小配置，例如添加按组 RBAC、多上游故障转移或遥测目标。配置参考涵盖每个选项。
• 从 Compose 迁移到 Kubernetes 或 Cloud Run 上的生产部署，正确设置您的 IdP，并审查安全模型。部署和操作指南涵盖每个 IdP 的设置、容器镜像要求、健康探针和故障排除。
• 对个别开发人员或组设置支出上限，以便失控的工作负载无法消耗您的整个承诺。支出限制涵盖管理 API 以及强制执行如何工作。
• 有关 AWS 上的完整工作示例，包括 ECS Fargate 或 EKS、Amazon RDS 和 Secrets Manager，请参阅在 AWS 上部署。
• 有关 Google Cloud 的完整工作示例，包括 Cloud Run、Cloud SQL 和 Secret Manager，请参阅在 Google Cloud 上部署。