SpyBara
Go Premium

microsoft-foundry.md 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

18 added, 6 removed.

2026
Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

Claude Code di Microsoft Foundry

Pelajari tentang mengonfigurasi Claude Code melalui Microsoft Foundry, termasuk setup, konfigurasi, dan pemecahan masalah.

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

Prasyarat

Sebelum mengonfigurasi Claude Code dengan Microsoft Foundry, pastikan Anda memiliki:

Setup

1. Menyediakan sumber daya Microsoft Foundry

Pertama, buat sumber daya Claude di Azure:

  1. Navigasikan ke portal Microsoft Foundry
  2. Buat sumber daya baru, catat nama sumber daya Anda
  3. Buat deployment untuk model Claude:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2) Konfigurasi kredensial Azure

Claude Code mendukung tiga metode autentikasi untuk Microsoft Foundry. Pilih metode yang paling sesuai dengan persyaratan keamanan Anda.

Opsi A: Autentikasi kunci API

  1. Navigasikan ke sumber daya Anda di portal Microsoft Foundry
  2. Buka bagian Endpoints and keys
  3. Salin API Key
  4. Atur variabel lingkungan:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Opsi B: Autentikasi Microsoft Entra ID

Ketika ANTHROPIC_FOUNDRY_API_KEY dan ANTHROPIC_FOUNDRY_AUTH_TOKEN tidak diatur, Claude Code secara otomatis menggunakan Azure SDK rantai kredensial default. Ini mendukung berbagai metode untuk mengautentikasi beban kerja lokal dan jarak jauh.

Di lingkungan lokal, Anda biasanya dapat menggunakan Azure CLI:

az login

Opsi C: Autentikasi bearer token

{/* min-version: 2.1.203 */}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 sign-in, telah memperoleh token akses untuk Anda. Memerlukan Claude Code v2.1.203 atau lebih baru.

Atur variabel ke bearer token yang dikeluarkan Microsoft Entra ID untuk sumber daya Anda:

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

ANTHROPIC_FOUNDRY_AUTH_TOKEN memiliki prioritas lebih tinggi daripada ANTHROPIC_FOUNDRY_API_KEY dan rantai kredensial default.

3. Konfigurasi Claude Code

Atur variabel lingkungan berikut untuk mengaktifkan Microsoft Foundry:

# Aktifkan integrasi Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1

# Nama sumber daya Azure (ganti {resource} dengan nama sumber daya Anda)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Atau berikan URL dasar lengkap:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. Pin model versions

Atur variabel model agar sesuai dengan nama deployment yang Anda buat di langkah 1.

Tanpa ANTHROPIC_DEFAULT_OPUS_MODEL, alias opus di Microsoft Foundry diselesaikan ke Opus 4.6. Aturnya ke ID Opus 4.8 untuk menggunakan model terbaru:

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 karena tidak setiap akun memiliki deployment Haiku. Untuk menggunakan Haiku untuk tugas latar belakang, atur ANTHROPIC_DEFAULT_HAIKU_MODEL ke deployment Haiku yang tersedia di akun Anda, seperti yang ditunjukkan di atas.

Untuk ID model saat ini dan legacy, lihat Models overview. Lihat Model configuration untuk daftar lengkap variabel lingkungan.

Prompt caching diaktifkan secara otomatis. Untuk meminta TTL cache 1 jam alih-alih default 5 menit, atur variabel berikut; cache writes dengan TTL 1 jam ditagih dengan tarif yang lebih tinggi:

export ENABLE_PROMPT_CACHING_1H=1

5. Jalankan Claude Code

Dengan variabel lingkungan yang diatur, mulai Claude Code dari direktori proyek Anda:

claude

Claude Code membaca CLAUDE_CODE_USE_FOUNDRY dan variabel Microsoft Foundry lainnya dari lingkungan dan terhubung ke sumber daya Azure Anda pada prompt pertama. Tidak seperti Amazon Bedrock dan Google Cloud's Agent Platform, Microsoft Foundry tidak memiliki wizard setup interaktif, jadi variabel lingkungan di langkah 3 dan 4 adalah satu-satunya jalur konfigurasi.

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.

Pemecahan Masalah

Jika Anda menerima kesalahan "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

Sumber daya tambahan