Konfigurowanie kodu Claude'a dla Microsoft Foundry

Anthropic Claude Code to narzędzie do kodowania agentów, które odczytuje bazę kodu, edytuje pliki, uruchamia polecenia i integruje się z narzędziami programistycznymi. Jest on dostępny jako narzędzie interfejsu wiersza polecenia i rozszerzenie programu VS Code. Podczas konfigurowania programu Claude Code za pomocą Microsoft Foundry uruchamiasz agenta kodowania w infrastrukturze Azure, zachowując dane w granicach zgodności. Ta konfiguracja zapewnia zabezpieczenia klasy korporacyjnej, sieć prywatną, kontrolę dostępu opartą na rolach i zarządzanie kosztami.

Z tego artykułu dowiesz się, jak wykonywać następujące działania:

  • Instalowanie i konfigurowanie interfejsu wiersza polecenia programu Claude Code dla Microsoft Foundry
  • Skonfiguruj rozszerzenie VS Code dla Claude Code
  • Uwierzytelnij się za pomocą Microsoft Entra ID lub kluczy API.
  • Tworzenie plików kontekstowych projektu w celu uzyskania lepszej pomocy w zakresie sztucznej inteligencji
  • Uruchamianie programu Claude Code w GitHub Actions dla automatyzacji procesu ciągłej integracji i wdrażania (CI/CD)

Aby korzystać z modeli Claude'a w usłudze Microsoft Foundry, musisz mieć płatną subskrypcję Azure z kontem rozliczeniowym w kraju lub regionie, w którym Anthropic oferuje modele do zakupu. Aby uzyskać listę typowych błędów związanych z subskrypcją, zobacz Typowe komunikaty o błędach i rozwiązania. Następujące typy subskrypcji nie są obecnie obsługiwane:

  • Konta przedsiębiorstwa znajdujące się w Korei Południowej
  • subskrypcje Dostawca rozwiązań w chmurze
  • Subskrypcje Azure, które nie mają aktywnej metody rozliczeń z płatnością zgodnie z rzeczywistym użyciem (na przykład dla studentów, bezpłatnych wersji próbnych lub kont opartych na kredytach startowych)
  • Subskrypcje sponsorowane, które korzystają wyłącznie z kredytów Azure. Uwaga: Jeśli masz konto z zarejestrowaną kartą kredytową, karta kredytowa zostanie obciążona zamiast Azure Credits.

Aby uzyskać listę obsługiwanych regionów, zobacz obsługiwane lokalizacje geograficzne. Należy pamiętać, że "Zasady obsługiwanych regionów" firmy Anthropic mogą wpływać na dostępność w Twoim regionie, sprawdź obsługiwane regiony aby uzyskać szczegółowe informacje.

Wymagania wstępne

Wymagania systemowe

Wymóg Szczegóły
System operacyjny macOS 13+, Ubuntu 20.04+/Debian 10+, Windows 10+ (działające natywnie za pośrednictwem Git Bash lub WSL)
RAM Minimalna 4 GB (zalecane 8 GB)
Git (opcjonalnie, zalecane) 2.23+ dla pomocników pull requestów

Wdrażanie modelu Claude'a w narzędziu Foundry

Przed skonfigurowaniem programu Claude Code wdróż dostępne modele Claude'a , których potrzebuje Claude Code. Większość modeli Claude'a obsługuje standardowe wdrożenie globalne. Aby uzyskać więcej informacji na temat obsługiwanych typów wdrożeń, zobacz Claude models in Microsoft Foundry (Modele Claude w usłudze Microsoft Foundry).

Claude Code używa różnych modeli do różnych zadań:

Ważne

Dostępność modeli Claude'a w Microsoft Foundry może ulec zmianie. Sprawdź stronę Modele Foundry od partnerów, aby uzyskać najnowszą listę dostępnych modeli.

