Configurer Claude Code pour Microsoft Foundry

Anthropic’s Claude Code est un outil de codage agentique qui lit votre codebase, modifie des fichiers, exécute des commandes et s’intègre à vos outils de développement. Il est disponible en tant qu’outil CLI et extension VS Code. Lorsque vous configurez Claude Code avec Microsoft Foundry, vous exécutez l’agent de codage sur l’infrastructure Azure tout en conservant vos données à l’intérieur de votre limite de conformité. Cette configuration fournit une sécurité de niveau entreprise, une mise en réseau privée, un contrôle d’accès en fonction du rôle et une gestion des coûts.

Dans cet article, vous allez apprendre à :

• Installer et configurer Claude Code CLI pour Microsoft Foundry
• Configurer l’extension Claude Code VS Code
• S’authentifier avec les clés d’API ou d’ID Microsoft Entra
• Créer des fichiers de contexte de projet pour une meilleure assistance IA
• Exécuter Claude Code dans GitHub Actions pour l’automatisation CI/CD

Pour utiliser des modèles Claude dans Microsoft Foundry, vous devez disposer d’un abonnement Azure payant avec un compte de facturation dans un pays ou une région où Anthropic propose les modèles à acheter. Pour obtenir la liste des erreurs courantes liées à l’abonnement, consultez les messages d’erreur courants et les solutions. Les types d’abonnement suivants ne sont actuellement pas pris en charge :

• Comptes d’entreprise situés en Corée du Sud
• Abonnements du fournisseur de solutions cloud
• Abonnements Azure qui n'ont pas de mode de facturation 'paiement à l'utilisation' actif (par exemple, étudiant, essai gratuit ou comptes basés sur des crédits de démarrage)
• Abonnements parrainés qui utilisent uniquement des crédits Azure. Remarque : Si vous avez un compte avec une carte de crédit enregistrée, celle-ci sera facturée au lieu des crédits Azure.

Pour obtenir la liste des régions prises en charge, consultez les emplacements géographiques pris en charge. Notez que la « stratégie de régions prises en charge » d’Anthropic peut s’appliquer à la disponibilité dans votre région, vérifiez les régions prises en charge pour plus d’informations.

Conditions préalables

• Un abonnement Azure avec un mode de paiement valide. Si vous n’avez pas d’abonnement Azure, créez un compte Azure payant.
• Accès à Microsoft Foundry avec les autorisations Contributeur pour créer et gérer des ressources.
• Un projet Microsoft Foundry créé dans l’une des régions prises en charge pour les déploiements de modèles Claude.
• Rôle Contributeur ou Propriétaire sur votre groupe de ressources Foundry. Pour plus d’informations, consultez Rôles RBAC Azure.
• Accès à la Place de marché Azure pour déployer des modèles Foundry à partir de partenaires.
• Pour Windows, utilisez Git Bash (inclus avec Git pour Windows) ou installez WSL2 (recommandé pour une compatibilité Linux complète). Consultez Installer WSL.
• (Facultatif) Azure CLI installé et configuré avec az login pour l'authentification Microsoft Entra ID.

Configuration requise

Déployer un modèle Claude dans Foundry

Avant de configurer Claude Code, déployez les modèles Claude Disponibles dont Claude Code a besoin. La plupart des modèles Claude prennent en charge le déploiement standard global. Pour plus d’informations sur les types de déploiement pris en charge, consultez les modèles Claude dans Microsoft Foundry.

Claude Code utilise différents modèles pour différentes tâches :

Déployer un modèle directement dans Foundry

Pour déployer un modèle :

1. Suivez les instructions de Deploy and use Claude models in Microsoft Foundry pour déployer un modèle Claude, tel que Opus 4.6.

2. Après le déploiement, sélectionnez l’onglet Détails du déploiement et notez votre URI et votre clécibles. Vous avez besoin de ces valeurs pour la configuration.

Alternative : Déployer un modèle à l’aide du routeur de modèle

