Konfigurieren von Claude Code für Microsoft Foundry

Anthropics Claude Code ist ein agentisches Codierungstool, das Ihre Codebasis liest, Dateien bearbeitet, Befehle ausführt und in Ihre Entwicklungstools integriert wird. Sie ist als CLI-Tool und VS Code-Erweiterung verfügbar. Wenn Sie Claude Code mit Microsoft Foundry konfigurieren, führen Sie den Codierungs-Agent in der Azure-Infrastruktur aus, während Ihre Daten in Ihrer Compliancegrenze bleiben. Diese Konfiguration bietet Sicherheit auf Unternehmensniveau, private Netzwerke, rollenbasierte Zugriffssteuerung und Kostenverwaltung.

In diesem Artikel erfahren Sie, wie Sie:

  • Installieren und Konfigurieren von Claude Code CLI für Microsoft Foundry
  • Einrichten der VS Code-Erweiterung für Claude Code
  • Authentifizieren mit Microsoft Entra-ID- oder API-Schlüsseln
  • Erstellen von Projektkontextdateien für eine bessere KI-Unterstützung
  • Ausführen von Claude Code in GitHub-Aktionen für CI/CD-Automatisierung

Um Claude-Modelle in Microsoft Foundry zu verwenden, müssen Sie über ein kostenpflichtiges Azure-Abonnement mit einem Abrechnungskonto in einem Land oder einer Region verfügen, in dem Anthropic die Modelle zum Kauf anbietet. Eine Liste allgemeiner Abonnementfehler finden Sie unter Allgemeine Fehlermeldungen und Lösungen. Die folgenden Abonnementtypen werden derzeit nicht unterstützt:

  • Unternehmenskonten in Südkorea
  • Abonnements für Cloudlösungsanbieter
  • Azure-Abonnements ohne aktive Abrechnungsmethode (z. B. Studenten-, kostenlose Test- oder Startguthabenkonten)
  • Gesponserte Abonnements, die nur Azure-Guthaben verwenden. Hinweis: Wenn Sie über ein Konto mit einer hinterlegten Kreditkarte verfügen, wird die Kreditkarte anstelle von Azure-Guthaben belastet.

Eine Liste der unterstützten Regionen finden Sie unter unterstützten geografischen Standorten. Beachten Sie, dass die Anthropic-Richtlinie "Unterstützte Regionen" möglicherweise für die Verfügbarkeit in Ihrer Region gilt, überprüfen Sie die unterstützten Regionen auf Details.

Voraussetzungen

Systemanforderungen

Anforderung Details
Betriebssystem macOS 13+, Ubuntu 20.04+/Debian 10+, Windows 10+ (native über Git Bash oder WSL)
RAM Mindestens 4 GB (empfohlen 8 GB)
Git (optional, empfohlen) 2.23+ für Pull-Anfrage-Hilfsprogramme

Bereitstellen eines Claude-Modells in Foundry

Stellen Sie vor der Konfiguration von Claude Code die verfügbaren Claude-Modelle bereit, die Claude Code benötigt. Die meisten Claude-Modelle unterstützen die globale Standardbereitstellung. Weitere Informationen zu unterstützten Bereitstellungstypen finden Sie unter Claude-Modelle in Microsoft Foundry.

Claude Code verwendet unterschiedliche Modelle für verschiedene Aufgaben:

Wichtig

Die Verfügbarkeit von Claude Modellen in Microsoft Foundry kann sich ändern. Auf der Seite " Foundry Models" von Partnern finden Sie die neueste Liste der verfügbaren Modelle.

Rolle "Claude Code" Empfohlene Bereitstellung Zweck
Primäres Modell claude-sonnet-4-6 Allgemeine Codierung – ausgewogene Geschwindigkeit und Qualität
Schnelles Modell claude-haiku-4-5 Schnelle Vorgänge – Dateilesevorgänge, kleine Bearbeitungen
Erweitertes Denken claude-opus-4-6 Komplexe Schlussfolgerungsaufgaben (optional)

Modell direkt in Foundry bereitstellen

