Claude Platform Docs
Messages雲端平台上的 Claude

Microsoft Foundry 中的 Claude

透過 Microsoft Foundry 使用 Azure 原生端點與驗證機制存取 Claude 模型。

本指南說明如何在 Microsoft Foundry 中設定 Claude 並對其進行 API 呼叫。您可以使用 Anthropic 的用戶端 SDK 或直接 HTTP 請求。當您透過 Microsoft Foundry 存取 Claude 時,您需透過 Azure Marketplace 支付 Claude 的使用費用。API 模型 ID 與部署列出了可用的模型。1M token「context window」(上下文視窗)等功能也可供使用。您可以透過 Azure 訂閱管理成本。

Claude 在 Foundry 資源中提供 Global Standard 和 US Data Zone Standard 部署類型,並透過 Azure Marketplace 以 Claude Consumption Units 計費。詳情請參閱 Microsoft Foundry 中的 Claude 定價。

託管選項

Microsoft Foundry 中的 Claude 模型提供兩種「hosting option」(託管選項)。您會在設定部署時選擇託管選項。

託管於 Azure(Hosted on Azure)託管於 Anthropic(Hosted on Anthropic)
推論執行位置在 Azure 基礎架構上執行、由 Anthropic 營運的服務在 Anthropic 基礎架構上執行、由 Anthropic 營運的服務
模型可用性部分 Opus、Sonnet 和 Haiku 模型Microsoft Foundry 上提供的所有 Claude 模型
部署類型Global Standard、US Data Zone StandardGlobal Standard
建議用途大多數工作負載需要僅託管於 Anthropic 的模型或僅在託管於 Anthropic 時可用之功能的工作負載

對於託管於 Azure 的部署,Anthropic 會在 Azure 基礎架構上處理提示和完成內容,並將保留的內容儲存於該處。保留的內容包括被 Anthropic 安全系統標記、供 Anthropic 審查的內容。不包含提示或完成內容的營運資料會儲存於 Anthropic 位於 Azure 以外的系統。範例包括安全分類器分數、識別碼,以及使用量與計費資料。

先決條件

開始之前,請確保您具備:

  • 有效的 Azure 訂閱
  • Foundry 入口網站的存取權限
  • 針對您在佈建中建立的 Foundry 資源,具備 Azure「role-based access control」(角色型存取控制),即 RBAC 角色,例如 Foundry User 或 Cognitive Services User
  • 選用:Azure CLI,用於透過 az account get-access-token 取得 Microsoft Entra ID 權杖

安裝 SDK

Anthropic 的用戶端 SDK 透過平台專用的套件或用戶端類別支援 Foundry。本頁範例也展示了使用 cURL 和 ant CLI 的請求。若要設定 CLI,請參閱 CLI 快速入門。

pip install -U "anthropic"

# 若要使用 Entra ID 驗證,請一併安裝 Azure Identity 程式庫
pip install azure-identity

佈建

Foundry 使用兩層階層結構:資源包含您的安全性與計費設定,而部署則是您透過 API 呼叫的模型執行個體。您將先建立 Foundry 資源,然後在其中建立一個或多個 Claude 部署。

佈建 Foundry 資源

