Claude Apps Gateway-Konfiguration

​

Dateistruktur

• listen: Bindungsadresse, öffentliche URL, TLS-Beendigung
• oidc: Ihr Identitätsanbieter (IdP), einschließlich Aussteller, Client, Anspruchszuordnung und wer sich anmelden darf
• session: die Bearer-Token, die das Gateway ausstellt, mit Geheimnis und Lebensdauer
• store: PostgreSQL, für Gerätezuschüsse und Rate-Limit-Zähler
• upstreams: wohin Inferenz geht, ob Anthropic, Amazon Bedrock, Claude Platform auf AWS, Agent Platform von Google Cloud oder Microsoft Foundry

• admin: Admin-API-Authentifizierung und Aufbewahrung für Ausgabenlimits
• enforcement: Ausgabenlimit-Verhalten bei Fehler-offen oder Fehler-geschlossen
• pricing: vertraglich vereinbarte Sätze und ein Rabattmultiplikator für das Ausgabenmessgerät und für die Kostenzahlen, die Entwickler sehen
• models und auto_include_builtin_models: von Admin kuratierte Modellliste und Pro-Upstream-IDs
• managed: verwaltete Einstellungsrichtlinien nach IdP-Gruppe
• telemetry: OTLP-Weiterleitung an Ihren Observability-Stack
• access_control, limits, timeouts, rate_limits: IP-Zulassung/Ablehnung, Anfragegrößenbeschränkungen, Upstream-Zeit-bis-erstes-Byte und Pro-IP-Anmeldungslimits
• load_test_mode: Lasttests des Gateways ohne Aufruf eines Modellanbieters

​

Geheimniserweiterung

​

Erforderliche Abschnitte

​

listen

​

oidc

​

IdP-Anfragen durch einen Forward-Proxy

​

Proxy-only Egress

export HTTPS_PROXY=http://proxy.corp.example.com:3128
export NO_PROXY=
export no_proxy=
export CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1

• HTTPS_PROXY oder HTTP_PROXY ist gesetzt.
• NO_PROXY und no_proxy sind leer. Wenn Ihre Plattform eines in Pods injiziert, setzen Sie beide auf einen leeren Wert auf dem Gateway-Container. Das Auflisten eines Telemetrie-Collectors in NO_PROXY hält Proxy-only Egress aus.
• CLAUDE_GATEWAY_ALLOW_LOOPBACK ist nicht aktiviert. Ein Collector oder IdP auf dem eigenen Loopback des Pods kann nicht mit Proxy-only Egress kombiniert werden, da eine an den Proxy übergebene Loopback-Adresse die des Proxy-Hosts selbst wäre, daher geben Sie diesen Services stattdessen eine Adresse, die der Proxy erreichen kann. Aus dem gleichen Grund weigert sich das Gateway, localhost-ähnliche Namen direkt zu akzeptieren, während Proxy-only Egress aktiv ist.

​

session

​

store

​

upstreams

​

Upstream-Fehlermeldungen

• Ein Upstream gab einen Status zurück, bei dem das Gateway nicht fehlschlägt über: diese Upstream-Antwort. Das Gateway versucht keine weiteren Upstreams.
• Jeder Upstream, den das Gateway versuchte, schlug auf eine Weise fehl, bei der es fehlschlägt über: das letzte 429. Wenn keiner ein 429 zurückgab, bevorzugt das Gateway in der Reihenfolge das letzte 401 oder 403, das letzte 404 und das letzte 501. Wenn keiner von diesen zurückgab, das eigene 502 des Gateways, all upstreams failed (N attempted), wobei N jeden Eintrag in upstreams zählt, einschließlich Einträge, die das Gateway übersprungen hat, weil sie das angeforderte Modell nicht bereitstellen.

• 400 oder 413 in Anthropics Standard-Fehler-Envelope: die eigene Nachricht des Upstreams, wie prompt is too long. Claude Platform on AWS, Agent Platform und Microsoft Foundry geben dieses Envelope für Modell-API-Ablehnungen zurück.
• 400 oder 413 in der eigenen Form des Anbieters: ein capability_rejected:-Token. Wenn das Gateway die Ablehnung nicht klassifizieren kann, upstream rejected the request bei einem 400 oder request too large for this upstream bei einem 413.
• Jeder andere Status: generischer Pro-Status-Text, wie upstream rate limit exceeded bei einem 429.

