Claude Platform Docs
PesanClaude di platform cloud

Claude di Microsoft Foundry

Akses model Claude melalui Microsoft Foundry dengan endpoint dan autentikasi native Azure.

Panduan ini menunjukkan cara menyiapkan Claude di Microsoft Foundry dan melakukan panggilan API ke Claude. Anda dapat menggunakan salah satu SDK klien Anthropic atau permintaan HTTP langsung. Saat Anda mengakses Claude di Microsoft Foundry, Anda membayar penggunaan Claude melalui Azure Marketplace. ID model API dan deployment mencantumkan model yang tersedia. Fitur seperti “context window” (jendela konteks) 1M token juga tersedia. Anda mengelola biaya melalui langganan Azure Anda.

Claude tersedia dalam jenis deployment Global Standard dan US Data Zone Standard di resource Foundry, ditagih dalam Claude Consumption Units melalui Azure Marketplace. Kunjungi harga Claude di Microsoft Foundry untuk detailnya.

Opsi hosting

Model Claude di Microsoft Foundry tersedia dalam dua opsi hosting. Anda memilih opsi hosting saat mengonfigurasi deployment.

Hosted on AzureHosted on Anthropic
Tempat inferensi berjalanLayanan yang dioperasikan Anthropic yang berjalan di infrastruktur AzureLayanan yang dioperasikan Anthropic yang berjalan di infrastruktur Anthropic
Ketersediaan modelBeberapa model Opus, Sonnet, dan HaikuSemua model Claude yang tersedia di Microsoft Foundry
Jenis deploymentGlobal Standard, US Data Zone StandardGlobal Standard
Direkomendasikan untukSebagian besar beban kerjaBeban kerja yang memerlukan model yang hanya di-hosting di Anthropic atau fitur yang hanya tersedia saat di-hosting di Anthropic

Untuk deployment yang di-hosting di Azure, Anthropic memproses prompt dan completion di infrastruktur Azure dan menyimpan konten yang dipertahankan di sana. Konten yang dipertahankan mencakup konten yang ditandai oleh sistem keamanan Anthropic untuk ditinjau oleh Anthropic. Data operasional yang tidak berisi prompt atau completion disimpan di sistem Anthropic di luar Azure. Contohnya meliputi skor pengklasifikasi keamanan, pengidentifikasi, serta data penggunaan dan penagihan.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  • Langganan Azure yang aktif
  • Akses ke portal Foundry
  • Peran “Azure role-based access control” (kontrol akses berbasis peran Azure), atau RBAC, seperti Foundry User atau Cognitive Services User, untuk resource Foundry yang Anda buat di Penyediaan
  • Opsional: Azure CLI untuk mendapatkan token Microsoft Entra ID dengan az account get-access-token

Instal SDK

SDK klien Anthropic mendukung Foundry melalui paket atau kelas klien khusus platform. Contoh di halaman ini juga menunjukkan permintaan dengan cURL dan CLI ant. Untuk menyiapkan CLI, lihat panduan memulai cepat CLI.

pip install -U "anthropic"

# Untuk autentikasi Entra ID, instal juga pustaka Azure Identity
pip install azure-identity

Penyediaan

Foundry menggunakan hierarki dua tingkat: resource berisi konfigurasi keamanan dan penagihan Anda, sedangkan deployment adalah instans model yang Anda panggil melalui API. Anda akan terlebih dahulu membuat resource Foundry, lalu membuat satu atau beberapa deployment Claude di dalamnya.

Provisioning resource Foundry

Untuk melakukan provisioning resource Anda:

  1. Buka portal Foundry.
  2. Buat atau pilih resource Foundry di region Azure tempat model Anda tersedia. Anda dapat mengikuti petunjuk Microsoft untuk membuat resource Foundry atau membuat proyek Foundry, yang akan membuat resource untuk Anda.
  3. Catat nama resource Anda, yang merupakan {resource} dalam endpoint API seperti https://{resource}.services.ai.azure.com/anthropic/v1/*.

Untuk membatasi akses jaringan, Anda dapat menambahkan resource Anda ke jaringan privat (Azure Virtual Network).

Membuat deployment Foundry

