Configurazione del gateway delle app Claude

​

Struttura dei file

• listen: indirizzo di binding, URL pubblico, terminazione TLS
• oidc: il vostro provider di identità (IdP), inclusi emittente, client, mappatura delle attestazioni e chi può accedere
• session: i bearer token che il gateway emette, con segreto e durata
• store: PostgreSQL, per le concessioni dei dispositivi e i contatori dei limiti di velocità
• upstreams: dove va l’inferenza, sia che si tratti di Anthropic, Amazon Bedrock, Claude Platform su AWS, Agent Platform di Google Cloud, o Microsoft Foundry

• admin: autenticazione dell’API Admin e conservazione dei limiti di spesa
• enforcement: comportamento fail-open o fail-closed dei limiti di spesa
• pricing: tariffe contrattuali e un moltiplicatore per il misuratore di spesa e per le cifre di costo che gli sviluppatori vedono
• models e auto_include_builtin_models: elenco di modelli curato dall’amministratore e ID per upstream
• managed: politiche di impostazioni gestite per gruppo IdP
• telemetry: inoltro OTLP al vostro stack di osservabilità
• access_control, limits, timeouts, rate_limits: IP allow/deny, limiti di dimensione delle richieste, tempo di primo byte upstream e limiti di accesso per IP
• load_test_mode: test di carico del gateway senza chiamare un provider di modelli

​

Espansione dei segreti

​

Sezioni obbligatorie

​

listen

​

oidc

​

Richieste IdP attraverso un proxy forward

​

Egress solo proxy

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 o HTTP_PROXY è impostato.
• NO_PROXY e no_proxy sono vuoti. Se la vostra piattaforma inietta uno di questi nei pod, impostate entrambi a un valore vuoto sul contenitore del gateway. Elencando un collettore di telemetria in NO_PROXY mantiene l’egress solo proxy disattivato.
• CLAUDE_GATEWAY_ALLOW_LOOPBACK non è attivato. Un collettore o IdP sul loopback proprio del pod non può essere combinato con l’egress solo proxy, perché un indirizzo loopback consegnato al proxy sarebbe il proprio dell’host proxy, quindi date a quei servizi un indirizzo che il proxy può raggiungere invece. Per lo stesso motivo il gateway rifiuta i nomi di stile localhost completamente mentre l’egress solo proxy è attivo.

​

session

​

store

​

upstreams

​

Messaggi di errore dell’upstream

• Un upstream ha restituito uno stato su cui il gateway non esegue il failover: quella risposta dell’upstream. Il gateway non prova ulteriori upstream.
• Ogni upstream che il gateway ha provato ha fallito in un modo su cui esegue il failover: l’ultimo 429. Quando nessuno ha restituito un 429, il gateway preferisce, in ordine, l’ultimo 401 o 403, l’ultimo 404 e l’ultimo 501. Quando nessuno ha restituito nessuno di quelli, il proprio 502 del gateway, all upstreams failed (N attempted), dove N conta ogni voce in upstreams, incluse le voci che il gateway ha saltato perché non servono il modello richiesto.

• 400 o 413 nell’envelope di errore standard di Anthropic: il messaggio dell’upstream stesso, come prompt is too long. Claude Platform on AWS, Agent Platform e Microsoft Foundry restituiscono questo envelope per i rifiuti dell’API del modello.
• 400 o 413 nella forma propria del provider: un token capability_rejected:. Quando il gateway non può classificare il rifiuto, upstream rejected the request su un 400 o request too large for this upstream su un 413.
• Qualsiasi altro stato: copia generica per stato, come upstream rate limit exceeded su un 429.

​

API Anthropic

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: invia x-api-key. Ruotatela nella Console Claude e aggiornate la variabile env.
• oauth_token: invia Authorization: Bearer. Usate la forma bearer quando la vostra organizzazione emette token a breve durata invece di chiavi API a lunga durata. Il bearer è letto una volta all’avvio, quindi aggiornate rimontando il segreto e riavviando.

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}

​

Intestazioni statiche sulle richieste upstream

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 e x-api-key
• host, content-type e user-agent
• Qualsiasi nome che inizia con anthropic-, x-goog-, x-amz- o x-amzn-

​

Più upstream

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

​

Sezioni facoltative

​

admin

admin:
  # Named static API keys for the admin endpoints, sent as x-api-key.
  # The id appears in the audit log as admin-key:<id> so each key is
  # attributable. Array for rotation: add the new key, roll clients,
  # remove the old.
  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 groups granted full admin via the normal gateway JWT (no API key).
  admin_groups: [platform-finops]
  blocked_message: request an increase at https://go.example.com/claude-limits

​