So stellen Sie ein Modell bereit:

  1. Befolgen Sie die Anweisungen in Deploy and use Claude models in Microsoft Foundry, um ein Claude-Modell wie beispielsweise Opus 4.6 bereitzustellen.

  2. Wählen Sie nach der Bereitstellung die Registerkarte "Details" der Bereitstellung aus, und notieren Sie sich den Ziel-URI und den Schlüssel. Sie benötigen diese Werte für die Konfiguration.

Alternative: Bereitstellen des Modells mithilfe des Modellrouters

Modellrouter ist ein Foundry-Modell, das jede Aufforderung intelligent an das beste zugrunde liegende Modell basierend auf Abfragekomplexität, Kosten und Leistung leitet. Modellrouter-Version 2025-11-18 unterstützt ausgewählte Claude-Modelle (claude-haiku-4-5, claude-opus-4-1und claude-sonnet-4-5) zusammen mit anderen Foundry-Modellen.

Hinweis

Der Modellrouter unterstützt derzeit weder claude-sonnet-4-6 noch claude-opus-4-6. Wenn Sie diese Modelle benötigen, stellen Sie diese bereit, und verweisen Sie sie direkt, anstatt den Modellrouter zu verwenden.

Vorteile für Claude Code-Benutzer:

  • Automatische Modellauswahl: Einfache Eingabeaufforderungen führen zu schnelleren, günstigeren Modellen. Komplexe Codierungsaufgaben werden an fähigere Modelle weitergeleitet.
  • Kostenoptimierung: Verwenden Sie Routingprofile, um Qualität und Kosten auszugleichen und gleichzeitig die geplante Leistung aufrechtzuerhalten.
  • Einzelner Endpunkt: Eine Implementierung behandelt alle Routing-Entscheidungen in Ihrer Modell-Flotte.

Um Modellrouter mit Claude Code zu verwenden, stellen Sie zuerst die unterstützten Claude-Modelle bereit, und stellen Sie dann Modellrouter bereit und aktivieren sie über die Modelluntermengekonfiguration.

Installieren von Claude Code CLI

Installieren Sie die Claude Code CLI, um mit Claude Code direkt in Ihrem Terminal zu arbeiten. Stellen Sie dann sicher, dass claude sich in Ihrem PATH befindet, indem Sie folgendes ausführen claude --version.

Hinweis

Anthropic hat die npm-Installationsmethode als veraltet erklärt. Verwenden Sie stattdessen das systemeigene Installationsprogramm oder Homebrew. Wenn Sie bereits über npm installiert haben, führen Sie den Befehl claude install aus, um zu der nativen Methode zu wechseln.

Systemeigene Installationen werden automatisch im Hintergrund aktualisiert, um Sie auf der neuesten Version zu halten.

Führen Sie unter macOS oder Windows (Git Bash oder WSL) das Installationsprogrammskript aus, das die claude Binärdatei herunterlädt und konfiguriert:

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

Installation mit Homebrew

Bei Verwendung von macOS:

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

Homebrew-Installationen werden nicht automatisch aktualisiert. Führen Sie brew upgrade claude-code regelmäßig aus, um die neuesten Features und Sicherheitskorrekturen zu erhalten.

Problembehandlung beim Installationsort

Wenn der claude --version Befehl nicht gefunden wird, fügen Sie den Installationsspeicherort wie folgt zu Ihrem PATH hinzu:

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

Weitere Installationsoptionen finden Sie in der Claude Code-Dokumentation.

Claude Code für Foundry konfigurieren

Sie verwenden entweder den Foundry-Ressourcennamen oder die Basis-URL, um Claude Code für Foundry zu konfigurieren.

So finden Sie den Namen der Foundry-Ressource aus dem Foundry-Portal:

  1. Wechseln Sie zur linken oberen Navigationsleiste und wählen Sie den Projektnamen >Projektdetails aus.
  2. Kopieren Sie den Wert der übergeordneten Ressource von der Projektdetailseite .

