在 Microsoft Foundry 中部署並使用 Claude 模型

Anthropic 的 Claude 模型為 Microsoft Foundry 帶來先進的對話式 AI 能力，讓您能以最先進的語言理解與生成能力打造智慧應用程式。 Claude 模型擅長複雜推理、程式碼生成及多模態任務，包括影像分析。

在本文中，您將學習如何：

  • 在 Microsoft Foundry 中部署 Claude 模型
  • 使用 Microsoft Entra ID 或 API 金鑰進行認證
  • 從 Python、JavaScript 或 REST 呼叫 Claude Messages API

有關可用型號、型號版本及功能，請參閱 Microsoft Foundry 中的 Claude 模型。 關於依訂閱類型的預設配額，請參見 Claude 模型配額與速率限制。

重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議將其用於生產工作負載。 某些功能可能不被支援或功能受限。 欲了解更多資訊，請參閱 Microsoft Azure 預覽版補充使用條款。

先決條件

訂閱類型與區域支援

要在 Microsoft Foundry 中使用 Claude 模型，您必須擁有付費的 Azure 訂閱，並在 Anthropic 提供模型購買的國家或地區擁有帳單帳戶。 關於常見訂閱相關錯誤的清單，請參見 常見錯誤訊息與解決方案。 以下訂閱類型目前不支援：

  • 位於南韓的企業帳戶
  • 雲端解決方案提供者 訂閱
  • 沒有有效隨用付費計費方式的 Azure 訂閱（例如學生、免費試用或創業信用帳號）
  • 贊助訂閱只使用 Azure 點數。 註：如果您有信用卡帳戶，信用卡費用將被收取，而非Azure Credits.

有關支援區域的清單，請參見 支援的地理位置。 請注意，Anthropic 的「支援區域政策」可能適用於您所在地區的可用性，詳情請參見 supported regions。

使用 Claude on Foundry 入門套件

若要使用 Microsoft Foundry 的基礎設施即程式碼工具部署 Claude 模型，請參見「使用 Bicep 或 Terraform 部署 Claude 模型於 Microsoft Foundry」。 這篇文章是基於 Claude on Foundry 入門套件，內容涵蓋如何配置 Foundry 帳號與專案、部署你所選的 Claude 模型，以及使用 Bicep 或 Terraform 自動化設定 Microsoft Entra ID 或 API 金鑰的認證。

部署 Claude 模型

請依照 Foundry 入口網站的以下步驟部署 Claude 模型：

  1. 登入 Microsoft Foundry。 確定 新鑄造廠 的開關是開啟的。 以下步驟適用於 Foundry（新）。

  2. 從 Foundry 入口網站首頁，在右上角的導覽中選擇 「發現 」，然後在左側窗格選擇 「模型 」。

  3. 選擇一款 Claude 型號，並在模型卡片中檢視其詳細資訊。 如果該模型同時提供兩個版本，預設會進入到 Hosted on Azure（版本 2）模型。 您可以在模型卡片的 Quick 事實窗格中，尋找 Hosted on 資訊，確認目前開啟的版本。

    Tip

    如果你選擇的 Claude 模型同時有兩個版本，模型卡會附上連結，帶你前往該模型的替代版本。

  4. 選擇 部署>自訂設定 以自訂你的部署。

  5. 閱讀 Azure Marketplace 條款，選擇產業，並選擇同意並繼續接受條款以訂閱 Azure Marketplace。

  6. 如果兩個版本都有，部署頁面預設會將模型版本設定為版本 2：在 Azure 上託管。 如果需要，將此選項改為 1：託管於 Anthropic 基礎架構。

    註

    如果你選擇>部署預設設定選項，你的部署會自動設定為版本 2：在 Azure 上託管。

  7. 配置其他部署設定：

    • 預設情況下，部署會使用模型名稱。 你可以在部署前修改這個名稱。 在推論過程中，使用參數中的 model 部署名稱將請求路由到該特定部署。
    • 選擇 區域範圍： 全域 （適用於所有 Claude 型號與版本）或 資料區 （若您的型號與版本組合皆有）。

  8. 選擇 部署 以建立你的部署。

  9. 部署完成後，你會進入 Foundry Playgrounds ，可以互動式測試模型。 您的專案與資源必須位於模型支援的部署區域之一。

  10. 選擇 「詳情 」標籤以驗證部署細節，並檢查部署狀態是否顯示 為成功。

