llm-gateway.md +0 −96 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Passerelles LLM
6
7> Acheminez Claude Code via une passerelle LLM pour l'authentification centralisée, le suivi de l'utilisation et les contrôles des coûts. Couvre la connexion de Claude Code à une passerelle, le déploiement d'une passerelle pour votre organisation, ce que Claude Code envoie à une passerelle et comment les passerelles interagissent avec les abonnements claude.ai.
8
9Une passerelle LLM 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, et la passerelle le transfère au fournisseur en utilisant une credential que votre organisation contrôle.
10
11<Note>
12 * Si vous êtes un développeur se connectant à une passerelle existante : [connectez Claude Code à votre passerelle](/fr/llm-gateway-connect)
13 * Si vous êtes un administrateur déployant une passerelle pour votre organisation : [déployez et distribuez une passerelle](/fr/llm-gateway-rollout)
14 * Si vous configurez un produit de passerelle : la [référence du protocole de passerelle](/fr/llm-gateway-protocol)
15</Note>
16
17<h2 id="what-a-gateway-provides">
18 Ce qu'une passerelle fournit
19</h2>
20
21Une passerelle donne à votre organisation un seul endroit pour gérer :
22
23* **Credentials** : la clé du fournisseur reste côté serveur ; les développeurs détiennent plutôt des credentials de passerelle
24* **Suivi de l'utilisation** : attribuez l'utilisation par développeur ou équipe, quel que soit le fournisseur qui traite la requête
25* **Contrôles des coûts** : appliquez les budgets et les limites de débit en un seul endroit
26* **Journalisation d'audit** : enregistrez chaque requête de modèle pour la conformité
27* **Changement de fournisseur** : changez le fournisseur dans la configuration de la passerelle, sans toucher aux machines des développeurs
28
29Tous ces éléments sauf le changement de fournisseur s'appliquent que le flux amont soit l'API d'Anthropic ou un [fournisseur cloud](/fr/third-party-integrations).
30
31Le 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](/fr/llm-gateway-protocol) couvre ce qu'il faut transférer.
32
33<h2 id="how-a-gateway-works">
34 Comment une passerelle fonctionne
35</h2>
36
37Par défaut, Claude Code envoie les requêtes directement à l'API d'Anthropic à `api.anthropic.com`. Pour acheminer via une passerelle, définissez `ANTHROPIC_BASE_URL` à l'adresse de la passerelle ; Claude Code envoie les mêmes requêtes là à la place. La passerelle authentifie le développeur, attache la credential du fournisseur de votre organisation, et transfère chaque requête au fournisseur pour lequel elle est configurée.
38
39`ANTHROPIC_BASE_URL` est la variable d'adresse pour la plupart des passerelles. Une passerelle qui fait face à un fournisseur cloud spécifique, tel que Bedrock, Vertex, Foundry, ou la Claude Platform sur AWS, utilise plutôt la variable d'URL de base de ce fournisseur ; [API formats](/fr/llm-gateway-protocol#api-formats) énumère quelle variable va avec chaque configuration.
40
41<Frame>
42 <img src="https://mintcdn.com/claude-code/-uq-4JE0W_JO5Er5/images/llm-gateway-flow.svg?fit=max&auto=format&n=-uq-4JE0W_JO5Er5&q=85&s=1c1a8dcc0cfcc3a58652cc8e28cd3e20" alt="Diagramme montrant Claude Code acheminé via une passerelle LLM. Dans une zone de machines de développeur, le CLI Claude Code, l'extension VS Code et les clients SDK CI ou Agent envoient des requêtes à la passerelle, avec la variable d'URL de base pour le format API de la passerelle la pointant et chaque développeur détenant une credential par développeur, et l'application de bureau atteint la même passerelle via la configuration distribuée par l'organisation. Dans une zone intitulée votre infrastructure, la passerelle LLM gère l'authentification, le suivi de l'utilisation, les budgets et le routage, et transfère les requêtes avec la credential de votre organisation. Dans une zone de fournisseurs de modèles, une flèche pleine mène au fournisseur que vous configurez, montré comme l'API Anthropic, et des flèches pointillées mènent à d'autres options de fournisseur, illustrées avec Amazon Bedrock, Google Vertex AI et Microsoft Foundry comme exemples." width="780" height="322" data-path="images/llm-gateway-flow.svg" />
43</Frame>
44
45Deux types de credential sont impliqués :
46
47* **Credentials de développeur** : chaque développeur détient la sienne, émise par la passerelle. Elle les authentifie auprès de la passerelle et les identifie dans le suivi de l'utilisation
48* **Credential du fournisseur** : la passerelle détient une credential pour votre compte de fournisseur, partagée par tout le trafic transféré. Vous ne provisionnez pas les clés du fournisseur par développeur
49
50La passerelle transfère chaque requête au fournisseur que vous configurez, tel que l'API Anthropic, [Amazon Bedrock](/fr/amazon-bedrock), [Google Vertex AI](/fr/google-vertex-ai), [Microsoft Foundry](/fr/microsoft-foundry), ou la [Claude Platform sur AWS](/fr/claude-platform-on-aws). Parce que Claude Code ne parle qu'à la passerelle, le choix du fournisseur est la configuration de la passerelle, pas celle du client.
51
52<h2 id="roll-out-a-gateway">
53 Déployer une passerelle
54</h2>
55
56Quand 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 :
57
581. Déployez la passerelle et donnez-lui votre credential du fournisseur, afin qu'elle puisse authentifier les requêtes qu'elle transfère.
592. É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.
603. Distribuez la configuration via un [fichier de paramètres gérés](/fr/settings#settings-files) 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](/fr/llm-gateway-connect) pour définir les variables eux-mêmes.
614. Faites en sorte que chaque développeur [vérifie la configuration dans Claude Code](/fr/llm-gateway-connect#check-for-an-existing-configuration), afin que les problèmes de distribution fassent surface avant qu'ils ne dépendent de la passerelle.
62
63[Déployez une passerelle LLM pour votre organisation](/fr/llm-gateway-rollout) 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, voir [Configurez Claude Code pour votre organisation](/fr/admin-setup).
64
65<h2 id="third-party-gateways">
66 Passerelles tierces
67</h2>
68
69Toute passerelle qui expose un [format API supporté](/fr/llm-gateway-protocol#api-formats) fonctionne. Anthropic n'approuve pas, ne maintient pas et n'audite pas les produits de passerelle tiers. Déployez-les en suivant leur propre documentation, puis complétez le côté Claude Code du déploiement avec les [étapes de déploiement](/fr/llm-gateway-rollout).
70
71<h2 id="subscriptions-and-gateways">
72 Abonnements et passerelles
73</h2>
74
75Tandis qu'une [variable de credential de passerelle](/fr/llm-gateway-connect#set-the-credential-variable) ou `apiKeyHelper` est active, l'abonnement claude.ai d'un développeur n'est pas utilisé : la credential remplace la connexion à l'abonnement pour cette session, et les limites d'utilisation de l'abonnement ne s'appliquent pas. 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 Bedrock, Vertex ou Foundry quand la passerelle achemine là.
76
77Définir uniquement `ANTHROPIC_BASE_URL`, 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` ; voir la [référence des en-têtes de requête](/fr/llm-gateway-protocol#request-headers).
78
79<h2 id="configure-separately-from-the-gateway">
80 Configurer séparément de la passerelle
81</h2>
82
83Une passerelle détermine où les requêtes API du modèle sont envoyées. La sélection du modèle, le reste du trafic réseau de Claude Code et les proxies d'entreprise sont configurés séparément :
84
85* **Sélection du modèle** : l'URL de base décide où les requêtes vont, pas quel modèle les répond. Choisissez le modèle avec la commande `/model` ou les variables d'environnement du modèle ; voir [comment définir votre modèle](/fr/model-config#setting-your-model)
86* **Trafic côté client** : les vérifications de version et la télémétrie client optionnelle, tous deux désactivés avec [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/fr/env-vars), et le trafic de connexion quand une connexion claude.ai ou Console est en cours d'utilisation, vont aux points de terminaison de mise à jour et d'authentification d'Anthropic plutôt qu'à la passerelle. Voir [exigences d'accès réseau](/fr/network-config#network-access-requirements) pour les domaines
87* **Proxies d'entreprise** : un proxy défini avec `HTTPS_PROXY` se situe entre Claude Code et chaque serveur avec lequel il communique, y compris la passerelle. Si votre réseau nécessite un proxy, configurez les deux ; voir [configuration du proxy](/fr/network-config#proxy-configuration)
88
89<h2 id="related-pages">
90 Pages connexes
91</h2>
92
93* [Connectez Claude Code à une passerelle LLM](/fr/llm-gateway-connect) : définissez l'URL de base et la credential sur votre propre machine, avec la configuration par surface et un tableau de dépannage
94* [Déployez une passerelle LLM pour votre organisation](/fr/llm-gateway-rollout) : la liste de contrôle de l'administrateur pour déployer une passerelle, émettre des credentials de développeur et distribuer les paramètres gérés
95* [Référence du protocole de passerelle](/fr/llm-gateway-protocol) : ce que Claude Code envoie à une passerelle, pour les opérateurs en configurant une, couvrant les points de terminaison, les en-têtes à transférer et le passage des fonctionnalités
96* [Configurez Claude Code pour votre organisation](/fr/admin-setup) : les décisions de déploiement plus larges dont une passerelle est une partie, y compris l'application des politiques et la visibilité de l'utilisation