SpyBara
Go Premium

gateways.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 19 additions and 16 deletions.

2026
Wed 9 22:58

Exécuter Claude Code via une passerelle

Acheminez Claude Code via une passerelle auto-hébergée pour les identifiants centralisés, le suivi de l'utilisation et les contrôles de coûts. Couvre l'architecture, la passerelle d'applications Claude d'Anthropic et l'utilisation d'autres produits de passerelle.

Une passerelle est un proxy que votre organisation exécute entre Claude Code et un fournisseur de modèles. Claude Code envoie le trafic API à la passerelle au lieu de l'envoyer directement au fournisseur, et la passerelle le transfère en utilisant un identifiant que votre organisation détient. Les développeurs s'authentifient auprès de la passerelle plutôt que de détenir des identifiants de fournisseur, de sorte que l'authentification, le suivi de l'utilisation, les budgets et la journalisation d'audit se produisent en un seul endroit que vous contrôlez.

Claude Code inclut une passerelle auto-hébergée, Claude apps gateway, dans le binaire claude, vous n'avez donc pas besoin d'adopter un produit de passerelle distinct pour en exécuter une. Si votre organisation exécute déjà une passerelle LLM, Claude Code fonctionne également avec celle-ci.

Cette page couvre :

Comment fonctionne une passerelle

Chaque Claude Code de développeur envoie ses demandes à l'adresse de la passerelle et s'authentifie avec un identifiant émis par la passerelle.

La passerelle authentifie le développeur, applique les règles d'accès et de budget que vous configurez, et transfère la demande à votre fournisseur avec l'identifiant de l'organisation. Le fournisseur peut être l'API d'Anthropic ou un fournisseur cloud tel qu'Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry ; la configuration de la passerelle le décide. Avec la passerelle d'applications Claude, ou une autre passerelle qui expose un seul point de terminaison au format Anthropic, le changement de fournisseur ne nécessite pas de toucher aux machines des développeurs.

Diagramme montrant Claude Code acheminé via une passerelle. Dans une zone de machines de développeur, l'interface CLI Claude Code et l'extension VS Code envoient des demandes à l'adresse de la passerelle avec un identifiant par développeur. Dans une zone intitulée votre infrastructure, la passerelle gère l'authentification, le suivi de l'utilisation, les budgets et l'acheminement, et transfère les demandes avec l'identifiant de votre organisation. Dans une zone de fournisseurs de modèles, une flèche pleine mène au fournisseur que vous configurez, affiché comme l'API Anthropic, et des flèches pointillées mènent à d'autres options de fournisseur, illustrées avec Amazon Bedrock, Google Cloud et Microsoft Foundry comme exemples.

Deux types d'identifiants sont impliqués :

  • Identifiant de développeur : chaque développeur en détient un, émis par la passerelle. Il l'authentifie auprès de la passerelle et l'identifie dans le suivi de l'utilisation
  • Identifiant de fournisseur : la passerelle détient un identifiant pour votre compte fournisseur, partagé par tout le trafic transféré

Choisir une passerelle

Claude Code fonctionne avec la passerelle d'Anthropic ou avec une passerelle que votre organisation exécute déjà.

Passerelle d'applications Claude

La passerelle d'applications Claude est la passerelle auto-hébergée d'Anthropic, incluse dans le binaire claude. Elle achemine vers Amazon Bedrock, Claude Platform sur AWS, Google Cloud, Microsoft Foundry ou l'API Anthropic en amont. Les développeurs se connectent avec votre fournisseur d'identité d'entreprise via /login, la passerelle applique l'accès aux modèles et les paramètres gérés par groupe IdP, et elle émet des métriques d'utilisation du protocole OpenTelemetry (OTLP) vers votre propre pile d'observabilité.

Parce qu'elle est construite et testée aux côtés de chaque version de Claude Code, elle transfère les en-têtes et les champs de demande que Claude Code envoie. Une passerelle maintenue séparément doit avoir ses règles de transfert mises à jour à mesure que ces en-têtes et champs changent à chaque version ; la passerelle d'applications Claude est publiée avec l'interface CLI, il n'y a donc pas de liste à tenir à jour. Voir Disponibilité et limitations pour le petit ensemble de fonctionnalités qui se comportent différemment sur une session de passerelle.

