Microsoft Foundry での Claude

このガイドでは、Python、TypeScript、または直接 HTTP リクエストを使用して、Foundry で Claude をセットアップし、API 呼び出しを行うプロセスについて説明します。Foundry で Claude にアクセスできる場合、Claude の使用に対して Microsoft Marketplace で Azure サブスクリプションを通じて課金され、Azure サブスクリプションを通じてコストを管理しながら Claude の最新機能にアクセスできます。

地域の可用性: 起動時に、Claude は Foundry リソースで Global Standard デプロイメントタイプとして利用可能です (US DataZone は近日中に提供予定)。Microsoft Marketplace での Claude の価格は Anthropic の標準 API 価格を使用しています。詳細については、価格ページをご覧ください。

Foundry は C#、Java、PHP、Python、および TypeScript SDK でサポートされています。Go および Ruby SDK は現在 Microsoft Foundry をサポートしていません。利用可能な SDK プラットフォーム統合については、Client SDKs を参照してください。

プレビュー

このプレビュープラットフォーム統合では、Claude モデルは Anthropic のインフラストラクチャ上で実行されます。これは Azure を通じた課金とアクセスのための商用統合です。Microsoft の独立したプロセッサとして、Microsoft Foundry を通じて Claude を使用する顧客は Anthropic のデータ使用条件の対象となります。Anthropic は、ゼロデータ保持の可用性を含む、業界をリードするセキュリティとデータコミットメントを引き続き提供しています。

前提条件

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

アクティブな Azure サブスクリプション
Foundry へのアクセス
Azure CLI がインストールされていること (オプション、リソース管理用)

SDK をインストールする

Anthropic の client SDKs は、プラットフォーム固有のパッケージを通じて Foundry をサポートしています。

プロビジョニング

Foundry は 2 レベルの階層を使用します: リソースはセキュリティと課金設定を含み、デプロイメントは API 経由で呼び出すモデルインスタンスです。最初に Foundry リソースを作成し、その中に 1 つ以上の Claude デプロイメントを作成します。

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

Foundry リソースを作成します。これは Azure でサービスを使用および管理するために必要です。これらの指示に従って Foundry リソースを作成できます。または、Foundry プロジェクトを作成することから始めることもできます。これには Foundry リソースの作成が含まれます。

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

