Claude Code configureren voor Microsoft Foundry

Anthropic's Claude Code is een agentisch coderingsprogramma dat uw codebasis leest, bestanden bewerkt, opdrachten uitvoert en integreert met uw ontwikkelhulpprogramma's. Het is beschikbaar als een CLI-hulpprogramma en VS Code-extensie. Wanneer u Claude Code configureert met Microsoft Foundry, voert u de coderingsagent uit op Azure infrastructuur terwijl u uw gegevens binnen uw nalevingsgrens houdt. Deze configuratie biedt beveiliging op bedrijfsniveau, privénetwerken, op rollen gebaseerd toegangsbeheer en kostenbeheer.

In dit artikel leert u het volgende:

• Claude Code CLI installeren en configureren voor Microsoft Foundry
• De extensie Claude Code VS Code instellen
• Verifiëren met Microsoft Entra ID- of API-sleutels
• Projectcontextbestanden maken voor betere AI-hulp
• Claude Code uitvoeren in GitHub Actions voor CI/CD-automatisering

Als u Claude-modellen in Microsoft Foundry wilt gebruiken, moet u een betaald Azure abonnement hebben met een factureringsrekening in een land of regio waar Anthropic de modellen voor aankoop aanbiedt. Zie Veelvoorkomende foutberichten en oplossingen voor een lijst met veelvoorkomende fouten met betrekking tot abonnementen. De volgende abonnementstypen worden momenteel niet ondersteund:

• Ondernemingsaccounts gevestigd in Zuid-Korea
• Cloud Solution Provider abonnementen
• Azure abonnementen die geen actieve factureringsmethode voor betalen per gebruik hebben (bijvoorbeeld accounts voor studenten, gratis proefversie of op opstarttegoed gebaseerde accounts)
• Gesponsorde abonnementen die alleen Azure-krediet gebruiken. Note: Als u een account met een creditcard in het bestand hebt, wordt de creditcard in rekening gebracht in plaats van Azure Tegoed.

Zie ondersteunde geografische locaties voor een lijst met ondersteunde regio's. Houd er rekening mee dat Anthropic beleid voor ondersteunde regio's mogelijk van toepassing is op de beschikbaarheid in uw regio, controleert u ondersteunde regio's voor meer informatie.

Voorwaarden

• Een Azure-abonnement met een geldige betalingswijze. Als u geen Azure-abonnement hebt, maakt u een paid Azure-account.
• Toegang tot Microsoft Foundry met inzendermachtigingen voor het maken en beheren van resources.
• Een Microsoft Foundry-project dat is gemaakt in een van de ondersteunde regio's voor Claude-modelimplementaties.
• De rol Bijdrager of Eigenaar in uw Foundry-resourcegroep. Zie Azure RBAC-rollen voor meer informatie.
• Toegang tot Azure Marketplace om Foundry-modellen van partners te implementeren.
• Voor Windows gebruikt u Git Bash (opgenomen in Git voor Windows) of installeert u WSL2 (aanbevolen voor volledige Linux-compatibiliteit). Zie WSL installeren.
• (Optioneel) Azure CLI geïnstalleerd en az login voltooid voor Microsoft Entra ID-authenticatie.

Systeemvereisten

Een Claude-model implementeren in Foundry

Voordat u Claude Code configureert, implementeert u de beschikbare Claude-modellen die Claude Code nodig heeft. De meeste Claude-modellen ondersteunen wereldwijde standaardimplementatie. Zie Claude-modellen in Microsoft Foundry voor meer informatie over ondersteunde implementatietypen.

Claude Code gebruikt verschillende modellen voor verschillende taken:

Model rechtstreeks implementeren in Foundry

Een model implementeren:

1. Volg de instructies in Claude-modellen implementeren en gebruiken in Microsoft Foundry om een Claude-model te implementeren, zoals Opus 4.6.

2. Selecteer na de implementatie het tabblad Details van de implementatie en noteer uw doel-URI en -sleutel. U hebt deze waarden nodig voor configuratie.

Alternatief: Model implementeren met modelrouter

ModelRouter is een Foundry-model dat elke prompt op intelligente wijze doorstuurt naar het beste onderliggende model op basis van querycomplexiteit, kosten en prestaties. Model Router-versie 2025-11-18 ondersteunt selecte Claude-modellen (claude-haiku-4-5, claude-sonnet-4-5, claude-opus-4-6, claude-opus-4-7en claude-opus-4-8), naast andere Foundry-modellen.

