Claude dans Microsoft Foundry

Ce guide vous montre comment configurer et effectuer des appels API vers Claude dans Microsoft Foundry en utilisant l'un des SDK clients d'Anthropic ou des requêtes HTTP directes. Lorsque vous accédez à Claude dans Microsoft Foundry, votre utilisation de Claude est facturée via l'Azure Marketplace. Vous pouvez utiliser les derniers modèles Claude, notamment Claude Opus 5, Claude Opus 4.8 et Claude Sonnet 5, ainsi que des fonctionnalités telles que la fenêtre de contexte de 1 million de tokens, tout en gérant les coûts via votre abonnement Azure.

Claude est disponible dans les types de déploiement Global Standard et US Data Zone Standard au sein des ressources Foundry, facturé en Claude Consumption Units via l'Azure Marketplace. Consultez la tarification de Claude dans Microsoft Foundry pour plus de détails.



Options d'hébergement

Les modèles Claude dans Microsoft Foundry sont disponibles avec deux options d'hébergement. Vous choisissez l'option d'hébergement lors de la configuration du déploiement.



Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Un abonnement Azure actif
• Un accès au portail Foundry
• L'Azure CLI installée (requise pour l'exemple cURL avec Entra ID, facultative sinon)
• Un rôle Azure RBAC vous permettant d'utiliser la ressource, tel que Foundry User (anciennement Azure AI User) ou Cognitive Services User



Installer un SDK

Les SDK clients d'Anthropic prennent en charge Foundry via un package ou une classe client spécifique à la plateforme. Les exemples de cette page montrent également des requêtes avec cURL et la CLI ant. Pour configurer la CLI, consultez le démarrage rapide de la CLI.

pip install -U "anthropic"

# Pour l'authentification Entra ID, installez également la bibliothèque Azure Identity
pip install azure-identity



Provisionnement

Foundry utilise une hiérarchie à deux niveaux : les ressources contiennent votre configuration de sécurité et de facturation, tandis que les déploiements sont les instances de modèle que vous appelez via l'API. Vous créerez d'abord une ressource Foundry, puis un ou plusieurs déploiements Claude au sein de celle-ci.



Provisionnement des ressources Foundry

Créez une ressource Foundry, nécessaire pour utiliser et gérer les services dans Azure. Vous pouvez suivre ces instructions pour créer une ressource Foundry. Vous pouvez également commencer par créer un projet Foundry, ce qui implique la création d'une ressource Foundry.

Pour provisionner votre ressource :

1. Accédez au portail Foundry.
2. Créez une nouvelle ressource Foundry ou sélectionnez-en une existante.
3. Configurez la gestion des accès à l'aide de clés API émises par Azure ou d'Entra ID (anciennement Azure Active Directory) pour le contrôle d'accès basé sur les rôles.
4. Configurez éventuellement la ressource pour qu'elle fasse partie d'un réseau privé (Azure Virtual Network) afin de restreindre l'accès réseau à votre ressource.
5. Notez le nom de votre ressource. Vous l'utiliserez comme {resource} dans les points de terminaison de l'API (par exemple, https://{resource}.services.ai.azure.com/anthropic/v1/*).



Création de déploiements Foundry

Après avoir créé votre ressource, déployez un modèle Claude pour le rendre disponible pour les appels API. Ces étapes décrivent le nouveau portail Foundry (le bouton New Foundry est activé) :

1. Connectez-vous au portail Foundry. Depuis la page d'accueil du portail, sélectionnez Discover dans la navigation en haut à droite, puis Models dans le volet de gauche pour ouvrir le catalogue de modèles.
2. Recherchez et sélectionnez un modèle Claude (par exemple, claude-opus-5). Chaque modèle apparaît une seule fois dans le catalogue, quel que soit le nombre d'options d'hébergement qu'il prend en charge.
3. Sur la fiche du modèle, sélectionnez Deploy, puis Custom settings pour ouvrir le volet des paramètres de déploiement. Si vous choisissez plutôt Default settings, le déploiement est automatiquement configuré comme Hébergé sur Azure pour les modèles disponibles dans les deux options d'hébergement.
4. Lors de votre premier déploiement Claude, consultez les conditions de l'Azure Marketplace, sélectionnez un secteur d'activité, puis sélectionnez Agree and Proceed pour accepter les conditions et vous abonner à l'offre Azure Marketplace.
5. Configurez le déploiement :
   • Deployment name : Par défaut, il s'agit de l'ID du modèle, mais vous pouvez le personnaliser (par exemple, my-claude-deployment). Le nom du déploiement ne peut pas être modifié après sa création.
   • Region scope : Sélectionnez Global ou, pour les modèles hébergés sur Azure, Data Zone. Sélectionner Data Zone crée un déploiement US Data Zone Standard, qui maintient l'inférence aux États-Unis et équivaut à définir inference_geo: "us" sur l'API Claude.
   • Model version : Développez Model version settings et sélectionnez une version dans le menu déroulant Model version. Chaque option d'hébergement est répertoriée comme une version de modèle distincte, étiquetée avec son option d'hébergement (par exemple, version 1 pour Hébergé sur Anthropic, version 2 pour Hébergé sur Azure).
6. Sélectionnez Deploy et attendez la fin du provisionnement.
7. Une fois le déploiement effectué, sélectionnez Build dans la navigation en haut à droite, puis Models dans le volet de gauche, et ouvrez votre déploiement. L'onglet Details affiche le Target URI (l'URL de votre point de terminaison) et la Key (votre clé API).