​

Anthropic API

upstreams:
  - provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}
    # OR an OAuth bearer (e.g. a Workload-Identity-Federation-exchanged token):
    #   oauth_token: ${file:/var/run/secrets/anthropic-oauth-token}
    # base_url: https://api.anthropic.com   # default; override for a forward proxy

• api_key: sendet x-api-key. Rotieren Sie ihn in der Claude Console und aktualisieren Sie die Umgebungsvariable.
• oauth_token: sendet Authorization: Bearer. Verwenden Sie die Bearer-Form, wenn Ihre Organisation kurzlebige Tokens statt langlebiger API-Schlüssel ausgibt. Der Bearer wird einmal beim Start gelesen, daher aktualisieren Sie durch Remounten des Geheimnisses und Neustart.

upstreams:
  - provider: anthropic
    auth:
      federation_rule_id: ${ANTHROPIC_FEDERATION_RULE_ID}
      organization_id: ${ANTHROPIC_ORGANIZATION_ID}
      identity_token_file: /var/run/secrets/anthropic/id-token
      # workspace_id: wrkspc_...       # required if the rule covers >1 workspace
      # service_account_id: svac_...   # optional expected-target check

upstreams:
  - provider: anthropic
    base_url: https://upstream-gateway.internal.example.com
    auth:
      api_key: ${PROXY_KEY}
    forward_user_identity: true        # default false

​

Amazon Bedrock

upstreams:
  - provider: bedrock
    region: us-east-1
    auth: {}                           # preferred: AWS default credential chain
    # OR explicit credentials:
    # auth:
    #   aws_access_key_id: ${AWS_AKID}
    #   aws_secret_access_key: ${AWS_SK}
    #   aws_session_token: ${AWS_ST}
    # OR a Bedrock API bearer token:
    # auth:
    #   aws_bearer_token: ${AWS_BEARER_TOKEN}
    # Override the bedrock-runtime endpoint for FIPS or VPC-endpoint deployments:
    # base_url: https://bedrock-runtime-fips.us-east-1.amazonaws.com

​

Claude Platform on AWS

upstreams:
  - provider: anthropicAws
    region: us-east-1
    workspace_id: wrkspc_...
    auth:
      api_key: ${ANTHROPIC_AWS_API_KEY}   # sent as x-api-key
    # OR SigV4 via the AWS default credential chain:
    # auth: {}
    # OR explicit SigV4 credentials:
    # auth:
    #   aws_access_key_id: ${AWS_ACCESS_KEY_ID}
    #   aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}
    # Override the derived endpoint:
    # base_url: https://aws-external-anthropic.us-east-1.api.aws

​

Google Cloud Agent Platform

upstreams:
  - provider: vertex
    region: us-east5
    project_id: example-prod
    auth: {}                           # preferred: Application Default Credentials
    # OR a service account key file:
    # auth: { service_account_json: /secrets/sa.json }
    # Override the aiplatform endpoint for Private Service Connect:
    # base_url: https://us-east5-aiplatform.p.googleapis.com

​

Microsoft Foundry

upstreams:
  - provider: foundry
    resource: example-foundry              # https://example-foundry.services.ai.azure.com
    auth: { use_azure_ad: true }        # preferred: DefaultAzureCredential / Managed Identity
    # OR an API key:
    # auth:
    #   api_key: ${FOUNDRY_API_KEY}

​

Statische Header auf Upstream-Anfragen

upstreams:
  - provider: vertex
    region: us-east5
    project_id: example-prod
    base_url: https://upstream-proxy.internal.example.com
    auth: {}
    headers:
      x-source: claude-apps-gateway
      x-proxy-token: ${PROXY_TOKEN}

• authorization und x-api-key
• host, content-type und user-agent
• Jeder Name, der mit anthropic-, x-goog-, x-amz- oder x-amzn- beginnt

​

Mehrere Upstreams