So suchen Sie Ihre Basis-URL aus dem Foundry-Portal:

  1. Zur Startseite des Foundry-Portals wechseln
  2. Suchen Sie den Project-Endpunkt, und kopieren Sie den Teil der URL, der vor /api/projects/<your-project-name> kommt. Ihre Basis-URL hat die Form https://<your-resource-name>.services.ai.azure.com. Claude Code fügt /anthropic automatisch zu dieser URL hinzu, wenn Sie ANTHROPIC_FOUNDRY_RESOURCE verwenden.

Legen Sie Umgebungsvariablen fest, um Claude Code mit Ihrer Microsoft Foundry-Bereitstellung zu verbinden:

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

In der folgenden Tabelle werden die einzelnen Variablen beschrieben:

Variable Beschreibung
CLAUDE_CODE_USE_FOUNDRY Legen Sie diesen Wert fest, 1 um die Microsoft Foundry-Integration zu aktivieren.
ANTHROPIC_FOUNDRY_RESOURCE Der Name der Foundry-Ressource. Claude Code erstellt die Endpunkt-URL als https://<resource-name>.services.ai.azure.com/anthropic.
ANTHROPIC_DEFAULT_SONNET_MODEL Der Bereitstellungsname für das Claude Sonnet-Modell (primäres Codierungsmodell).
ANTHROPIC_DEFAULT_HAIKU_MODEL Der Bereitstellungsname für das Claude Haiku-Modell (schnelle Vorgänge).
ANTHROPIC_DEFAULT_OPUS_MODEL Der Bereitstellungsname für das Claude Opus-Modell (komplexe Begründung).

Um diese Variablen über Terminalsitzungen hinweg beizubehalten, fügen Sie sie Ihrem Shellprofil (wie ~/.bashrc oder ~/.zshrc) hinzu.

Authentifizieren mit Foundry

Claude Code unterstützt zwei Authentifizierungsmethoden für Microsoft Foundry:

  • Microsoft Entra-ID (empfohlen): Verwendet Ihre Azure CLI-Anmeldeinformationen. Am besten geeignet für Unternehmensumgebungen, Teamzugriff und CI/CD-Pipelines, in denen Sie eine zentrale Identitätsverwaltung wünschen, ohne geheime Schlüssel zu verwalten.
  • API-Schlüssel: Verwendet einen Projekt-API-Schlüssel aus dem Foundry-Portal. Am besten geeignet für schnelle Tests oder Umgebungen, in denen die Azure CLI nicht verfügbar ist.

Die Microsoft Entra ID-Authentifizierung verwendet Ihre Azure CLI-Anmeldeinformationen automatisch. Führen Sie az login aus, bevor Sie Claude Code starten.

  1. Melden Sie sich mit der Azure CLI an:

    az login
    

    Tipp

    Wenn sich Ihre Foundry-Ressource in einem anderen Mandanten befindet als Ihr Standardmäßiger Azure CLI-Mandant, geben Sie die Mandanten-ID an:

    az login --tenant <tenant-id>
    
  2. Überprüfen Sie, ob Ihre Anmeldung auf das richtige Abonnement abzielt:

    az account show
    

Wenn Sie Microsoft Foundry verwenden, sind die /login- und /logout-Befehle innerhalb von Claude Code deaktiviert. Die Authentifizierung wird über Ihre Azure-Anmeldeinformationen verarbeitet.

Claude Code erkennt Ihre Azure CLI-Sitzung und verwendet sie für die Authentifizierung ohne zusätzliche Konfiguration.

Option B: API-Schlüssel

Wenn Sie die API-Schlüsselauthentifizierung bevorzugen, legen Sie den Schlüssel in Ihren Umgebungsvariablen fest.

  1. Öffnen Sie ihre Ressource im Microsoft Foundry-Portal.
  2. Suchen Sie auf der Seite Start das Feld Projekt-API-Schlüssel.
  3. Wählen Sie " Projekt-API-Schlüssel kopieren" aus, um den Wert zu kopieren. Dies ist der Schlüssel, den Sie für die ANTHROPIC_FOUNDRY_API_KEY Umgebungsvariable verwenden.
  4. Legen Sie die Umgebungsvariable in Ihrem Terminal fest:
export ANTHROPIC_FOUNDRY_API_KEY="<your-foundry-api-key>"

