← Claude Docs

Claude apps gateway deployment and operations - Claude Code Docs

Claude Docs · June 30, 2026
The article covers the operational procedures for deploying and running Claude apps gateway, including registering an OAuth/OIDC client with an identity provider, containerizing the gateway, and managing it during operation. Production deployments follow four sequential steps: identity provider setup, gateway deployment, operations configuration, and security review. The gateway runs as a stateless Linux binary and can be deployed on various platforms including Kubernetes and Cloud Run, with specific configuration requirements depending on the chosen identity provider.

Detailed Analysis

Anthropic's Claude apps gateway represents a purpose-built enterprise access layer that allows organizations to deploy controlled, authenticated endpoints for Claude model inference within their own network infrastructure. The documentation describes a four-stage deployment process encompassing identity provider registration, container-based deployment, operational configuration, and security review. At its core, the gateway functions as a stateless Linux binary that coordinates through a shared Postgres layer, enabling horizontal scaling across replicas while serving as the single egress point through which developer traffic flows to upstream model providers.

The identity provider integration is notably comprehensive, supporting any OIDC-compliant system including Okta, Microsoft Entra ID, Google Workspace, Keycloak, and PingFederate, among others. Each major provider carries specific implementation nuances that the documentation addresses in detail. Okta's organizational authorization server requires a userinfo fallback for email and group claims, while Entra ID emits group Object IDs rather than human-readable names, pushing administrators toward GUID-based policy matching or App Roles. Google Workspace presents the most complex configuration, requiring Admin SDK Directory API integration via a service account with domain-wide delegation to support group-based access policies, since Google's native id_token carries no group membership data. These provider-specific accommodations reflect the heterogeneous enterprise identity landscape that large organizations typically operate within.

The deployment architecture reveals deliberate design choices oriented toward enterprise network security. The gateway is explicitly designed to operate inside organizational network perimeters, functioning as a credential holder and inference egress controller. However, the documentation candidly acknowledges a significant limitation: the gateway cannot by itself enforce that developers route all model traffic through it. Closing direct access to upstream APIs such as api.anthropic.com requires separate network policy enforcement, which the documentation flags as an egress-blocking decision rather than a gateway capability. This architectural candor is notable, as it places responsibility for complete traffic control on the organization's network infrastructure rather than implying the gateway alone provides full enforcement.

The operational and cost model embedded in the documentation signals Anthropic's positioning strategy for enterprise Claude deployments. The gateway binary carries no separate licensing or per-seat fees, meaning organizations pay only for inference consumption through existing cloud or Anthropic commitments plus compute overhead. Support for multi-gateway topologies, where different teams connect to distinct gateway instances with separate trust fingerprints stored per hostname, accommodates large enterprises with segmented organizational units or varying compliance requirements. The explicit exclusion of serverless execution environments like AWS Lambda and Google Cloud Functions — due to the gateway's long-running HTTP server architecture — narrows the deployment surface to more traditional container orchestration platforms, reinforcing the gateway's positioning as persistent infrastructure rather than ephemeral compute.

This technical framework connects to a broader industry pattern in which AI providers are building enterprise-grade access control and governance tooling alongside their core model capabilities. As organizations move from experimental AI use to production deployments, identity-aware proxies, audit logging, managed policies, and network-level controls become prerequisites for compliance and risk management. Anthropic's gateway approach mirrors similar enterprise access layers seen in other developer tool ecosystems, where the central challenge is reconciling developer autonomy with organizational security requirements. The gateway's design — stateless, horizontally scalable, IdP-agnostic, and network-perimeter-native — reflects the architectural patterns that enterprise infrastructure teams expect, suggesting Anthropic is actively engineering for adoption within regulated industries and large institutional environments where ad hoc API key distribution is insufficient.

Read original article →