Créez une nouvelle ressource, en notant le nom de votre ressource
Créez des déploiements pour les modèles Claude :
Claude Opus
Claude Sonnet
Claude Haiku
2. Configurer les identifiants Azure
Claude Code prend en charge deux méthodes d'authentification pour Microsoft Foundry. Choisissez la méthode qui correspond le mieux à vos exigences de sécurité.
Option A : Authentification par clé API
Accédez à votre ressource dans le portail Microsoft Foundry
Lorsque ANTHROPIC_FOUNDRY_API_KEY n'est pas défini, Claude Code utilise automatiquement 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.
Dans les environnements locaux, vous pouvez généralement utiliser Azure CLI :
az login
3. Configurer Claude Code
Définissez les variables d'environnement suivantes pour activer Microsoft Foundry :
# Activer l'intégration Microsoft Foundryexport CLAUDE_CODE_USE_FOUNDRY=1# Nom de la ressource Azure (remplacez {resource} par le nom de votre ressource)export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Ou fournissez l'URL de base complète :# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
4. Épingler les versions de modèle
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 Foundry se résout en Opus 4.6. Définissez-le sur l'ID Opus 4.7 pour utiliser le modèle le plus récent :
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 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.
Le cache des invites 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é :
export ENABLE_PROMPT_CACHING_1H=1
5. Exécuter Claude Code
Avec les variables d'environnement définies, démarrez Claude Code à partir de votre répertoire de projet :
claude
Claude Code lit CLAUDE_CODE_USE_FOUNDRY et les autres variables Foundry à partir de l'environnement et se connecte à votre ressource Azure à la première invite. Contrairement à Bedrock et Vertex AI, 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.
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 :
178Avec les variables d'environnement définies, démarrez Claude Code à partir de votre répertoire de projet :
179
180```bash theme={null}
181claude
182```
183
184Claude Code lit `CLAUDE_CODE_USE_FOUNDRY` et les autres variables Foundry à partir de l'environnement et se connecte à votre ressource Azure à la première invite. Contrairement à Bedrock et Vertex AI, 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.
178Les rôles par défaut `Azure AI User` et `Cognitive Services User` incluent toutes les autorisations requises pour invoquer les modèles Claude.188Les rôles par défaut `Azure AI User` et `Cognitive Services User` incluent toutes les autorisations requises pour invoquer les modèles Claude.