Le routeur de modèles est un modèle Foundry qui achemine intelligemment chaque invite vers le meilleur modèle sous-jacent en fonction de la complexité des requêtes, du coût et des performances. La version 2025-11-18 du routeur de modèles prend en charge les modèles Claude (claude-haiku-4-5, claude-sonnet-4-5, claude-opus-4-6, claude-opus-4-7et claude-opus-4-8), ainsi que d’autres modèles Foundry.

Avantages pour les utilisateurs de Claude Code :

• Sélection automatique du modèle : les invites simples routent vers des modèles plus rapides et moins chers. Les tâches de codage complexes sont routées vers des modèles plus capables.
• Optimisation des coûts : utilisez des profils de routage pour équilibrer la qualité et le coût tout en conservant les performances de référence.
• Point de terminaison unique : un déploiement gère toutes les décisions de routage dans votre flotte de modèles.

Pour utiliser le routeur de modèles avec Claude Code, déployez d’abord les modèles Claude pris en charge, puis déployez le routeur de modèles et activez-les via la configuration du sous-ensemble de modèles.

Installer Claude Code CLI

Installez l’interface CLI Claude Code pour travailler avec Claude Code directement dans votre terminal. Vérifiez ensuite que claude est dans votre PATH en exécutant claude --version.

Installation native (recommandé)

Les installations natives sont automatiquement mises à jour en arrière-plan pour vous tenir à jour sur la dernière version.

curl -fsSL https://claude.ai/install.sh | bash
claude --version # verify installation

irm https://claude.ai/install.ps1 | iex
claude --version # verify installation

Installation avec Homebrew

Si vous utilisez macOS :

brew install --cask claude-code
claude --version # verify installation

Les installations homebrew ne sont pas mises à jour automatiquement. Exécutez brew upgrade claude-code régulièrement pour obtenir les dernières fonctionnalités et correctifs de sécurité.

Dépannage de la localisation d'installation

Si la claude --version commande est introuvable, ajoutez l’emplacement d’installation à votre chemin d’accès comme suit :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Pour plus d’options d’installation, consultez la documentation de Claude Code.

Configurer Claude Code pour Foundry

Vous utilisez votre nom de ressource Foundry ou l’URL de base pour configurer Claude Code pour Foundry.

Pour trouver le nom de votre ressource Foundry à partir du portail Foundry :

1. Accédez au volet de navigation supérieur gauche, puis sélectionnez Gérer>Project détails.
2. Copiez la valeur de la ressource parente à partir de la page détails du projet .

Pour rechercher votre URL de base à partir du portail Foundry :

1. Accédez à la page d’accueil du portail Foundry
2. Recherchez le point de terminaison Project et copiez la partie de l’URL qui vient avant /api/projects/<your-project-name>. Votre URL de base est de la forme https://<your-resource-name>.services.ai.azure.com. Claude Code ajoute automatiquement /anthropic à cette URL lorsque vous utilisez ANTHROPIC_FOUNDRY_RESOURCE.

Définissez des variables d’environnement pour connecter Claude Code à votre déploiement Microsoft Foundry :

# Required: Enable Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure resource name (replace <your-resource-name> with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE=<your-resource-name>
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://<your-resource-name>.services.ai.azure.com

# Optional: Specify model deployment names if different from defaults
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"

# Required: Enable Foundry integration
$env:CLAUDE_CODE_USE_FOUNDRY = "1"

# Azure resource name (replace <your-resource-name> with your resource name)
$env:ANTHROPIC_FOUNDRY_RESOURCE = "<your-resource-name>"
# Or provide the full base URL:
# $env:ANTHROPIC_FOUNDRY_BASE_URL = "https://<your-resource-name>.services.ai.azure.com"

# Optional: Specify model deployment names if different from defaults
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-4-6"

Le tableau suivant décrit chaque variable :

Pour conserver ces variables entre les sessions de terminal, ajoutez-les à votre profil shell (par ~/.bashrc~/.zshrcexemple).

S’authentifier auprès de Foundry

Claude Code prend en charge deux méthodes d’authentification pour Microsoft Foundry :

• ID Microsoft Entra (recommandé) : utilise vos informations d’identification Azure CLI. Idéal pour les environnements d’entreprise, l’accès aux équipes et les pipelines CI/CD dans lesquels vous souhaitez centraliser la gestion des identités sans gérer les secrets.
• Clé API : utilise une clé API de projet à partir du portail Foundry. Idéal pour les tests rapides ou les environnements où Azure CLI n’est pas disponible.