enforcement

​

pricing

• Claude Code v2.1.227 o successivo sul server del gateway. Le versioni precedenti rifiutano la chiave sconosciuta all’avvio.
• Un blocco admin: o, in v2.1.268 o successivo, un blocco managed: con almeno una policy. Il gateway rifiuta di avviarsi con pricing impostato e nessuno dei due blocchi, perché nulla lo leggerebbe.

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

• Una riga sostituisce il prezzo di listino per le richieste che upstream, un upstreams[].name, serve per model. Questo include il tasso fast mode più alto, quindi le richieste fast e standard vengono misurate agli stessi quattro tassi.
• Un ID incorporato come claude-sonnet-4-6, abbinato come models[].id, copre ogni forma datata, forma regionale di Amazon Bedrock, o forma di Google Cloud’s Agent Platform che il misuratore prezza come quel modello. Qualsiasi altra stringa, come un alias o un ARN del profilo di inferenza, abbina l’ID che il client ha inviato o la stringa inviata upstream, senza distinzione tra maiuscole e minuscole.
• Dove le righe si sovrappongono, il misuratore sceglie la riga più specifica piuttosto che la prima riga: una riga il cui model è la stringa di modello esatta inviata upstream, quindi una riga che corrisponde all’ID esatto che il client ha inviato, quindi una riga che nomina il modello incorporato.
• Un nome upstream sconosciuto fallisce all’avvio, così come due righe per uno upstream che nominano lo stesso modello, incluse due ortografie di un modello incorporato. Il gateway avverte all’avvio di una riga che nessun modello richiedibile può utilizzare.
• Le richieste di ricerca web rimangono al prezzo di listino $0.01; il moltiplicatore si applica comunque a loro.

​

Aumenta i prezzi

pricing:
  multiplier: 1.2

​

Inviare le tariffe ai client firmati

• Cosa aggiunge il gateway: a meno che il blocco cli di una policy non imposti già modelPricing, il gateway aggiunge il multiplier e, per ogni ID modello che un client può richiedere, la riga di override del primo upstream che serve quell’ID. Un tasso che solo un upstream di failover addebita rimane sul gateway.
• Escludi una policy: imposta modelPricing a {} nel blocco cli di quella policy, e i suoi sviluppatori rimangono al prezzo di listino.
• Mantieni le tariffe proprie di una policy: una policy il cui blocco cli imposta modelPricing con il suo multiplier o overrides mantiene quel modelPricing intero, e il gateway non aggiunge tariffe proprie a esso.

​

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]

• Allow-lists: availableModels e permissions.allow. L’elenco di una policy specifica sostituisce completamente quello della base.
• Deny-lists e hook arrays: permissions.deny, permissions.ask, disabledMcpjsonServers, deniedMcpServers, blockedMarketplaces e ogni array di tipo evento hooks. Questi prendono l’unione di base e policy, quindi un deny a livello di organizzazione o un hook di audit non può essere accidentalmente eliminato da un override per ruolo.
• Record-typed keys: env, modelOverrides e skillOverrides. Questi si uniscono superficialmente, quindi un blocco env per ruolo sostituisce le chiavi che imposta e eredita il resto dalla base.

• Quando il valore è mancante o vuoto, il gateway rifiuta la richiesta con il messaggio model is required. Questo controllo richiede un gateway che esegue Claude Code v2.1.228 o successivo.
• Quando il valore è presente ma non è una stringa, il gateway rifiuta la richiesta con il messaggio model must be a string. Richiede un gateway che esegue Claude Code v2.1.221 o successivo.

​

Matcher values that stop the gateway at boot

• Un elenco groups vuoto
• Una voce vuota in groups o in admin_groups
• Un email_domain vuoto
• Un email_domain che contiene @, spazi bianchi o una virgola. Il gateway taglia il valore e rimuove un @ iniziale prima di questo controllo. Scrivi un dominio nudo, come example.com.

• Un email_domain vuoto: il gateway ha saltato il controllo del dominio, quindi una policy con un email_domain vuoto e nessun elenco groups corrisponde a ogni utente autenticato
• Un elenco groups vuoto: la policy non corrisponde a nessuno
• Un email_domain contenente @, spazi bianchi o una virgola: la policy non corrisponde a nessuno
• Una voce vuota in groups o in admin_groups: la voce corrisponde a un utente solo quando il claim groups dell’IdP di quell’utente conteneva anche una voce vuota. In admin_groups, quella corrispondenza ha concesso l’accesso admin. Se il tuo elenco admin_groups non ha mai contenuto una voce vuota, nessuno ha ottenuto l’accesso admin in questo modo.

​