upstreams:
  # Primary: provisioned throughput in your home region.
  - name: bedrock-pt
    provider: bedrock
    region: us-east-1
    auth: {}
  # Overflow: on-demand cross-region.
  - name: bedrock-od
    provider: bedrock
    region: us-west-2
    auth: {}
  # Different account: a separate Bedrock allotment via assumed-role creds.
  - name: bedrock-acct2
    provider: bedrock
    region: us-east-1
    auth:
      aws_access_key_id: ${ACCT2_AKID}
      aws_secret_access_key: ${ACCT2_SK}
  # Last resort: direct Anthropic API.
  - name: anthropic-fallback
    provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}

# Per-upstream model IDs are keyed on the upstream's `name:`.
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    upstream_model:
      bedrock-pt: arn:aws:bedrock:us-east-1:111111111111:provisioned-model/abcdef
      bedrock-od: us.anthropic.claude-opus-4-8
      bedrock-acct2: us.anthropic.claude-opus-4-8
      anthropic-fallback: claude-opus-4-8

​

Optionale Abschnitte

​

admin

admin:
  # Benannte statische API-Schlüssel für die Admin-Endpunkte, gesendet als x-api-key.
  # Die ID wird im Audit-Log als admin-key:<id> angezeigt, sodass jeder Schlüssel
  # zuordenbar ist. Array für Rotation: neuen Schlüssel hinzufügen, Clients aktualisieren,
  # alten entfernen.
  write_keys:
    - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }
    - { id: ci,        key: "${GATEWAY_ADMIN_WRITE_KEY_CI}" }
  read_keys:
    - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }
  # IdP-Gruppen mit vollständigem Admin-Zugriff über das normale Gateway-JWT (kein API-Schlüssel).
  admin_groups: [platform-finops]
  blocked_message: request an increase at https://go.example.com/claude-limits

​

enforcement

​

pricing

• Claude Code v2.1.227 oder später auf dem Gateway-Server. Frühere Versionen lehnen den unbekannten Schlüssel beim Start ab.
• Ein admin:-Block oder in v2.1.268 oder später ein managed:-Block mit mindestens einer Richtlinie. Das Gateway weigert sich zu starten, wenn pricing gesetzt ist und keiner der Blöcke vorhanden ist, da nichts es lesen würde.

pricing:
  multiplier: 0.85
  overrides:
    - upstream: bedrock-eu
      model: claude-sonnet-4-6
      input: 3.30
      output: 16.50
      cache_read: 0.33
      cache_write: 4.125

• Eine Zeile ersetzt den Listenpreis für Anfragen, die upstream, ein upstreams[].name, für model bedient. Das schließt den höheren Schnellmodus-Satz ein, sodass Schnell- und Standardanfragen mit denselben vier Sätzen gezählt werden.
• Eine integrierte ID wie claude-sonnet-4-6, abgeglichen wie models[].id, deckt jede datierte Form, regionale Amazon-Bedrock-Form oder Google-Cloud-Agent-Plattformform ab, die der Zähler als dieses Modell bewertet. Jede andere Zeichenkette, z. B. ein Alias oder ein Inferenzprofil-ARN, gleicht die ID ab, die der Client gesendet hat, oder die Zeichenkette, die upstream gesendet wurde, Groß-/Kleinschreibung ignoriert.
• Wenn sich Zeilen überlappen, wählt der Zähler die spezifischste Zeile statt der ersten Zeile: eine Zeile, deren model die genaue Modellzeichenkette ist, die upstream gesendet wurde, dann eine Zeile, die die genaue ID abgleicht, die der Client gesendet hat, dann eine Zeile, die das integrierte Modell benennt.
• Ein unbekannter Upstream-Name schlägt beim Start fehl, ebenso wie zwei Zeilen für einen Upstream, die dasselbe Modell benennen, einschließlich zwei Schreibweisen eines integrierten Modells. Das Gateway warnt beim Start vor einer Zeile, die kein anforderbares Modell verwenden kann.
• Web-Such-Anfragen bleiben beim $0,01-Listenpreis; der Multiplikator wird immer noch auf sie angewendet.

​

Preise erhöhen

pricing:
  multiplier: 1.2

​

Sätze an angemeldete Clients senden

