Claude-Modelle in Microsoft Foundry mit Bicep oder Terraform bereitstellen

Das Claude on Foundry Starter Kit hilft Ihnen, Anthropic Claude Modelle mithilfe Azure Developer CLI (azd) auf Microsoft Foundry bereitzustellen. Außerdem können Sie die lokale Authentifizierung konfigurieren und das bereitgestellte Modell von Claude Code oder Python aufrufen.

In diesem Artikel erfahren Sie, wie Sie:

  • Stellen Sie Claude Sonnet mithilfe der Bicep Variante des Starterkits auf Microsoft Foundry bereit.
  • Konfigurieren Sie die erforderlichen Nachweiswerte des Anthropic-Modellanbieters.
  • Konfigurieren Sie Claude Code für die Verwendung des vom Foundry gehosteten Modells.
  • Rufen Sie das bereitgestellte Claude-Modell von Python mithilfe von Microsoft Entra ID auf.
  • Passen Sie die Bereitstellung für Terraform, zusätzliche Modellfamilien, andere Regionen oder eine andere Kapazität an.

Important

Beim Ausführen von azd up mit diesem Starter Kit werden die Anthropic-Marketplace-Bedingungen akzeptiert und die Attestierungswerte CLAUDE_ORGANIZATION_NAME, CLAUDE_COUNTRY_CODE und CLAUDE_INDUSTRY mit Anfragen gesendet. Legen Sie Werte fest, die die tatsächliche Organisation mithilfe des Modells beschreiben. Ausführliche Informationen finden Sie unter Nutzungsbedingungen.

Schnellstart

Dieser „optimale Ablauf“ stellt Claude Sonnet mithilfe von Bicep in eastus2 mit einer Kapazität 25 (25.000 Token pro Minute) bereit. Verwenden Sie sie zuerst, um zu einer funktionierenden Bereitstellung zu gelangen, und wechseln Sie dann zur Anpassung der Bereitstellung , wenn Sie Terraform, mehrere Modellfamilien, eine andere Region oder eine andere Kapazität benötigen.

Sie benötigen ein Azure-Abonnement, das für Anthropic Claude in Microsoft Foundry, Berechtigungen zum Erstellen der Zielressourcen, Azure CLI, Azure Developer CLI, Git und Python 3.10 oder höher berechtigt ist. Wenn Ihr Konto Rollenzuweisungen erstellen kann, gewährt der QuickStart Ihrem Benutzer auch Zugriff auf Modellaufrufe, sodass die Beispiele sofort ausgeführt werden können.

Klonen, Konfigurieren und Bereitstellen

Wenn sich Ihr für Claude berechtigtes Abonnement in einem Nicht-Standard-Mandanten befindet, fügen Sie die Mandanten-ID zu beiden Anmeldebefehlen hinzu.

git clone https://github.com/Azure-Samples/claude.git
cd claude\infra-bicep

az login
azd auth login

azd env new my-claude
azd env set CLAUDE_ORGANIZATION_NAME "Contoso"
azd env set CLAUDE_COUNTRY_CODE "US"
azd env set CLAUDE_INDUSTRY "technology"
azd env set AZURE_LOCATION "eastus2"
azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"
azd env set CLAUDE_SONNET_CAPACITY 25
azd env set ASSIGN_RBAC true

azd up

Ersetzen Sie Contoso, US und technology durch Werte für die tatsächliche Organisation bei der Verwendung von Claude. Wenn Ihr Konto keine Rollenzuweisungen erstellen kann, überspringen Sie ASSIGN_RBAC und lassen Sie sich von einem Administrator Zugriff zum Aufrufen des Modells gewähren, bevor Sie die Beispiele ausführen.

Claude Code überprüfen und ausführen

Überprüfen Sie aus dem Repositorystamm den generierten Konfigurations- und Bereitstellungsstatus. Das Skip-Flag verhindert bei der Verifizierung einen Live-Aufruf an Claude.

cd ..
pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall -WaitForDeployment

. .\claude-code.env.ps1
claude

Ausführen des Python-Beispiels

