Configuration de la passerelle Claude apps

​

Structure du fichier

• listen : adresse de liaison, URL publique, terminaison TLS
• oidc : votre fournisseur d’identité (IdP), y compris l’émetteur, le client, le mappage des réclamations et qui peut se connecter
• session : les jetons porteurs que la passerelle émet, avec secret et durée de vie
• store : PostgreSQL, pour les subventions d’appareils et les compteurs de limite de débit
• upstreams : où l’inférence va, qu’il s’agisse d’Anthropic, Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud ou Microsoft Foundry

• admin : authentification de l’API Admin et rétention pour les limites de dépenses
• enforcement : comportement de limite de dépenses fail-open ou fail-closed
• pricing : tarifs contractuels et multiplicateur de remise pour le compteur de dépenses et pour les chiffres de coût que les développeurs voient
• models et auto_include_builtin_models : liste de modèles curée par l’administrateur et IDs par upstream
• managed : politiques de paramètres gérés par groupe IdP
• telemetry : transfert OTLP vers votre pile d’observabilité
• access_control, limits, timeouts, rate_limits : autorisation/refus IP, plafonds de taille de requête, time-to-first-byte upstream et limites de connexion par IP
• load_test_mode : tester en charge la passerelle sans appeler un fournisseur de modèle

​

Expansion des secrets

​

Sections requises

​

listen

​

oidc

​

Demandes IdP via un proxy de transfert

​

Egress proxy uniquement

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 ou HTTP_PROXY est défini.
• NO_PROXY et no_proxy sont vides. Si votre plateforme injecte l’un ou l’autre dans les pods, définissez les deux sur une valeur vide sur le conteneur de la passerelle. Lister un collecteur de télémétrie dans NO_PROXY garde l’egress proxy uniquement désactivé.
• CLAUDE_GATEWAY_ALLOW_LOOPBACK n’est pas activé. Un collecteur ou IdP sur la propre boucle locale du pod ne peut pas être combiné avec l’egress proxy uniquement, car une adresse loopback remise au proxy serait la propre boucle locale de l’hôte proxy, donc donnez à ces services une adresse que le proxy peut atteindre à la place. Pour la même raison, la passerelle refuse les noms de style localhost directement pendant que l’egress proxy uniquement est actif.

​

session

​

store

​

upstreams

​

Messages d’erreur d’upstream

• Un upstream a retourné un statut sur lequel la passerelle ne bascule pas : la réponse de cet upstream. La passerelle n’essaie pas d’autres upstreams.
• Chaque upstream que la passerelle a essayé a échoué d’une manière sur laquelle elle bascule : le dernier 429. Lorsqu’aucun n’a retourné un 429, la passerelle préfère, dans l’ordre, le dernier 401 ou 403, le dernier 404 et le dernier 501. Lorsqu’aucun n’a retourné l’un de ceux-ci, le propre 502 de la passerelle, all upstreams failed (N attempted), où N compte chaque entrée dans upstreams, y compris les entrées que la passerelle a ignorées car elles ne servent pas le modèle demandé.

• 400 ou 413 dans l’enveloppe d’erreur standard d’Anthropic : le message propre de l’upstream, tel que prompt is too long. Claude Platform on AWS, Agent Platform et Microsoft Foundry retournent cette enveloppe pour les rejets d’API de modèle.
• 400 ou 413 dans la propre forme du fournisseur : un jeton capability_rejected:. Lorsque la passerelle ne peut pas classer le rejet, upstream rejected the request sur un 400 ou request too large for this upstream sur un 413.
• Tout autre statut : copie générique par statut, tel que upstream rate limit exceeded sur un 429.

​

Anthropic API

upstreams:
  - provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}
    # OU un porteur OAuth (par exemple un jeton échangé par Workload-Identity-Federation) :
    #   oauth_token: ${file:/var/run/secrets/anthropic-oauth-token}
    # base_url: https://api.anthropic.com   # par défaut ; remplacer pour un proxy de transfert

• api_key : envoie x-api-key. Faites-la pivoter dans la Console Claude et mettez à jour la variable env.
• oauth_token : envoie Authorization: Bearer. Utilisez la forme porteur lorsque votre organisation émet des jetons de courte durée au lieu de clés API de longue durée. Le porteur est lu une fois au démarrage, donc actualisez en remontant le secret et en redémarrant.

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_...       # requis si la règle couvre >1 espace de travail
      # service_account_id: svac_...   # vérification de cible attendue optionnelle

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

​

Amazon Bedrock