• Was das Gateway hinzufügt: Sofern der cli-Block einer Richtlinie nicht bereits modelPricing setzt, fügt das Gateway den multiplier und für jede Modell-ID, die ein Client anfordern kann, die Überschreibungszeile des ersten Upstream hinzu, der diese ID bedient. Ein Satz, den nur ein Failover-Upstream berechnet, bleibt beim Gateway.
• Eine Richtlinie ausschließen: Setzen Sie modelPricing auf {} im cli-Block dieser Richtlinie, und ihre Entwickler bleiben beim Listenpreis.
• Sätze einer Richtlinie behalten: Eine Richtlinie, deren cli-Block modelPricing mit ihrem eigenen multiplier oder overrides setzt, behält dieses modelPricing ganz, und das Gateway fügt keine eigenen Sätze hinzu.

​

models

auto_include_builtin_models: true   # false: expose only the list below
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    # description: optional text shown in clients that surface it
    upstream_model:
      anthropic: claude-opus-4-8
      bedrock: us.anthropic.claude-opus-4-8   # or an inference-profile ARN
      foundry: your-opus-deployment-name

​

managed

managed:
  policies:
    # Specific groups first.
    - match: { groups: [eng-contractors] }
      cli:
        availableModels: [claude-sonnet-4-6]
        permissions: { deny: ["WebFetch", "WebSearch"] }
    # Default catch-all last: matches everyone who authenticated.
    - match: {}
      cli:
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

• Zulassungslisten: availableModels und permissions.allow. Die Liste einer bestimmten Richtlinie ersetzt die Basis vollständig.
• Ablehnungslisten und Hook-Arrays: permissions.deny, permissions.ask, disabledMcpjsonServers, deniedMcpServers, blockedMarketplaces und jedes hooks-Event-Typ-Array. Diese nehmen die Vereinigung von Basis und Richtlinie, sodass ein organisationsweiter Ablehnungs- oder Audit-Hook nicht versehentlich durch eine Pro-Rollen-Überschreibung gelöscht werden kann.
• Datensatz-typisierte Schlüssel: env, modelOverrides und skillOverrides. Diese werden flach zusammengeführt, sodass ein Pro-Rollen-env-Block Schlüssel überschreibt, die er setzt, und den Rest von der Basis erbt.

• Wenn der Wert fehlt oder leer ist, lehnt das Gateway die Anfrage mit der Meldung model is required ab. Diese Prüfung erfordert ein Gateway, das Claude Code v2.1.228 oder später ausführt.
• Wenn der Wert vorhanden ist, aber keine Zeichenkette ist, lehnt das Gateway die Anfrage mit der Meldung model must be a string ab. Erfordert ein Gateway, das Claude Code v2.1.221 oder später ausführt.

​

Matcher-Werte, die das Gateway beim Start stoppen

• Eine leere groups-Liste
• Ein leerer Eintrag in groups oder in admin_groups
• Eine leere email_domain
• Eine email_domain, die @, Leerzeichen oder ein Komma enthält. Das Gateway trimmt den Wert und entfernt ein führendes @, bevor diese Prüfung durchgeführt wird. Schreiben Sie eine bloße Domäne, z. B. example.com.

• Eine leere email_domain: Das Gateway übersprung die Domänenprüfung, sodass eine Richtlinie mit einer leeren email_domain und keiner groups-Liste jeden authentifizierten Benutzer abglich
• Eine leere groups-Liste: Die Richtlinie gleichte niemanden ab
• Eine email_domain, die @, Leerzeichen oder ein Komma enthält: Die Richtlinie gleichte niemanden ab
• Ein leerer Eintrag in groups oder in admin_groups: Der Eintrag gleichte einen Benutzer nur ab, wenn der groups-Anspruch des IdP dieses Benutzers auch einen leeren Eintrag enthielt. In admin_groups gewährte diese Übereinstimmung Admin-Zugriff. Wenn Ihre admin_groups-Liste niemals einen leeren Eintrag enthielt, erhielt niemand auf diese Weise Admin-Zugriff.

​

Was in cli geht