呼叫 Claude Messages API

部署 Claude 模型後，與之互動以產生文字回應：

  • 使用 Anthropic SDK 與 Claude API，例如：

    • 訊息 API：傳送包含文字或圖片的結構化輸入訊息清單。 模型會產生對話中的下一則訊息。
    • 代幣計數 API：計算訊息中的代幣數量。

想了解更多支援的 API，請參閱 Microsoft Foundry 中的 Claude 模型。

發送帶有認證的訊息

以下範例說明如何使用 Microsoft Entra ID 或 API 金鑰驗證向 Claude Sonnet 4.6 發送請求。 要使用已部署的模型，你需要：

  • 你的基本網址，格式為 https://<resource name>.services.ai.azure.com/anthropic。
  • 你的目標 URI 來自你的部署細節，格式為 https://<resource name>.services.ai.azure.com/anthropic/v1/messages。
  • Microsoft Entra ID 用於無金鑰認證，或是你部署的 API 金鑰用於 API 認證。
  • 你在建立部署時選擇的部署名稱。 這個名稱可以與型號 ID 不同。

關於 Claude 模型的進階功能與能力，請參見 Microsoft Foundry 中的 Claude 模型。

使用 Microsoft Entra ID 認證

對於 Messages API 端點，請使用你的基礎 URL 搭配 Microsoft Entra ID 認證。

  1. 安裝 Azure Identity 用戶端函式庫：安裝此函式庫以使用 DefaultAzureCredential。 授權最簡單是當使用DefaultAzureCredential時，因為它會在其執行環境中找到最適合的憑證。

    pip install azure-identity

    將Microsoft Entra ID應用程式的用戶端 ID、租戶 ID 和用戶端秘密設定為環境變數：AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET。

    export AZURE_CLIENT_ID="<AZURE_CLIENT_ID>"
export AZURE_TENANT_ID="<AZURE_TENANT_ID>"
export AZURE_CLIENT_SECRET="<AZURE_CLIENT_SECRET>"

  2. Install dependencies：使用 pip 安裝 Anthropic SDK（需 Python 3.8 或更新版本）。

    pip install -U "anthropic"

  3. 執行基本程式碼範例 以完成以下任務：

    1. 使用 Anthropic SDK 建立客戶端，並使用 Microsoft Entra ID 認證。
    2. 先對訊息 API 做基本呼叫。 通話是同步的。
    from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name
deploymentName = "claude-sonnet-4-6" # Replace with your deployment name

# Create token provider for Entra ID authentication
tokenProvider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    azure_ad_token_provider=tokenProvider,
    base_url=baseURL
)

# Send request
message = client.messages.create(
    model=deploymentName,
    messages=[
        {"role": "user", "content": "What are 3 things to visit in Seattle?"}
    ],
    max_tokens=1048,
    temperature=1,
    thinking={"type":"adaptive"},
    output_config={"effort": "max"},
    stream=False
)

print(message.content)

    預期產出： 一個包含模型文字補全及三項西雅圖建議的 JSON 回應。

    Reference：Anthropic Client SDK， DefaultAzureCredential

使用 API 金鑰認證

重要

Claude Mythos 5-1、Mythos 5 和 Mythos Preview 僅支援 Microsoft Entra ID 認證。

對於 Messages API 端點，請使用你的基礎 URL 和 API 金鑰來驗證服務。

  1. Install dependencies：使用 pip 安裝 Anthropic SDK（需 Python 3.8 或更新版本）：

    pip install -U "anthropic"

  2. 執行基本程式碼範例 以完成以下任務：

    1. 透過將你的 API 金鑰傳遞到 SDK 的設定，使用 Anthropic SDK 建立客戶端。 此認證方式讓您能無縫與服務互動。
    2. 先對訊息 API 做基本呼叫。 通話是同步的。
    from anthropic import AnthropicFoundry

