Microsoft FoundryのClaude

このガイドでは、Anthropicのクライアント SDKのいずれか、または直接のHTTPリクエストを使用して、Microsoft FoundryのClaudeをセットアップし、API呼び出しを行う方法を説明します。Microsoft FoundryのClaudeにアクセスすると、Claudeの使用料はAzure Marketplaceで請求されます。Azureサブスクリプションでコストを管理しながら、Claude Fable 5.1、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Sonnet 5.5、Claude Sonnet 5などのClaudeモデルや、100万トークンの「context window」（コンテキストウィンドウ）などの機能を使用できます。

Claudeは、FoundryリソースにおいてGlobal StandardおよびUS Data Zone Standardのデプロイメントタイプで利用可能で、Azure Marketplaceを通じてClaude Consumption Unitsで請求されます。詳細については、Microsoft FoundryのClaudeの料金をご覧ください。

ホスティングオプション

Microsoft FoundryのClaudeモデルは、2つのホスティングオプションで利用できます。ホスティングオプションはデプロイメントを構成する際に選択します。

Claude Sonnet 5.5は、Global Standardデプロイメントのみをサポートしています。

前提条件

始める前に、以下を準備してください。

• 有効なAzureサブスクリプション
• Foundryポータルへのアクセス
• Azure CLIのインストール（Entra IDのcURLの例では必須、それ以外では任意）
• リソースの使用を許可するAzure RBACロール（Foundry User（旧Azure AI User）やCognitive Services Userなど）

SDKのインストール

Anthropicのクライアント SDKは、プラットフォーム固有のパッケージまたはクライアントクラスを通じてFoundryをサポートしています。このページの例では、cURLおよびant CLIを使用したリクエストも示しています。CLIのセットアップについては、CLIクイックスタートを参照してください。

pip install -U "anthropic"

# Entra ID認証を使用する場合は、Azure Identityライブラリもインストールしてください
pip install azure-identity

プロビジョニング

Foundryは2階層の構造を使用します。リソースにはセキュリティと請求の構成が含まれ、デプロイメントはAPIを通じて呼び出すモデルインスタンスです。まずFoundryリソースを作成し、次にその中に1つ以上のClaudeデプロイメントを作成します。

Foundryリソースのプロビジョニング

Azureでサービスを使用および管理するために必要なFoundryリソースを作成します。Foundryリソースを作成するには、こちらの手順に従ってください。または、Foundryリソースの作成を伴うFoundryプロジェクトの作成から始めることもできます。

リソースをプロビジョニングするには：

1. Foundryポータルに移動します。
2. 新しいFoundryリソースを作成するか、既存のリソースを選択します。
3. Azure発行のAPIキー、またはロールベースのアクセス制御のためのEntra ID（旧Azure Active Directory）を使用してアクセス管理を構成します。
4. 必要に応じて、リソースへのネットワークアクセスを制限するために、リソースをプライベートネットワーク（Azure Virtual Network）の一部として構成します。
5. リソース名をメモします。これはAPIエンドポイントで{resource}として使用します（例：https://{resource}.services.ai.azure.com/anthropic/v1/*）。

Foundryデプロイメントの作成

リソースを作成した後、Claudeモデルをデプロイして、API呼び出しで利用できるようにします。以下の手順は新しいFoundryポータル（New Foundryトグルがオンの状態）について説明しています。

1. Foundryポータルにサインインします。ポータルのホームページで、右上のナビゲーションからDiscoverを選択し、左側のペインでModelsを選択してモデルカタログを開きます。
2. Claudeモデル（例：claude-opus-5）を検索して選択します。各モデルは、サポートするホスティングオプションの数に関係なく、カタログに1回だけ表示されます。
3. モデルカードでDeployを選択し、次にCustom settingsを選択してデプロイメント設定ペインを開きます。代わりにDefault settingsを選択した場合、両方のホスティングオプションで利用可能なモデルについては、デプロイメントが自動的にHosted on Azureとして構成されます。
4. 最初のClaudeデプロイメントでは、Azure Marketplaceの利用規約を確認し、業種を選択してAgree and Proceedを選択し、規約に同意してAzure Marketplaceのオファーをサブスクライブします。
5. デプロイメントを構成します。
   • Deployment name: デフォルトはモデルIDですが、カスタマイズできます（例：my-claude-deployment）。デプロイメント名は作成後に変更できません。
   • Region scope: Globalを選択するか、Azureでホストされるモデルの場合はData Zoneを選択します。Data Zoneを選択するとUS Data Zone Standardデプロイメントが作成され、推論が米国内に留まります。これはClaude APIでinference_geo: "us"を設定することと同等です。Claude Sonnet 5.5の場合は、Globalを選択してください。
   • Model version: Model version settingsを展開し、Model versionドロップダウンメニューからバージョンを選択します。各ホスティングオプションは個別のモデルバージョンとして一覧表示され、ホスティングオプションのラベルが付いています（例：Hosted on Anthropicはバージョン1、Hosted on Azureはバージョン2）。
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トークンの2つの認証方法をサポートしています。どちらの方法も、https://{resource}.services.ai.azure.com/anthropic/v1/*形式のAzureホストのエンドポイントを使用します。