managed:
  policies:
    - match: {}
      cli:
        # Model access (also enforced server-side at /v1/messages)
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]

        # Permission policy
        permissions:
          deny:
            - "WebFetch"
            - "Read(./.env)"
            - "Read(./secrets/**)"
          disableBypassPermissionsMode: disable   # blocks --dangerously-skip-permissions
        allowManagedPermissionRulesOnly: true     # ignore user/project permission rules

        # Environment pushed into the CLI process. DISABLE_UPDATES blocks
        # background and manual updates; DISABLE_AUTOUPDATER stops only
        # background updates.
        env:
          DISABLE_UPDATES: "1"                    # pin versions via your own distribution

        # Org-wide hooks. Hook commands run on developer machines, not the
        # gateway, so the path must exist on every client OS in the policy.
        hooks:
          PostToolUse:
            - matcher: "Edit|Write"
              hooks:
                - { type: command, command: /usr/local/bin/audit-edit.sh }

• hooks
• env-Variablen, die die Genehmigung des Entwicklers erfordern, wie Proxy- und Basis-URL-Variablen
• Shell-Ausführungseinstellungen wie apiKeyHelper und statusLine
• die Sandbox-Binäreinstellungen sandbox.bwrapPath, sandbox.socatPath und sandbox.ripgrep
• Sandbox-Einstellungen, die Datenverkehr abfangen, Anmeldedaten injizieren oder die Isolation schwächen, wie sandbox.network.tlsTerminate und die Proxy-Port-Einstellungen. Sicherheitsgenehmigungsdialoge listet sie alle auf.

​

MCP-Server in einer Richtlinie

​

Claude Desktop-Überlagerung

• Die Modellliste aus availableModels
• Deaktivierte Tools aus Bare-Tool-Namen-permissions.deny-Einträgen. Wenn Sie disabledBuiltinTools im desktop-Block der Richtlinie setzen, bedient das Gateway die Vereinigung Ihres Wertes und der abgeleiteten Liste, sodass Sie auf diese Weise mehr Tools deaktivieren können, aber eines, das Sie durch permissions.deny deaktiviert haben, nicht erneut aktivieren können
• Die Egress-Zulassungsliste aus sandbox.network.allowedDomains. Wenn Sie coworkEgressAllowedHosts im desktop-Block der Richtlinie setzen, verwendet das Gateway diesen Wert statt der abgeleiteten Liste
• Ein OTLP-Endpunkt, der auf das Gateway selbst zeigt, und die Identitätsattribute des angemeldeten Benutzers. Das Gateway leitet die Exporte, die es an diesem Endpunkt erhält, an Ihre forward_to-Ziele weiter. Es enthält den Endpunkt und die Attribute, wenn Sie sowohl telemetry.forward_to als auch listen.public_url setzen. Claude Desktop exportiert jedes Signal mit einer Kodierung: http/protobuf oder http/json, wenn Sie OTEL_EXPORTER_OTLP_PROTOCOL oder eine seiner Pro-Signal-Varianten auf http/json im env der Richtlinie setzen. Vor Claude Code v2.1.261 auf dem Gateway-Server setzte die Antwort http/json unabhängig, sodass ein Collector, der nur Protobuf akzeptiert, Claude Desktops Exporte ablehnte

managed:
  policies:
    - match: { groups: [eng-contractors] }
      cli:
        availableModels: [claude-sonnet-4-6]
      desktop:
        isLocalDevMcpEnabled: false
        disableAutoUpdates: true
        banner: { text: "Contractor build: internal use only" }

• Ein unbekannter Schlüssel
• Ein erkannter Schlüssel, dessen Wert Claude Desktop ablehnen oder stillschweigend löschen würde, wie ein leerer Wert oder ein falsch geschriebener Unterschlüssel in einem verschachtelten Eintrag. Vor v2.1.260 ließ das Gateway ein falsch geschriebenes Feld in einem verschachtelten Objekt eines managedMcpServers- oder orgPluginSettings-Eintrags stillschweigend fallen, anstatt beim Start fehlzuschlagen.
• Ein Schlüssel, den das Gateway selbst berechnet: die Inferenzverbindung, die Modellliste und das OTLP-Relay. Konfigurieren Sie diese durch upstreams, models und den telemetry-Abschnitt forward_to.
• Ein Legacy-Alias eines aktuellen Schlüssels. Im Boot-Fehler benennt das Gateway den kanonischen Schlüssel zum Schreiben.

