Ketika ANTHROPIC_FOUNDRY_API_KEY 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
3. Konfigurasi Claude Code
Atur variabel lingkungan berikut untuk mengaktifkan Microsoft Foundry:
# Aktifkan integrasi Microsoft Foundryexport 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 Foundry diselesaikan ke Opus 4.6. Aturnya ke ID Opus 4.7 untuk menggunakan model terbaru:
Tugas latar belakang seperti pembuatan judul sesi menggunakan model kecil/cepat, biasanya model kelas Haiku. Di 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.
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 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.
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:
178Dengan variabel lingkungan yang diatur, mulai Claude Code dari direktori proyek Anda:
179
180```bash theme={null}
181claude
182```
183
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.
178Peran default `Azure AI User` dan `Cognitive Services User` mencakup semua izin yang diperlukan untuk memanggil model Claude.188Peran default `Azure AI User` dan `Cognitive Services User` mencakup semua izin yang diperlukan untuk memanggil model Claude.