Si le bouton New Foundry est désactivé, vous êtes dans la disposition classique du portail. Dans ce cas, ouvrez Model catalog dans le volet de gauche pour rechercher et déployer un modèle, et ouvrez Models + endpoints (sous My assets) pour afficher vos déploiements et les détails de leurs points de terminaison.



Authentification

Claude dans Microsoft Foundry prend en charge deux méthodes d'authentification : les clés API et les jetons Entra ID. Les deux méthodes utilisent des points de terminaison hébergés sur Azure au format https://{resource}.services.ai.azure.com/anthropic/v1/*.



Authentification par clé API

Après avoir provisionné votre ressource Foundry Claude, vous pouvez obtenir une clé API depuis le portail Foundry :

1. Dans le portail Foundry, sélectionnez Build dans la navigation en haut à droite, puis Models dans le volet de gauche.
2. Ouvrez votre déploiement Claude et sélectionnez l'onglet Details.
3. Copiez la valeur Key (et notez le Target URI pour votre point de terminaison).
4. Utilisez l'en-tête api-key ou x-api-key dans vos requêtes, ou fournissez-la au SDK.

Les SDK Foundry nécessitent une clé API et soit un nom de ressource, soit une URL de base. Les SDK C#, Java, PHP, Python et TypeScript lisent automatiquement ces valeurs à partir des variables d'environnement suivantes si elles sont définies :

• ANTHROPIC_FOUNDRY_API_KEY - Votre clé API
• ANTHROPIC_FOUNDRY_RESOURCE - Le nom de votre ressource (par exemple, example-resource)
• ANTHROPIC_FOUNDRY_BASE_URL - Alternative au nom de ressource : l'URL de base complète (par exemple, https://example-resource.services.ai.azure.com/anthropic/). Le SDK C# ne lit pas cette variable : il construit toujours l'URL de base à partir du nom de la ressource.

Exemple utilisant une clé API :

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource="example-resource",  # your resource name
)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)



Authentification Microsoft Entra

L'authentification Entra ID vous permet de gérer les accès avec Azure RBAC, de vous intégrer à la gestion des identités de votre organisation et d'éviter de manipuler manuellement les clés API. Pour utiliser les jetons Entra ID :

1. Activez l'authentification Microsoft Entra ID pour votre ressource Foundry.
2. Obtenez un jeton d'accès auprès d'Entra ID.
3. Utilisez le jeton dans l'en-tête Authorization: Bearer {TOKEN}.

Exemple utilisant Entra ID :

from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Obtenir le jeton Microsoft Entra ID via le modèle de fournisseur de jetons
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# Créer le client avec l'authentification Entra ID
client = AnthropicFoundry(
    resource="example-resource",  # your resource name
    azure_ad_token_provider=token_provider,  # Use token provider for Entra ID auth
)

# Effectuer la requête
message = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)



Identifiants de corrélation des requêtes

Foundry inclut des identifiants de requête dans les en-têtes de réponse HTTP pour le débogage et le traçage. Lorsque vous contactez le support, fournissez à la fois les valeurs request-id et apim-request-id (Azure API Management) pour aider les équipes à localiser et examiner rapidement votre requête dans les systèmes Anthropic et Azure.



Prise en charge des fonctionnalités

Claude dans Microsoft Foundry prend en charge la plupart des fonctionnalités de Claude. Vous trouverez toutes les fonctionnalités actuellement prises en charge dans la vue d'ensemble des fonctionnalités.



Fenêtre de contexte

Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 et Claude Sonnet 4.6 disposent d'une fenêtre de contexte de 1 million de tokens sur Microsoft Foundry. Les autres modèles Claude, y compris Claude Sonnet 4.5, disposent d'une fenêtre de contexte de 200 000 tokens.



Fonctionnalités Claude non prises en charge pour Claude dans Microsoft Foundry

• Admin API
• Outil Advisor
• Claude Managed Agents
• Compliance API
• Models API
• Message Batches API
• Fallback côté serveur (le paramètre fallbacks ; utilisez plutôt le modèle de fallback côté client)



Fonctionnalités supplémentaires non prises en charge lors de l'hébergement sur Azure

Les fonctionnalités suivantes sont disponibles pour les déploiements hébergés sur Anthropic mais ne sont pas prises en charge pour les déploiements hébergés sur Azure :

