Microsoft FoundryでのClaude

このガイドでは、Anthropicのクライアント SDK のいずれか、または直接の HTTP リクエストを使用して、Microsoft Foundry で Claude をセットアップし、API 呼び出しを行うプロセスについて説明します。Microsoft Foundry で Claude にアクセスすると、Claude の使用料は Azure Marketplace で請求されるため、Azure サブスクリプションを通じてコストを管理しながら、Claude の最新機能にアクセスできます。

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



ホスティングオプション

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



前提条件

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

• アクティブな Azure サブスクリプション
• Foundry へのアクセス
• Azure CLI のインストール（オプション、リソース管理用）



SDK のインストール

Anthropic のクライアント SDK は、プラットフォーム固有のパッケージまたはクライアントクラスを通じて Foundry をサポートしています。



プロビジョニング

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 を選択した場合、両方のホスティングオプションで利用可能なモデルについては、デプロイメントは自動的に 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キー）が表示されます。



認証

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/）

APIキーを使用した例：



Microsoft Entra 認証

セキュリティの強化と一元的なアクセス管理のために、Entra ID トークンを使用できます。

1. Foundry リソースの Entra 認証を有効にします
2. Entra ID からアクセストークンを取得します
3. Authorization: Bearer {TOKEN} ヘッダーでトークンを使用します

Entra ID を使用した例：



相関リクエスト ID

Foundry は、デバッグとトレースのために HTTP レスポンスヘッダーにリクエスト識別子を含めます。サポートに連絡する際は、request-id と apim-request-id の両方の値を提供してください。これにより、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 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-sonnet-4-6）を使用してください。
• 解決策： モデル/デプロイメントが Azure リージョンで利用可能であることを確認してください。

エラー： Invalid model parameter

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



追加リソース

• Foundry ドキュメント： ai.azure.com/catalog
• Azure 料金： azure.microsoft.com/en-us/pricing/details/ai-foundry
• Anthropic 料金詳細： モデル料金
• 認証ガイド： 認証を参照してください
• Azure ポータル： portal.azure.com