Tipp

Sie finden Ihren API-Schlüssel auch im Findry-Portal auf der Registerkarte "Details " Ihrer Modellbereitstellung.

Konfigurieren der VS Code-Erweiterung

Die Erweiterung Claude Code VS Code bietet eine systemeigene grafische Schnittstelle für Claude Code direkt in Ihrer IDE.

  1. Installieren Sie die Erweiterung vom VS Code Marketplace.

  2. Öffnen Sie VS-Codeeinstellungen (STRG+oderCMD+), und suchen Sie nach Claude Code: Umgebungsvariablen.

  3. Wählen Sie "In settings.jsonbearbeiten" aus, und fügen Sie die folgende Konfiguration hinzu:

      {
        "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. Wählen Sie das Spark-Symbol in der Randleiste aus, um den Claude Code-Bereich zu öffnen.

  5. Claude Code authentifiziert sich mit Ihren Azure-Anmeldeinformationen. Führen Sie az login zuerst aus, wenn Sie die Microsoft Entra ID-Authentifizierung verwenden.

Die Erweiterung unterstützt automatisch den Bearbeitungsmodus, den Planmodus, das erweiterte Denken und die Dateiverwaltung mit @-Erwähnungen – alles während der Weiterleitung über Ihre Microsoft Foundry-Bereitstellung.

Überprüfen der Konfiguration

Stellen Sie sicher, dass Claude Code ordnungsgemäß für die Verwendung von Microsoft Foundry konfiguriert ist.

  1. Öffnen Sie ein Terminal, und navigieren Sie zu einem Projektverzeichnis:

    cd your-project
    
  2. Starten Sie Claude Code:

    claude
    

    Claude Code verwendet standardmäßig das Sonnet-Modell für die allgemeine Codierung. Wenn Sie noch nicht alle drei Modelle bereitgestellt haben, können Sie ein bereitgestelltes Modell direkt angeben:

    claude --model claude-opus-4-6
    
  3. Führen Sie den /status Befehl aus:

    > /status
    

    Die Ausgabe sollte dem folgenden Beispiel ähneln. Das genaue Format kann je nach Claude Code-Version variieren.

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

    Bestätigen Sie Folgendes in der Statusausgabe:

    Feld Erwarteter Wert
    API-Anbieter Microsoft Foundry
    Foundry-Ressource Name der Foundry-Ressource
    Modell Ihr bereitgestelltes Modell (z. B. claude-sonnet-4-6)
  4. Senden Sie eine Testaufforderung wie "Struktur dieses Projekts zusammenfassen".

  5. Vergewissern Sie sich, dass Claude Code mit einer Analyse Ihres Projekts reagiert. Eine erfolgreiche Verbindung zeigt die interaktive Eingabeaufforderung von Claude Code ohne Authentifizierungsfehler.

    Wenn Claude Code einen Fehler wie "Fehler beim Abrufen eines Tokens" oder "Modell ist nicht verfügbar" anzeigt, lesen Sie den Abschnitt "Problembehandlung ".

Erstellen des Projektkontexts mit CLAUDE.md

Sie können Claude Code zusätzliche Anweisungen und Anleitungen mithilfe von CLAUDE.md Dateien geben. Claude Code sucht an den folgenden Stellen nach CLAUDE.md Dateien und führt sie von oben nach unten zusammen (d. h. die Dateien werden in der Reihenfolge geladen, wobei spätere Dateien frühere überschreiben), sodass Ihnen Kontext zu Ihren persönlichen Vorlieben, projektspezifischen Details und der aktuellen Aufgabe gegeben wird.

  1. ~/.claude/CLAUDE.md – Globale Standardwerte für alle Projekte
  2. ./CLAUDE.md – Repositorystammeinstellungen
  3. ./current-dir/CLAUDE.md – Aktuelle Verzeichnisspezifische Angaben

Claude Code unterstützt auch Projektregeln (.claude/rules/*.md) und lokalen Speicher (CLAUDE.local.md) für eine genauere Kontrolle. Die vollständige Speicherhierarchie finden Sie in der Dokumentation zum Speicher von Claude Code.

Das folgende Beispiel zeigt eine CLAUDE.md Datei für ein Microsoft Agent Framework-Projekt . Erstellen Sie eine ähnliche Datei im Projektstamm, um Claude Code dabei zu unterstützen, Ihre Codebasis zu verstehen:

# 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

Nachdem Sie eine CLAUDE.md Datei erstellt haben, starten Sie Claude Code in Ihrem Projektverzeichnis, um den Kontext zu 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/"

Konfigurieren von Azure RBAC

Um Teammitgliedern Zugriff auf Ihre von Findry gehosteten Claude-Modelle zu gewähren, weisen Sie eine der folgenden integrierten Rollen zu:

Rolle Berechtigungen
Foundry-Benutzer Aufrufen von Modellen, Anzeigen von Bereitstellungen
Benutzer der Cognitive Services Aufrufen von Modellen, Anzeigen von Bereitstellungen (Ältere Azure AI Services-Rolle)

Wichtig

Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

Die Rolle Foundry User ist die empfohlene native Rolle für Foundry. Die Rolle "Cognitive Services User " ist eine ältere Rolle, die auch Modellaufrufberechtigungen auf Azure-Ressourcenebene gewährt.

Diese Rollen umfassen alle erforderlichen Berechtigungen zum Ausführen von Claude Code mit Foundry.

Erstellen Sie für restriktiveren Zugriff eine benutzerdefinierte Rolle, die auf die spezifischen Datenaktionen zugeschnitten ist, die Ihr Team benötigt. Anleitungen zum Definieren benutzerdefinierter Rollen finden Sie unter Rollenbasierte Zugriffssteuerung für Microsoft Foundry.

Ausführen von Claude Code in GitHub-Aktionen

Claude Code ist in GitHub Actions for CI/CD Automation integriert. Speichern Sie Ihren API-Schlüssel im geheimen Speicher des Repositorys, bevor Sie diese Workflows verwenden.

Generieren von Tests für Pullanforderungen

Erstellen Sie einen Workflow, der Tests generiert, wenn sich Agent- oder Tooldateien ändern:

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

PR-Überprüfung auslösen mit @claude

Erstellen Sie einen Workflow, der auf @claude Erwähnungen in Pull-Request-Kommentaren antwortet:

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

Überwachen der Nutzung

Überwachen Sie die Verwendung von Claude Code im Gießereiportal:

  1. Wechseln Sie zu Microsoft Foundry , und öffnen Sie Ihr Projekt.

  2. Navigieren Sie zu "Betreiben ", um Nutzungsmetriken anzuzeigen:

    • Tokenverbrauch nach Modell
    • Anforderungslatenz
    • Fehlerraten und Rate-Limit-Überschreitungen

Um Tokenbeschränkungen pro Anforderung festzulegen, konfigurieren Sie die ANTHROPIC_MAX_TOKENS Umgebungsvariable:

Hinweis

Die ANTHROPIC_MAX_TOKENS Variable wird möglicherweise nicht in allen Claude Code-Versionen unterstützt. In der Claude Code-Dokumentation finden Sie die neuesten unterstützten Umgebungsvariablen.

export ANTHROPIC_MAX_TOKENS=100000

Konfigurationsoptionen, die die Tokennutzung und -kosten steuern, z. B. modellspezifische Tokengrenzwerte, finden Sie in der Dokumentation zur Claude Code-Konfiguration.

Bereinigen von Ressourcen

Wenn Sie die Claude-Modellbereitstellungen nicht mehr benötigen, löschen Sie sie, um Bereitstellungsplätze und Kontingente in Ihrer Ressource freizugeben. Claude-Modelle verwenden globale Standardbereitstellungen mit Abrechnung per Token, sodass Leerlaufbereitstellungen keine Gebühren verursachen. Jede Bereitstellung geht jedoch zu Lasten Ihres Bereitstellungsgrenzwertes von 32 pro Ressource.

Löschen von Bereitstellungen im Gießereiportal

Verwenden Sie eine der folgenden Navigationspfade:

  • Wählen Sie Bedienen im oberen Navigationsbereich aus, und wählen Sie dann Assets>Models im linken Navigationsbereich aus. Wählen Sie die Bereitstellung aus, die Sie löschen möchten, und wählen Sie dann "Löschen" aus.
  • Wählen Sie "Erstellen " aus der oberen Navigationsleiste aus, und wählen Sie dann " Modelle " aus der linken Navigation aus. Wählen Sie den Bereitstellungsnamen aus, um die Detailseite zu öffnen, wählen Sie die Registerkarte "Details " und dann " Löschen " aus dem oberen Bereich aus.

Löschen von Bereitstellungen mit der Azure CLI

Führen Sie für jede Bereitstellung den Befehl az cognitiveservices account deployment delete aus:

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

Ersetzen Sie <deployment-name> durch den Namen der Modellbereitstellung (wie claude-sonnet-4-6), <resource-name> durch den Namen Ihrer Foundry-Ressource und <resource-group-name> durch die Ressourcengruppe, die Ihre Foundry-Ressource enthält.

Problembehandlung

Problem Lösung
Autorisierungsfehler (HTTP 401/403) Stellen Sie sicher, dass az login erfolgreich abgeschlossen wurde oder dass der API-Schlüssel ordnungsgemäß festgelegt wurde. Überprüfen Sie, ob Ihr Konto Zugriff auf die Foundry-Ressource hat.
Claude Code startet, kann aber keine Modelle finden. Überprüfen Sie, ob ANTHROPIC_FOUNDRY_RESOURCE Ihrem Ressourcenname entspricht und ob die ANTHROPIC_DEFAULT_*_MODEL-Werte Ihren Bereitstellungsnamen entsprechen.
Grenzwert überschritten (HTTP 429) Überprüfen Sie Ihre Kontingente im Gießereiportal unter Betreiben>Kontingente. Erwägen Sie, Ihre Tokengrenzwerte gemäß der Claude Code-Konfigurationsdokumentation anzupassen.
VS Code-Erweiterung verbindet nicht Stellen Sie sicher, dass Umgebungsvariablen vor dem Starten von VS Code festgelegt sind. Versuchen Sie, VS Code aus dem Terminal zu starten, nachdem Sie die Variablen festgelegt haben.
Probleme mit der WSL+ VS-Codeerweiterung Die Erweiterung sucht möglicherweise nicht innerhalb von WSL, sondern nach dem API-Schlüssel auf dem Windows-Host. Legen Sie die Umgebungsvariable sowohl auf dem Windows-Host als auch auf WSL fest, und starten Sie dann ein neues Terminal von WSL, und führen Sie code .
Regionsfehler Claude Modelle sind nur in Ost-USA 2 und Schweden Zentral erhältlich.
"Fehler beim Abrufen des Tokens von azureADTokenProvider: Fehler bei der ChainedTokenCredential-Authentifizierung" Melden Sie sich mit az login an oder verwenden Sie ANTHROPIC_FOUNDRY_API_KEY für die API-Schlüsselauthentifizierung.
„Das Modell <model-name> ist in Ihrer Foundry-Bereitstellung nicht verfügbar.“ Stellen Sie das fehlende Modell im Foundry-Portal bereit. Bei Claude Code braucht jede Modellrolle (Sonnet, Haiku, Opus) eine entsprechende Bereitstellung.
„Tokenmandant stimmt nicht mit Ressourcenmandant überein“ Ihre Azure CLI ist bei einem anderen Mandanten als Ihre Foundry-Ressource angemeldet. Führen Sie az login --tenant <tenant-id> aus, um sich beim richtigen Mandanten anzumelden.
Fehler bei der Bereitstellungserstellung im Foundry-Portal Vergewissern Sie sich, dass Sie über die Rolle "Mitwirkender " oder "Besitzer " in der Ressourcengruppe verfügen, und Ihr Abonnement hat den Azure Marketplace-Zugriff aktiviert.
Claude Code fordert zur Anthropic-Anmeldung auf Stellen Sie sicher, dass CLAUDE_CODE_USE_FOUNDRY=1 eingestellt ist. Ohne diese Variable verwendet Claude Code die standardmäßige Anthropic-API.