Voordelen voor Claude Code-gebruikers:

• Automatische modelselectie: Eenvoudige prompts sturen naar snellere, goedkopere modellen. Complexe coderingstaken worden doorgestuurd naar capabelere modellen.
• Kostenoptimalisatie: gebruik routeringsprofielen om de kwaliteit en kosten te verdelen terwijl de basislijnprestaties behouden blijven.
• Eén eindpunt: Één implementatie verwerkt alle routeringsbeslissingen in uw modelpark.

Als u Model Router wilt gebruiken met Claude Code, implementeert u eerst de ondersteunde Claude-modellen, implementeert u vervolgens ModelRouter en schakelt u deze in via de modelsubsetconfiguratie.

Claude Code CLI installeren

Installeer de Claude Code CLI om rechtstreeks in uw terminal met Claude Code te werken. Controleer vervolgens of dit claude zich in uw PATH bevindt door uit te voeren claude --version.

Systeemeigen installatie (aanbevolen)

Systeemeigen installaties worden automatisch op de achtergrond bijgewerkt om u op de nieuwste versie te houden.

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

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

Installatie met Homebrew

Als u macOS gebruikt:

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

Homebrew-installaties worden niet automatisch bijgewerkt. Voer brew upgrade claude-code regelmatig uit om de nieuwste functies en beveiligingsoplossingen te verkrijgen.

Problemen met de installatielocatie oplossen

Als de opdracht niet wordt gevonden, voegt u de claude --version installatielocatie als volgt toe aan uw PATH:

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

Zie de documentatie van Claude Code voor meer installatieopties.

Claude Code configureren voor Foundry

U gebruikt de naam van uw Foundry-resource of de basis-URL om Claude Code voor Foundry te configureren.

Om de naam van je Foundry-resource in de Foundry-portal te vinden:

1. Ga naar het navigatiegedeelte linksboven en selecteer Beheren>Project details.
2. Kopieer de waarde van Parent resource van de pagina Project details.

Ga als volgende te werk om uw basis-URL te vinden via de Foundry-portal:

1. Ga naar de startpagina van de Foundry-portal
2. Zoek het Project-eindpunt en kopieer het deel van de URL dat vóór /api/projects/<your-project-name> wordt geleverd. Uw basis-URL is van het formulier https://<your-resource-name>.services.ai.azure.com. Claude Code voegt /anthropic automatisch aan deze URL toe wanneer u ANTHROPIC_FOUNDRY_RESOURCE gebruikt.

Stel omgevingsvariabelen in om Claude Code te verbinden met uw Microsoft Foundry-implementatie:

# 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"

In de volgende tabel wordt elke variabele beschreven:

Als u deze variabelen tussen terminalsessies wilt behouden, voegt u deze toe aan uw shell-profiel (zoals ~/.bashrc of ~/.zshrc).

Verifiëren met Foundry

Claude Code ondersteunt twee verificatiemethoden voor Microsoft Foundry:

• Microsoft Entra ID (aanbevolen): gebruikt uw Azure CLI-referenties. Het meest geschikt voor bedrijfsomgevingen, teamtoegang en CI/CD-pijplijnen waar u gecentraliseerd identiteitsbeheer wilt uitvoeren zonder geheimen te beheren.
• API-sleutel: maakt gebruik van een project-API-sleutel vanuit de Foundry-portal. Het meest geschikt voor snelle tests of omgevingen waar de Azure CLI niet beschikbaar is.

Optie A: Microsoft Entra ID (aanbevolen)

De Microsoft Entra ID-authenticatie gebruikt automatisch uw Azure CLI-referenties. Voer az login uit voordat u Claude Code start.

1. Meld u aan met de Azure CLI:

   az login
   

   Tip

   Als uw Foundry-resource zich in een andere tenant bevindt dan uw standaard-Azure CLI tenant, geeft u de tenant-id op:

   az login --tenant <tenant-id>
   

2. Controleer of uw aanmelding is gericht op het juiste abonnement:

   az account show
   

Wanneer u Microsoft Foundry gebruikt, worden de opdrachten /login en /logout in Claude Code uitgeschakeld. Verificatie wordt verwerkt via uw Azure referenties.

