Konfigurera Claude Code för Microsoft Foundry

Anthropic är Claude Code är ett agentiskt kodningsverktyg som läser din kodbas, redigerar filer, kör kommandon och integrerar med dina utvecklingsverktyg. Det är tillgängligt som ett CLI-verktyg och VS Code-tillägg. När du konfigurerar Claude Code med Microsoft Foundry kör du kodningsagenten på Azure infrastruktur samtidigt som du håller dina data inom din efterlevnadsgräns. Den här konfigurationen ger säkerhet i företagsklass, privat nätverk, rollbaserad åtkomstkontroll och kostnadshantering.

I den här artikeln lär du dig att:

• Installera och konfigurera Claude Code CLI för Microsoft Foundry
• Konfigurera Claude Code VS Code-tillägget
• Autentisera med Microsoft Entra ID- eller API-nycklar
• Skapa projektkontextfiler för bättre AI-hjälp
• Kör Claude Code i GitHub Actions för CI/CD-automatisering

Om du vill använda Claude-modeller i Microsoft Foundry måste du ha en betald Azure prenumeration med ett faktureringskonto i ett land eller en region där Anthropic erbjuder modellerna för köp. En lista över vanliga prenumerationsrelaterade fel finns i Vanliga felmeddelanden och lösningar. Följande prenumerationstyper stöds för närvarande inte:

• Företagskonton i Sydkorea
• Cloud Solution Provider prenumerationer
• Azure-prenumeration som inte har en aktiv faktureringsmetod för användningsbaserad betalning (till exempel student, kostnadsfri utvärdering eller startkreditbaserade konton)
• Sponsrade prenumerationer som endast använder Azure krediter. Observera: Om du har ett konto med ett registrerat kreditkort debiteras kreditkortet i stället för Azure-krediter.

En lista över regioner som stöds finns i geografiska platser som stöds. Observera att Anthropics "policy för regioner som stöds" kan gälla för tillgängligheten i din region, kontrollera regioner som stöds för närmare detaljer.

Förutsättningar

• En Azure prenumeration med en giltig betalningsmetod. Om du inte har en Azure prenumeration skapar du ett betalt Azure konto.
• Åtkomst till Microsoft Foundry med deltagarbehörighet för att skapa och hantera resurser.
• Ett Microsoft Foundry-projekt som skapats i en av de regioner som stöds för Claude-modelldistributioner.
• Deltagar- eller ägarrollen i din Foundry-resursgrupp. Mer information finns i Azure RBAC-roller.
• Åtkomst till Azure Marketplace för att distribuera Foundry Models från partner.
• För Windows använder du Git Bash (ingår i Git för Windows) eller installerar WSL2 (rekommenderas för fullständig Linux-kompatibilitet). Se: Installera WSL.
• (Valfritt) Azure CLI installerat med az login slutfört för Microsoft Entra ID autentisering.

Systemkrav

Distribuera Claude-modellen i Foundry

Innan du konfigurerar Claude Code distribuerar du de tillgängliga Claude-modeller som Claude Code behöver. De flesta Claude-modeller stöder global standarddistribution. Mer information om distributionstyper som stöds finns i Claude-modeller i Microsoft Foundry.

Claude Code använder olika modeller för olika uppgifter:

Distribuera modellen direkt i Foundry

För att distribuera en modell:

1. Följ anvisningarna i Distribuera och använd Claude-modeller i Microsoft Foundry för att distribuera en Claude-modell, till exempel Opus 4.6.

2. Efter distributionen väljer du fliken Information för distributionen och noterar din mål-URI och nyckel. Du behöver dessa värden för konfiguration.

Alternativ: Distribuera modell med modellrouter

Modellrouter är en Foundry-modell som intelligent dirigerar varje uppmaning till den bästa underliggande modellen baserat på frågekomplexitet, kostnad och prestanda. Model Router-versionen 2025-11-18 stöder välj Claude-modeller (claude-haiku-4-5, , claude-sonnet-4-5claude-opus-4-6, claude-opus-4-7och claude-opus-4-8), tillsammans med andra Foundry-modeller.