La connexion à la passerelle est une étape SSO du navigateur, et il n'y a pas de flux de jeton de service, donc un pipeline CI sans développeur pour approuver la connexion ne peut pas s'authentifier via celui-ci ; configurez-les directement auprès de votre fournisseur. Les sessions du SDK Agent et les exécutions claude -p sur une machine où un développeur s'est connecté utilisent la session de passerelle de cette machine et sont régies par ses politiques. Voir Pipelines CI et machines distantes.

Voir Claude apps gateway pour la déployer.

Autres passerelles

Si votre organisation exécute déjà une passerelle LLM ou une passerelle API, vous pouvez l'utiliser à la place. Anthropic n'approuve pas, ne maintient pas et n'audite pas d'autres produits de passerelle, et ne supporte pas l'acheminement de Claude Code vers des modèles non-Claude via aucune passerelle. Voir Autres passerelles LLM pour la liste de contrôle du déploiement administrateur, ce qu'une passerelle doit implémenter et comment pointer Claude Code vers celle-ci.

Abonnements et passerelles

Lorsque les développeurs se connectent via une passerelle avec un identifiant de passerelle, l'utilisation est facturée au compte fournisseur de votre organisation aux tarifs de l'API, et leurs abonnements claude.ai ne sont pas utilisés ni facturés. La définition de ANTHROPIC_AUTH_TOKEN pour une passerelle que vous exécutez, ou la connexion à une passerelle d'applications Claude avec /login, désactive la connexion par abonnement pour cette session. Chaque demande transférée sous cet identifiant est facturée au compte derrière l'identifiant du fournisseur de la passerelle.

L'exception est de définir uniquement ANTHROPIC_BASE_URL, sans identifiant de passerelle. Les demandes s'acheminent toujours via la passerelle, mais une connexion claude.ai enregistrée reste l'identifiant actif, de sorte que les limites d'utilisation et la facturation de l'abonnement s'appliquent. Autres passerelles LLM couvre cette configuration et ce que la passerelle doit transférer pour que cela fonctionne.

Configurer séparément de la passerelle

Une passerelle achemine les demandes d'API de modèle. Quelques éléments que vous pourriez vous attendre à ce qu'elle gère sont configurés ailleurs :

  • Quel modèle répond : choisissez le modèle avec la commande /model ou les variables d'environnement de modèle. La passerelle décide où les demandes vont, pas quel modèle le développeur sélectionne. La passerelle d'applications Claude peut limiter le choix avec une liste d'autorisation availableModels par groupe, mais le développeur choisit toujours dans celle-ci.
  • Autre trafic réseau : Claude Code lui-même envoie les vérifications de version et les téléchargements directement à Anthropic, séparément du chemin de la passerelle. Votre réseau a toujours besoin d'une sortie vers les domaines requis, ou définissez CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC pour désactiver les flux optionnels.
  • Télémétrie client : Claude Code désactive son analyse client liée à Anthropic lorsqu'une session se connecte à une passerelle d'applications Claude. Pour maintenir également la télémétrie de démarrage avant la connexion désactivée, livrez DISABLE_TELEMETRY dans les paramètres gérés côté client sur chaque appareil.
  • Télémétrie client sur d'autres passerelles : le fait que Claude Code envoie le flux de télémétrie client optionnel dépend de votre fournisseur, et le tableau des valeurs par défaut de télémétrie couvre chaque cas.
  • Destinations de télémétrie : l'endroit où Claude Code envoie la télémétrie d'une session de passerelle dépend de la façon dont la session s'est connectée, et Ce qui est appliqué aux développeurs indique où les exports de chaque type de session vont.
  • Proxies HTTP d'entreprise : un HTTPS_PROXY s'insère entre Claude Code et chaque serveur avec lequel il communique, y compris la passerelle. Si votre réseau en nécessite un, configurez le proxy en plus de la passerelle. Pour une passerelle d'applications Claude que vous hébergez, la connexion vérifie que l'hôte proxy est également sur un réseau privé ; si ce n'est pas le cas, ajoutez l'hôte de la passerelle à NO_PROXY pour que l'interface CLI s'y connecte directement.

Étapes suivantes

La page suivante dépend de qui exécute la passerelle. La passerelle d'Anthropic s'exécute à partir du binaire claude et a son propre guide de configuration ; une passerelle que votre organisation exécute déjà a un protocole à implémenter et une liste de contrôle du déploiement administrateur.