What goes in cli

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
• Variabili env che richiedono l’approvazione dello sviluppatore, come variabili proxy e base-URL
• impostazioni di esecuzione della shell come apiKeyHelper e statusLine
• le impostazioni binarie della sandbox sandbox.bwrapPath, sandbox.socatPath e sandbox.ripgrep
• Impostazioni della sandbox che intercettano il traffico, iniettano credenziali o indeboliscono l’isolamento, come sandbox.network.tlsTerminate e le impostazioni della porta proxy. Security approval dialogs le elenca tutte.

​

MCP servers in a policy

​

Claude Desktop overlay

• L’elenco dei modelli, da availableModels
• Strumenti disabilitati, da voci permissions.deny con nome di strumento nudo. Se imposti disabledBuiltinTools nel blocco desktop della policy, il gateway serve l’unione del tuo valore e dell’elenco derivato, quindi puoi disabilitare più strumenti in questo modo ma non puoi riabilitarne uno che hai disabilitato tramite permissions.deny
• L’allowlist di uscita, da sandbox.network.allowedDomains. Se imposti coworkEgressAllowedHosts nel blocco desktop della policy, il gateway usa quel valore invece dell’elenco derivato
• Un endpoint OTLP che punta al gateway stesso, e gli attributi di identità dell’utente firmato. Il gateway inoltra le esportazioni che riceve a quell’endpoint alle tue destinazioni forward_to. Include l’endpoint e gli attributi quando imposti sia telemetry.forward_to che listen.public_url. Claude Desktop esporta ogni segnale con una codifica: http/protobuf, o http/json quando imposti OTEL_EXPORTER_OTLP_PROTOCOL o uno dei suoi varianti per segnale a http/json nel env della policy. Prima di Claude Code v2.1.261 sul server del gateway, la risposta impostava http/json indipendentemente, quindi un collettore che accetta solo protobuf rifiutava le esportazioni di Claude Desktop

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

• Una chiave sconosciuta
• Una chiave riconosciuta il cui valore Claude Desktop rifiuterebbe o lascerebbe cadere silenziosamente, come un valore vuoto o un nome di sub-chiave errato all’interno di una voce annidata. Prima di v2.1.260, il gateway lasciava cadere silenziosamente un campo errato all’interno di un oggetto annidato di una voce managedMcpServers o orgPluginSettings invece di fallire all’avvio.
• Una chiave che il gateway calcola da solo: la connessione di inferenza, l’elenco dei modelli e l’inoltro OTLP. Configura quelli attraverso upstreams, models e la sezione telemetry forward_to.
• Un alias legacy di una chiave attuale. Nell’errore di avvio, il gateway nomina la chiave canonica da scrivere.

• disabledBuiltinTools: il gateway usa l’unione dell’elenco della base e dell’elenco della policy
• builtinToolPolicy: se imposti uno strumento a un valore diverso da allow nella base, il gateway mantiene quel valore anche se imposti allow per lo stesso strumento in una policy per ruolo

​

Precedence with other managed sources

​

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> passa la convalida della configurazione, ma la SSRF guard blocca ogni esportazione con ECONNREFUSED_SSRF a meno che non imposti CLAUDE_GATEWAY_ALLOW_LOOPBACK=1 nell’ambiente del gateway
• http://127.0.0.1:<port> o http://[::1]:<port> fallisce all’avvio a meno che quella variabile non sia impostata

• CLAUDE_CODE_ENABLE_TELEMETRY=1
• OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER e OTEL_TRACES_EXPORTER, ognuno impostato a otlp se almeno una destinazione forward_to abilita quel segnale e a none altrimenti
• OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>
• OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

• Variabili impostate localmente: Claude Code applica le variabili spinte al livello gestito, quindi ognuna sostituisce il valore che uno sviluppatore imposta per essa localmente.
• Endpoint configurati localmente: con l’esportazione OTLP/HTTP abilitata, la CLI ignora qualsiasi endpoint configurato localmente, indipendentemente dal fatto che il gateway abbia spinto le variabili di telemetria. Le sue esportazioni vanno al gateway a meno che una policy non nomini il tuo collettore come endpoint.

​

Add your own labels

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

• I nomi usano solo lettere, cifre, ., _ e -
• I nomi non sono riservati. Confrontati in qualsiasi maiuscola, i nomi riservati sono tutto ciò che inizia con user., enduser. o identity., più service.name, service.version, claude.deployment_mode, host.arch, os.type, os.version e wsl.version
• I valori sono ASCII stampabile non vuoto senza spazio e nessuno di , ; = \ " %
• I valori sono al massimo 255 caratteri come il gateway li conta dopo la codifica percentuale, quindi /, : e @ contano ciascuno come tre
• I valori sono testo, quindi cita un numero, true o false