Rola Code Claude'a Zalecane wdrożenie Cel
Model podstawowy claude-sonnet-4-6 Kodowanie ogólne — zrównoważona szybkość i jakość
Szybki model claude-haiku-4-5 Szybkie operacje — odczyty plików, małe edycje
Myślenie rozszerzone claude-opus-4-6 Złożone zadania rozumowania (opcjonalnie)

Wdrażanie modelu bezpośrednio w narzędziu Foundry

Aby wdrożyć model:

  1. Postępuj zgodnie z instrukcjami w artykule Wdrażanie i używanie modeli Claude'a w Microsoft Foundry w celu wdrożenia modelu Claude'a, takiego jak Opus 4.6.

  2. Po wdrożeniu wybierz kartę Szczegóły wdrożenia i zanotuj identyfikator URI i klucz docelowy. Te wartości są potrzebne do konfiguracji.

Alternatywa: Wdrażanie modelu przy użyciu routera modelu

Model Routera to model Foundry, który inteligentnie kieruje każde żądanie do najlepszego modelu bazowego na podstawie złożoności, kosztów i wydajności zapytań. Wersja 2025-11-18 routera modelu obsługuje wybieranie modeli Claude'a (claude-haiku-4-5, claude-sonnet-4-5, claude-opus-4-6, claude-opus-4-7i claude-opus-4-8) wraz z innymi modelami rozwiązania Foundry.

Uwaga

Router modelu może jeszcze nie obsługiwać niektórych nowszych modeli Claude'a. Jeśli potrzebujesz takich modeli, wdróż je i odwołuj się bezpośrednio zamiast używać routera modelu.

Korzyści dla użytkowników Aplikacji Claude Code:

  • Automatyczny wybór modelu: Proste wskazówki kierują do szybszych, tańszych modeli. Złożone zadania kodowania kierują do bardziej zdolnych modeli.
  • Optymalizacja kosztów: użyj profilów routingu, aby równoważyć jakość i koszty przy zachowaniu wydajności punktu odniesienia.
  • Pojedynczy punkt końcowy: jedno wdrożenie obsługuje wszystkie decyzje dotyczące routingu w całej floty modeli.

Aby użyć Routera Modelu z Claude Code, najpierw implementuj obsługiwane modele Claude, a następnie implementuj Router Modelu i włącz je za pomocą konfiguracji podzestawu modelu.

Instalowanie interfejsu wiersza polecenia programu Claude Code

Zainstaluj interfejs wiersza polecenia programu Claude Code, aby pracować z programem Claude Code bezpośrednio w terminalu. Następnie sprawdź, czy claude znajduje się w zmiennej PATH, uruchamiając polecenie claude --version.

Uwaga

Anthropic zaniechał stosowania metody instalacji npm. Zamiast tego użyj natywnego instalatora lub oprogramowania Homebrew. Jeśli już zainstalowałeś za pomocą npm, uruchom claude install, aby przeprowadzić migrację do metody natywnej.

Instalacje natywne są automatycznie aktualizowane w tle, aby zachować najnowszą wersję.

W systemie macOS lub Windows (Git Bash lub WSL) uruchom skrypt instalatora, który pobiera i konfiguruje plik binarny claude:

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

Instalacja za pomocą oprogramowania Homebrew

W przypadku korzystania z systemu macOS:

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

Instalacje oprogramowania Homebrew nie aktualizują się automatycznie. Uruchamiaj brew upgrade claude-code okresowo, aby uzyskać najnowsze funkcje i poprawki zabezpieczeń.

Rozwiązywanie problemów z lokalizacją instalacji

claude --version Jeśli polecenie nie zostanie znalezione, dodaj lokalizację instalacji do zmiennej środowiskowej PATH w następujący sposób:

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

Aby uzyskać więcej opcji instalacji, zobacz dokumentację programu Claude Code.

Konfigurowanie kodu Claude'a dla rozwiązania Foundry

Aby skonfigurować program Claude Code for Foundry, należy użyć nazwy zasobu Foundry lub podstawowego adresu URL.