Setelah membuat resource Anda, deploy model Claude agar tersedia untuk panggilan API. Langkah-langkah ini menjelaskan portal Foundry baru (toggle New Foundry aktif):

  1. Masuk ke portal Foundry. Dari beranda portal, pilih Discover di navigasi kanan atas, lalu Models di panel kiri untuk membuka katalog model.
  2. Cari dan pilih model Claude (misalnya, claude-opus-5-5⁠). Setiap model muncul satu kali di katalog, terlepas dari berapa banyak opsi hosting yang didukungnya.
  3. Di kartu model, pilih Deploy, lalu Custom settings untuk membuka panel pengaturan deployment. Jika Anda memilih Default settings sebagai gantinya, deployment secara otomatis dikonfigurasi sebagai Hosted on Azure untuk model yang tersedia di kedua opsi hosting.
  4. Pada deployment Claude pertama Anda, tinjau ketentuan Azure Marketplace, pilih industri, dan pilih Agree and Proceed untuk menerima ketentuan dan berlangganan penawaran Azure Marketplace.
  5. Konfigurasikan deployment:
    • Deployment name: Default-nya adalah ID model, tetapi Anda dapat menyesuaikannya (misalnya, my-claude-deployment). Nama deployment tidak dapat diubah setelah dibuat.
    • Model version: Pengaturan ini menentukan opsi hosting. Perluas Model version settings, buka menu dropdown Model version, dan pilih versi yang diberi label dengan opsi hosting yang Anda inginkan.
    • Region scope: Pilih Global, atau Data Zone jika deployment di-hosting di Azure. Data Zone membuat deployment US Data Zone Standard, yang menjaga inferensi tetap berada di Amerika Serikat. Untuk harga, lihat Geografi inferensi.
  6. Pilih Deploy dan tunggu hingga provisioning selesai.
  7. Setelah di-deploy, pilih Build di navigasi kanan atas, lalu Models di panel kiri, dan buka deployment Anda. Tab Details menampilkan Target URI (URL endpoint Anda) dan Key (kunci API Anda).

Jika toggle New Foundry nonaktif, Anda berada di tata letak portal klasik. Di sana, buka Model catalog di panel kiri untuk menemukan dan men-deploy model, dan buka Models + endpoints (di bawah My assets) untuk melihat deployment Anda beserta detail endpoint-nya.

Autentikasi

Claude di Microsoft Foundry mendukung dua metode autentikasi: kunci API dan token Entra ID. Kedua metode menggunakan endpoint dengan format https://{resource}.services.ai.azure.com/anthropic/v1/*. Untuk model Claude Mythos, gunakan token Entra ID.

Autentikasi kunci API

Setelah melakukan provisioning resource Claude Foundry Anda, Anda dapat memperoleh kunci API dari portal Foundry:

  1. Di portal Foundry, pilih Build di navigasi kanan atas, lalu Models di panel kiri.
  2. Buka deployment Claude Anda dan pilih tab Details.
  3. Salin nilai Key (dan catat Target URI untuk endpoint Anda).
  4. Gunakan header api-key atau x-api-key dalam permintaan Anda, atau berikan ke SDK.

Klien Foundry pada SDK memerlukan kunci API dan salah satu dari nama resource atau base URL, dan secara otomatis membacanya dari variabel lingkungan berikut jika didefinisikan:

  • ANTHROPIC_FOUNDRY_API_KEY - Kunci API Anda
  • ANTHROPIC_FOUNDRY_RESOURCE - Nama resource Anda (misalnya, example-resource)
  • ANTHROPIC_FOUNDRY_BASE_URL - Alternatif untuk nama resource di setiap SDK kecuali C#: base URL lengkap (misalnya, https://example-resource.services.ai.azure.com/anthropic/)

Contoh menggunakan kunci API:

import os
from anthropic import AnthropicFoundry

client = AnthropicFoundry(
    api_key=os.environ.get("ANTHROPIC_FOUNDRY_API_KEY"),
    resource="example-resource",  # your resource name
)

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

Autentikasi Microsoft Entra

Autentikasi Entra ID memungkinkan Anda mengelola akses dengan Azure RBAC, berintegrasi dengan manajemen identitas organisasi Anda, dan menghindari penanganan kunci API secara manual. Untuk menggunakan token Entra ID:

  1. Aktifkan autentikasi Microsoft Entra ID untuk resource Foundry Anda.
  2. Dapatkan token akses dari Entra ID.
  3. Gunakan token tersebut di header Authorization: Bearer {TOKEN}.

Contoh menggunakan Entra ID:

from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Dapatkan token Microsoft Entra ID menggunakan pola penyedia token
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# Buat klien dengan autentikasi Entra ID
client = AnthropicFoundry(
    resource="example-resource",  # your resource name
    azure_ad_token_provider=token_provider,  # Use token provider for Entra ID auth
)

# Kirim permintaan
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)

ID permintaan korelasi

Foundry menyertakan pengidentifikasi permintaan dalam header respons HTTP untuk debugging dan tracing. Saat menghubungi dukungan, berikan nilai request-id dan apim-request-id (Azure API Management) untuk membantu tim menemukan dan menyelidiki permintaan Anda dengan cepat di sistem Anthropic maupun Azure.

Dukungan fitur

Claude di Microsoft Foundry mendukung sebagian besar fitur Claude. Ikhtisar fitur mencantumkan fitur-fitur Claude, dan bagian Ketersediaan di halaman suatu fitur menunjukkan apakah Foundry mendukungnya dan dengan opsi hosting mana.

Jendela konteks

Semua model yang tersedia memiliki jendela konteks 1M token di Microsoft Foundry kecuali Claude Opus 4.5, Claude Sonnet 4.5 (deprecated), dan Claude Haiku 4.5. Ketiga model ini memiliki jendela konteks 200k token.

Fitur Claude yang tidak didukung untuk Claude di Microsoft Foundry

Fitur tambahan yang tidak didukung saat di-hosting di Azure

Fitur-fitur berikut tersedia untuk deployment yang di-hosting di Anthropic tetapi tidak didukung untuk deployment yang di-hosting di Azure:

Permintaan yang menggunakan fitur-fitur ini terhadap deployment yang di-hosting di Azure akan mengembalikan error 400 Bad Request sesuai desain. Claude Code mendeteksi deployment yang di-hosting di Azure dan secara otomatis menyesuaikan set fiturnya.

Respons API

Respons API dari Claude di Microsoft Foundry mengikuti format respons Claude APIPratinjau dengan tautan ke referensi API tersedia — tekan Tab hingga fokus masuk ke kartu, Escape untuk kembali. standar, termasuk objek usage.

Untuk detail tentang header respons khusus Foundry, lihat ID permintaan korelasi.

ID model API dan deployment

Istilah siklus hidup (Deprecated, Retired) didefinisikan di Penghentian model. Microsoft Foundry mengikuti jadwal siklus hidup Claude API.

Model Claude berikut tersedia melalui Foundry:

ModelNama deployment defaultDi-hosting di AzureDi-host di Anthropic
Claude Fable 5.2claude-fable-5-2✓
Claude Mythos 5.2 (ketersediaan terbatas)claude-mythos-5-2✓
Claude Fable 5.1claude-fable-5-1✓
Claude Mythos 5.1 (ketersediaan terbatas)claude-mythos-5-1✓
Claude Fable 5claude-fable-5✓
Claude Mythos 5 (ketersediaan terbatas)claude-mythos-5✓
Claude Opus 5.5claude-opus-5-5✓✓
Claude Opus 5claude-opus-5✓✓
Claude Opus 4.8claude-opus-4-8✓✓
Claude Opus 4.7claude-opus-4-7✓
Claude Opus 4.6claude-opus-4-6✓
Claude Opus 4.5claude-opus-4-5✓
Claude Sonnet 5.5claude-sonnet-5-5✓✓
Claude Sonnet 5claude-sonnet-5✓✓
Claude Sonnet 4.6claude-sonnet-4-6✓
Claude Sonnet 4.5 (tidak digunakan lagi)claude-sonnet-4-5✓
Claude Haiku 5.5claude-haiku-5-5✓✓
Claude Haiku 4.5claude-haiku-4-5✓✓

Secara default, nama deployment sama dengan ID model yang ditampilkan pada tabel di atas. Namun, Anda dapat membuat deployment kustom dengan nama berbeda di portal Foundry untuk mengelola konfigurasi, versi, atau batas laju yang berbeda. Gunakan nama deployment (tidak harus ID model) dalam permintaan API Anda.

Claude Code

Biarkan Claude Code memigrasikan kode Anda ke model yang lebih baru

/claude-api migrate proyek ini ke model Claude Opus terbaru

Penagihan

Claude di Microsoft Foundry ditagih melalui Azure Marketplace. Penggunaan dinyatakan dalam Claude Consumption Units (CCU), diukur per jam, dan ditagihkan bulanan di akhir periode pada tagihan Azure Anda. CCU bukan kredit prabayar. Tidak ada saldo atau komitmen CCU.