​

Export directly to your collector

• L’endpoint viene dal gateway stesso. Se imposti la stessa variabile in un profilo MDM o in un managed-settings.json locale, le esportazioni rimangono sull’inoltro.
• L’URL usa https://, o http:// a un indirizzo loopback
• L’URL si risolve in un percorso che termina in /v1/<signal>, senza query o frammento. Claude Code costruisce quel percorso da solo dalla variabile generica. Usa una variabile per segnale come OTEL_EXPORTER_OTLP_METRICS_ENDPOINT come scritto, quindi includi il percorso completo lì.
• L’URL non è l’host del gateway stesso. Un endpoint indirizzato al gateway mantiene il percorso di inoltro e il suo token di sessione.
• Né tu né lo sviluppatore avete configurato otelHeadersHelper in nessuna fonte di impostazioni. Con un helper configurato, ogni segnale rimane sull’inoltro.

• Se il gateway già spinge le variabili di telemetria, coprono l’abilitazione, i selettori e il protocollo, e il tuo endpoint esplicito sostituisce il valore <public_url> spinto. Imposta un selettore OTEL_*_EXPORTER a otlp tu stesso solo per un segnale che nessuna destinazione forward_to abilita.
• Se non lo fa, imposta anche CLAUDE_CODE_ENABLE_TELEMETRY=1, i selettori OTEL_*_EXPORTER e OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf.

​

When a destination fails

​

HTTP tuning

• All’avvio: un avviso nel log operativo consiglia di consentire solo gli intervalli privati 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 e fc00::/7, più qualsiasi altro intervallo interno da cui i tuoi sviluppatori si connettono. Se leghi il gateway a un indirizzo loopback e non imposti né trusted_proxies né public_url, come nello sviluppo locale, l’avviso non appare.
• A runtime: la prima volta che una richiesta arriva da un indirizzo al di fuori di quegli intervalli privati, il gateway registra un avviso e emette un evento di audit access.public_client che porta l’IP client. Entrambi si attivano una volta per processo. Gli indirizzi link-local, 169.254.0.0/16 e fe80::/10, non contano come pubblici. Il gateway risponde a /healthz e /readyz prima che questo controllo venga eseguito, quindi i probe di salute da intervalli pubblici non lo attivano.

​

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

​

Esempio completo

# Run with:
#   claude gateway --config gateway.yaml
#
# Operational log verbosity is controlled by the CLAUDE_GATEWAY_LOG_LEVEL
# environment variable (debug | info | warn | error; default info). debug
# also logs the claim names in each id_token, for groups_claim diagnosis.
# It does not affect audit events, which are always emitted.

listen:
  host: 0.0.0.0
  port: 8080
  public_url: https://claude-gateway.internal.example.com
  # Omit the tls block when running behind a TLS-terminating ingress.
  # 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
  # Required when the issuer is the Okta org server, whose id_tokens
  # can omit email and groups; the gateway fills them from /userinfo.
  userinfo_fallback: true
  # allowed_groups: [claude-code-users]
  # Okta emits groups only when the `groups` scope is requested and the
  # app's groups claim filter allows them. The contractors policy below
  # matches on groups, so the scope is requested here.
  scopes: [openid, profile, email, offline_access, groups]
  # extra_auth_params: { access_type: offline, prompt: consent }  # Google
  # groups_claim: groups          # Entra app roles: use `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

# Enables /v1/organizations/spend_limits (mirrors the Anthropic Admin API)
# and per-developer spend enforcement on /v1/messages. Omit to disable.
# Caps themselves are set via the admin API, not here.
# 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

# Load test this deployment without calling a model provider. Never on a
# gateway that developers use: every request gets a canned reply.
# load_test_mode:
#   enabled: true
#   # reply_tokens: 750
#   # reply_seconds: 9.5

# Meter at contracted rates instead of USD list price. Requires admin: or a
# managed: policy. With managed:, the same rates also go to signed-in clients.
# Rates below are placeholders, not real contract prices.
# 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]
        # Constrain the Default picker option to availableModels instead of
        # the tier default, so contractors don't get a 400 on the default.
        enforceAvailableModels: true
        # allow auto-approves these tools; it does not block the rest.
        # Add deny rules to restrict tools.
        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}

​

Impostazioni gestite lato client

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

​

Correlati

• Panoramica del gateway delle app Claude: guida rapida e connessione dello sviluppatore
• Guida alla distribuzione: configurazione IdP, immagine del contenitore, Kubernetes e Cloud Run e operazioni
• Limiti di spesa: cap per sviluppatore e API Admin