SpyBara
Go Premium

microsoft-foundry.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

3 added, 3 removed.

2026
Fri 7 15:00 Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Claude Code sur Microsoft Foundry

Découvrez comment configurer Claude Code via Microsoft Foundry, y compris la configuration, les paramètres et la résolution des problèmes.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Conditions préalables

Avant de configurer Claude Code avec Microsoft Foundry, assurez-vous que vous disposez de :

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

2) 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é.

Option A : Authentification par clé API

  1. Accédez à votre ressource dans le portail Microsoft Foundry
  2. Allez à la section Points de terminaison 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 :
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Option B : Authentification Microsoft Entra ID

Lorsque ni ANTHROPIC_FOUNDRY_API_KEY ni ANTHROPIC_FOUNDRY_AUTH_TOKEN ne sont définis, 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

Option C : Authentification par jeton porteur

Claude Code envoie la valeur de ANTHROPIC_FOUNDRY_AUTH_TOKEN sur chaque demande 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. Nécessite Claude Code v2.1.203 ou version ultérieure.

Définissez la variable sur un jeton porteur émis par Microsoft Entra ID pour votre ressource :

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

ANTHROPIC_FOUNDRY_AUTH_TOKEN a la priorité sur ANTHROPIC_FOUNDRY_API_KEY et sur la chaîne d'identifiants par défaut.

3. Configurer Claude Code

Définissez les variables d'environnement suivantes pour activer Microsoft Foundry :

# Activer l'intégration Microsoft Foundry
export 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 Microsoft Foundry se résout en Opus 4.6. Définissez-le sur l'ID Opus 4.8 pour utiliser le modèle le plus récent :

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

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 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 Microsoft Foundry à partir de l'environnement et se connecte à votre ressource Azure à la première invite. 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 :

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

Pour plus de détails, consultez la documentation RBAC de Microsoft Foundry.

Résolution des problèmes

Si vous recevez une erreur « Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed » :

Si les requêtes échouent avec des erreurs de connexion répétées sur la première invite :

Ressources supplémentaires