Schreiben Sie die azd Ausgaben in .env.local, installieren Sie Abhängigkeiten und führen Sie das One-Shot-Beispiel mit Microsoft Entra ID aus.

cd infra-bicep
azd env get-values | Out-File -Encoding utf8 ..\.env.local
cd ..
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python src\hello_claude.py

Wie das Starter Kit hilft

Das Starter Kit automatisiert die Claude-Bereitstellung mithilfe von Bicep oder Terraform. Er konfiguriert die lokale Authentifizierung für Microsoft Entra ID und stellt funktionierende Claude Code- und Python-Beispiele bereit. Es enthält auch Preflight-Prüfungen für allgemeine Marketplace-, Regions- und Kontingentprobleme, sodass Sie Blocker vor der Bereitstellung beheben können. Weitere Informationen finden Sie unter Was die Bereitstellung erstellt und Bereitstellung anpassen.

Voraussetzungen

  • Ein Azure-Abonnement, das Anthropic Claude Modelle in Microsoft Foundry bereitstellen kann. Die Verfügbarkeit von Claude-Modell hängt von Abonnementtyp, Abrechnungsstatus, Region und Anthropic unterstützten Regionen ab.
  • Berechtigungen zum Erstellen und Verwalten der Azure-Zielressourcen. Normalerweise benötigen Sie Contributor oder Owner für das Abonnement oder die Zielressourcengruppe.
  • Zugriff auf Azure Marketplace für Partnermodellangebote.
  • Azure CLI.
  • Azure Developer CLI.
  • Git.
  • Python 3.10 oder höher für die Python Beispiele.
  • Terraform 1.6 oder höher, wenn Sie die Terraform Variante wählen.

Tip

Das Repository unterstützt auch GitHub Codespaces und VS Code Dev Containers. Diese Umgebungen enthalten die erforderlichen Entwicklertools und sind daher eine gute Wahl, wenn Sie az, azd und Python nicht lokal installieren möchten.

Was die Bereitstellung erzeugt

Das Starter Kit erstellt diese Ressourcen und lokale Konfigurationsdateien:

  • Eine Azure Ressourcengruppe für die azd Umgebung.
  • Ein Microsoft Foundry-Konto.
  • Ein Microsoft Foundry-Projekt.
  • Eine oder mehrere Bereitstellungen von Claude-Modellen im Foundry-Konto.
  • Eine optionale Rollenzuweisung für den Modellaufruf.
  • Lokale Claude-Code-Aktivierungsskripte im Stammverzeichnis des Repositorys.
  • Claude-Workspace-Konfiguration, die Claude Code an eine bereitgestellte Modellfamilie bindet.
  • Optionale Einstellungen der VS Code-Erweiterung beim Festlegen von CLAUDE_WRITE_VSCODE_SETTINGS=true.
  • azd Die Umgebungsausgabe, einschließlich des Namens des Foundry-Kontos, der Basis-URL, des Projektendpunkts und der Bereitstellungsnamen.

Bereitstellung anpassen

Verwenden Sie diesen Abschnitt, wenn Sie den Schnellstartpfad variieren möchten, z. B. Terraform verwenden, eine andere Region auswählen, mehrere Claude-Familien bereitstellen oder Kapazität ändern möchten. Wenn Sie die Schnellstartanleitung bereits abgeschlossen haben, können Sie mit der Verwendung von Claude Code mit dem bereitgestellten Modell oder "Claude anrufen" von Python fortfahren.

Klonen des Starterkits

Klonen Sie das Startkit, und wechseln Sie in das Repository:

git clone https://github.com/Azure-Samples/claude.git
cd claude

Optional können Sie den Live-Katalog von Claude prüfen, bevor Sie Modell-IDs auswählen. Dieses Hilfsprogramm ist im Starter-Kit nur für PowerShell verfügbar.

pwsh -File .\Get-ClaudeCatalog.ps1 -Latest

Der Katalog ändert sich im Laufe der Zeit. Verwenden Sie die Skriptausgabe, um zu bestätigen, welche Claude-Modell-IDs in der Region verfügbar sind, die Sie bereitstellen möchten.

Auswählen einer Infrastrukturvariante

