Claude on 3rd-party platforms

Microsoft Foundry での Claude

Azure ネイティブエンドポイントと認証を使用して 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 価格を使用します。詳細については、価格ページをご覧ください。

プレビュー

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

前提条件

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

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

SDK をインストールする

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

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

プロビジョニング

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 ポータルで、リソースに移動します
モデル + エンドポイントに移動し、+ モデルをデプロイ > ベースモデルをデプロイを選択します
Claude モデル (例: claude-sonnet-4-5) を検索して選択します
デプロイメント設定を構成します:
- デプロイメント名: デフォルトではモデル ID ですが、カスタマイズできます (例: my-claude-deployment)。デプロイメント名は作成後に変更することはできません。
- デプロイメントタイプ: Global Standard を選択します (Claude に推奨)
デプロイを選択し、プロビジョニングが完了するまで待ちます
デプロイされたら、キーとエンドポイントの下でエンドポイント 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 ポータルでリソースに移動します
キーとエンドポイントセクションに移動します
提供されている 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 キーを使用した例:

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-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

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

Microsoft Entra 認証

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

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

Entra ID を使用した例:

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Get Azure Entra ID token using token provider pattern
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    resource='example-resource', # your resource name
    azure_ad_token_provider=token_provider  # Use token provider for Entra ID auth
)

# Make request
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

Azure Entra ID 認証を使用すると、Azure RBAC を使用してアクセスを管理し、組織の ID 管理と統合し、API キーを手動で管理することを避けることができます。

相関リクエスト ID

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

サポートされている機能

Claude on Foundry は Claude の強力な機能のほとんどをサポートしています。現在サポートされているすべての機能はここで見つけることができます。

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

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

API レスポンス

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

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

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

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

モデル	デフォルトデプロイメント名
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 リソースの キーとエンドポイントから新しい 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-5) を使用します。
解決策: モデル/デプロイメントが Azure リージョンで利用可能であることを確認します。

エラー: Invalid model parameter

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

追加リソース

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

Claude on 3rd-party platforms

Microsoft Foundry での Claude

Azure ネイティブエンドポイントと認証を使用して Microsoft Foundry 経由で Claude モデルにアクセスします。

プレビュー

前提条件

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

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

SDK をインストールする

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

# Python
pip install -U "anthropic"

# Typescript
npm install @anthropic-ai/foundry-sdk

プロビジョニング

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

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

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

Foundry デプロイメントの作成

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

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

認証

API キー認証

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

Foundry ポータルでリソースに移動します
キーとエンドポイントセクションに移動します
提供されている API キーの 1 つをコピーします
リクエストで api-key または x-api-key ヘッダーを使用するか、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 キーを使用した例:

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-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

Microsoft Entra 認証

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

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

Entra ID を使用した例:

import os
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

# Get Azure Entra ID token using token provider pattern
token_provider = get_bearer_token_provider(
    DefaultAzureCredential(),
    "https://cognitiveservices.azure.com/.default"
)

# Create client with Entra ID authentication
client = AnthropicFoundry(
    resource='example-resource', # your resource name
    azure_ad_token_provider=token_provider  # Use token provider for Entra ID auth
)

# Make request
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content)

相関リクエスト ID

サポートされている機能

Claude on Foundry は Claude の強力な機能のほとんどをサポートしています。現在サポートされているすべての機能はここで見つけることができます。

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

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

API レスポンス

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

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

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

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

監視とログ

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

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

トラブルシューティング

認証エラー

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

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

エラー: 403 Forbidden

解決策: Azure アカウントに必要な権限がない可能性があります。適切な Azure RBAC ロール (例: "Cognitive Services OpenAI User") が割り当てられていることを確認します。

レート制限

エラー: 429 Too Many Requests

解決策: レート制限を超えています。アプリケーションに指数バックオフと再試行ロジックを実装します。
解決策: Azure ポータルまたは Azure サポートを通じてレート制限の増加をリクエストすることを検討してください。

レート制限ヘッダー

モデルとデプロイメントエラー

エラー: Model not found または Deployment not found

解決策: 正しいデプロイメント名を使用していることを確認します。カスタムデプロイメントを作成していない場合は、デフォルトモデル ID (例: claude-sonnet-4-5) を使用します。
解決策: モデル/デプロイメントが Azure リージョンで利用可能であることを確認します。

エラー: Invalid model parameter

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

追加リソース

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

プレビュー

前提条件

SDK をインストールする

プロビジョニング

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

Foundry デプロイメントの作成

認証

API キー認証

Microsoft Entra 認証

相関リクエスト ID

サポートされている機能

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

API レスポンス

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

監視とログ

トラブルシューティング

認証エラー

レート制限

レート制限ヘッダー

モデルとデプロイメント エラー

追加リソース

プレビュー

前提条件

SDK をインストールする

プロビジョニング

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

Foundry デプロイメントの作成

認証

API キー認証

Microsoft Entra 認証

相関リクエスト ID

サポートされている機能

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

API レスポンス

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

監視とログ

トラブルシューティング

認証エラー

レート制限

レート制限ヘッダー

モデルとデプロイメント エラー

追加リソース

モデルとデプロイメントエラー

モデルとデプロイメントエラー