upstreams:
  - provider: bedrock
    region: us-east-1
    auth: {}                           # préféré : chaîne d'identifiants par défaut AWS
    # OU identifiants explicites :
    # auth:
    #   aws_access_key_id: ${AWS_AKID}
    #   aws_secret_access_key: ${AWS_SK}
    #   aws_session_token: ${AWS_ST}
    # OU un jeton porteur Bedrock API :
    # auth:
    #   aws_bearer_token: ${AWS_BEARER_TOKEN}
    # Remplacer le point de terminaison bedrock-runtime pour les déploiements FIPS ou VPC-endpoint :
    # 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}   # envoyé en tant que x-api-key
    # OU SigV4 via la chaîne d'identifiants par défaut AWS :
    # auth: {}
    # OU identifiants SigV4 explicites :
    # auth:
    #   aws_access_key_id: ${AWS_ACCESS_KEY_ID}
    #   aws_secret_access_key: ${AWS_SECRET_ACCESS_KEY}
    # Remplacer le point de terminaison dérivé :
    # 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: {}                           # préféré : identifiants par défaut d'application
    # OU un fichier de clé de compte de service :
    # auth: { service_account_json: /secrets/sa.json }
    # Remplacer le point de terminaison aiplatform pour 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 }        # préféré : DefaultAzureCredential / Managed Identity
    # OU une clé API :
    # auth:
    #   api_key: ${FOUNDRY_API_KEY}

​

En-têtes statiques sur les demandes d’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 et x-api-key
• host, content-type et user-agent
• Tout nom commençant par anthropic-, x-goog-, x-amz- ou x-amzn-

​

Plusieurs upstreams

upstreams:
  # Principal : débit provisionné dans votre région d'accueil.
  - name: bedrock-pt
    provider: bedrock
    region: us-east-1
    auth: {}
  # Débordement : demande inter-régions.
  - name: bedrock-od
    provider: bedrock
    region: us-west-2
    auth: {}
  # Compte différent : une allocation Bedrock séparée via des identifiants de rôle assumé.
  - name: bedrock-acct2
    provider: bedrock
    region: us-east-1
    auth:
      aws_access_key_id: ${ACCT2_AKID}
      aws_secret_access_key: ${ACCT2_SK}
  # Dernier recours : API Anthropic directe.
  - name: anthropic-fallback
    provider: anthropic
    auth:
      api_key: ${ANTHROPIC_API_KEY}

# Les IDs de modèle par upstream sont indexés sur le `name:` de l'upstream.
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

​

Sections optionnelles

​

admin

admin:
  # Clés API statiques nommées pour les points de terminaison admin, envoyées en tant que x-api-key.
  # L'id apparaît dans le journal d'audit en tant que admin-key:<id> afin que chaque clé soit
  # attribuable. Tableau pour la rotation : ajoutez la nouvelle clé, mettez à jour les clients,
  # supprimez l'ancienne.
  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}" }
  # Groupes IdP disposant d'un accès admin complet via le JWT de passerelle normal (pas de clé API).
  admin_groups: [platform-finops]
  blocked_message: request an increase at https://go.example.com/claude-limits

​

enforcement

​

pricing

• Claude Code v2.1.227 ou ultérieur sur le serveur de passerelle. Les versions antérieures rejettent la clé inconnue au démarrage.
• Un bloc admin: ou, dans v2.1.268 ou ultérieur, un bloc managed: avec au moins une politique. La passerelle refuse de démarrer avec pricing défini et aucun bloc, car rien ne le lirait.

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

• Une ligne remplace le prix catalogue pour les demandes que upstream, un upstreams[].name, traite pour model. Cela inclut le tarif mode rapide plus élevé, afin que les demandes en mode rapide et standard soient mesurées aux mêmes quatre tarifs.
• Un ID intégré tel que claude-sonnet-4-6, correspondant comme models[].id, couvre chaque forme datée, forme régionale Amazon Bedrock, ou forme Google Cloud Agent Platform que le compteur évalue comme ce modèle. Toute autre chaîne, comme un alias ou un ARN de profil d’inférence, correspond à l’ID que le client a envoyé ou à la chaîne envoyée en amont, insensible à la casse.
• Lorsque les lignes se chevauchent, le compteur choisit la ligne la plus spécifique plutôt que la première ligne : une ligne dont model est la chaîne de modèle exacte envoyée en amont, puis une ligne correspondant à l’ID exact que le client a envoyé, puis une ligne nommant le modèle intégré.
• Un nom d’amont inconnu échoue au démarrage, tout comme deux lignes pour un amont qui nomment le même modèle, y compris deux orthographes d’un modèle intégré. La passerelle avertit au démarrage à propos d’une ligne qu’aucun modèle demandable ne peut utiliser.
• Les demandes de recherche Web restent au prix catalogue de $0,01 ; le multiplicateur s’y applique toujours.