Option A : MICROSOFT Entra ID (recommandé)

L’authentification Microsoft Entra ID utilise automatiquement vos informations d’identification Azure CLI. Exécutez az login avant de commencer Claude Code :

1. Connectez-vous avec Azure CLI :

   az login
   

   Conseil

   Si votre ressource Foundry se trouve dans un locataire différent de celui de votre locataire Azure CLI par défaut, spécifiez l’ID de locataire :

   az login --tenant <tenant-id>
   

2. Vérifiez que votre connexion cible l’abonnement approprié :

   az account show
   

Lorsque vous utilisez Microsoft Foundry, les commandes /login et /logout à l’intérieur de Claude Code sont désactivées. L’authentification est gérée via vos informations d’identification Azure.

Claude Code détecte votre session Azure CLI et l’utilise pour l’authentification sans configuration supplémentaire.

Option B : clé API

Si vous préférez l’authentification par clé API, définissez la clé dans vos variables d’environnement.

1. Dans le portail Microsoft Foundry, ouvrez votre ressource.
2. Dans la page d’accueil , recherchez le champ clé API Project .
3. Sélectionnez Copier la clé API Project pour copier la valeur. Il s’agit de la clé que vous utilisez pour la variable d’environnement ANTHROPIC_FOUNDRY_API_KEY .
4. Définissez la variable d’environnement dans votre terminal :

export ANTHROPIC_FOUNDRY_API_KEY="<your-foundry-api-key>"

$env:ANTHROPIC_FOUNDRY_API_KEY = "<your-foundry-api-key>"

Configurer l’extension VS Code

L’extension VS Code de Claude Code fournit une interface graphique native pour Claude Code directement dans votre IDE.

1. Installez l’extension à partir de la Place de marché VS Code.

2. Ouvrez les paramètres VS Code (Ctrl+ouCmd+), puis recherchez Claude Code : Variables d’environnement.

3. Sélectionnez Modifier dans settings.json et ajoutez la configuration suivante :

     {
       "Claude Code: Environment Variables": [
         { "name": "CLAUDE_CODE_USE_FOUNDRY", "value": "1" },
         { "name": "ANTHROPIC_FOUNDRY_RESOURCE", "value": "<your-resource-name>" },
         { "name": "ANTHROPIC_FOUNDRY_API_KEY", "value": "<optional-for-non-entra-auth>" }
       ]
     }
   

4. Sélectionnez l’icône Spark dans la barre latérale pour ouvrir le panneau Claude Code.

5. Claude Code s’authentifie à l’aide de vos informations d’identification Azure. Exécutez d’abord az login si vous utilisez l’authentification Microsoft Entra ID.

L’extension prend en charge le mode d'acceptation des modifications automatiquement, le mode planification, la réflexion étendue et la gestion des fichiers avec @mentions, tout en effectuant le routage via votre déploiement Microsoft Foundry.

Valider la configuration

Vérifiez que Claude Code est correctement configuré pour utiliser Microsoft Foundry.

1. Ouvrez un terminal et accédez à un répertoire de projet :

   cd your-project
   

2. Lancer Claude Code :

   claude
   

   Claude Code est défini par défaut sur le modèle Sonnet pour le codage général. Si vous n’avez pas encore déployé les trois modèles, vous pouvez spécifier un modèle déployé directement :

   claude --model claude-opus-4-6
   

3. Exécutez la /status commande :

   > /status
   

   La sortie doit ressembler à l’exemple suivant. Le format exact peut varier en fonction de votre version de Claude Code.

   ─────────────────────────────────────
   Version: 2.1.52
   Session name: /rename to add a name
   Session ID: <your-session-ID>
   cwd: C:\WINDOWS\system32
   API provider: Microsoft Foundry
   Microsoft Foundry Resource: <your-resource-name>
   Model: Default (claude-sonnet-4-6)
   Memory:
   Setting sources:
   ─────────────────────────────────────
   

   Confirmez ce qui suit dans la sortie d’état :

   Champ	Valeur attendue
   Fournisseur d’API	Microsoft Foundry
   Ressource Fonderie	Nom de votre ressource Foundry
   Modèle	Votre modèle déployé (par exemple, claude-sonnet-4-6)