Das Starter Kit umfasst zwei gleichwertige Infrastrukturvarianten:

Variante Folder Verwenden Sie, wenn
Bicep infra-bicep Sie bevorzugen eine Azure-native Infrastruktur als Code.
Terraform infra-terraform Sie bevorzugen Terraform und verwenden bereits Terraform-Workflows.

Wechseln Sie in einen der Variantenordner:

cd infra-bicep

Oder:

cd infra-terraform

Der Rest der Befehle in diesem Artikel wird aus dem ausgewählten Variant-Ordner ausgeführt.

Anmelden bei Azure

Melden Sie sich mit Azure CLI und Azure Developer CLI an:

az login
azd auth login

Wenn sich Ihr für Claude berechtigtes Abonnement in einem nicht als Standard festgelegten Mandanten befindet, geben Sie den Mandanten an:

az login --tenant <tenant-id>
azd auth login --tenant-id <tenant-id>

Erstellen einer azd Umgebung

Erstellen Sie eine azd Umgebung zum Speichern der Bereitstellungskonfiguration:

azd env new my-claude

Wenn Sie bereits eine Umgebung erstellt haben, wählen Sie sie stattdessen aus:

azd env select my-claude

Konfigurieren der erforderlichen Bereitstellungswerte

Legen Sie die Organisationswerte fest, die für den Claude-Modellanbieternachweis verwendet werden:

azd env set CLAUDE_ORGANIZATION_NAME "Contoso"
azd env set CLAUDE_COUNTRY_CODE "US"
azd env set CLAUDE_INDUSTRY "technology"

Ersetzen Sie die Beispielwerte durch den Namen der juristischen Person Ihrer Organisation, den Zwei-Buchstaben-Ländercode und die Branche. Das Starter-Kit bietet Standardwerte für Land und Branche, überschreiben Sie diese jedoch, es sei denn, US und technology beschreiben die Organisation, die Claude verwendet, genau.

Der Industriewert muss kleingeschrieben sein. Unterstützte Werte sind:

  • technology
  • finance
  • healthcare
  • education
  • retail
  • manufacturing
  • government
  • media
  • other

Legen Sie die region Azure fest:

azd env set AZURE_LOCATION "eastus2"

Das Starter Kit unterstützt Regionen, in denen die ausgewählten Claude-Modelle verfügbar sind. Der QuickStart verwendet eastus2. Für einen gemeinsamen Einsatz in der gesamten Familie hosten eastus2 und swedencentral derzeit Haiku, Sonnet und Opus. westus2 hostet Sonnet und Opus. Die Verfügbarkeit kann sich ändern. Verwenden Sie daher das Livekatalogskript, wenn Sie nicht sicher sind, welche Modellfamilien in Ihrer Zielregion verfügbar sind.

Bereitstellen weiterer Modellfamilien oder Ändern der Kapazität

Stellen Sie für eine einfache erste Bereitstellung nur Sonnet bereit, indem Sie die bevorzugte Familienvariable verwenden:

azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"

Wenn Sie mehrere Modellfamilien in demselben Foundry-Konto bereitstellen möchten, legen Sie eine oder mehrere Familienvariablen fest:

azd env set CLAUDE_HAIKU_MODEL "claude-haiku-4-5"
azd env set CLAUDE_SONNET_MODEL "claude-sonnet-4-6"
azd env set CLAUDE_OPUS_MODEL "<opus-model-id-from-catalog>"

Jede nicht leere Familienvariable führt zu einer eigenständigen Bereitstellung. Lassen Sie eine Familie ungestört, um es zu überspringen. Die ältere CLAUDE_MODEL_NAME Einstellung ist ein Legacy-Fallback für eine einzelne Bereitstellung und wird nur dann verwendet, wenn CLAUDE_HAIKU_MODEL, CLAUDE_SONNET_MODEL und CLAUDE_OPUS_MODEL alle leer sind.

Der Schnellstart setzt die Sonnet-Kapazität auf 25. Um die Kapazität für jede bereitgestellte Familie außer Kraft zu setzen, legen Sie die entsprechende Kapazitätsvariable fest:

azd env set CLAUDE_SONNET_CAPACITY 25

Kapazitätswerte werden in Tausenden von Token pro Minute gemessen. 25 fordert z. B. 25.000 TPM an.

Modellaufrufzugriff konfigurieren

Damit die Microsoft Entra ID Beispiele unmittelbar nach der Bereitstellung funktionieren, setzen Sie ASSIGN_RBAC=true vor azd up. Die Vorlage weist der Prinzipal-ID, die Cognitive Services User über azd bereitstellt, die Rolle mit den geringsten Berechtigungen AZURE_PRINCIPAL_ID auf dem Foundry-Konto zu, sodass Sie normalerweise Ihre eigene Objekt-ID nicht nachschlagen müssen.

azd env set ASSIGN_RBAC true

Legen Sie AZURE_PRINCIPAL_ID nur dann manuell fest, wenn Sie einem anderen Benutzer oder Dienstprinzipal Zugriff gewähren müssen:

azd env set AZURE_PRINCIPAL_ID "<object-id>"
azd env set ASSIGN_RBAC true

Wenn Sie diese Option nicht aktivieren, können Sie die Ressourcen weiterhin bereitstellen. Sie oder ein Administrator müssen jedoch Modellaufrufberechtigungen erteilen, bevor die Microsoft Entra ID Beispiele das Modell aufrufen können.

Das Starter-Kit weist Cognitive Services User zu, da dies die Rolle mit den geringsten Rechten für schlüssellose Modellaufrufe ist. Wenn Sie später planen, umfassendere Projektfunktionen in Foundry wie etwa Agenten oder Auswerter hinzuzufügen, können Sie separat umfassendere Datenzugriffsebenenrollen wie Foundry User oder Azure AI Developer zuweisen.

Bereitstellen mit azd up

Führen Sie den Bereitstellungsvorgang aus.

azd up

Der azd up Befehl führt die folgenden Aufgaben aus:

  1. Führt eine Vorabprüfung der erforderlichen Einstellungen, der Verfügbarkeit des Marketplace-Katalogs und des verfügbaren Kontingentspielraums durch.
  2. Erstellt die Azure-Ressourcengruppe.
  3. Erstellt das Microsoft Foundry-Konto und -Projekt.
  4. Stellt die ausgewählten Claude-Modellfamilien bereit.
  5. Weist optional die Rolle für den Modellaufruf zu.
  6. Schreibt Ausgabewerte wie z. B. CLAUDE_BASE_URL, CLAUDE_DEPLOYMENT_NAME und Bereitstellungsnamen pro Familie.
  7. Führt den Postprovision-Hook aus, um Claude Code-Aktivatordateien zu konfigurieren.

Die Bereitstellung kann einige Minuten dauern. Modellbereitstellungen können die Bereitstellung auch fortsetzen, nachdem der ARM-Bereitstellungsvorgang ein Timeout zurückgegeben hat. Verwenden Sie in diesem Fall das Überprüfungsskript im nächsten Abschnitt, um den tatsächlichen Bereitstellungsstatus zu prüfen, bevor azd up erneut ausgeführt wird.

Überprüfen Sie die Bereitstellung

Führen Sie im Stammverzeichnis des Repositorys das Verifizierungsskript aus:

cd ..
pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall

Um auf Modellimplementierungen zu warten, die sich noch in der Bereitstellung befinden, fügen Sie das Wait-Flag hinzu:

pwsh -File .\scripts\verify-claude-code.ps1 -SkipClaudeCall -WaitForDeployment

Um einen Live-Roundtrip mit Claude Code einzubinden, lassen Sie das Skip-Flag weg:

pwsh -File .\scripts\verify-claude-code.ps1

Das Überprüfungsskript überprüft den generierten Aktivator, erwartete Umgebungsvariablen, Azure CLI Anmeldung, sichtbare Foundry-Ressource, Modellbereitstellungsstatus und Verfügbarkeit der Claude Code CLI.

Verwenden von Claude Code mit dem bereitgestellten Modell

Verwenden Sie die Claude Code CLI