baseURL = "https://<resource-name>.services.ai.azure.com/anthropic" # Your base URL. Replace <resource-name> with your resource name
deploymentName = "claude-sonnet-4-6" # Replace with your deployment name
apiKey = "YOUR_API_KEY" # Replace YOUR_API_KEY with your API key

# Create client with API key authentication
client = AnthropicFoundry(
    api_key=apiKey,
    base_url=baseURL
)

# Send request
message = client.messages.create(
    model=deploymentName,
    messages=[
        {"role": "user", "content": "What are 3 things to visit in Seattle?"}
    ],
    max_tokens=1048,
    temperature=1,
    thinking={"type":"adaptive"},
    output_config={"effort": "max"},
    stream=False
)

print(message.content)

    預期產出： 一個包含模型文字補全及三項西雅圖建議的 JSON 回應。

    Reference：Anthropic 客戶端 SDK

故障排除

下表列出了在 Foundry 中使用 Claude 模型及其解法時常見的錯誤：

錯誤 成因 解法
401 未經授權 API 金鑰無效或過期，或是 Entra ID token 範圍錯誤。 請確認你的 API 金鑰是否正確。 針對 Entra ID，請確認您使用了 scope https://ai.azure.com/.default。
403 禁忌 資源或訂閱權限不足。 確認你在資源群組中有貢獻 者 或 擁有 者的角色。 在使用 Entra ID 時，確保已分配認知服務使用者角色。
404號未找到 終端網址或部署名稱錯誤。 確認你的基礎網址符合這個模式 https://<resource-name>.services.ai.azure.com/anthropic ，且部署名稱是否符合你的設定。
429 太多請求 您的訂閱等級已超過費率上限。 實現帶有重試邏輯的指數退避。 可以考慮減少請求頻率或要求 增加配額。
所需資料保留量（400 invalid_request_error） 此模型是 Anthropic 指定的 涵蓋模型，必須保留資料，但您的訂用帳戶已啟用零資料保留 (ZDR)。 上游的 Anthropic 訊息顯示你的「組織或工作空間必須啟用資料保留」，但在 Foundry 中，這個設定是套用到你的訂閱。 Anthropic 獨立管理 Azure 上的 Claude 資料保留，所以 Microsoft 無法幫你更改這個設定。 要使用這個模型，可以直接與 Anthropic 合作，為你的訂閱停用 ZDR，或是建立一個新的訂閱（因為新訂閱預設啟用了資料保留），然後部署模型。 背景請參見 涵蓋模型的資料保存實務。
訂閱資格錯誤 你的 Azure 訂閱類型或帳單區域不被支援，或者你的訂閱等級預設配額為 0。 確認你的訂閱是否採用有效的隨用付費計費方式，以及支援的計費國家/地區。 請參閱 訂閱類型與地區支援。 關於階級特定的預設限制，請參見 Claude 模型配額與速率限制。
區域不可用 嘗試部署於無支援區域。 部署到你所使用的 Claude 模型支援的 Azure 區域。 關於模型可取得的 Azure 具體區域，請參閱依部署類型的區域可用性。
當包含 context-1m-2025-08-07 beta 標頭且請求超過 20 萬代幣時，對 Claude Sonnet 4.5 的請求會失敗 Claude Sonnet 4.5 的 1M 上下文測試版已於 2026 年 4 月 30 日停止提供。 自 2026 年 5 月 1 日起，超過 20 萬個帶有 context-1m-2025-08-07 beta 標頭的代幣請求將被拒絕。 請從你的請求中移除 context-1m-2025-08-07 測試標頭。 對於需要 1M 上下文的工作負載，遷移到 Claude Sonnet 4.6 （此處普遍有 1M 上下文可用），或遷移到 Claude Opus 4.6 或 Claude Opus 5 ，以處理更高智慧的工作負載。 對 Claude Sonnet 4.5 發出的 20 萬個 Token 或更少的請求，即使包含該標頭，也不受影響。

相關內容

  • Last updated on