​

Majorer les prix

pricing:
  multiplier: 1.2

​

Envoyer les tarifs aux clients connectés

• Ce que la passerelle ajoute : à moins que le bloc cli d’une politique ne définisse déjà modelPricing, la passerelle ajoute le multiplier et, pour chaque ID de modèle qu’un client peut demander, la ligne de remplacement du premier amont qui sert cet ID. Un tarif que seul un amont de basculement facture reste sur la passerelle.
• Exclure une politique : définissez modelPricing à {} dans le bloc cli de cette politique, et ses développeurs restent au prix catalogue.
• Conserver les tarifs propres d’une politique : une politique dont le bloc cli définit modelPricing avec son propre multiplier ou overrides conserve ce modelPricing entièrement, et la passerelle n’ajoute aucun de ses propres tarifs à celui-ci.

​

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]

• Listes d’autorisation : availableModels et permissions.allow. La liste d’une politique spécifique remplace entièrement celle de la base.
• Listes de refus et tableaux de hooks : permissions.deny, permissions.ask, disabledMcpjsonServers, deniedMcpServers, blockedMarketplaces et chaque tableau d’événement de type hooks. Ceux-ci prennent l’union de la base et de la politique, afin qu’un refus à l’échelle de l’organisation ou un hook d’audit ne soit pas accidentellement supprimé par un remplacement par rôle.
• Clés de type enregistrement : env, modelOverrides et skillOverrides. Ceux-ci fusionnent superficiellement, afin qu’un bloc env par rôle remplace les clés qu’il définit et hérite du reste de la base.

• Lorsque la valeur est manquante ou vide, la passerelle rejette la demande avec le message model is required. Cette vérification nécessite une passerelle exécutant Claude Code v2.1.228 ou ultérieur.
• Lorsque la valeur est présente mais n’est pas une chaîne, la passerelle rejette la demande avec le message model must be a string. Nécessite une passerelle exécutant Claude Code v2.1.221 ou ultérieur.

​

Valeurs de correspondance qui arrêtent la passerelle au démarrage

• Une liste groups vide
• Une entrée vide dans groups ou dans admin_groups
• Un email_domain vide
• Un email_domain qui contient @, un espace ou une virgule. La passerelle supprime la valeur et enlève un @ initial avant cette vérification. Écrivez un domaine nu, comme example.com.

• Un email_domain vide : la passerelle a ignoré la vérification du domaine, afin qu’une politique avec un email_domain vide et aucune liste groups corresponde à chaque utilisateur authentifié
• Une liste groups vide : la politique ne correspondait à personne
• Un email_domain contenant @, un espace ou une virgule : la politique ne correspondait à personne
• Une entrée vide dans groups ou dans admin_groups : l’entrée correspondait à un utilisateur uniquement lorsque la revendication groups IdP de cet utilisateur contenait également une entrée vide. Dans admin_groups, cette correspondance accordait l’accès admin. Si votre liste admin_groups ne contenait jamais une entrée vide, personne n’a obtenu l’accès admin de cette façon.

​

Ce qui va dans 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
• Variables env qui nécessitent l’approbation du développeur, comme les variables de proxy et d’URL de base
• Paramètres d’exécution de shell comme apiKeyHelper et statusLine
• Les paramètres binaires du bac à sable sandbox.bwrapPath, sandbox.socatPath et sandbox.ripgrep
• Les paramètres du bac à sable qui interceptent le trafic, injectent des identifiants ou affaiblissent l’isolation, comme sandbox.network.tlsTerminate et les paramètres du port proxy. Boîtes de dialogue d’approbation de sécurité les liste tous.

​

Serveurs MCP dans une politique

​

Superposition Claude Desktop