4. Envoyez une invite de test telle que « Résumer la structure de ce projet ».

5. Vérifiez que Claude Code répond avec une analyse de votre projet. Une connexion réussie affiche l’invite interactive de Claude Code sans erreur d’authentification.

   Si Claude Code affiche une erreur telle que « Échec de l’obtention du jeton » ou « Le modèle n’est pas disponible », consultez la section Résolution des problèmes .

Créer un contexte de projet avec CLAUDE.md

Vous pouvez donner des instructions et des conseils supplémentaires à Claude Code à l’aide de CLAUDE.md fichiers. Claude Code recherche CLAUDE.md les fichiers dans les emplacements suivants et les fusionne de haut en bas (c'est-à-dire que les fichiers se chargent dans l'ordre, les fichiers ultérieurs remplaçant les fichiers précédents), en lui donnant un contexte sur vos préférences personnelles, les détails spécifiques au projet et la tâche actuelle :

1. ~/.claude/CLAUDE.md – Valeurs globales par défaut dans tous les projets
2. ./CLAUDE.md – Paramètres racine du référentiel
3. ./current-dir/CLAUDE.md – Spécificités du répertoire actuel

Claude Code prend également en charge les règles de projet (.claude/rules/*.md) et la mémoire locale (CLAUDE.local.md) pour un contrôle plus précis. Pour obtenir la hiérarchie de mémoire complète, consultez la documentation sur la mémoire de Claude Code.

L’exemple suivant montre un CLAUDE.md fichier pour un projet Microsoft Agent Framework . Créez un fichier similaire à la racine de votre projet pour aider Claude Code à comprendre votre codebase :

# Project: Customer Service Agent

## Overview
Multi-agent system using Microsoft Agent Framework with Foundry Agent Service.

## Tech Stack
- Python 3.11+
- agent-framework (Microsoft Agent Framework Python SDK)
- Microsoft Foundry for hosted agents
- MCP tools for enterprise data access

## Architecture
- `src/agents/` - Agent definitions (triage, specialist, escalation)
- `src/tools/` - MCP tool implementations
- `src/workflows/` - Multi-agent orchestration
- `tests/` - pytest with async fixtures

## Commands
```bash
# Run locally
python -m src.main

# Test
pytest tests/ -v

# Deploy to Foundry Agent Service
az ai agent deploy --config deploy.yaml
```

## Code Patterns
Use `AzureAIAgentClient` with `AzureCliCredential`:
```python
async with AzureAIAgentClient(async_credential=AzureCliCredential()) as client:
    agent = client.create_agent(instructions="...", tools=[...])
```

## Current Sprint
- Implementing RAG grounding with Foundry IQ
- Adding Fabric connector for sales data

Après avoir créé un CLAUDE.md fichier, démarrez Claude Code dans votre répertoire de projet pour charger le contexte :

# Start Claude Code in your project
cd your-project
claude

# Or run a one-off command
claude "explain the agent orchestration in src/workflows/"

Configurer Azure RBAC

Pour accorder aux membres de l’équipe l’accès à vos modèles Claude hébergés par Foundry, attribuez l’un des rôles intégrés suivants :

Le rôle Utilisateur Foundry est le rôle natif Foundry recommandé. Le rôle d’utilisateur Cognitive Services est un rôle hérité qui accorde également des autorisations d’appel de modèle au niveau de la ressource Azure.

Ces rôles incluent toutes les autorisations requises pour exécuter Claude Code avec Foundry.

Pour un accès plus restrictif, créez un rôle personnalisé limité aux actions de données spécifiques dont votre équipe a besoin. Pour obtenir des conseils sur la définition de rôles personnalisés, consultez contrôle d’accès en fonction du rôle pour Microsoft Foundry.

Exécuter Claude Code dans GitHub Actions

Claude Code s’intègre à GitHub Actions pour l’automatisation CI/CD. Stockez votre clé API dans le magasin de secrets du référentiel avant d’utiliser ces flux de travail.

Générer des tests pour les pull requests

Créez un flux de travail qui génère des tests lorsque les fichiers d’agent ou d’outil changent :

name: Generate Agent Tests
on:
  pull_request:
    paths:
      - 'src/agents/**'
      - 'src/tools/**'

jobs:
  generate-tests:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      
      - name: Run Claude Code
        uses: anthropics/claude-code-action@v1
        with:
          prompt: |
            Review the changed agent files and generate pytest tests.
            Use async fixtures for AIProjectClient mocking.
            Follow patterns in tests/conftest.py.
          allowed_tools: "edit,write,bash"
        env:
          CLAUDE_CODE_USE_FOUNDRY: "1"
          ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
          ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}

Déclencher une révision de demande de tirage avec @claude

Créez un workflow qui répond aux mentions @claude dans les commentaires des demandes de tirage :

name: Claude PR Assistant
on:
  issue_comment:
    types: [created]

jobs:
  respond:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      
      - name: Claude Review
        uses: anthropics/claude-code-action@v1
        with:
          prompt: ${{ github.event.comment.body }}
          context: "PR #${{ github.event.issue.number }}"
        env:
          CLAUDE_CODE_USE_FOUNDRY: "1"
          ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
          ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}

Surveiller l’utilisation

Surveillez l’utilisation de Claude Code dans le portail Foundry :

1. Accédez à Microsoft Foundry et ouvrez votre projet.

2. Accédez à Utiliser pour afficher les métriques d’utilisation :

   • Consommation de jetons par modèle
   • Latence des requêtes
   • Taux d’erreur et déclenchements de limite de débit

Pour définir des limites de jeton par requête, configurez la variable d’environnement ANTHROPIC_MAX_TOKENS :

export ANTHROPIC_MAX_TOKENS=100000

$env:ANTHROPIC_MAX_TOKENS = "100000"

Pour connaître les options de configuration qui contrôlent l’utilisation et le coût des jetons, telles que les limites de jeton spécifiques au modèle, consultez la documentation de configuration de Claude Code.

Nettoyer les ressources

Si vous n’avez plus besoin des déploiements de modèles Claude, supprimez-les pour libérer des emplacements de déploiement et un quota dans votre ressource. Les modèles Claude utilisent des déploiements Global Standard avec facturation par jeton, de sorte que les déploiements inactifs n’entraînent pas de frais. Toutefois, chaque déploiement compte par rapport à votre limite de déploiement de 32 par ressource.

Supprimer des déploiements dans le portail Foundry

Utilisez l’un des chemins de navigation suivants :

• Sélectionnez Exploitation dans la navigation supérieure, puis sélectionnez Ressources>Modèles dans la navigation de gauche. Sélectionnez le déploiement à supprimer, puis sélectionnez Supprimer.
• Sélectionnez Générer dans le volet de navigation supérieur, puis sélectionnez Modèles dans le volet de navigation gauche. Sélectionnez le nom du déploiement pour ouvrir sa page de détails, sélectionnez l’onglet Détails , puis sélectionnez Supprimer dans le volet supérieur.

Supprimer des déploiements avec Azure CLI

Exécutez la commande az cognitiveservices account deployment delete pour chaque déploiement :

az cognitiveservices account deployment delete \
  --deployment-name <deployment-name> \
  --name <resource-name> \
  --resource-group <resource-group-name>

Remplacez <deployment-name> par le nom de déploiement du modèle (par exemple claude-sonnet-4-6), <resource-name> par le nom de votre ressource Foundry et <resource-group-name> par le groupe de ressources qui contient votre ressource Foundry.

Dépannage

Contenu connexe

• Modèles Claude dans Microsoft Foundry
• Déployer et utiliser des modèles Claude dans Microsoft Foundry
• Données, confidentialité et sécurité pour les modèles Claude
• Quotas et limites des modèles Microsoft Foundry
• Surveiller l’utilisation et les coûts du modèle
• Configurer Claude Desktop pour Microsoft Foundry
• Claude dans Microsoft Foundry (docs Anthropic)
• Documentation Claude Code (documentation anthropice)
• Claude Code sur Microsoft Foundry (documentation d'Anthropic)