Aby znaleźć nazwę zasobu Foundry w portalu Foundry:

  1. Przejdź do lewej górnej nawigacji i wybierz pozycję Zarządzaj>Project szczegóły.
  2. Skopiuj wartość Parent resource ze strony szczegóły projektu.

Aby znaleźć podstawowy adres URL z portalu Foundry:

  1. Przejdź do strony głównej portalu Foundry
  2. Znajdź punkt końcowy Project i skopiuj część adresu URL przed /api/projects/<your-project-name>. Podstawowy adres URL ma postać https://<your-resource-name>.services.ai.azure.com. Claude Code dołącza /anthropic do tego adresu URL automatycznie, gdy używasz polecenia ANTHROPIC_FOUNDRY_RESOURCE.

Ustaw zmienne środowiskowe, aby połączyć program Claude Code z wdrożeniem 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"

W poniższej tabeli opisano każdą zmienną:

Zmienna Opis
CLAUDE_CODE_USE_FOUNDRY Ustaw wartość 1, aby włączyć integrację Microsoft Foundry.
ANTHROPIC_FOUNDRY_RESOURCE Nazwa zasobu usługi Foundry. Claude Code tworzy adres URL punktu końcowego jako https://<resource-name>.services.ai.azure.com/anthropic.
ANTHROPIC_DEFAULT_SONNET_MODEL Nazwa wdrożenia modelu Claude Sonnet (podstawowy model kodowania).
ANTHROPIC_DEFAULT_HAIKU_MODEL Nazwa wdrożenia modelu Claude Haiku (szybkie operacje).
ANTHROPIC_DEFAULT_OPUS_MODEL Nazwa wdrożenia modelu Claude Opus (skomplikowane rozumowanie).

Aby zachować te zmienne między sesjami terminala, dodaj je do profilu powłoki (np. ~/.bashrc lub ~/.zshrc).

Uwierzytelnianie za pomocą narzędzia Foundry

Program Claude Code obsługuje dwie metody uwierzytelniania dla Microsoft Foundry:

  • Microsoft Entra ID (zalecane): używa poświadczeń Azure CLI. Najlepsze dla środowisk korporacyjnych, dostępu zespołowego oraz potoków CI/CD, gdzie pożądane jest scentralizowane zarządzanie tożsamościami bez konieczności zarządzania tajnymi danymi.
  • Klucz interfejsu API: używa klucza interfejsu API projektu z portalu Foundry. Najlepsze w przypadku szybkich testów lub środowisk, w których Azure CLI nie jest dostępna.

Uwierzytelnianie Microsoft Entra ID automatycznie używa twoich poświadczeń Azure CLI. Uruchom az login przed rozpoczęciem programu Claude Code:

  1. Zaloguj się przy użyciu Azure CLI:

    az login

    Wskazówka

    Jeśli zasób Foundry znajduje się w innej dzierżawie niż domyślna dzierżawa Azure CLI, określ identyfikator dzierżawy:

    az login --tenant <tenant-id>

  2. Sprawdź, czy logowanie jest przeznaczone dla właściwej subskrypcji:

    az account show

W przypadku używania Microsoft Foundry polecenia /login i /logout wewnątrz programu Claude Code są wyłączone. Uwierzytelnianie jest obsługiwane za pośrednictwem poświadczeń Azure.

Claude Code wykrywa sesję Azure CLI i używa jej do uwierzytelniania bez dodatkowej konfiguracji.

Opcja B: klucz interfejsu API

Jeśli wolisz uwierzytelnianie klucza interfejsu API, ustaw klucz w zmiennych środowiskowych.

  1. W portalu Microsoft Foundry otwórz zasób.
  2. Na stronie Home znajdź klucz interfejsu API Project.
  3. Wybierz Skopiuj klucz API projektu, aby skopiować wartość. Jest to klucz używany dla zmiennej środowiskowej ANTHROPIC_FOUNDRY_API_KEY .
  4. Ustaw zmienną środowiskową w terminalu:
export ANTHROPIC_FOUNDRY_API_KEY="<your-foundry-api-key>"

Wskazówka

