6 6
7> Pelajari tentang mengonfigurasi Claude Code melalui Microsoft Foundry, termasuk setup, konfigurasi, dan pemecahan masalah.7> Pelajari tentang mengonfigurasi Claude Code melalui Microsoft Foundry, termasuk setup, konfigurasi, dan pemecahan masalah.
8 8
9export const ContactSalesCard = ({surface}) => {9<h2 id="prerequisites">
10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 Prasyarat
11 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">11</h2>
12 <line x1="5" y1="12" x2="19" y2="12" />
13 <polyline points="12 5 19 12 12 19" />
14 </svg>;
15 const STYLES = `
16.cc-cs {
17 --cs-slate: #141413;
18 --cs-clay: #d97757;
19 --cs-clay-deep: #c6613f;
20 --cs-gray-000: #ffffff;
21 --cs-gray-700: #3d3d3a;
22 --cs-border-default: rgba(31, 30, 29, 0.15);
23 font-family: inherit;
24}
25.dark .cc-cs {
26 --cs-slate: #f0eee6;
27 --cs-gray-000: #262624;
28 --cs-gray-700: #bfbdb4;
29 --cs-border-default: rgba(240, 238, 230, 0.14);
30}
31.cc-cs-card {
32 display: flex; align-items: center; justify-content: space-between;
33 gap: 16px; padding: 14px 16px; margin: 0;
34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);
35 border-radius: 8px; flex-wrap: wrap;
36}
37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }
38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }
39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }
40.cc-cs-btn-clay {
41 display: inline-flex; align-items: center; gap: 8px;
42 background: var(--cs-clay-deep); color: #fff; border: none;
43 border-radius: 8px; padding: 8px 14px;
44 font-size: 13px; font-weight: 500;
45 transition: background-color 0.15s; white-space: nowrap;
46}
47.cc-cs-btn-clay:hover { background: var(--cs-clay); }
48.cc-cs-btn-ghost {
49 display: inline-flex; align-items: center; gap: 8px;
50 background: transparent; color: var(--cs-gray-700);
51 border: 0.5px solid var(--cs-border-default);
52 border-radius: 8px; padding: 8px 14px;
53 font-size: 13px; font-weight: 500;
54}
55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }
56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }
57@media (max-width: 720px) {
58 .cc-cs-actions { width: 100%; }
59}
60`;
61 return <div className="cc-cs not-prose">
62 <style>{STYLES}</style>
63 <div className="cc-cs-card">
64 <div className="cc-cs-text">
65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.
66 </div>
67 <div className="cc-cs-actions">
68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">
69 View plans
70 </a>
71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">
72 Contact sales {iconArrowRight()}
73 </a>
74 </div>
75 </div>
76 </div>;
77};
78
79<ContactSalesCard surface="foundry" />
80
81## Prasyarat
82 12
83Sebelum mengonfigurasi Claude Code dengan Microsoft Foundry, pastikan Anda memiliki:13Sebelum mengonfigurasi Claude Code dengan Microsoft Foundry, pastikan Anda memiliki:
84 14
90 Jika Anda menerapkan Claude Code ke beberapa pengguna, [pin versi model Anda](#4-pin-model-versions) untuk mencegah kerusakan ketika Anthropic merilis model baru.20 Jika Anda menerapkan Claude Code ke beberapa pengguna, [pin versi model Anda](#4-pin-model-versions) untuk mencegah kerusakan ketika Anthropic merilis model baru.
91</Note>21</Note>
92 22
93## Setup23<h2 id="setup">
24 Setup
25</h2>
94 26
95### 1. Menyediakan sumber daya Microsoft Foundry27<h3 id="1-provision-microsoft-foundry-resource">
28 1. Menyediakan sumber daya Microsoft Foundry
29</h3>
96 30
97Pertama, buat sumber daya Claude di Azure:31Pertama, buat sumber daya Claude di Azure:
98 32
103 * Claude Sonnet37 * Claude Sonnet
104 * Claude Haiku38 * Claude Haiku
105 39
106### 2. Konfigurasi kredensial Azure40<h3 id="2-configure-azure-credentials">
41 2) Konfigurasi kredensial Azure
42</h3>
107 43
108Claude Code mendukung dua metode autentikasi untuk Microsoft Foundry. Pilih metode yang paling sesuai dengan persyaratan keamanan Anda.44Claude Code mendukung dua metode autentikasi untuk Microsoft Foundry. Pilih metode yang paling sesuai dengan persyaratan keamanan Anda.
109 45
130```66```
131 67
132<Note>68<Note>
133 Saat menggunakan Microsoft Foundry, perintah `/login` dan `/logout` dinonaktifkan karena autentikasi ditangani melalui kredensial Azure.69 Saat menggunakan Microsoft Foundry, perintah `/logout` tidak tersedia karena autentikasi ditangani melalui kredensial Azure.
134</Note>70</Note>
135 71
136### 3. Konfigurasi Claude Code72<h3 id="3-configure-claude-code">
73 3. Konfigurasi Claude Code
74</h3>
137 75
138Atur variabel lingkungan berikut untuk mengaktifkan Microsoft Foundry:76Atur variabel lingkungan berikut untuk mengaktifkan Microsoft Foundry:
139 77
147# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic85# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
148```86```
149 87
150### 4. Pin model versions88<h3 id="4-pin-model-versions">
89 4. Pin model versions
90</h3>
151 91
152<Warning>92<Warning>
153 Pin versi model spesifik untuk setiap deployment. Jika Anda menggunakan alias model (`sonnet`, `opus`, `haiku`) tanpa pinning, Claude Code mungkin mencoba menggunakan versi model yang lebih baru yang tidak tersedia di akun Foundry Anda, merusak pengguna yang ada ketika Anthropic merilis pembaruan. Ketika Anda membuat deployment Azure, pilih versi model spesifik daripada "auto-update to latest."93 Pin versi model spesifik untuk setiap deployment. Jika Anda menggunakan alias model (`sonnet`, `opus`, `haiku`) tanpa pinning, Claude Code mungkin mencoba menggunakan versi model yang lebih baru yang tidak tersedia di akun Foundry Anda, merusak pengguna yang ada ketika Anthropic merilis pembaruan. Ketika Anda membuat deployment Azure, pilih versi model spesifik daripada "auto-update to latest."
155 95
156Atur variabel model agar sesuai dengan nama deployment yang Anda buat di langkah 1.96Atur variabel model agar sesuai dengan nama deployment yang Anda buat di langkah 1.
157 97
158Tanpa `ANTHROPIC_DEFAULT_OPUS_MODEL`, alias `opus` di Foundry diselesaikan ke Opus 4.6. Aturnya ke ID Opus 4.7 untuk menggunakan model terbaru:98Tanpa `ANTHROPIC_DEFAULT_OPUS_MODEL`, alias `opus` di Foundry diselesaikan ke Opus 4.6. Aturnya ke ID Opus 4.8 untuk menggunakan model terbaru:
159 99
160```bash theme={null}100```bash theme={null}
161export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'101export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
162export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'102export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
163export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'103export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
164```104```
167 107
168Untuk ID model saat ini dan legacy, lihat [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Lihat [Model configuration](/id/model-config#pin-models-for-third-party-deployments) untuk daftar lengkap variabel lingkungan.108Untuk ID model saat ini dan legacy, lihat [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview). Lihat [Model configuration](/id/model-config#pin-models-for-third-party-deployments) untuk daftar lengkap variabel lingkungan.
169 109
170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/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:110[Prompt caching](/id/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:
171 111
172```bash theme={null}112```bash theme={null}
173export ENABLE_PROMPT_CACHING_1H=1113export ENABLE_PROMPT_CACHING_1H=1
174```114```
175 115
176### 5. Jalankan Claude Code116<h3 id="5-run-claude-code">
117 5. Jalankan Claude Code
118</h3>
177 119
178Dengan variabel lingkungan yang diatur, mulai Claude Code dari direktori proyek Anda:120Dengan variabel lingkungan yang diatur, mulai Claude Code dari direktori proyek Anda:
179 121
183 125
184Claude Code membaca `CLAUDE_CODE_USE_FOUNDRY` dan variabel Foundry lainnya dari lingkungan dan terhubung ke sumber daya Azure Anda pada prompt pertama. Tidak seperti Bedrock dan Vertex AI, Foundry tidak memiliki wizard setup interaktif, jadi variabel lingkungan di langkah 3 dan 4 adalah satu-satunya jalur konfigurasi.126Claude Code membaca `CLAUDE_CODE_USE_FOUNDRY` dan variabel Foundry lainnya dari lingkungan dan terhubung ke sumber daya Azure Anda pada prompt pertama. Tidak seperti Bedrock dan Vertex AI, Foundry tidak memiliki wizard setup interaktif, jadi variabel lingkungan di langkah 3 dan 4 adalah satu-satunya jalur konfigurasi.
185 127
186## Konfigurasi Azure RBAC128<h2 id="azure-rbac-configuration">
129 Konfigurasi Azure RBAC
130</h2>
187 131
188Peran default `Azure AI User` dan `Cognitive Services User` mencakup semua izin yang diperlukan untuk memanggil model Claude.132Peran default `Azure AI User` dan `Cognitive Services User` mencakup semua izin yang diperlukan untuk memanggil model Claude.
189 133
203 147
204Untuk detail, lihat [dokumentasi RBAC Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).148Untuk detail, lihat [dokumentasi RBAC Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).
205 149
206## Pemecahan Masalah150<h2 id="troubleshooting">
151 Pemecahan Masalah
152</h2>
207 153
208Jika Anda menerima kesalahan "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":154Jika Anda menerima kesalahan "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":
209 155
210* Konfigurasi Entra ID di lingkungan, atau atur `ANTHROPIC_FOUNDRY_API_KEY`.156* Konfigurasi Entra ID di lingkungan, atau atur `ANTHROPIC_FOUNDRY_API_KEY`.
211 157
212## Sumber daya tambahan158<h2 id="additional-resources">
159 Sumber daya tambahan
160</h2>
213 161
214* [Dokumentasi Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)162* [Dokumentasi Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)
215* [Model Microsoft Foundry](https://ai.azure.com/explore/models)163* [Model Microsoft Foundry](https://ai.azure.com/explore/models)