佈建資源的步驟:

  1. 前往 Foundry 入口網站。
  2. 在您的模型可用的 Azure 區域中建立或選擇 Foundry 資源。您可以依照 Microsoft 的建立 Foundry 資源說明操作,或建立 Foundry 專案,系統會為您建立資源。
  3. 記下您的資源名稱,也就是 API 端點(例如 https://{resource}.services.ai.azure.com/anthropic/v1/*)中的 {resource}。

若要限制網路存取,您可以將資源加入私人網路(Azure Virtual Network)。

建立 Foundry 部署

建立資源後,部署 Claude 模型以供 API 呼叫使用。以下步驟說明的是新版 Foundry 入口網站(New Foundry 切換開關為開啟狀態):

  1. 登入 Foundry 入口網站。在入口網站首頁,選擇右上方導覽列中的 Discover,然後選擇左側窗格中的 Models 以開啟模型目錄。
  2. 搜尋並選擇 Claude 模型(例如 claude-opus-5-5⁠)。無論模型支援多少種託管選項,每個模型在目錄中只會出現一次。
  3. 在模型卡片上,選擇 Deploy,然後選擇 Custom settings 以開啟部署設定窗格。若您改為選擇 Default settings,對於在兩種託管選項中皆可用的模型,部署會自動設定為託管於 Azure。
  4. 在您的第一個 Claude 部署中,檢閱 Azure Marketplace 條款、選擇產業,然後選擇 Agree and Proceed 以接受條款並訂閱 Azure Marketplace 方案。
  5. 設定部署:
    • Deployment name:預設為模型 ID,但您可以自訂(例如 my-claude-deployment)。部署名稱在建立後無法變更。
    • Model version:此設定決定託管選項。展開 Model version settings,開啟 Model version 下拉選單,然後選擇標示為您所需託管選項的版本。
    • Region scope:請選擇 Global;若部署託管於 Azure,也可選擇 Data Zone。Data Zone 會建立 US Data Zone Standard 部署,將推論保留在美國境內。有關定價,請參閱推論地理位置。
  6. 選擇 Deploy 並等待佈建完成。
  7. 部署完成後,選擇右上方導覽列中的 Build,然後選擇左側窗格中的 Models,並開啟您的部署。Details 分頁會顯示 Target URI(您的端點 URL)和 Key(您的 API 金鑰)。

如果 New Foundry 切換開關為關閉狀態,您使用的是傳統入口網站版面配置。在該版面中,請開啟左側窗格中的 Model catalog 來尋找並部署模型,並開啟 Models + endpoints(位於 My assets 下)來檢視您的部署及其端點詳細資訊。

驗證

Microsoft Foundry 中的 Claude 支援兩種驗證方法:API 金鑰與 Entra ID 權杖。兩種方法都使用格式為 https://{resource}.services.ai.azure.com/anthropic/v1/* 的端點。對於 Claude Mythos 模型,請使用 Entra ID 權杖。

API 金鑰驗證

佈建 Foundry Claude 資源後,您可以從 Foundry 入口網站取得 API 金鑰:

  1. 在 Foundry 入口網站中,選擇右上方導覽列中的 Build,然後選擇左側窗格中的 Models。
  2. 開啟您的 Claude 部署並選擇 Details 分頁。
  3. 複製 Key 值(並記下您端點的 Target URI)。
  4. 在請求中使用 api-key 或 x-api-key 標頭,或將其提供給 SDK。

SDK 的 Foundry 用戶端需要 API 金鑰以及資源名稱或基礎 URL 其中之一,若已定義下列環境變數,會自動從中讀取:

  • ANTHROPIC_FOUNDRY_API_KEY - 您的 API 金鑰
  • ANTHROPIC_FOUNDRY_RESOURCE - 您的資源名稱(例如 example-resource)
  • ANTHROPIC_FOUNDRY_BASE_URL - 資源名稱的替代選項,適用於 C# 以外的所有 SDK:完整的基礎 URL(例如 https://example-resource.services.ai.azure.com/anthropic/)

使用 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)

Microsoft Entra 驗證

Entra ID 驗證可讓您透過 Azure RBAC 管理存取權限、與組織的身分管理整合,並避免手動處理 API 金鑰。若要使用 Entra ID 權杖:

  1. 為您的 Foundry 資源啟用 Microsoft Entra ID 驗證。
  2. 從 Entra ID 取得存取權杖。
  3. 在 Authorization: Bearer {TOKEN} 標頭中使用該權杖。

使用 Entra ID 的範例:

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

# 使用權杖提供者模式取得 Microsoft Entra ID 權杖
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# 建立使用 Entra ID 驗證的用戶端
client = AnthropicFoundry(
    resource="example-resource",  # your resource name
    azure_ad_token_provider=token_provider,  # Use token provider for Entra ID auth
)

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

關聯請求 ID

Foundry 會在 HTTP 回應標頭中包含請求識別碼,以供偵錯與追蹤。聯絡支援團隊時,請同時提供 request-id 與 apim-request-id(Azure API Management)的值,以協助團隊在 Anthropic 與 Azure 系統中快速定位並調查您的請求。

功能支援

Microsoft Foundry 中的 Claude 支援大多數 Claude 功能。功能概覽列出了 Claude 的功能,而各功能頁面的可用性區段會顯示 Foundry 是否支援該功能,以及支援的託管選項。

上下文視窗

在 Microsoft Foundry 上,除了 Claude Opus 4.5、Claude Sonnet 4.5(已棄用)和 Claude Haiku 4.5 之外,所有可用模型皆具有 1M token 上下文視窗。這三個模型具有 200k token 上下文視窗。

Microsoft Foundry 中的 Claude 不支援的 Claude 功能

託管於 Azure 時不支援的其他功能

下列功能可用於託管於 Anthropic 的部署,但不支援託管於 Azure 的部署:

依設計,對託管於 Azure 的部署使用這些功能的請求會傳回 400 Bad Request 錯誤。Claude Code 會偵測託管於 Azure 的部署,並自動調整其功能集。

API 回應

Microsoft Foundry 中的 Claude 所傳回的 API 回應遵循標準的 Claude API 回應格式可檢視預覽,內含 API 參考文件連結——按 Tab 鍵直到焦點進入卡片,按 Escape 鍵返回。,包括 usage 物件。

有關 Foundry 專屬回應標頭的詳細資訊,請參閱關聯請求 ID。