Standardmäßig schreibt das Starter Kit projektspezifische Aktivierungsskripte und die Konfiguration des Claude-Arbeitsbereichs im Stammverzeichnis des Repositorys:

  • claude-code.env.ps1 für PowerShell.
  • claude-code.env.sh für Bash, macOS, Linux, Git Bash oder WSL.
  • Claude-Workspace-Konfiguration, um Claude Code auf eine Modellfamilie festzulegen, die Sie bereitgestellt haben.
. .\claude-code.env.ps1
claude

Der Aktivator konfiguriert Claude Code für die Verwendung Microsoft Foundry und legt die Bereitstellungsnamen für die modellbasierten Familien fest, die Sie bereitgestellt haben. Für jede bereitgestellte Familie schreibt der Post-Provisioning-Hook einen ANTHROPIC_DEFAULT_<FAMILY>_MODEL-Wert in den Aktivator, damit Claude Code an Haiku, Sonnet oder Opus weiterleiten kann, wenn diese Bereitstellungen existieren. Die Konfiguration des Claude-Arbeitsbereichs legt den Standard des Arbeitsbereichs auf eine bereitgestellte Modellfamilie fest, sodass claude zu einem Modell aufgelöst wird, das in Ihrem Foundry-Konto vorhanden ist.

Wenn der Befehl nicht installiert ist, druckt der claude Postprovision-Hook den Installationsbefehl für Ihre Plattform. Damit das Starter Kit Claude Code während der Bereitstellung automatisch installiert, legen Sie diesen Wert fest, bevor Sie folgendes ausführen azd up:

azd env set CLAUDE_CODE_AUTO_INSTALL true

Optional: Konfigurieren der VS-Codeerweiterung

Das Starter Kit schreibt .vscode/settings.json nicht standardmäßig. Wenn Sie die Claude Code VS Code-Erweiterung verwenden und das Starterkit zur Konfiguration nutzen möchten, aktivieren Sie diese Option vor azd up:

azd env set CLAUDE_WRITE_VSCODE_SETTINGS true

Wenn Sie diese Option aktivieren, schreibt oder führt der Postprovision-Hook claudeCode.environmentVariables und claudeCode.disableLoginPrompt in .vscode/settings.json zusammen, sodass die Erweiterung Ihre Foundry-Bereitstellung verwendet, anstatt zur Anmeldung bei einem Anthropic-Konto aufzufordern.

Claude von Python anrufen

Das Repository enthält Python Beispiele unter src. Verwenden Sie sie, um den anwendungsbasierten Zugriff mit dem Anthropic SDK und Microsoft Entra ID zu testen.

Wechseln Sie vom Repository-Stammverzeichnis aus zurück in den Ordner der Infrastrukturvariante und schreiben Sie die azd-Ausgaben nach .env.local im Repository-Stammverzeichnis:

cd infra-bicep # or: cd infra-terraform
azd env get-values | Out-File -Encoding utf8 ..\.env.local

Erstellen Sie dann eine virtuelle Umgebung, und installieren Sie Abhängigkeiten:

cd ..
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Führen Sie das One-Shot-Beispiel aus:

python src\hello_claude.py

Das Beispiel lädt CLAUDE_BASE_URL und CLAUDE_DEPLOYMENT_NAME, ruft ein Microsoft Entra ID-Token für https://ai.azure.com/.default ab, erstellt einen Anthropic-Client mit der Foundry-Basis-URL und sendet eine Anfrage an die Messages API.

Sie können auch die Streaming- und Langlaufvarianten ausprobieren.

python src\chat_stream.py
python src\hello_claude_token_refresh.py

Verwenden Sie das Tokenaktualisierungsbeispiel für Dienste, Daemons, Notizbücher oder andere Prozesse, die möglicherweise länger als die Lebensdauer eines einzelnen Microsoft Entra ID-Tokens ausgeführt werden.

Erweitert: Testen mit einem API-Schlüssel

Verwenden Sie Microsoft Entra ID für normale Entwicklungs- und Produktionsszenarien. Für schnelle lokale Tests enthält das Repository auch ein API-Schlüsselbeispiel.

