SpyBara
Go Premium

llm-gateway.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 16 additions and 16 deletions.

2026
Thu 1 23:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Autres passerelles LLM

Acheminez Claude Code via une passerelle LLM que votre organisation exécute déjà. Couvre la connexion de Claude Code à une passerelle, le déploiement d'une passerelle pour votre organisation et ce que Claude Code envoie à une passerelle.

Cette section couvre l'utilisation d'un produit de passerelle que votre organisation exécute déjà, plutôt que la passerelle Claude apps. Pour savoir ce qu'est une passerelle, comment elle se situe entre Claude Code et votre fournisseur, et comment choisir entre la passerelle Claude apps et un autre produit, consultez l'aperçu des passerelles.

[!NOTE]

Toute passerelle qui expose un format API supporté fonctionne. Anthropic n'approuve pas, ne maintient pas et n'audite pas les produits de passerelle tiers, et ne supporte pas l'acheminement de Claude Code vers des modèles non-Claude via aucune passerelle. Déployez la passerelle en suivant sa propre documentation, puis complétez le côté Claude Code avec les étapes de déploiement ci-dessous.

Ce qu'une passerelle fournit

Une passerelle donne à votre organisation un seul endroit pour gérer :

  • Credentials : la clé du fournisseur reste côté serveur ; les développeurs détiennent plutôt des credentials de passerelle
  • Suivi de l'utilisation : attribuez l'utilisation par développeur ou équipe, quel que soit le fournisseur qui traite la requête
  • Contrôles des coûts : appliquez les budgets et les limites de débit en un seul endroit
  • Journalisation d'audit : enregistrez chaque requête de modèle pour la conformité
  • Changement de fournisseur : changez le fournisseur dans la configuration de la passerelle, sans toucher aux machines des développeurs

Tous ces éléments sauf le changement de fournisseur s'appliquent que le flux amont soit l'API d'Anthropic ou un fournisseur cloud. Le changement de fournisseur sans reconfiguration des machines des développeurs dépend également de la passerelle exposant un seul point de terminaison au format Anthropic quel que soit le flux amont. Une passerelle qui expose le propre format d'un fournisseur lie la configuration du client à ce fournisseur et change ce que Claude Code envoie et les valeurs par défaut qu'il applique.

Le compromis est que la passerelle devient une infrastructure que votre organisation exploite. Claude Code ajoute des capacités à chaque version, et une passerelle qui ne les transfère pas casse les fonctionnalités correspondantes, donc le produit de passerelle doit être maintenu à jour à mesure que Claude Code évolue. La référence du protocole de passerelle couvre ce qu'il faut transférer.

Déployer une passerelle

Quand vous êtes prêt à déployer une passerelle LLM pour votre organisation, la séquence est la même quel que soit le produit de passerelle que vous choisissez :

  1. Déployez la passerelle et donnez-lui votre credential du fournisseur, afin qu'elle puisse authentifier les requêtes qu'elle transfère.
  2. Émettez à chaque développeur une credential de passerelle, afin que l'utilisation soit attribuée au développeur et que l'offboarding révoque une credential.
  3. Distribuez la configuration via un fichier de paramètres gérés et votre outillage de secrets, afin que chaque machine reçoive l'URL de base et une credential. Quand les deux sont distribués, les développeurs ne configurent rien. Si vous n'avez pas de distribution de paramètres en place, les développeurs suivent la page de connexion pour définir les variables eux-mêmes.
  4. Faites en sorte que chaque développeur vérifie la configuration dans Claude Code, afin que les problèmes de distribution fassent surface avant qu'ils ne dépendent de la passerelle.

Déployez une passerelle LLM pour votre organisation parcourt chaque étape et montre les fichiers de configuration à distribuer à chacune. La passerelle est une partie de la configuration de l'organisation ; pour l'application des politiques, la visibilité de l'utilisation et les décisions de traitement des données, consultez Configurez Claude Code pour votre organisation.

Pour faire d'une passerelle accessible via ANTHROPIC_BASE_URL la seule destination qu'une machine gérée peut utiliser, définissez allowedProviders à ["customEndpoint"] dans le même fichier de paramètres gérés et mettez l'ANTHROPIC_BASE_URL de la passerelle dans le bloc env de ce fichier. Claude Code refuse alors une session pointée ailleurs, y compris directement vers Anthropic ou vers le propre proxy d'un développeur, et accepte ANTHROPIC_BASE_URL uniquement avec la valeur que vous y définissez. Pour une passerelle accessible via une variable de point de terminaison spécifique au fournisseur telle que ANTHROPIC_BEDROCK_BASE_URL, l'entrée allowedProviders indique quelle variable épingler. Nécessite Claude Code v2.1.285 ou ultérieur.

Abonnements et passerelles

Tandis qu'une variable de credential de passerelle ou apiKeyHelper est active, les requêtes portent cette credential à la place de la connexion d'abonnement claude.ai d'un développeur, et les limites d'utilisation de l'abonnement ne s'appliquent pas à celles-ci. Claude Code conserve une connexion claude.ai sauvegardée sur la machine mais ne l'envoie pas avec ces requêtes. Ce trafic est facturé par token à celui qui possède la credential que la passerelle transfère, tel que le compte Anthropic Console de votre organisation, ou votre compte Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry quand la passerelle achemine là.

ANTHROPIC_BASE_URL est la variable qui pointe Claude Code vers la passerelle. Définir uniquement cette variable, sans credential de passerelle, ne remplace pas l'abonnement. Les requêtes acheminent toujours via la passerelle, mais une connexion claude.ai sauvegardée reste la credential active, donc ses limites d'utilisation et sa facturation s'appliquent. Les passerelles qui transmettent ce trafic à Anthropic doivent transférer la capacité OAuth dans anthropic-beta ; consultez la référence des en-têtes de requête.

Pages connexes