Foundry ポータルに移動します
新しい Foundry リソースを作成するか、既存のリソースを選択します
Azure が発行した API キーまたはロールベースのアクセス制御用の Entra ID を使用してアクセス管理を設定します
オプションで、リソースをプライベートネットワーク (Azure Virtual Network) の一部になるように設定して、セキュリティを強化します
リソース名をメモします。これを API エンドポイントで {resource} として使用します (例: https://{resource}.services.ai.azure.com/anthropic/v1/*)

Foundry デプロイメントの作成

リソースを作成した後、Claude モデルをデプロイして、API 呼び出しで利用できるようにします:

Foundry ポータルでリソースに移動します
Models + endpoints に移動し、+ Deploy model > Deploy base model を選択します
Claude モデル (例: claude-sonnet-4-6) を検索して選択します
デプロイメント設定を構成します:
- Deployment name: デフォルトではモデル ID ですが、カスタマイズできます (例: my-claude-deployment)。デプロイメント名は作成後に変更することはできません。
- Deployment type: Global Standard を選択します (Claude に推奨)
Deploy を選択し、プロビジョニングが完了するまで待ちます
デプロイされたら、Keys and Endpoint でエンドポイント URL とキーを確認できます

選択したデプロイメント名は、API リクエストの model パラメータで渡す値になります。同じモデルの複数のデプロイメントを異なる名前で作成して、個別の設定またはレート制限を管理できます。

認証

Claude on Foundry は 2 つの認証方法をサポートしています: API キーと Entra ID トークン。両方の方法は、https://{resource}.services.ai.azure.com/anthropic/v1/* 形式の Azure ホストエンドポイントを使用します。

API キー認証

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

Foundry ポータルでリソースに移動します
Keys and Endpoint セクションに移動します
提供されている API キーの 1 つをコピーします
リクエストで api-key または x-api-key ヘッダーを使用するか、SDK に提供します

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

ANTHROPIC_FOUNDRY_API_KEY - API キー
ANTHROPIC_FOUNDRY_RESOURCE - リソース名 (例: example-resource)
ANTHROPIC_FOUNDRY_BASE_URL - リソース名の代替; 完全なベース URL (例: https://example-resource.services.ai.azure.com/anthropic/)

resource パラメータと base_url パラメータは相互に排他的です。リソース名 (SDK が https://{resource}.services.ai.azure.com/anthropic/ として URL を構築するために使用) または完全なベース URL のいずれかを提供します。

API キーを使用した例:

API キーを安全に保つ。バージョン管理にコミットしたり、公開で共有したりしないでください。API キーにアクセスできる人は誰でも、Foundry リソース経由で Claude にリクエストを行うことができます。

Microsoft Entra 認証

セキュリティの向上と一元化されたアクセス管理のために、Entra ID (旧 Azure Active Directory) トークンを使用できます:

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

Entra ID を使用した例:

Azure Entra ID 認証により、Azure RBAC を使用してアクセスを管理し、組織のアイデンティティ管理と統合し、API キーを手動で管理することを回避できます。

相関リクエスト ID

Foundry は、デバッグとトレース用に HTTP レスポンスヘッダーにリクエスト識別子を含めます。サポートに連絡する場合は、request-id と apim-request-id の両方の値を提供して、チームが Anthropic と Azure の両方のシステム全体でリクエストをすばやく特定して調査できるようにします。

サポートされている機能

Claude on Foundry は Claude の強力な機能のほとんどをサポートしています。現在サポートされているすべての機能は、概要ドキュメントで確認できます。

コンテキストウィンドウ

Claude Opus 4.7、Claude Opus 4.6、および Claude Sonnet 4.6 は、Microsoft Foundry で 1M トークンコンテキストウィンドウを持っています。Sonnet 4.5 を含む他の Claude モデルは、200k トークンコンテキストウィンドウを持っています。

サポートされていない機能

Admin API (/v1/organizations/* エンドポイント)
Models API (/v1/models)
Message Batch API (/v1/messages/batches)

API レスポンス

Claude on Foundry からの API レスポンスは、標準の Claude API レスポンス形式に従います。これには、リクエストのトークン消費情報を提供するレスポンス本体の usage オブジェクトが含まれます。usage オブジェクトはすべてのプラットフォーム (ファーストパーティ API、Foundry、Amazon Bedrock、および Google Vertex AI) で一貫しています。

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

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

以下の Claude モデルは Foundry を通じて利用可能です。最新世代モデル (Opus 4.7、Opus 4.6、Sonnet 4.6、および Haiku 4.5) は最も高度な機能を提供します:

モデル	デフォルトデプロイメント名
Claude Opus 4.7	`claude-opus-4-7`
Claude Opus 4.6	`claude-opus-4-6`
Claude Opus 4.5	`claude-opus-4-5`
Claude Sonnet 4.6	`claude-sonnet-4-6`
Claude Sonnet 4.5	`claude-sonnet-4-5`
Claude Opus 4.1	`claude-opus-4-1`
Claude Haiku 4.5	`claude-haiku-4-5`

デフォルトでは、デプロイメント名は上記のモデル ID と一致します。ただし、Foundry ポータルで異なる名前のカスタムデプロイメントを作成して、異なる設定、バージョン、またはレート制限を管理できます。API リクエストでデプロイメント名 (必ずしもモデル ID ではない) を使用します。

監視とログ

Azure は、標準的な Azure パターンを通じて Claude の使用に関する包括的な監視とログ機能を提供します:

Azure Monitor: API 使用、レイテンシ、エラー率を追跡します
Azure Log Analytics: リクエスト/レスポンスログをクエリして分析します
Cost Management: Claude の使用に関連するコストを監視および予測します

Anthropic は、使用パターンを理解し、潜在的な問題を調査するために、少なくとも 30 日間のローリングベースで活動をログすることをお勧めします。

Azure のログサービスは Azure サブスクリプション内で設定されます。ログを有効にしても、課金とサービス運用に必要な範囲を超えて、Microsoft または Anthropic がコンテンツにアクセスすることはありません。

トラブルシューティング

認証エラー

エラー: 401 Unauthorized または Invalid API key

解決策: API キーが正しいことを確認してください。Azure ポータルの Claude リソースの Keys and Endpoint から新しい API キーを取得できます。
解決策: Azure Entra ID を使用している場合は、アクセストークンが有効で、期限切れになっていないことを確認してください。トークンは通常 1 時間後に期限切れになります。

エラー: 403 Forbidden

解決策: Azure アカウントに必要な権限がない可能性があります。適切な Azure RBAC ロール (例: "Cognitive Services OpenAI 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 ポータルでカスタマイズできるデプロイメント名を含める必要があります。デプロイメントが存在し、適切に設定されていることを確認してください。

Claude Mythos Preview は、Microsoft Foundry で招待されたお客様が利用できるリサーチプレビューです。詳細については、Project Glasswing を参照してください。

その他のリソース

Foundry ドキュメント: ai.azure.com/catalog
Azure 価格: azure.microsoft.com/en-us/pricing
Anthropic 価格詳細: 価格ドキュメント
認証ガイド: 上記の認証セクションを参照してください
Azure ポータル: portal.azure.com