Claude Code di Microsoft Foundry
Pelajari tentang mengonfigurasi Claude Code melalui Microsoft Foundry, termasuk setup, konfigurasi, dan pemecahan masalah.
Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.
View plans Contact sales
Prasyarat
Sebelum mengonfigurasi Claude Code dengan Microsoft Foundry, pastikan Anda memiliki:
- Langganan Azure dengan akses ke Microsoft Foundry
- Izin RBAC untuk membuat sumber daya dan deployment Microsoft Foundry
- Azure CLI diinstal dan dikonfigurasi (opsional - hanya diperlukan jika Anda tidak memiliki mekanisme lain untuk mendapatkan kredensial)
[!NOTE]
Jika Anda menerapkan Claude Code ke beberapa pengguna, pin versi model Anda sebelum melakukan peluncuran.
Penyiapan
Sediakan resource Microsoft Foundry
Pertama, buat resource Claude di Azure:
-
Buat resource baru, dan catat nama resource Anda
-
Buat deployment untuk model Claude, dan catat nama deployment yang Anda berikan untuk masing-masing; Anda akan menetapkan nama-nama ini sebagai variabel model pada langkah 4:
- Claude Opus
- Claude Sonnet
- Claude Haiku
Saat Anda mengonfigurasi deployment, Anda juga memilih opsi hosting-nya, yang menentukan apakah inferensi berjalan di infrastruktur Azure atau di infrastruktur Anthropic.
Konfigurasikan kredensial Azure
Claude Code mendukung tiga metode autentikasi untuk Microsoft Foundry. Pilih metode yang paling sesuai dengan persyaratan keamanan Anda:
- Kunci API: Anda menyalin kunci dari portal Microsoft Foundry dan menetapkannya sebagai
ANTHROPIC_FOUNDRY_API_KEY - Microsoft Entra ID: Claude Code mendapatkan token melalui rantai kredensial default Azure SDK, misalnya dari sesi
az login, sehingga tidak ada kunci API yang perlu disimpan - Bearer token: proses lain memperoleh access token Microsoft Entra ID dan Anda meneruskannya di
ANTHROPIC_FOUNDRY_AUTH_TOKEN
[!NOTE]
Saat menggunakan Microsoft Foundry, perintah
/logouttidak tersedia karena autentikasi ditangani melalui kredensial Azure.
Menggunakan kunci API
Salin kunci dari portal Microsoft Foundry, lalu tetapkan sebagai environment variable:
- Buka resource Anda di portal Microsoft Foundry
- Buka bagian Endpoints and keys
- Salin API Key
- Tetapkan environment variable, dengan mengganti
your-azure-api-keydengan kunci yang Anda salin:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
Menggunakan Microsoft Entra ID
Biarkan ANTHROPIC_FOUNDRY_API_KEY dan ANTHROPIC_FOUNDRY_AUTH_TOKEN tidak ditetapkan. Claude Code kemudian menggunakan rantai kredensial default Azure SDK.
Ini mendukung berbagai metode untuk mengautentikasi workload lokal maupun jarak jauh.
Di mesin lokal, masuk dengan Azure CLI:
az login
Untuk peran yang dibutuhkan identitas Anda, lihat Konfigurasi Azure RBAC.
Menggunakan bearer token
Claude Code mengirimkan nilai ANTHROPIC_FOUNDRY_AUTH_TOKEN pada setiap permintaan sebagai header Authorization: Bearer. Gunakan opsi ini ketika proses lain, seperti aplikasi host atau skrip masuk, telah memperoleh access token untuk Anda.
Tetapkan variabel ke bearer token yang diterbitkan Microsoft Entra ID untuk resource Anda:
export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
ANTHROPIC_FOUNDRY_AUTH_TOKEN diutamakan daripada ANTHROPIC_FOUNDRY_API_KEY dan daripada rantai kredensial default.
Konfigurasikan Claude Code
Tetapkan environment variable berikut untuk mengaktifkan Microsoft Foundry:
# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
Tetapkan ANTHROPIC_FOUNDRY_RESOURCE hanya ke nama resource, seperti my-resource. Claude Code menolak URL atau nama host saat Anda mengirim pesan.
Sematkan versi model
[!WARNING]
Sematkan versi model tertentu untuk setiap deployment. Tanpa penyematan, alias model seperti
sonnetdanopusdi-resolve ke default bawaan Claude Code untuk Microsoft Foundry, yang mungkin tertinggal dari rilis terbaru dan mungkin belum tersedia di akun Anda. Microsoft Foundry tidak memiliki pemeriksaan model saat startup, sehingga permintaan gagal ketika default tidak tersedia. Saat Anda membuat deployment Azure, pilih versi model tertentu alih-alih "auto-update to latest."
Tetapkan variabel model agar sesuai dengan nama deployment yang Anda buat pada langkah 1.
Tanpa ANTHROPIC_DEFAULT_OPUS_MODEL, alias opus di Microsoft Foundry di-resolve ke Opus 4.6. Tetapkan ke ID model Opus yang lebih baru, seperti Opus 4.8:
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
Tugas latar belakang seperti pembuatan judul sesi menggunakan model kecil/cepat, biasanya model kelas Haiku. Di Microsoft Foundry, Claude Code secara default menggunakan model utama untuk ini karena tidak setiap akun memiliki deployment Haiku. Untuk menggunakan Haiku bagi tugas latar belakang, tetapkan ANTHROPIC_DEFAULT_HAIKU_MODEL ke deployment Haiku yang tersedia di akun Anda, seperti yang ditunjukkan di atas.
Untuk ID model saat ini dan lama, lihat Ikhtisar model. Lihat Konfigurasi model untuk daftar lengkap environment variable.
Prompt caching diaktifkan secara otomatis. Untuk meminta TTL cache 1 jam alih-alih default 5 menit, tetapkan variabel berikut; penulisan cache dengan TTL 1 jam ditagih dengan tarif yang lebih tinggi:
export ENABLE_PROMPT_CACHING_1H=1
Untuk menetapkan TTL yang berbeda untuk percakapan utama Anda dan untuk permintaan yang dibuat Claude Code di luar percakapan tersebut, pilih TTL sendiri.
Jalankan Claude Code
Setelah environment variable ditetapkan, jalankan Claude Code dari direktori proyek Anda:
claude
Claude Code membaca CLAUDE_CODE_USE_FOUNDRY dan variabel Microsoft Foundry lainnya dari lingkungan dan terhubung ke resource Azure Anda pada prompt pertama. Tidak seperti Amazon Bedrock dan Agent Platform dari Google Cloud, Microsoft Foundry tidak memiliki wizard penyiapan interaktif, sehingga environment variable pada langkah 3 dan 4 adalah satu-satunya jalur konfigurasi.
Untuk memverifikasi penyiapan Anda, jalankan /status di dalam Claude Code. Baris penyedia API menampilkan Microsoft Foundry, beserta nama resource atau base URL yang Anda konfigurasikan.
Konfigurasi Azure RBAC
Peran default Azure AI User dan Cognitive Services User mencakup semua izin yang diperlukan untuk memanggil model Claude.
Untuk izin yang lebih ketat, buat peran khusus dengan yang berikut:
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
Untuk detail, lihat dokumentasi RBAC Microsoft Foundry.
1M token context window
Di Microsoft Foundry, ketika Claude Code dapat mengetahui model mana yang dilayani oleh deployment Anda, model Fable, Sonnet 5 dan yang lebih baru, serta Opus 4.7 dan yang lebih baru berjalan dengan 1M token context window secara default, tanpa perlu akhiran [1m]. Claude Code membaca model dari nama deployment dalam variabel model Anda. Beri nama setiap deployment dengan ID modelnya, seperti claude-opus-4-8, atau petakan model ke nama deployment Anda dengan modelOverrides. Untuk nama deployment yang tidak dapat dicocokkan dengan model, Claude Code mengasumsikan window 200K kecuali Anda mendeklarasikan window yang berbeda.
Entri settings.json ini memberi tahu Claude Code bahwa deployment bernama team-opus-prod melayani Opus 4.8:
{
"modelOverrides": {
"claude-opus-4-8": "team-opus-prod"
}
}
Untuk tetap menggunakan window 200K, atur CLAUDE_CODE_DISABLE_1M_CONTEXT=1.
Opus 4.6 dan Sonnet 4.6 mencapai window 1M ketika Anda menambahkan [1m] ke nama deployment di ANTHROPIC_DEFAULT_OPUS_MODEL atau ANTHROPIC_DEFAULT_SONNET_MODEL, sebagaimana dijelaskan dalam Menyematkan model untuk deployment pihak ketiga. Sebelum v2.1.287, model Fable serta Opus 4.7 dan yang lebih baru juga memerlukan akhiran tersebut di Microsoft Foundry dan berjalan dengan window 200K secara default tanpanya.
Pemecahan Masalah
Jika Anda menerima kesalahan "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":
- Konfigurasi Entra ID di lingkungan, atau atur
ANTHROPIC_FOUNDRY_API_KEY.
Jika permintaan gagal dengan kesalahan koneksi berulang pada prompt pertama:
- Periksa bahwa
ANTHROPIC_FOUNDRY_RESOURCEdiatur ke nama sumber daya aktual Anda daripada placeholder. Claude Code membangun URL endpoint dari nilai ini, jadi nama yang salah menunjuk ke host yang tidak ada.