Fördelar för Claude Code-användare:

• Automatisk modellval: Enkla instruktioner leder till snabbare och billigare modeller. Komplexa kodningsuppgifter dirigeras till mer kompatibla modeller.
• Kostnadsoptimering: Använd routningsprofiler för att balansera kvalitet jämfört med kostnad samtidigt som baslinjeprestanda bibehålls.
• Enskild slutpunkt: En distribution hanterar alla routningsbeslut i din modellflotta.

Om du vill använda modellrouter med Claude Code distribuerar du först de Claude-modeller som stöds och distribuerar sedan Modellrouter och aktiverar dem via modellunderuppsättningskonfiguration.

Installera Claude Code CLI

Installera Claude Code CLI för att arbeta med Claude Code direkt i terminalen. Kontrollera sedan att claude finns i din PATH genom att köra claude --version.

Inbyggd installation (rekommenderas)

Interna installationer uppdateras automatiskt i bakgrunden så att du får den senaste versionen.

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

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

Installation med Homebrew

Om du använder macOS:

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

Homebrew-installationer uppdateras inte automatiskt. Kör brew upgrade claude-code regelbundet för att hämta de senaste funktionerna och säkerhetskorrigeringarna.

Felsöka installationsplats

claude --version Om kommandot inte hittas lägger du till installationsplatsen i sökvägen på följande sätt:

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

Fler installationsalternativ finns i Dokumentation om Claude Code.

Konfigurera Claude Code för Foundry

Du använder antingen ditt Foundry-resursnamn eller bas-URL:en för att konfigurera Claude Code for Foundry.

Så här hittar du ditt Foundry-resursnamn från Foundry-portalen:

1. Gå till det övre vänstra navigeringsfältet och välj Hantera>Project information.
2. Kopiera värdet för Överordnad resurs från sidan Projektinformation.

Så här hittar du din bas-URL från Foundry-portalen:

1. Gå till startsidan för Foundry-portalen
2. Leta upp slutpunkten Project och kopiera den del av URL:en som kommer före /api/projects/<your-project-name>. Din bas-URL är av formuläret https://<your-resource-name>.services.ai.azure.com. Claude Code lägger automatiskt till /anthropic den här URL:en när du använder ANTHROPIC_FOUNDRY_RESOURCE.

Ange miljövariabler för att ansluta Claude Code till din Microsoft Foundry-distribution:

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

I följande tabell beskrivs varje variabel:

Om du vill spara dessa variabler mellan terminalsessioner lägger du till dem i din gränssnittsprofil (till exempel ~/.bashrc eller ~/.zshrc).

Autentisera med Foundry

Claude Code stöder två autentiseringsmetoder för Microsoft Foundry:

• Microsoft Entra ID (rekommenderas): Använder dina Azure CLI autentiseringsuppgifter. Bäst för företagsmiljöer, teamåtkomst och CI/CD-pipelines där du vill ha centraliserad identitetshantering utan att hantera hemligheter.
• API-nyckel: Använder en projekt-API-nyckel från Foundry-portalen. Bäst för snabbtestning eller miljöer där Azure CLI inte är tillgängligt.

Alternativ A: Microsoft Entra ID (rekommenderas)

Microsoft Entra ID autentisering använder dina Azure CLI autentiseringsuppgifter automatiskt. Kör az login innan du startar Claude Code:

1. Logga in med Azure CLI:

   az login
   

   Tips

   Om din Foundry-resurs finns i en annan klientorganisation än din standard-Azure CLI klientorganisation anger du klientorganisations-ID:t:

   az login --tenant <tenant-id>
   

2. Kontrollera att inloggningen är avsedd för rätt prenumeration:

   az account show
   

