Microsoft Foundry上のClaude

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

Claude は、Foundry リソースの Global Standard および US Data Zone Standard デプロイメントタイプで利用可能で、Azure Marketplace を通じて Claude Consumption Unit で請求されます。詳細については、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-4-8）を検索して選択します。各モデルは、サポートするホスティングオプションの数に関係なく、カタログに1回だけ表示されます。
3. モデルカードで Deploy を選択し、次に Custom settings を選択してデプロイメント設定ペインを開きます。代わりに Default settings を選択した場合、両方のホスティングオプションで利用可能なモデルについては、デプロイメントは自動的に Azure でホストとして構成されます。
4. 最初の Claude デプロイメントでは、Azure Marketplace の条件を確認し、業界を選択して、Agree and Proceed を選択して条件に同意し、Azure Marketplace オファーにサブスクライブします。
5. デプロイメントを構成します：
   • デプロイメント名： デフォルトはモデル ID ですが、カスタマイズできます（例：my-claude-deployment）。デプロイメント名は作成後に変更できません。
   • リージョンスコープ： Global を選択するか、Azure でホストされているモデルの場合は Data Zone を選択します。Data Zone を選択すると、US Data Zone Standard デプロイメントが作成され、推論が米国内に保持されます。これは Claude API で inference_geo: "us" を設定することと同等です。
   • モデルバージョン： Model version settings を展開し、Model version ドロップダウンからバージョンを選択します。各ホスティングオプションは、そのホスティングオプションのラベルが付いた個別のモデルバージョンとして一覧表示されます（例：Anthropic でホストの場合はバージョン1、Azure でホストの場合はバージョン2）。
6. Deploy を選択し、プロビジョニングが完了するのを待ちます。
7. デプロイが完了したら、右上のナビゲーションで Build を選択し、次に左ペインで Models を選択して、デプロイメントを開きます。Details タブには、Target URI（エンドポイント URL）と Key（APIキー）が表示されます。

New Foundry トグルがオフの場合は、クラシックポータルレイアウトになっています。その場合は、左ペインの Model catalog を開いてモデルを検索してデプロイし、（My assets の下の）Models + endpoints を開いてデプロイメントとそのエンドポイントの詳細を表示します。



認証

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-4-8",
    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-4-8",
    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 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、Foundry、AWS 上の Claude Platform、Amazon Bedrock、Google Cloud）で一貫しています。

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



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

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

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

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



請求

Microsoft Foundry 上の Claude は、Azure Marketplace を通じて請求されます。使用量は Claude Consumption Unit（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-4-8）を使用してください。
• 解決策： モデル/デプロイメントが Azure リージョンで利用可能であることを確認してください。

エラー： Invalid model parameter

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



次のステップ



その他のリソース