Skip to main content

​
Conditions préalables

Avant de configurer Claude Code avec Microsoft Foundry, assurez-vous que vous disposez de :
  • Un abonnement Azure avec accès à Microsoft Foundry
  • Des autorisations RBAC pour créer des ressources et des déploiements Microsoft Foundry
  • Azure CLI installé et configuré (facultatif - nécessaire uniquement si vous n’avez pas d’autre mécanisme pour obtenir les identifiants)
Si vous déployez Claude Code pour plusieurs utilisateurs, épinglez vos versions de modèle avant le déploiement.

​
Configuration

​
  1. Provisionner la ressource Microsoft Foundry

Tout d’abord, créez une ressource Claude dans Azure :
  1. Accédez au portail Microsoft Foundry
  2. Créez une nouvelle ressource, en notant le nom de votre ressource
  3. Créez des déploiements pour les modèles Claude, en notant le nom de déploiement que vous donnez à chacun ; vous définirez ces noms comme variables de modèle à l’étape 4 :
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku
    Lorsque vous configurez un déploiement, vous choisissez également son option d’hébergement, qui détermine si l’inférence s’exécute sur Azure ou sur l’infrastructure Anthropic.

​
  1. Configurer les identifiants Azure

Claude Code prend en charge trois méthodes d’authentification pour Microsoft Foundry. Choisissez la méthode qui correspond le mieux à vos exigences de sécurité :
  • Clé API : vous copiez une clé depuis le portail Microsoft Foundry et la définissez comme ANTHROPIC_FOUNDRY_API_KEY
  • Microsoft Entra ID : Claude Code obtient des jetons via la chaîne d’identifiants par défaut du SDK Azure, par exemple à partir d’une session az login, il n’y a donc aucune clé API à stocker
  • Jeton porteur : un autre processus obtient un jeton d’accès Microsoft Entra ID et vous le transmettez dans ANTHROPIC_FOUNDRY_AUTH_TOKEN
Lors de l’utilisation de Microsoft Foundry, la commande /logout n’est pas disponible car l’authentification est gérée via les identifiants Azure.

​
Utiliser une clé API

Copiez une clé depuis le portail Microsoft Foundry, puis définissez-la comme variable d’environnement :
  1. Accédez à votre ressource dans le portail Microsoft Foundry
  2. Ouvrez la section Endpoints et clés
  3. Copiez la Clé API
  4. Définissez la variable d’environnement, en remplaçant your-azure-api-key par la clé que vous avez copiée :

​
Utiliser Microsoft Entra ID

Laissez ANTHROPIC_FOUNDRY_API_KEY et ANTHROPIC_FOUNDRY_AUTH_TOKEN non définis. Claude Code utilise alors la chaîne d’identifiants par défaut du SDK Azure. Cela prend en charge une variété de méthodes pour authentifier les charges de travail locales et distantes. Sur une machine locale, connectez-vous avec Azure CLI :
Pour les rôles dont votre identité a besoin, consultez Configuration Azure RBAC.

​
Utiliser un jeton porteur

Claude Code envoie la valeur de ANTHROPIC_FOUNDRY_AUTH_TOKEN sur chaque requête en tant qu’en-tête Authorization: Bearer. Utilisez cette option lorsqu’un autre processus, tel qu’une application hôte ou un script de connexion, a déjà obtenu un jeton d’accès pour vous. Définissez la variable sur un jeton porteur émis par Microsoft Entra ID pour votre ressource :
ANTHROPIC_FOUNDRY_AUTH_TOKEN a la priorité sur ANTHROPIC_FOUNDRY_API_KEY et sur la chaîne d’identifiants par défaut.

​
  1. Configurer Claude Code

Définissez les variables d’environnement suivantes pour activer Microsoft Foundry :
Définissez ANTHROPIC_FOUNDRY_RESOURCE sur le nom de la ressource seul, tel que my-resource. Claude Code refuse une URL ou un nom d’hôte lorsque vous envoyez un message.

​
  1. Épingler les versions de modèle

