Microsoft FoundryでのClaude

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

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



ホスティングオプション

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



前提条件

開始する前に、以下を確認してください。

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



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" を設定することと同等です。
   • 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",
    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",
    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、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、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 パラメータ。代わりにクライアントサイドフォールバックパターンを使用してください）



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

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

• 構造化出力
• サーバーサイドツール（ウェブ検索、ウェブフェッチ、コード実行、ツール検索）
• MCP コネクタ
• Agent Skills
• プログラマティックツール呼び出し
• Files API

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



API レスポンス

Microsoft Foundry の Claude からの API レスポンスは、標準の Claude API レスポンス形式に従います。これには、レスポンスボディの usage オブジェクトが含まれ、リクエストの詳細なトークン消費情報を提供します。usage オブジェクトは、すべてのプラットフォーム（Claude API、Amazon Bedrock、AWS 上の Claude Platform、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. モデルのもう一方のホスティングバージョン（Hosted on Azure または Hosted on 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 ポータルでカスタマイズできます。デプロイメントが存在し、適切に構成されていることを確認してください。



次のステップ



追加リソース