Untuk harga CCU, mekanisme konversi, dan tarif token per model, lihat harga Claude di Microsoft Foundry.

Migrasi antar opsi hosting

Untuk memindahkan deployment yang ada dari satu opsi hosting ke opsi lainnya:

  1. Buat deployment baru dari versi hosting lain model tersebut (Hosted on Azure atau Hosted on Anthropic). Ini dapat berada di resource Foundry yang sama, atau yang baru.
  2. Perbarui aplikasi Anda untuk memberikan nama deployment baru dalam parameter model.
  3. Hapus deployment lama setelah lalu lintas berpindah.

Jika deployment baru berada di resource Foundry yang sama, URL endpoint dan autentikasi Anda tidak berubah. Jika Anda membuat resource baru, perbarui endpoint dan kredensial aplikasi Anda agar mengarah ke resource tersebut.

Pemantauan dan logging

Azure menyediakan pemantauan dan logging untuk penggunaan Claude Anda melalui pola Azure standar:

  • Azure Monitor: Lacak penggunaan API, latensi, dan tingkat error
  • Azure Log Analytics: Kueri dan analisis log permintaan/respons
  • Cost Management: Pantau dan perkirakan biaya yang terkait dengan penggunaan Claude

Anthropic merekomendasikan untuk mencatat aktivitas Anda setidaknya dalam basis bergulir 30 hari untuk memahami pola penggunaan dan menyelidiki potensi masalah apa pun.

Pemecahan masalah

Error autentikasi

Error: 401 Unauthorized atau Invalid API key

  • Solusi: Verifikasi bahwa kunci API Anda benar. Anda dapat menemukannya di portal Foundry pada tab Details deployment Anda (di bawah Build > Models).
  • Solusi: Jika menggunakan Microsoft Entra ID, pastikan token akses Anda valid dan belum kedaluwarsa. Token biasanya kedaluwarsa setelah 1 jam.

Error: 403 Forbidden

Penyebab: Akun Azure Anda mungkin tidak memiliki izin yang diperlukan.

  • Solusi: Pastikan Anda memiliki peran Azure RBAC yang sesuai (misalnya, Foundry User atau Cognitive Services User).

Pembatasan laju

Error: 429 Too Many Requests

  • Solusi: Anda telah melampaui batas laju Anda. Terapkan logika exponential backoff dan percobaan ulang dalam aplikasi Anda.
  • Solusi: Pertimbangkan untuk meminta peningkatan batas laju melalui portal Azure atau dukungan Azure.

Header batas laju

Foundry tidak menyertakan header batas laju standar Anthropic (anthropic-ratelimit-tokens-limit, anthropic-ratelimit-tokens-remaining, anthropic-ratelimit-tokens-reset, anthropic-ratelimit-input-tokens-limit, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-input-tokens-reset, anthropic-ratelimit-output-tokens-limit, anthropic-ratelimit-output-tokens-remaining, dan anthropic-ratelimit-output-tokens-reset) dalam respons. Kelola pembatasan laju melalui alat pemantauan Azure sebagai gantinya.

Error model dan deployment

Error: Model not found atau Deployment not found

  • Solusi: Verifikasi bahwa Anda menggunakan nama deployment yang benar. Jika Anda belum membuat deployment kustom, gunakan ID model default (misalnya, claude-opus-5-5⁠).
  • Solusi: Pastikan model/deployment tersedia di region Azure Anda.

Error: Invalid model parameter

  • Solusi: Parameter model harus berisi nama deployment Anda, yang dapat disesuaikan di portal Foundry. Verifikasi bahwa deployment ada dan dikonfigurasi dengan benar.

Langkah selanjutnya

Jelajahi fitur dan kemampuan lanjutan Claude.

Pelajari struktur harga Anthropic untuk model dan fitur.

Seiring diluncurkannya model yang lebih aman dan lebih mumpuni, Anthropic secara rutin menghentikan model lama. Lihat semua penghentian API, beserta pengganti yang direkomendasikan.

Sumber daya tambahan

Telusuri model Anthropic di katalog Foundry.

Lihat detail harga Microsoft untuk Microsoft Foundry.

Lihat detail harga per model Anthropic.

Kelola resource Azure Anda.

Apakah halaman ini membantu?