APIキー認証

Foundry Claudeリソースをプロビジョニングした後、FoundryポータルからAPIキーを取得できます。

1. Foundryポータルで、右上のナビゲーションでBuildを選択し、次に左ペインでModelsを選択します。
2. Claudeデプロイメントを開き、Detailsタブを選択します。
3. Keyの値をコピーします（また、エンドポイントのTarget URIをメモします）。
4. リクエストでapi-keyまたはx-api-keyヘッダーのいずれかを使用するか、SDKに提供します。

Foundry SDKには、APIキーと、リソース名またはベースURLのいずれかが必要です。C#、Java、PHP、Python、TypeScriptのSDKは、以下の環境変数が定義されている場合、自動的にそれらを読み取ります。

• ANTHROPIC_FOUNDRY_API_KEY - APIキー
• ANTHROPIC_FOUNDRY_RESOURCE - リソース名（例：example-resource）
• ANTHROPIC_FOUNDRY_BASE_URL - リソース名の代替：完全なベースURL（例：https://example-resource.services.ai.azure.com/anthropic/）。C# SDKはこの変数を読み取りません。常にリソース名からベースURLを構築します。

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でアクセスを管理し、組織のID管理と統合し、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 Fable 5.1、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5.5、Claude Sonnet 5、Claude Sonnet 4.6は、Microsoft Foundryで100万トークンのコンテキストウィンドウを備えています。Claude Sonnet 4.5を含むその他のClaudeモデルのコンテキストウィンドウは20万トークンです。

Microsoft FoundryのClaudeでサポートされていないClaude機能

• Admin API
• Advisorツール
• Claude Managed Agents
• Compliance API
• Models API
• Message Batches API
• サーバーサイドフォールバック（fallbacksパラメータ。代わりにクライアントサイドフォールバックパターンを使用してください）
• コンピュータ使用およびブラウザ使用ツールセット（computer_toolset_20260801およびbrowser_toolset_20260801は現在Microsoft Foundryでは利用できません。ベータ版のコンピュータ使用ツールのバージョンは引き続き利用可能です）

Azureでホストされる場合にサポートされない追加機能

以下の機能は、Anthropicでホストされるデプロイメントでは利用可能ですが、Azureでホストされるデプロイメントではサポートされていません。

• コード実行
• web_search_20250305およびweb_fetch_20250910より後のウェブ検索およびウェブフェッチツールのバージョン。Azureでホストされるデプロイメントはこれらの基本バージョンのみをサポートするため、動的フィルタリング、レスポンスの包含、キャッシュバイパスは利用できません。
• Agent Skills
• プログラムによるツール呼び出し
• Files API

Azureでホストされるデプロイメントに対してこれらの機能を使用するリクエストは、設計上400 Bad Requestエラーを返します。Claude CodeはAzureでホストされるデプロイメントを検出し、機能セットを自動的に適応させます。

APIレスポンス

Microsoft FoundryのClaudeからのAPIレスポンスは、標準のClaude APIレスポンス形式に従います。これには、リクエストの詳細なトークン消費情報を提供するレスポンスボディ内のusageオブジェクトが含まれます。usageオブジェクトは、すべてのプラットフォーム（Claude API、Amazon Bedrock、Claude Platform on AWS、Foundry、Google Cloud）で一貫しています。

Foundry固有のレスポンスヘッダーの詳細については、相関リクエストIDを参照してください。

APIモデルIDとデプロイメント

ライフサイクル用語（非推奨、廃止済み）はモデルの非推奨で定義されています。Microsoft FoundryはClaude APIのライフサイクルスケジュールに従います。

以下のClaudeモデルがFoundryを通じて利用可能です。

デフォルトでは、デプロイメント名は上記の表に示されているモデルIDと一致します。ただし、Foundryポータルで異なる名前のカスタムデプロイメントを作成して、異なる構成、バージョン、またはレート制限を管理できます。APIリクエストでは、デプロイメント名（必ずしもモデルIDではありません）を使用してください。

請求

Microsoft FoundryのClaudeは、Azure Marketplaceを通じて請求されます。使用量はClaude Consumption Units（CCU）で表され、1時間ごとに計測され、Azureの請求書で毎月後払いで請求されます。CCUはプリペイドクレジットではありません。CCUの残高やコミットメントはありません。

CCUの価格、換算の仕組み、モデルごとのトークンレートについては、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（旧Azure AI 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）を使用してください。
• 解決策： モデル/デプロイメントがお使いのAzureリージョンで利用可能であることを確認してください。

エラー： Invalid model parameter

• 解決策： modelパラメータにはデプロイメント名を含める必要があります。デプロイメント名はFoundryポータルでカスタマイズできます。デプロイメントが存在し、正しく構成されていることを確認してください。

次のステップ

追加リソース