Klucz interfejsu API można również znaleźć w portalu Foundry na karcie Szczegóły wdrożenia modelu.

Konfigurowanie rozszerzenia programu VS Code

Rozszerzenie Claude Code programu VS Code udostępnia natywny interfejs graficzny dla programu Claude Code bezpośrednio w środowisku IDE.

  1. Zainstaluj rozszerzenie z witryny MARKETPLACE programu VS Code.

  2. Otwórz ustawienia programu VS Code (Ctrl+lubCmd+) i wyszukaj frazę Claude Code: Zmienne środowiskowe.

  3. Wybierz pozycję Edytuj w settings.json i dodaj następującą konfigurację:

      {
    "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. Wybierz ikonę Spark na pasku bocznym, aby otworzyć panel Claude Code.

  5. Claude Code uwierzytelnia się przy użyciu poświadczeń Azure. Uruchom az login najpierw, jeśli używasz uwierzytelniania Microsoft Entra ID.

Rozszerzenie obsługuje tryb automatycznego akceptowania edycji, trybu planu, rozszerzonego myślenia i zarządzania plikami za pomocą @-mentions — wszystko to podczas routingu za pośrednictwem wdrożenia Microsoft Foundry.

Weryfikowanie konfiguracji

Sprawdź, czy kod Claude'a jest poprawnie skonfigurowany do używania Microsoft Foundry.

  1. Otwórz terminal i przejdź do katalogu projektu:

    cd your-project

  2. Uruchom Program Claude Code:

    claude

    Kod Claude'a domyślnie określa model Sonnet na potrzeby ogólnego kodowania. Jeśli nie wdrożono jeszcze wszystkich trzech modeli, możesz bezpośrednio określić wdrożony model:

    claude --model claude-opus-4-6

  3. /status Uruchom polecenie:

    > /status

    Dane wyjściowe powinny wyglądać podobnie do poniższego przykładu. Dokładny format może się różnić w zależności od wersji programu 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:
─────────────────────────────────────

    Potwierdź następujące elementy w wynikach z raportu stanu:

    Pole Oczekiwana wartość
    Dostawca interfejsu API Microsoft Foundry
    Zasób usługi Foundry Nazwa zasobu usługi Foundry
    Model Wdrożony model (na przykład claude-sonnet-4-6)

  4. Wyślij monit testowy, taki jak "Podsumuj strukturę tego projektu".

  5. Upewnij się, że Claude Code odpowiada analizą twojego projektu. Pomyślne połączenie pokazuje interakcyjny monit Claude Code bez błędów uwierzytelniania.

    Jeśli kod Claude'a wyświetla błąd, taki jak "Nie można uzyskać tokenu" lub "model jest niedostępny", zobacz sekcję Rozwiązywanie problemów .

Tworzenie kontekstu projektu za pomocą CLAUDE.md

Dodatkowe instrukcje i wskazówki dotyczące programu Claude Code można przekazać za pomocą CLAUDE.md plików. Claude Code szuka CLAUDE.md plików w następujących miejscach i scala je od góry do dołu (czyli pliki ładują się w kolejności, gdzie późniejsze pliki zastępują wcześniejsze), dzięki czemu ma kontekst dotyczący twoich osobistych preferencji, szczegółów specyficznych dla projektu i obecnego zadania.

  1. ~/.claude/CLAUDE.md — Wartości domyślne globalne we wszystkich projektach
  2. ./CLAUDE.md — Ustawienia katalogu głównego repozytorium
  3. ./current-dir/CLAUDE.md — Specyfika bieżącego katalogu

Claude Code obsługuje również reguły projektu (.claude/rules/*.md) i pamięć lokalną (CLAUDE.local.md) dla bardziej szczegółowej kontroli. Aby uzyskać pełną hierarchię pamięci, zobacz dokumentację pamięci Claude Code.

Poniższy przykład przedstawia plik CLAUDE.md dla projektu Microsoft Agent Framework. Utwórz podobny plik w katalogu głównym projektu, aby ułatwić Aplikacji Claude Code zrozumienie bazy kodu:

# 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

Po utworzeniu CLAUDE.md pliku uruchom program Claude Code w katalogu projektu, aby załadować kontekst:

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

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

Konfigurowanie kontroli dostępu opartej na rolach Azure

Aby udzielić członkom zespołu dostępu do modeli Claude'a hostowanego przez usługę Foundry, przypisz jedną z następujących wbudowanych ról:

Roli Uprawnienia
Użytkownik platformy Foundry Wywoływanie modeli, wyświetlanie wdrożeń
Użytkownik usług Cognitive Services Wywoływanie modeli, wyświetlanie wdrożeń (starsza Azure rola usług sztucznej inteligencji)

Ważne

Niedawno zmieniono nazwy ról RBAC w usłudze Foundry. Użytkownik Foundry, właściciel Foundry, właściciel konta Foundry i menedżer projektu Foundry były wcześniej nazywane odpowiednio użytkownikiem Azure AI, właścicielem Azure AI, właścicielem konta Azure AI i menedżerem projektu Azure AI. Poprzednie nazwy mogą być nadal widoczne w niektórych miejscach, podczas gdy zmiana nazwy jest wdrażana. Identyfikatory ról i uprawnienia podstawowe są niezmienione przez zmianę nazwy.

Rola Użytkownika usługi Foundry jest zalecaną rolą natywną dla rozwiązania Foundry. Rola użytkownika usług Cognitive Services jest starszą rolą, która również przyznaje uprawnienia wywołania modelu na poziomie zasobu Azure.

Te role obejmują wszystkie wymagane uprawnienia do uruchamiania Claude Code z Foundry.

Aby uzyskać bardziej restrykcyjny dostęp, utwórz rolę niestandardową o zakresie dopasowanym do konkretnych działań na danych potrzebnych zespołowi. Aby uzyskać wskazówki dotyczące definiowania ról niestandardowych, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

Uruchamianie programu Claude Code w GitHub Actions

Claude Code integruje się z GitHub Actions do automatyzacji CI/CD. Przed użyciem tych workflowów zapisz klucz interfejsu API w składnicy tajemnic repozytorium.

Generowanie testów żądań ściągnięcia

Utwórz przepływ pracy, który generuje testy w przypadku zmiany plików agenta lub narzędzia:

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

Wyzwalanie przeglądu żądania ściągnięcia za pomocą polecenia @claude

Utwórz workflow, który odpowiada na @claude wzmianki w komentarzach pull requestów:

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

Monitorowanie użycia

Monitorowanie użycia kodu Claude'a w portalu Foundry:

  1. Przejdź do Microsoft Foundry i otwórz projekt.

  2. Przejdź do obszaru Obsługa , aby wyświetlić metryki użycia:

    • Użycie tokenu według modelu
    • Opóźnienie żądania
    • Współczynniki błędów i przekroczenia limitu szybkości

Aby ustawić limity tokenów na żądanie, skonfiguruj zmienną ANTHROPIC_MAX_TOKENS środowiskową:

Uwaga

ANTHROPIC_MAX_TOKENS zmienna może nie być obsługiwana we wszystkich wersjach programu Claude Code. Zapoznaj się z dokumentacją programu Claude Code , aby zapoznać się z najnowszymi obsługiwanymi zmiennymi środowiskowymi.

export ANTHROPIC_MAX_TOKENS=100000

Aby uzyskać opcje konfiguracji kontrolujące użycie i koszt tokenu, takie jak limity tokenów specyficznych dla modelu, zobacz dokumentację konfiguracji kodu Claude'a.

Czyszczenie zasobów

Jeśli nie potrzebujesz już wdrożeń modelu Claude'a, usuń je, aby zwolnić miejsca wdrożenia i limit przydziału w zasobie. Modele Claude'a korzystają z wdrożeń według globalnego standardu z rozliczeniem opartym na liczbie tokenów, więc nieużywane wdrożenia nie generują opłat. Jednak każde wdrożenie liczy się do limitu wdrożenia, który wynosi 32 wdrożenia na zasób.

Usuwanie wdrożeń w portalu Foundry

Użyj jednej z tych ścieżek nawigacji:

  • Wybierz pozycję Obsługa w górnej nawigacji, a następnie wybierz pozycję Modele zasobów> w lewym obszarze nawigacyjnym. Wybierz wdrożenie, które chcesz usunąć, a następnie wybierz pozycję Usuń.
  • Wybierz pozycję Kompiluj w górnej nawigacji, a następnie wybierz pozycję Modele w obszarze nawigacji po lewej stronie. Wybierz nazwę wdrożenia, aby otworzyć jego stronę szczegółów, wybierz kartę Szczegóły , a następnie wybierz pozycję Usuń w górnym panelu.

Usuwanie wdrożeń za pomocą Azure CLI

Uruchom polecenie az cognitiveservices account deployment delete na każdym wdrożeniu:

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

Zastąp <deployment-name> nazwą wdrożenia modelu (taką jak claude-sonnet-4-6), <resource-name> nazwą zasobu Foundry i <resource-group-name> grupą zasobów zawierającą zasób Foundry.

Rozwiązywanie problemów

Problem Rozwiązanie
Autoryzacja nie powiodła się (HTTP 401/403) Sprawdź, czy az login zakończono pomyślnie lub czy klucz API został poprawnie ustawiony. Sprawdź, czy twoje konto ma dostęp do zasobu Foundry.
Claude Code się uruchamia, ale nie znajduje modeli Sprawdź, czy ANTHROPIC_FOUNDRY_RESOURCE pasuje do nazwy zasobu i czy ANTHROPIC_DEFAULT_*_MODEL wartości są zgodne z nazwami wdrożeń.
Przekroczono limit szybkości (HTTP 429) Sprawdź limity przydziału w portalu Foundry w obszarze Zarządzanie limitem>przydziału. Rozważ dostosowanie limitów tokenów zgodnie z dokumentacją konfiguracji programu Claude Code.
Rozszerzenie programu VS Code nie łączy się Przed uruchomieniem programu VS Code upewnij się, że zmienne środowiskowe są ustawione. Spróbuj uruchomić program VS Code z terminalu po ustawieniu zmiennych.
Problemy z rozszerzeniem WSL + VS Code Rozszerzenie może sprawdzić klucz API na hoście Windows zamiast w środowisku WSL. Ustaw zmienną środowiskową zarówno na hoście Windows, jak i WSL, a następnie uruchom nowy terminal z programu WSL i uruchom polecenie code .
Błędy regionów Modele Claude'a są dostępne tylko w regionach East US 2 i Centralnej Szwecji.
Nie udało się pobrać tokenu z azureADTokenProvider: Uwierzytelnienie ChainedTokenCredential zakończyło się niepowodzeniem. Zaloguj się poprzez az login lub ustaw ANTHROPIC_FOUNDRY_API_KEY dla uwierzytelniania klucza API.
"Model <model-name> nie jest dostępny we wdrożeniu rozwiązania foundry" Wdróż brakujący model w portalu Foundry. Claude Code wymaga, aby każda rola modelu (Sonnet, Haiku, Opus) posiadała odpowiadające wdrożenie.
Token dzierżawcy nie pasuje do dzierżawcy zasobu Twój Azure CLI jest zalogowany do innego najemcy niż zasób Foundry. Uruchom polecenie az login --tenant <tenant-id> , aby zalogować się do odpowiedniej dzierżawy.
Tworzenie wdrożenia kończy się niepowodzeniem w portalu Foundry Sprawdź, czy masz rolę Contributor lub Owner w grupie zasobów, a subskrypcja ma włączony dostęp Azure Marketplace.
Claude Code prosi o zalogowanie do Anthropic Sprawdź, czy CLAUDE_CODE_USE_FOUNDRY=1 ustawiono wartość . Bez tej zmiennej Claude Code używa domyślnego interfejsu API Anthropic.

Powiązana zawartość

  • Last updated on