Wechseln Sie aus dem Repositorystamm in den Infrastrukturvariantenordner, und rufen Sie den Namen und die Ressourcengruppe des Foundry-Kontos ab:

cd infra-bicep # or: cd infra-terraform
azd env get-values

Verwenden Sie die Werte für FOUNDRY_ACCOUNT_NAME und AZURE_RESOURCE_GROUP aus der Ausgabe, um CLAUDE_API_KEY festzulegen. Führen Sie dann das API-Schlüsselbeispiel aus dem Repositorystamm aus:

$env:CLAUDE_API_KEY = (az cognitiveservices account keys list `
  --name "<foundry-account-name>" `
  --resource-group "<resource-group-name>" `
  --query key1 -o tsv)

cd ..
python src\hello_claude_apikey.py

API-Schlüssel sind nützlich für eine schnelle Konnektivitätsprüfung, bieten jedoch nicht die gleichen Vorteile für die Zugriffssteuerung und den Lebenszyklus von Anmeldeinformationen pro Benutzer wie Microsoft Entra ID.

Nutzungsbedingungen

Die Varianten Bicep und Terraform senden beide einen modelProviderData-Block mit jeder Claude-Bereitstellung. Dieser Block enthält organizationName, countryCodeund industry. Der Ressourcenanbieter von Cognitive Services verwendet diese Werte, um das Azure Marketplace-Angebot für Anthropic Claude in Ihrem Namen anzunehmen, sodass während azd up kein separater manueller Klick erforderlich ist.

Vor der Bereitstellung:

  1. Überprüfen Sie die rechtlichen Dokumente, die für Claude über Microsoft Foundry gelten:
  2. Legen Sie die Nachweiswerte so fest, dass sie Ihre Organisation genau beschreiben:
    • CLAUDE_ORGANIZATION_NAME: name der juristischen Person. Dieser Wert ist erforderlich und hat keinen Standardwert.
    • CLAUDE_COUNTRY_CODE: die Ländervorwahl mit zwei Buchstaben. Der Standard des Starterkits lautet US.
    • CLAUDE_INDUSTRY: die Organisationsindustrie. Der Standard des Starterkits lautet technology.
  3. Vergewissern Sie sich, dass Ihr Azure-Abonnement berechtigt ist, Anthropic Claude Modelle in Microsoft Foundry bereitzustellen.

Wenn die Standardwerte für Land oder Industrie die Organisation, die Claude verwendet, nicht genau beschreiben, überschreiben Sie sie vor der Bereitstellung.

Vorschau des von Foundry im manuellen Pfad angezeigten Dialogfelds und Audit-Akzeptanz nach azd up anzeigen

Das Dialogfeld „Zustimmen und fortfahren“ im Azure-Portal für eine Claude-SKU wird aus den Metadaten des aktuellen Marketplace-Angebots generiert. Da sich dieser Marketplace-Text ändern kann, verwenden Sie den Liveeintrag für die SKU, die Sie bereitstellen möchten, anstatt sich auf eine kopierte Momentaufnahme zu verlassen.

Danach azd upkönnen Sie die Metadaten der akzeptierten Marketplace-Vereinbarung mithilfe von Azure CLI überwachen. Der Befehl gibt Metadaten wie den akzeptierten Zustand, die Signatur, das Datum und den Lizenztextlink zurück. Der vollständige Portaldialogtext wird nicht zurückgegeben.

az term show `
  --publisher anthropic `
  --product anthropic-claude-sonnet-4-6-offer `
  --plan <plan-name>

Ersetzen Sie für andere Claude SKUs den --product Wert durch das entsprechende Marketplace-Angebot. Verwenden Sie den Plannamen aus den Metadaten des Live-Angebots oder den Überprüfungen im Starterkit-Katalog.

Troubleshooting

Weitere Fälle finden Sie im Abschnitt zur Problembehandlung im Startkit.

Problem Was Sie testen sollten
Abonnement- oder Angebotsberechtigungsblöcke azd up Vergewissern Sie sich, dass Ihr Abonnement- und Abrechnungskonto für Claude-Modelle in Microsoft Foundry berechtigt sind. Wenn Ihre Organisation eine explizite Annahme im Marketplace erfordert, akzeptieren Sie das entsprechende Anthropic-Angebot, bevor Sie azd up erneut ausführen.
Region ist für das ausgewählte Modell nicht verfügbar. Verwenden Sie eine Region, in der die ausgewählte Claude-Familie verfügbar ist. Der QuickStart verwendet eastus2; swedencentral hostet ebenfalls häufig Haiku, Sonnet und Opus, und westus2 hostet Sonnet und Opus. Die Verfügbarkeit kann sich ändern. Wenn Sie sich nicht sicher sind, führen Sie pwsh -File .\Get-ClaudeCatalog.ps1 -Latest im Stammverzeichnis des Repositorys aus.
Das Kontingent reicht nicht aus, oder das Kontingent scheint voll zu sein, obwohl keine aktiven Bereitstellungen vorhanden sind. Verringern Sie den übereinstimmenden CLAUDE_*_CAPACITY Wert, löschen Sie nicht verwendete Bereitstellungen, oder fordern Sie eine Kontingenterhöhung an. Vorläufig gelöschte Foundry- oder AIServices-Konten können bis zu 48 Stunden lang TPM-Kontingent reservieren; listen Sie sie mit az cognitiveservices account list-deleted -o table auf und löschen Sie Konten, die Sie nicht mehr benötigen, endgültig.
Terraform schlägt mit einem undurchsichtigen 715-123420 Fehler fehl. Behandeln Sie dies als wahrscheinlichen Kontingentfehler, einschließlich des Kontingents, das von vorläufig gelöschten Konten gehalten wird. Führen Sie die Preflight-Prüfungen des Starterkits aus, überprüfen Sie den Kontingentspielraum, verringern Sie die Kapazität oder wiederholen Sie den Vorgang mit der Bicep-Variante, damit eine klarere InsufficientQuota-Meldung ausgegeben wird.
Claude Code oder Python gibt 401 oder 403 zurück. Führen Sie az login aus, vergewissern Sie sich, dass Sie bei dem Mandanten angemeldet sind, dem die Foundry-Ressource gehört, und überprüfen Sie, ob der Aufrufer über Zugriff zum Aufrufen des Modells verfügt, z. B. Cognitive Services User. Es kann einige Minuten dauern, bis neue RBAC-Zuweisungen wirksam werden.
GatewayTimeout wird während der Modellbereitstellung angezeigt Die Modellbereitstellung kann auch dann fortgesetzt werden, wenn beim ARM-Vorgang eine Zeitüberschreitung auftritt. Bevor Sie azd up erneut ausführen, führen Sie das Überprüfungsskript mit -WaitForDeployment oder --wait-for-deployment aus, um den tatsächlichen Status der Bereitstellung zu prüfen.

Bereinigen von Ressourcen

Wenn Sie die Ressourcen nicht mehr benötigen, löschen Sie sie mit azd down aus dem Ordner der Infrastrukturvariante:

cd infra-bicep
azd down

Oder:

cd infra-terraform
azd down

Überprüfen Sie die Ressourcen, die azd löschen möchte, bevor Sie bestätigen. Durch das Löschen der Umgebung werden das Foundry-Konto, das Projekt und die Modellbereitstellungen entfernt, die das Startkit erstellt hat.

Wenn Sie Bereitstellungen iterativ verbessern und das reservierte Claude-TPM-Kontingent sofort wieder benötigen, verwenden Sie die Option „Purge“, sofern Ihre azd-Version dies unterstützt:

azd down --purge

Ohne endgültige Löschung können vorläufig gelöschte Foundry- oder AIServices-Konten das TPM-Kontingent noch bis zu 48 Stunden belegen. Wenn Sie bereits eine Umgebung ohne Bereinigung gelöscht haben und das Kontingent weiterhin als voll angezeigt wird, verwenden Sie az cognitiveservices account list-deleted -o table, um gelöschte Konten zu finden und die Konten, die Sie nicht mehr benötigen, endgültig zu löschen.

Nächste Schritte

  • Last updated on