• La liste des modèles, de availableModels
• Outils désactivés, à partir des entrées permissions.deny de nom d’outil nu. Si vous définissez disabledBuiltinTools dans le bloc desktop de la politique, la passerelle sert l’union de votre valeur et de la liste dérivée, afin que vous puissiez désactiver plus d’outils de cette façon mais ne puissiez pas réactiver un que vous avez désactivé via permissions.deny
• La liste d’autorisation de sortie, de sandbox.network.allowedDomains. Si vous définissez coworkEgressAllowedHosts dans le bloc desktop de la politique, la passerelle utilise cette valeur à la place de la liste dérivée
• Un point de terminaison OTLP qui pointe vers la passerelle elle-même, et les attributs d’identité de l’utilisateur connecté. La passerelle relaie les exportations qu’elle reçoit à ce point de terminaison vers vos destinations forward_to. Elle inclut le point de terminaison et les attributs lorsque vous définissez à la fois telemetry.forward_to et listen.public_url. Claude Desktop exporte chaque signal avec un encodage : http/protobuf, ou http/json lorsque vous définissez OTEL_EXPORTER_OTLP_PROTOCOL ou l’un de ses variantes par signal à http/json dans l’env de la politique. Avant Claude Code v2.1.261 sur le serveur de passerelle, la réponse définissait http/json indépendamment, afin qu’un collecteur qui accepte uniquement protobuf rejette les exportations de 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" }

• Une clé inconnue
• Une clé reconnue dont la valeur Claude Desktop rejetterait ou supprimerait silencieusement, comme une valeur vide ou une sous-clé mal orthographiée à l’intérieur d’une entrée imbriquée. Avant v2.1.260, la passerelle supprimait silencieusement un champ mal orthographié à l’intérieur d’un objet imbriqué d’une entrée managedMcpServers ou orgPluginSettings au lieu d’échouer au démarrage.
• Une clé que la passerelle calcule elle-même : la connexion d’inférence, la liste des modèles et le relais OTLP. Configurez ceux-ci via upstreams, models et la section telemetry forward_to.
• Un alias hérité d’une clé actuelle. Dans l’erreur de démarrage, la passerelle nomme la clé canonique à écrire.

• disabledBuiltinTools : la passerelle utilise l’union de la liste de la base et de la liste de la politique
• builtinToolPolicy : si vous définissez un outil à une valeur autre que allow dans la base, la passerelle conserve cette valeur même si vous définissez allow pour le même outil dans une politique par rôle

​

Précédence avec d’autres sources gérées

​

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> passe la validation de configuration, mais la garde SSRF bloque chaque exportation avec ECONNREFUSED_SSRF à moins que vous ne définissiez CLAUDE_GATEWAY_ALLOW_LOOPBACK=1 dans l’environnement de la passerelle
• http://127.0.0.1:<port> ou http://[::1]:<port> échoue au démarrage à moins que cette variable ne soit définie

• CLAUDE_CODE_ENABLE_TELEMETRY=1
• OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER et OTEL_TRACES_EXPORTER, chacun défini à otlp si au moins une destination forward_to active ce signal et à none sinon
• OTEL_EXPORTER_OTLP_ENDPOINT=<public_url>
• OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf

• Variables définies localement : Claude Code applique les variables poussées au niveau géré, afin que chacune remplace la valeur qu’un développeur définit pour elle localement.
• Points de terminaison configurés localement : avec l’exportation OTLP/HTTP activée, le CLI ignore tout point de terminaison configuré localement, que la passerelle ait poussé les variables de télémétrie ou non. Ses exportations vont à la passerelle à moins qu’une politique nomme votre collecteur comme point de terminaison.

​

Ajouter vos propres étiquettes

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

• Les noms utilisent uniquement des lettres, des chiffres, ., _ et -
• Les noms ne sont pas réservés. Comparés dans n’importe quelle casse de lettre, les noms réservés sont tout ce qui commence par user., enduser. ou identity., plus service.name, service.version, claude.deployment_mode, host.arch, os.type, os.version et wsl.version
• Les valeurs sont des ASCII imprimables non vides sans espace et aucun de , ; = \ " %
• Les valeurs sont au maximum 255 caractères tels que la passerelle les compte après codage en pourcentage, donc /, : et @ comptent chacun comme trois
• Les valeurs sont du texte, donc citez un nombre, true ou false

​

Exporter directement vers votre collecteur

• Le point de terminaison provient de la passerelle elle-même. Si vous définissez la même variable dans un profil MDM ou un managed-settings.json local, les exportations restent sur le relais.
• L’URL utilise https://, ou http:// à une adresse de bouclage
• L’URL se résout en un chemin se terminant par /v1/<signal>, sans requête ni fragment. Claude Code construit ce chemin lui-même à partir de la variable générique. Il utilise une variable par signal comme OTEL_EXPORTER_OTLP_METRICS_ENDPOINT telle qu’écrite, afin d’inclure le chemin complet là-bas.
• L’URL n’est pas l’hôte propre de la passerelle. Un point de terminaison adressé à la passerelle conserve le chemin du relais et son jeton de session.
• Ni vous ni le développeur n’avez configuré otelHeadersHelper dans aucune source de paramètres. Avec un helper configuré, chaque signal reste sur le relais.