• disabledBuiltinTools: Das Gateway verwendet die Vereinigung der Liste der Basis und der Richtlinie
• builtinToolPolicy: Wenn Sie ein Tool in der Basis auf einen anderen Wert als allow setzen, behält das Gateway diesen Wert, auch wenn Sie allow für das gleiche Tool in einer Rollen-Richtlinie setzen

​

Vorrang mit anderen verwalteten Quellen

​

telemetry

telemetry:
  forward_to:
    - url: https://otel-collector.internal.example.com
      headers:
        Authorization: ${OTLP_TOKEN}
      # Per-signal opt-in. Default: metrics only.
      metrics: true
      logs: false
      traces: false
    - url: https://api.datadoghq.com/api/v2/otlp
      headers:
        DD-API-KEY: ${DD_API_KEY}

• http://localhost:<port> besteht die Konfigurationsvalidierung, aber der SSRF-Guard blockiert jeden Export mit ECONNREFUSED_SSRF, es sei denn, Sie setzen CLAUDE_GATEWAY_ALLOW_LOOPBACK=1 in der Umgebung des Gateways
• http://127.0.0.1:<port> oder http://[::1]:<port> schlägt beim Start fehl, es sei denn, diese Variable ist gesetzt

• CLAUDE_CODE_ENABLE_TELEMETRY=1
• OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER und OTEL_TRACES_EXPORTER, jeweils auf otlp gesetzt, wenn mindestens ein forward_to-Ziel dieses Signal aktiviert, und auf none andernfalls
• OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>
• OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

• Lokal gesetzte Variablen: Claude Code wendet die gepushten Variablen auf der verwalteten Ebene an, sodass jede den Wert überschreibt, den ein Entwickler lokal dafür setzt.
• Lokal konfigurierte Endpunkte: Mit OTLP/HTTP-Export aktiviert ignoriert die CLI jeden lokal konfigurierten Endpunkt, unabhängig davon, ob das Gateway die Telemetrie-Variablen gepusht hat. Seine Exporte gehen an das Gateway, es sei denn, eine Richtlinie benennt Ihren Collector als Endpunkt.

​

Ihre eigenen Labels hinzufügen

telemetry:
  forward_to:
    - url: https://otel-collector.internal.example.com
  resource_attributes:
    service.namespace: claude
    deployment.environment.name: prod

• Namen verwenden nur Buchstaben, Ziffern, ., _ und -
• Namen sind nicht reserviert. Verglichen in jeder Schreibweise sind die reservierten Namen alles, das mit user., enduser. oder identity. beginnt, plus service.name, service.version, claude.deployment_mode, host.arch, os.type, os.version und wsl.version
• Werte sind nicht leere druckbare ASCII ohne Leerzeichen und keine von , ; = \ " %
• Werte sind höchstens 255 Zeichen, wie das Gateway sie nach prozentualem Kodieren zählt, sodass /, : und @ jeweils als drei zählen
• Werte sind Text, daher zitieren Sie eine Zahl, true oder false

​

Direkt an Ihren Collector exportieren

• Der Endpunkt kommt vom Gateway selbst. Wenn Sie die gleiche Variable in einem MDM-Profil oder einer lokalen managed-settings.json setzen, bleiben Exporte auf dem Relay.
• Die URL verwendet https:// oder http:// zu einer Loopback-Adresse
• Die URL wird zu einem Pfad aufgelöst, der mit /v1/<signal> endet, ohne Abfrage oder Fragment. Claude Code erstellt diesen Pfad selbst aus der generischen Variable. Es verwendet eine Pro-Signal-Variable wie OTEL_EXPORTER_OTLP_METRICS_ENDPOINT wie geschrieben, daher den vollständigen Pfad dort einschließen.
• Die URL ist nicht der eigene Host des Gateways. Ein Endpunkt, der auf das Gateway adressiert ist, behält den Relay-Pfad und sein Sitzungstoken.
• Weder Sie noch der Entwickler haben otelHeadersHelper in einer Einstellungsquelle konfiguriert. Mit einem konfigurierten Helper bleibt jedes Signal auf dem Relay.