API 模型 ID 與部署

生命週期術語(已棄用、已停用)定義於模型棄用。Microsoft Foundry 遵循 Claude API 的生命週期時程。

下列 Claude 模型可透過 Foundry 使用:

模型預設部署名稱託管於 Azure託管於 Anthropic
Claude Fable 5.2claude-fable-5-2✓
Claude Mythos 5.2(限量開放)claude-mythos-5-2✓
Claude Fable 5.1claude-fable-5-1✓
Claude Mythos 5.1(限量開放)claude-mythos-5-1✓
Claude Fable 5claude-fable-5✓
Claude Mythos 5(限量開放)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(已淘汰)claude-sonnet-4-5✓
Claude Haiku 5.5claude-haiku-5-5✓✓
Claude Haiku 4.5claude-haiku-4-5✓✓

預設情況下,部署名稱與上表所示的模型 ID 相符。不過,您可以在 Foundry 入口網站中建立不同名稱的自訂部署,以管理不同的設定、版本或速率限制。請在 API 請求中使用部署名稱(不一定是模型 ID)。

Claude Code

讓 Claude Code 將您的程式碼遷移至較新的模型

/claude-api migrate 將此專案遷移至最新的 Claude Opus 模型

計費

Microsoft Foundry 中的 Claude 透過 Azure Marketplace 計費。使用量以 Claude Consumption Units(CCU)計價,每小時計量,並於每月事後在您的 Azure 帳單上開立發票。CCU 並非預付點數。不存在 CCU 餘額或承諾用量。

有關 CCU 價格、換算機制與各模型 token 費率,請參閱 Microsoft Foundry 中的 Claude 定價。

在託管選項之間遷移

若要將現有部署從一種託管選項移至另一種:

  1. 建立該模型另一個託管版本(託管於 Azure 或託管於 Anthropic)的新部署。這可以在同一個 Foundry 資源中,也可以在新的資源中。
  2. 更新您的應用程式,在 model 參數中傳入新的部署名稱。
  3. 流量轉移完成後,刪除舊部署。

若新部署位於同一個 Foundry 資源中,您的端點 URL 與驗證方式維持不變。若您建立了新資源,請更新應用程式的端點與憑證以指向新資源。

監控與記錄

Azure 透過標準 Azure 模式為您的 Claude 使用量提供監控與記錄:

  • Azure Monitor: 追蹤 API 使用量、延遲與錯誤率
  • Azure Log Analytics: 查詢與分析請求/回應記錄
  • Cost Management: 監控與預測與 Claude 使用量相關的成本

Anthropic 建議至少以 30 天滾動方式記錄您的活動,以了解使用模式並調查任何潛在問題。

疑難排解

驗證錯誤

錯誤: 401 Unauthorized 或 Invalid API key

  • 解決方法: 確認您的 API 金鑰正確。您可以在 Foundry 入口網站中部署的 Details 分頁(位於 Build > Models 下)找到它。
  • 解決方法: 若使用 Microsoft Entra ID,請確認您的存取權杖有效且尚未過期。權杖通常在 1 小時後過期。

錯誤: 403 Forbidden

原因: 您的 Azure 帳戶可能缺少必要的權限。

  • 解決方法: 確認您已獲指派適當的 Azure RBAC 角色(例如 Foundry User 或 Cognitive Services User)。

速率限制

錯誤: 429 Too Many Requests

  • 解決方法: 您已超出速率限制。請在應用程式中實作指數退避與重試邏輯。
  • 解決方法: 考慮透過 Azure 入口網站或 Azure 支援申請提高速率限制。

速率限制標頭

Foundry 的回應中不包含 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 與 anthropic-ratelimit-output-tokens-reset)。請改用 Azure 的監控工具管理速率限制。

模型與部署錯誤

錯誤: Model not found 或 Deployment not found

  • 解決方法: 確認您使用的是正確的部署名稱。如果您尚未建立自訂部署,請使用預設的模型 ID(例如 claude-opus-5-5⁠)。
  • 解決方法: 確認該模型/部署在您的 Azure 區域中可用。

錯誤: Invalid model parameter

  • 解決方案: model 參數應包含您的部署名稱,該名稱可在 Foundry 入口網站中自訂。請確認該部署存在且設定正確。

後續步驟

探索 Claude 的進階功能與能力。

了解 Anthropic 針對模型與功能的定價結構。

隨著更安全、更強大的模型推出,Anthropic 會定期淘汰舊模型。查看所有 API 棄用項目及建議的替代方案。

其他資源

瀏覽 Foundry 目錄中的 Anthropic 模型。

檢視 Microsoft 的 Microsoft Foundry 定價詳細資訊。

檢視 Anthropic 各模型的定價詳細資訊。

管理您的 Azure 資源。

這個頁面有幫助嗎?