Épinglez des versions de modèle spécifiques pour chaque déploiement. Sans épinglage, les alias de modèle tels que sonnet et opus se résolvent à la valeur par défaut intégrée de Claude Code pour Microsoft Foundry, qui peut être en retard par rapport à la version la plus récente et peut ne pas encore être disponible dans votre compte. Microsoft Foundry n’a pas de vérification de modèle au démarrage, donc les requêtes échouent lorsque la valeur par défaut n’est pas disponible. Lorsque vous créez des déploiements Azure, sélectionnez une version de modèle spécifique plutôt que « mise à jour automatique vers la dernière version ».
Définissez les variables de modèle pour correspondre aux noms de déploiement que vous avez créés à l’étape 1. Sans ANTHROPIC_DEFAULT_OPUS_MODEL, l’alias opus sur Microsoft Foundry se résout en Opus 4.6. Définissez-le sur l’ID d’un modèle Opus plus récent, tel qu’Opus 4.8 :
Les tâches en arrière-plan telles que la génération de titres de session utilisent le modèle petit/rapide, normalement un modèle de classe Haiku. Sur Microsoft Foundry, Claude Code utilise par défaut le modèle principal car tous les comptes n’ont pas de déploiement Haiku. Pour utiliser Haiku pour les tâches en arrière-plan, définissez ANTHROPIC_DEFAULT_HAIKU_MODEL sur un déploiement Haiku disponible dans votre compte, comme indiqué ci-dessus. Pour les ID de modèle actuels et hérités, consultez Aperçu des modèles. Consultez Configuration des modèles pour la liste complète des variables d’environnement. Le prompt caching est activé automatiquement. Pour demander un TTL de cache d’une heure au lieu de la valeur par défaut de 5 minutes, définissez la variable suivante ; les écritures de cache avec un TTL d’une heure sont facturées à un taux plus élevé :
Pour définir différents TTL pour votre conversation principale et pour les requêtes que Claude Code effectue en dehors de celle-ci, choisissez vous-même le TTL.

​
  1. Exécuter Claude Code

Avec les variables d’environnement définies, démarrez Claude Code à partir de votre répertoire de projet :
Claude Code lit CLAUDE_CODE_USE_FOUNDRY et les autres variables Microsoft Foundry à partir de l’environnement et se connecte à votre ressource Azure au premier prompt. Contrairement à Amazon Bedrock et à Google Cloud’s Agent Platform, Microsoft Foundry n’a pas d’assistant de configuration interactif, donc les variables d’environnement des étapes 3 et 4 sont le seul chemin de configuration. Pour vérifier votre configuration, exécutez /status dans Claude Code. La ligne du fournisseur API affiche Microsoft Foundry, ainsi que le nom de la ressource ou l’URL de base que vous avez configurés.

​
Configuration Azure RBAC

Les rôles par défaut Azure AI User et Cognitive Services User incluent toutes les autorisations requises pour invoquer les modèles Claude. Pour des autorisations plus restrictives, créez un rôle personnalisé avec les éléments suivants :
Pour plus de détails, consultez la documentation RBAC de Microsoft Foundry.

​
Fenêtre de contexte de 1M tokens

Sur Microsoft Foundry, lorsque Claude Code peut déterminer quel modèle votre déploiement sert, les modèles Fable, Sonnet 5 et versions ultérieures, ainsi qu’Opus 4.7 et versions ultérieures s’exécutent par défaut avec la fenêtre de contexte de 1M tokens, sans qu’aucun suffixe [1m] soit nécessaire. Claude Code lit le modèle à partir du nom de déploiement dans vos variables de modèle. Nommez chaque déploiement avec son ID de modèle, par exemple claude-opus-4-8, ou associez le modèle au nom de votre déploiement avec modelOverrides. Pour un nom de déploiement qu’il ne peut pas associer à un modèle, Claude Code suppose une fenêtre de 200K, sauf si vous en déclarez une autre. Cette entrée settings.json indique à Claude Code qu’un déploiement nommé team-opus-prod sert Opus 4.8 :
Pour conserver plutôt une fenêtre de 200K, définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Opus 4.6 et Sonnet 4.6 accèdent à la fenêtre de 1M lorsque vous ajoutez [1m] au nom de déploiement dans ANTHROPIC_DEFAULT_OPUS_MODEL ou ANTHROPIC_DEFAULT_SONNET_MODEL, comme le décrit Épingler les modèles pour les déploiements tiers. Avant la v2.1.287, les modèles Fable ainsi qu’Opus 4.7 et versions ultérieures nécessitaient également ce suffixe sur Microsoft Foundry et s’exécutaient par défaut avec une fenêtre de 200K sans celui-ci.

​
Résolution des problèmes

Si vous recevez une erreur « Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed » :
  • Configurez Entra ID sur l’environnement, ou définissez ANTHROPIC_FOUNDRY_API_KEY.
Si les requêtes échouent avec des erreurs de connexion répétées sur la première invite :
  • Vérifiez que ANTHROPIC_FOUNDRY_RESOURCE est défini sur le nom de votre ressource réelle plutôt que sur un espace réservé. Claude Code construit l’URL du point de terminaison à partir de cette valeur, donc un nom incorrect pointe vers un hôte qui n’existe pas.

​
Ressources supplémentaires