• Wenn das Gateway bereits die Telemetrie-Variablen drückt, decken sie Aktivierung, Selektoren und Protokoll ab, und Ihr expliziter Endpunkt überschreibt den gepushten <public_url>-Wert. Setzen Sie einen OTEL_*_EXPORTER-Selektor auf otlp selbst nur für ein Signal, das kein forward_to-Ziel aktiviert.
• Wenn nicht, setzen Sie auch CLAUDE_CODE_ENABLE_TELEMETRY=1, die OTEL_*_EXPORTER-Selektoren und OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf.

​

Wenn ein Ziel fehlschlägt

​

HTTP-Optimierung

• Beim Start: eine Warnung im Betriebsprotokoll empfiehlt, nur die privaten Bereiche 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 100.64.0.0/10, 127.0.0.0/8, ::1/128 und fc00::/7 zuzulassen, plus alle anderen internen Bereiche, von denen sich Ihre Entwickler verbinden. Wenn Sie das Gateway an eine Loopback-Adresse binden und weder trusted_proxies noch public_url setzen, wie in der lokalen Entwicklung, erscheint die Warnung nicht.
• Zur Laufzeit: Das erste Mal, wenn eine Anfrage von einer Adresse außerhalb dieser privaten Bereiche ankommt, protokolliert das Gateway eine Warnung und gibt ein access.public_client-Audit-Ereignis aus, das die Client-IP trägt. Beide werden einmal pro Prozess ausgelöst. Link-lokale Adressen, 169.254.0.0/16 und fe80::/10, zählen nicht als öffentlich. Das Gateway antwortet auf /healthz und /readyz, bevor diese Prüfung ausgeführt wird, sodass Health-Probes aus öffentlichen Bereichen sie nicht auslösen.

​

load_test_mode

load_test_mode:
  enabled: true
  reply_tokens: 750     # roughly how many tokens of text each canned reply carries
  reply_seconds: 9.5    # how long a streamed reply takes

​

Vollständiges Beispiel

# Laufen mit:
#   claude gateway --config gateway.yaml
#
# Operatives Log-Verbosity wird durch die Umgebungsvariable CLAUDE_GATEWAY_LOG_LEVEL
# gesteuert (debug | info | warn | error; Standard info). debug
# protokolliert auch die Anspruchsnamen in jedem id_token zur Diagnose von groups_claim.
# Es beeinflusst nicht Audit-Ereignisse, die immer ausgegeben werden.

listen:
  host: 0.0.0.0
  port: 8080
  public_url: https://claude-gateway.internal.example.com
  # Lassen Sie den tls-Block weg, wenn Sie hinter einem TLS-beendenden Ingress laufen.
  # tls:
  #   cert: /certs/gateway.crt
  #   key: /certs/gateway.key
  # trusted_proxies:
  #   - 10.0.0.0/8

oidc:
  issuer: https://example.okta.com
  client_id: 0oa1example2
  client_secret: ${OIDC_CLIENT_SECRET}
  allowed_email_domains:
    - example.com
  # Erforderlich, wenn der Aussteller der Okta-Org-Server ist, dessen id_tokens
  # E-Mail und Gruppen auslassen können; das Gateway füllt sie von /userinfo.
  userinfo_fallback: true
  # allowed_groups: [claude-code-users]
  # Okta gibt Gruppen nur aus, wenn der `groups`-Bereich angefordert wird und die
  # App-Gruppenanspruchsfilter sie erlauben. Die Contractor-Richtlinie unten
  # passt auf Gruppen, also wird der Bereich hier angefordert.
  scopes: [openid, profile, email, offline_access, groups]
  # extra_auth_params: { access_type: offline, prompt: consent }  # Google
  # groups_claim: groups          # Entra-App-Rollen: verwenden Sie `roles`
  # email_claim: email

session:
  jwt_secret: ${GATEWAY_JWT_SECRET}   # openssl rand -base64 32
  # ttl_hours: 1

store:
  postgres_url: ${GATEWAY_POSTGRES_URL}
  # max_connections: 5
  # connect_timeout_seconds: 5