Claude Code detecteert uw Azure CLI sessie en gebruikt deze voor verificatie zonder extra configuratie.

Optie B: API-sleutel

Als u de voorkeur geeft aan API-sleutelverificatie, stelt u de sleutel in uw omgevingsvariabelen in.

1. Open uw resource in de Microsoft Foundry-portal.
2. Zoek op de pagina Home het veld Project API-sleutel.
3. Selecteer Copy Project API-sleutel om de waarde te kopiëren. Dit is de sleutel die u gebruikt voor de ANTHROPIC_FOUNDRY_API_KEY omgevingsvariabele.
4. Stel de omgevingsvariabele in uw terminal in:

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

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

De VS Code-extensie configureren

De extensie Claude Code VS Code biedt een systeemeigen grafische interface voor Claude Code rechtstreeks in uw IDE.

1. Installeer de extensie vanuit vs Code Marketplace.

2. Open VS Code-instellingen (Ctrl+ofCmd+,) en zoek naar Claude Code: Omgevingsvariabelen.

3. Selecteer Bewerken in settings.json en voeg de volgende configuratie toe:

     {
       "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. Selecteer het Spark-pictogram in de zijbalk om het deelvenster Claude Code te openen.

5. Claude Code verifieert met uw Azure referenties. Voer eerst az login uit als u Microsoft Entra ID verificatie gebruikt.

De extensie ondersteunt automatische acceptatie van bewerkingen, de planmodus, diepgaand denken en bestandsbeheer met @-vermeldingen, allemaal terwijl deze via uw Microsoft Foundry-implementatie worden aangestuurd.

De configuratie valideren

Controleer of Claude Code correct is geconfigureerd voor gebruik van Microsoft Foundry.

1. Open een terminal en navigeer naar een projectmap:

   cd your-project
   

2. Start Claude Code:

   claude
   

   Claude Code is standaard ingesteld op het Sonnet-model voor algemene codering. Als u nog niet alle drie de modellen hebt geïmplementeerd, kunt u rechtstreeks een geïmplementeerd model opgeven:

   claude --model claude-opus-4-6
   

3. Voer de /status opdracht uit:

   > /status
   

   De uitvoer moet lijken op het volgende voorbeeld. De exacte indeling kan variëren, afhankelijk van uw Claude Code-versie.

   ─────────────────────────────────────
   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:
   ─────────────────────────────────────
   

   Bevestig het volgende in de statusuitvoer:

   Veld	Verwachte waarde
   API-provider	Microsoft Foundry
   Gieterijhulpbron	De naam van uw Foundry-resource
   Model	Uw geïmplementeerde model (bijvoorbeeld claude-sonnet-4-6)

4. Verzend een testprompt zoals 'De structuur van dit project samenvatten'.

5. Bevestig dat Claude Code reageert met een analyse van uw project. Een geslaagde verbinding toont de interactieve prompt van Claude Code zonder verificatiefouten.

   Als Claude Code een fout weergeeft zoals 'Kan token niet ophalen' of 'model is niet beschikbaar', raadpleegt u de sectie Probleemoplossing .

Projectcontext maken met CLAUDE.md

U kunt Claude Code extra instructies en richtlijnen geven met behulp van CLAUDE.md bestanden. Claude Code zoekt naar CLAUDE.md bestanden op de volgende plaatsen en voegt ze boven-beneden samen (dat wil zeggen, de bestanden worden op volgorde geladen, met latere bestanden die eerdere bestanden overschrijven), waardoor het context geeft over uw persoonlijke voorkeuren, projectspecifieke details en de huidige taak:

1. ~/.claude/CLAUDE.md – Algemene standaardinstellingen voor alle projecten
2. ./CLAUDE.md – Hoofdinstellingen van opslagplaats
3. ./current-dir/CLAUDE.md – Huidige mapspecifieke gegevens

Claude Code ondersteunt ook projectregels (.claude/rules/*.md) en lokaal geheugen (CLAUDE.local.md) voor gedetailleerdere controle. Zie de documentatie over het geheugen van Claude Code voor de volledige geheugenhiërarchie.

In het volgende voorbeeld ziet u een bestand CLAUDE.md voor een Microsoft Agent Framework project. Maak een vergelijkbaar bestand in de hoofdmap van uw project om Claude Code inzicht te geven in uw codebasis:

# 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

Nadat u een CLAUDE.md bestand hebt gemaakt, start u Claude Code in uw projectmap om de context te laden:

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

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

Azure RBAC configureren

Als u teamleden toegang wilt verlenen tot uw door Foundry gehoste Claude-modellen, wijst u een van de volgende ingebouwde rollen toe:

De rol Foundry User is de aanbevolen native Foundry-rol. De rol Cognitive Services User is een verouderde rol die ook modelaanroepmachtigingen verleent op Azure resourceniveau.

Deze rollen omvatten alle vereiste machtigingen voor het uitvoeren van Claude Code met Foundry.

Voor meer beperkende toegang maakt u een aangepaste rol die is afgestemd op de specifieke gegevensacties die uw team nodig heeft. Zie Toegangsbeheer op basis van Microsoft Foundry voor hulp bij het definiëren van aangepaste rollen.

Claude Code uitvoeren in GitHub Actions

Claude Code kan worden geïntegreerd met GitHub Actions voor CI/CD-automatisering. Sla uw API-sleutel op in het geheime archief van de opslagplaats voordat u deze werkstromen gebruikt.

Tests genereren voor pull-aanvragen

Maak een werkstroom waarmee tests worden gegenereerd wanneer agent- of toolbestanden worden gewijzigd:

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 }}

Activeren PR-review met @claude

Maak een werkstroom die reageert @claude op vermeldingen in opmerkingen bij pull-aanvragen:

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 }}

Gebruik bewaken

Bewaak het gebruik van Claude Code in de Foundry-portal:

1. Ga naar Microsoft Foundry en open uw project.

2. Navigeer naar Operate om metrische gegevens over gebruik weer te geven:

   • Tokenverbruik per model
   • Latentie aanvragen
   • Foutpercentages en tarieflimietoverschrijdingen

Als u tokenlimieten per aanvraag wilt instellen, configureert u de ANTHROPIC_MAX_TOKENS omgevingsvariabele:

export ANTHROPIC_MAX_TOKENS=100000

$env:ANTHROPIC_MAX_TOKENS = "100000"

Zie de configuratiedocumentatie van Claude Code voor configuratieopties waarmee het gebruik en de kosten van tokens worden bepaald, zoals modelspecifieke tokenlimieten.

Resources opschonen

Als u de Claude-modelimplementaties niet meer nodig hebt, verwijder deze dan om implementatieslots en quota in uw omgeving vrij te maken. Claude-modellen maken gebruik van Global Standard-implementaties met facturering per token, zodat niet-actieve implementaties geen kosten in rekening brengen. Elke implementatie telt echter mee voor uw implementatielimiet van 32 per resource.

Implementaties verwijderen in de Foundry-portal

Gebruik een van deze navigatiepaden:

• Selecteer Opereren in de bovenste navigatie en selecteer Assets>Modellen in de linkernavigatie. Selecteer de implementatie die u wilt verwijderen en selecteer vervolgens Verwijderen.
• Selecteer Bouwen in de bovenste navigatiebalk en selecteer vervolgens Modellen in de linkernavigatiebalk. Selecteer de naam van de implementatie om de detailpagina te openen, selecteer het tabblad Details en selecteer Vervolgens Verwijderen in het bovenste deelvenster.

Implementaties verwijderen met de Azure CLI

Voer de opdracht az cognitiveservices account deployment delete uit voor elke implementatie:

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

Vervang <deployment-name> door de naam van de modelimplementatie (zoals claude-sonnet-4-6), <resource-name> door de naam van de Foundry-resource en <resource-group-name> door de resourcegroep die uw Foundry-resource bevat.

Probleemoplossing

Verwante inhoud

• Claude modellen in Microsoft Foundry
• Implementeer en gebruik Claude-modellen in Microsoft Foundry
• Gegevens, privacy en beveiliging voor Claude-modellen
• quotas en limieten voor Microsoft Foundry Models
• Modelgebruik en -kosten bewaken
• Configureer Claude Desktop voor Microsoft Foundry
• Claude in Microsoft Foundry (Antropische documenten)
• Documentatie voor Claude Code (antropische documenten)
• Claude-code bij Microsoft Foundry (Anthropic-documenten)