• Sorties structurées
• Outils côté serveur (recherche web, récupération web, exécution de code et recherche d'outils)
• Connecteur MCP
• Agent Skills
• Appel d'outils programmatique
• Files API

Les requêtes qui utilisent ces fonctionnalités sur un déploiement hébergé sur Azure renvoient une erreur 400 Bad Request par conception. Claude Code détecte les déploiements hébergés sur Azure et adapte automatiquement son ensemble de fonctionnalités.



Réponses de l'API

Les réponses de l'API de Claude dans Microsoft Foundry suivent le format de réponse standard de l'API Claude. Cela inclut l'objet usage dans les corps de réponse, qui fournit des informations détaillées sur la consommation de tokens pour vos requêtes. L'objet usage est cohérent sur toutes les plateformes (API Claude, Amazon Bedrock, Claude Platform sur AWS, Foundry et Google Cloud).

Pour plus de détails sur les en-têtes de réponse spécifiques à Foundry, consultez Identifiants de corrélation des requêtes.



ID de modèles et déploiements de l'API

Les termes du cycle de vie (Déprécié, Retiré) sont définis dans Dépréciations de modèles. Microsoft Foundry suit le calendrier du cycle de vie de l'API Claude.

Les modèles Claude suivants sont disponibles via Foundry :

Par défaut, les noms de déploiement correspondent aux ID de modèles indiqués dans le tableau précédent. Cependant, vous pouvez créer des déploiements personnalisés avec des noms différents dans le portail Foundry pour gérer différentes configurations, versions ou limites de débit. Utilisez le nom du déploiement (pas nécessairement l'ID du modèle) dans vos requêtes API.



Facturation

Claude dans Microsoft Foundry est facturé via l'Azure Marketplace. L'utilisation est libellée en Claude Consumption Units (CCU), mesurée toutes les heures et facturée mensuellement à terme échu sur votre facture Azure. Les CCU ne sont pas des crédits prépayés. Il n'y a ni solde ni engagement de CCU.

Pour le prix des CCU, les mécanismes de conversion et les tarifs de tokens par modèle, consultez la tarification de Claude dans Microsoft Foundry.



Migration entre les options d'hébergement

Pour déplacer un déploiement existant d'une option d'hébergement à l'autre :

1. Créez un nouveau déploiement de l'autre version d'hébergement du modèle (Hébergé sur Azure ou Hébergé sur Anthropic). Cela peut être dans la même ressource Foundry ou dans une nouvelle.
2. Mettez à jour votre application pour passer le nouveau nom de déploiement dans le paramètre model.
3. Supprimez l'ancien déploiement une fois le trafic transféré.

Si le nouveau déploiement se trouve dans la même ressource Foundry, l'URL de votre point de terminaison et votre authentification restent inchangées. Si vous avez créé une nouvelle ressource, mettez à jour le point de terminaison et les identifiants de votre application pour pointer vers celle-ci.



Surveillance et journalisation

Azure fournit la surveillance et la journalisation de votre utilisation de Claude via les modèles standard d'Azure :

• Azure Monitor : Suivez l'utilisation de l'API, la latence et les taux d'erreur
• Azure Log Analytics : Interrogez et analysez les journaux de requêtes/réponses
• Cost Management : Surveillez et prévoyez les coûts associés à l'utilisation de Claude

Anthropic recommande de journaliser votre activité sur une base glissante d'au moins 30 jours afin de comprendre les modèles d'utilisation et d'examiner tout problème potentiel.



Dépannage



Erreurs d'authentification

Erreur : 401 Unauthorized ou Invalid API key

• Solution : Vérifiez que votre clé API est correcte. Vous pouvez la trouver dans le portail Foundry sur l'onglet Details de votre déploiement (sous Build > Models).
• Solution : Si vous utilisez Microsoft Entra ID, assurez-vous que votre jeton d'accès est valide et n'a pas expiré. Les jetons expirent généralement après 1 heure.

Erreur : 403 Forbidden

• Solution : Votre compte Azure ne dispose peut-être pas des autorisations nécessaires. Assurez-vous que le rôle Azure RBAC approprié vous est attribué (par exemple, Foundry User (anciennement Azure AI User) ou Cognitive Services User).



Limitation de débit

Erreur : 429 Too Many Requests

• Solution : Vous avez dépassé votre limite de débit. Implémentez une logique de backoff exponentiel et de nouvelle tentative dans votre application.
• Solution : Envisagez de demander des augmentations de limite de débit via le portail Azure ou le support Azure.



En-têtes de limite de débit

Foundry n'inclut pas les en-têtes de limite de débit standard d'Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining et anthropic-ratelimit-output-tokens-reset) dans les réponses. Gérez plutôt la limitation de débit via les outils de surveillance d'Azure.



Erreurs de modèle et de déploiement

Erreur : Model not found ou Deployment not found

• Solution : Vérifiez que vous utilisez le bon nom de déploiement. Si vous n'avez pas créé de déploiement personnalisé, utilisez l'ID de modèle par défaut (par exemple, claude-opus-5).
• Solution : Assurez-vous que le modèle/déploiement est disponible dans votre région Azure.

Erreur : Invalid model parameter

• Solution : Le paramètre model doit contenir le nom de votre déploiement, qui peut être personnalisé dans le portail Foundry. Vérifiez que le déploiement existe et est correctement configuré.



Étapes suivantes



Ressources supplémentaires