# Aktiviert /v1/organizations/spend_limits (spiegelt die Anthropic Admin API)
# und Pro-Entwickler-Ausgabendurchsetzung auf /v1/messages. Lassen Sie weg, um zu deaktivieren.
# Caps selbst werden über die Admin API gesetzt, nicht hier.
# admin:
#   write_keys:
#     - { id: terraform, key: "${GATEWAY_ADMIN_WRITE_KEY_TF}" }
#   read_keys:
#     - { id: reporting, key: "${GATEWAY_ADMIN_READ_KEY}" }
#   admin_groups: [platform-finops]
#   blocked_message: request an increase at https://go.example.com/claude-limits
#   # audit_retention_days: 365
#   # spend_retention_months: 13
#   # identity_retention_days: 90
#   # group_limit_mode: min

# enforcement:
#   fail_closed_on_error: false

# Laden Sie diese Bereitstellung zu Testzwecken, ohne einen Modell-Provider aufzurufen. Niemals auf einem
# Gateway, das Entwickler verwenden: jede Anfrage erhält eine vorgefertigte Antwort.
# load_test_mode:
#   enabled: true
#   # reply_tokens: 750
#   # reply_seconds: 9.5

# Meter zu vertraglich vereinbarten Sätzen statt USD-Listenpreis. Erfordert admin: oder eine
# managed:-Richtlinie. Mit managed: gehen die gleichen Sätze auch an angemeldete Clients.
# Die folgenden Sätze sind Platzhalter, keine echten Vertragspreise.
# pricing:
#   multiplier: 0.85
#   overrides:
#     - { upstream: anthropic, model: claude-sonnet-4-6, input: 3.30, output: 16.50, cache_read: 0.33, cache_write: 4.125 }

upstreams:
  - provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}

  # - provider: bedrock
  #   region: us-east-1
  #   auth: {}

  # - provider: anthropicAws
  #   region: us-east-1
  #   workspace_id: wrkspc_...
  #   auth:
  #     api_key: ${ANTHROPIC_AWS_API_KEY}

  # - provider: vertex
  #   region: us-east5
  #   project_id: example-prod
  #   auth: {}

  # - provider: foundry
  #   resource: example-foundry
  #   auth: { use_azure_ad: true }

auto_include_builtin_models: true
models:
  - id: claude-opus-4-8
    label: Claude Opus 4.8
    upstream_model:
      anthropic: claude-opus-4-8
      # bedrock: us.anthropic.claude-opus-4-8
      # anthropicAws: claude-opus-4-8
      # vertex: claude-opus-4-8
      # foundry: <your-opus-deployment-name>
  - id: claude-sonnet-4-6
    label: Claude Sonnet 4.6
    upstream_model:
      anthropic: claude-sonnet-4-6
  - id: claude-haiku-4-5
    label: Claude Haiku 4.5
    upstream_model:
      anthropic: claude-haiku-4-5

managed:
  policies:
    - match: { groups: [contractors] }
      cli:
        availableModels: [claude-haiku-4-5]
        # Beschränken Sie die Standard-Picker-Option auf availableModels statt
        # der Tier-Standard, sodass Contractors keinen 400 auf dem Standard erhalten.
        enforceAvailableModels: true
        # allow genehmigt diese Tools automatisch; es blockiert nicht den Rest.
        # Fügen Sie deny-Regeln hinzu, um Tools zu beschränken.
        permissions: { allow: [Read, Grep] }
    - match: {}
      cli:
        availableModels: [claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5]
        permissions:
          allow: [Read, Grep, Bash, Edit]
          deny: ["WebFetch"]
        env: { HTTP_PROXY: http://proxy.example.com:8080 }

telemetry:
  forward_to:
    - url: https://otel.internal.example.com:4318
      headers:
        Authorization: Bearer ${OTEL_TOKEN}

​

Client-seitige verwaltete Einstellungen

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

​

Verwandt

• Claude Apps Gateway-Übersicht: Schnellstart und Entwickler-Verbindung
• Bereitstellungsleitfaden: IdP-Setup, Container-Image, Kubernetes und Cloud Run sowie Operationen
• Ausgabenlimits: Pro-Entwickler-Caps und die Admin API