När du använder Microsoft Foundry inaktiveras kommandona /login och /logout i Claude Code. Autentiseringen hanteras via dina Azure autentiseringsuppgifter.

Claude Code identifierar din Azure CLI-session och använder den för autentisering utan extra konfiguration.

Alternativ B: API-nyckel

Om du föredrar API-nyckelautentisering anger du nyckeln i miljövariablerna.

1. Öppna resursen i Microsoft Foundry-portalen.
2. På sidan Home hittar du fältet Project API-nyckel.
3. Välj Copy Project API-nyckel för att kopiera värdet. Det här är den nyckel som du använder för ANTHROPIC_FOUNDRY_API_KEY miljövariabeln.
4. Ange miljövariabeln i terminalen:

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

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

Konfigurera VS Code-tillägget

Tillägget Claude Code VS Code innehåller ett internt grafiskt gränssnitt för Claude Code direkt i din IDE.

1. Installera tillägget från VS Code Marketplace.

2. Öppna VS Code-inställningar (Ctrl+ellerCmd+) och sök efter Claude Code: Miljövariabler.

3. Välj Redigera i settings.json och lägg till följande konfiguration:

     {
       "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. Välj Spark-ikonen i sidofältet för att öppna panelen Claude Code.

5. Claude Code autentiserar med dina Azure autentiseringsuppgifter. Kör az login först om du använder Microsoft Entra ID autentisering.

Tillägget stöder automatiskt godkänna redigeringsläge, planeringsläge, utökat tänkande och filhantering med @-mentions – allt medan det dirigeras genom din Microsoft Foundry-distribution.

Verifiera konfigurationen

Kontrollera att Claude Code är korrekt konfigurerad för att använda Microsoft Foundry.

1. Öppna en terminal och navigera till en projektkatalog:

   cd your-project
   

2. Starta Claude Code:

   claude
   

   Claude Code använder Sonnet-modellen som standard för allmän kodning. Om du inte har distribuerat alla tre modellerna ännu kan du ange en distribuerad modell direkt:

   claude --model claude-opus-4-6
   

3. /status Kör kommandot:

   > /status
   

   Utdata bör se ut ungefär som i följande exempel. Det exakta formatet kan variera beroende på din Claude Code-version.

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

   Bekräfta följande i statusutdata:

   Fältet	Förväntat värde
   API-leverantör	Microsoft Foundry
   gjuteriresurs	Namnet på din Foundry-resurs
   Modell	Din implementerade modell (till exempel claude-sonnet-4-6)

4. Skicka en testprompt som "Sammanfatta projektets struktur".

5. Bekräfta att Claude Code svarar med en analys av projektet. En lyckad anslutning visar Claude Codes interaktiva prompt utan autentiseringsfel.

   Om Claude Code visar ett fel som "Det gick inte att hämta token" eller "modellen är inte tillgänglig" läser du avsnittet Felsökning .

Skapa projektkontext med CLAUDE.md

Du kan ge Claude Code extra instruktioner och vägledning med hjälp av CLAUDE.md filer. Claude Code söker CLAUDE.md efter filer på följande platser och sammanfogar dem uppifrån och ned (d.s. filerna läses in i ordning, med senare filer som åsidosätter tidigare filer), vilket ger den kontext om dina personliga inställningar, projektspecifik information och den aktuella uppgiften:

1. ~/.claude/CLAUDE.md – Globala standardvärden för alla projekt
2. ./CLAUDE.md – Rotinställningar för lagringsplats
3. ./current-dir/CLAUDE.md – Nuvarande kataloginformation

Claude Code stöder även projektregler (.claude/rules/*.md) och lokalt minne (CLAUDE.local.md) för mer detaljerad kontroll. Den fullständiga minneshierarkin finns i Dokumentation om Claude Code-minne.

I följande exempel visas en CLAUDE.md-fil för ett Microsoft Agent Framework projekt. Skapa en liknande fil i projektroten för att hjälpa Claude Code att förstå din kodbas:

# 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

När du har skapat en CLAUDE.md fil startar du Claude Code i projektkatalogen för att läsa in kontexten:

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

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

Konfigurera Azure RBAC

Om du vill ge gruppmedlemmar åtkomst till Foundry-hostade Claude-modeller tilldelar du någon av följande inbyggda roller.

Foundry-användarrollen är den rekommenderade Foundry-inbyggda rollen. Rollen Cognitive Services User är en äldre roll som även ger behörigheter för modellanrop på resursnivå Azure.

De här rollerna innehåller alla behörigheter som krävs för att köra Claude Code med Foundry.

Om du vill ha mer restriktiv åtkomst skapar du en anpassad roll som är begränsad till de specifika dataåtgärder som ditt team behöver. Information om hur du definierar anpassade roller finns i Role-baserad åtkomstkontroll för Microsoft Foundry.

Kör Claude Code i GitHub Actions

Claude Code integreras med GitHub Actions för CI/CD-automatisering. Lagra din API-nyckel i lagringsplatsens hemliga arkiv innan du använder dessa arbetsflöden.

Generera tester på pull-begäranden

Skapa ett arbetsflöde som genererar tester när agent- eller verktygsfiler ändras:

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

Utlös PR-granskning med @claude

Skapa ett arbetsflöde som svarar på @claude omnämnanden i pull-begärandekommenter:

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

Övervaka användning

Övervaka Claude Code-användning i Foundry-portalen:

1. Gå till Microsoft Foundry och öppna projektet.

2. Gå till Använd för att visa användningsstatistik:

   • Tokenförbrukning efter modell
   • Svarstid för begäran
   • Felfrekvens och träffar vid hastighetsbegränsning

Konfigurera miljövariabeln för att ange tokengränser per begäran ANTHROPIC_MAX_TOKENS :

export ANTHROPIC_MAX_TOKENS=100000

$env:ANTHROPIC_MAX_TOKENS = "100000"

Konfigurationsalternativ som styr tokenanvändning och kostnader, till exempel modellspecifika tokengränser, finns i dokumentationen om Claude Code-konfiguration.

Rensa resurser

Om du inte längre behöver Claude-modelldistributionerna tar du bort dem för att frigöra distributionsplatser och kvoter i resursen. Claude-modeller använder Global Standard-distributioner med fakturering per token, så inaktiva distributioner debiteras inte. Varje distribution räknas dock mot distributionsgränsen på 32 per resurs.

Ta bort distributioner i Foundry-portalen

Använd någon av följande navigeringsvägar:

• Välj Använd i det övre navigeringsfönstret och välj sedan Tillgångar>modeller i det vänstra navigeringsfältet. Välj den distribution som du vill ta bort och välj sedan Ta bort.
• Välj Skapa i det övre navigeringsfönstret och välj sedan Modeller i det vänstra navigeringsfältet. Välj distributionsnamnet för att öppna informationssidan, välj fliken Information och välj sedan Ta bort på den översta panelen.

Ta bort distributioner med Azure CLI

Kör kommandot az cognitiveservices account deployment delete för varje distribution:

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

Ersätt <deployment-name> med modelldistributionsnamnet (till exempel claude-sonnet-4-6), <resource-name> med resursnamnet för Foundry och <resource-group-name> med resursgruppen som innehåller din Foundry-resurs.

Felsökning

Relaterat innehåll

• Claude-modeller i Microsoft Foundry
• Distribuera och använda Claude-modeller i Microsoft Foundry
• Data, sekretess och säkerhet för Claude-modeller
• Microsoft Foundry Models kvoter och begränsningar
• Övervaka modellanvändning och kostnader
• Konfigurera Claude Desktop för Microsoft Foundry
• Claude i Microsoft Foundry (Anthropic docs)
• Dokumentation om Claude Code (antropiska dokument)
• Claude Code på Microsoft Foundry (Anthropic docs)