• Si la passerelle pousse déjà les variables de télémétrie, elles couvrent l’activation, les sélecteurs et le protocole, et votre point de terminaison explicite remplace la valeur <public_url> poussée. Définissez un sélecteur OTEL_*_EXPORTER à otlp vous-même uniquement pour un signal qu’aucune destination forward_to n’active.
• Si ce n’est pas le cas, définissez également CLAUDE_CODE_ENABLE_TELEMETRY=1, les sélecteurs OTEL_*_EXPORTER et OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf.

​

Lorsqu’une destination échoue

​

Réglage HTTP

• Au démarrage : un avertissement dans le journal opérationnel recommande d’autoriser uniquement les plages privées 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 et fc00::/7, plus toute autre plage interne à partir de laquelle vos développeurs se connectent. Si vous liez la passerelle à une adresse de bouclage et ne définissez ni trusted_proxies ni public_url, comme dans le développement local, l’avertissement n’apparaît pas.
• À l’exécution : la première fois qu’une demande arrive d’une adresse en dehors de ces plages privées, la passerelle enregistre un avertissement et émet un événement d’audit access.public_client portant l’adresse IP du client. Les deux se déclenchent une fois par processus. Les adresses lien-local, 169.254.0.0/16 et fe80::/10, ne comptent pas comme publiques. La passerelle répond à /healthz et /readyz avant cette vérification, afin que les sondes de santé à partir de plages publiques ne la déclenchent pas.

​

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

​

Exemple complet

# Exécutez avec :
#   claude gateway --config gateway.yaml
#
# La verbosité du journal opérationnel est contrôlée par la variable
# d'environnement CLAUDE_GATEWAY_LOG_LEVEL
# (debug | info | warn | error ; par défaut info). debug
# enregistre également les noms de réclamations dans chaque id_token, pour le diagnostic groups_claim.
# Cela n'affecte pas les événements d'audit, qui sont toujours émis.

listen:
  host: 0.0.0.0
  port: 8080
  public_url: https://claude-gateway.internal.example.com
  # Omettez le bloc tls lors de l'exécution derrière une entrée qui termine TLS.
  # 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
  # Requis lorsque l'émetteur est le serveur d'organisation Okta, dont les id_tokens
  # peuvent omettre l'e-mail et les groupes ; la passerelle les remplit à partir de /userinfo.
  userinfo_fallback: true
  # allowed_groups: [claude-code-users]
  # Okta émet des groupes uniquement lorsque la portée `groups` est demandée et que
  # le filtre de réclamation de groupes de l'application les autorise. La politique
  # des entrepreneurs ci-dessous correspond aux groupes, donc la portée est demandée ici.
  scopes: [openid, profile, email, offline_access, groups]
  # extra_auth_params: { access_type: offline, prompt: consent }  # Google
  # groups_claim: groups          # Rôles d'application Entra : utilisez `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

# Active /v1/organizations/spend_limits (reflète l'API Admin Anthropic)
# et l'application des limites de dépenses par développeur sur /v1/messages. Omettez pour désactiver.
# Les plafonds eux-mêmes sont définis via l'API admin, pas ici.
# 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

# Testez en charge ce déploiement sans appeler un fournisseur de modèle. Jamais sur une
# passerelle que les développeurs utilisent : chaque demande reçoit une réponse en conserve.
# load_test_mode:
#   enabled: true
#   # reply_tokens: 750
#   # reply_seconds: 9.5

# Mesurez aux tarifs contractuels au lieu du prix catalogue USD. Nécessite admin: ou une
# politique managed:. Avec managed:, les mêmes tarifs vont également aux clients connectés.
# Les tarifs ci-dessous sont des espaces réservés, pas des prix de contrat réels.
# 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]
        # Limitez l'option du sélecteur par défaut à availableModels au lieu de
        # la valeur par défaut du niveau, afin que les entrepreneurs n'obtiennent pas une erreur 400 sur la valeur par défaut.
        enforceAvailableModels: true
        # allow approuve automatiquement ces outils ; il ne bloque pas le reste.
        # Ajoutez des règles de refus pour restreindre les outils.
        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}

​

Paramètres gérés côté client

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

​

Connexes

• Aperçu de la passerelle Claude apps : démarrage rapide et connexion des développeurs
• Guide de déploiement : configuration IdP, image de conteneur, Kubernetes et Cloud Run, et opérations
• Limites de dépenses : plafonds par développeur et API Admin