Microsoft FoundryのClaude
Azureネイティブのエンドポイントと認証を使用して、Microsoft Foundry経由でClaudeモデルにアクセスします。
このガイドでは、Microsoft FoundryのClaudeをセットアップし、API呼び出しを行う方法を説明します。AnthropicのクライアントSDKのいずれか、または直接のHTTPリクエストを使用できます。Microsoft FoundryでClaudeにアクセスする場合、Claudeの使用料はAzure Marketplaceを通じて支払います。利用可能なモデルはAPIモデルIDとデプロイメントに記載されています。100万トークンの「context window」(コンテキストウィンドウ)などの機能も利用できます。コストはAzureサブスクリプションを通じて管理します。
Claudeは、FoundryリソースのGlobal StandardおよびUS Data Zone Standardのデプロイメントタイプで利用でき、Azure Marketplaceを通じてClaude Consumption Unitsで請求されます。詳細については、Microsoft FoundryのClaudeの料金を参照してください。
ホスティングオプション
Microsoft FoundryのClaudeモデルは、2つのホスティングオプションで利用できます。ホスティングオプションはデプロイメントを構成する際に選択します。
| Azureでホスト(Hosted on Azure) | Anthropicでホスト(Hosted on Anthropic) | |
|---|---|---|
| 推論の実行場所 | Azureインフラストラクチャ上で稼働する、Anthropicが運用するサービス | Anthropicインフラストラクチャ上で稼働する、Anthropicが運用するサービス |
| モデルの利用可能性 | 一部のOpus、Sonnet、Haikuモデル | Microsoft Foundryで利用可能なすべてのClaudeモデル |
| デプロイメントタイプ | Global Standard、US Data Zone Standard | Global Standard |
| 推奨される用途 | ほとんどのワークロード | AnthropicでのみホストされるモデルまたはAnthropicでホストされる場合にのみ利用可能な機能を必要とするワークロード |
Azureでホストされるデプロイメントの場合、Anthropicはプロンプトと補完をAzureインフラストラクチャ上で処理し、保持されるコンテンツをそこに保存します。保持されるコンテンツには、Anthropicの安全システムによってAnthropicによるレビュー対象としてフラグが付けられたコンテンツが含まれます。プロンプトや補完を含まない運用データは、Azure外のAnthropicのシステムに保存されます。例としては、安全性分類器が出力するスコア、識別子、使用状況および請求データなどがあります。
前提条件
開始する前に、以下があることを確認してください:
- 有効なAzureサブスクリプション
- Foundryポータルへのアクセス
- プロビジョニングで作成するFoundryリソースに対する、Foundry UserやCognitive Services UserなどのAzureの「role-based access control」(ロールベースのアクセス制御)、すなわちRBACのロール
- オプション:
az account get-access-tokenでMicrosoft Entra IDトークンを取得するためのAzure CLI
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リソースのプロビジョニング
リソースをプロビジョニングするには:
- Foundryポータルに移動します。
- モデルが利用可能なAzureリージョンで、Foundryリソースを作成または選択します。MicrosoftのFoundryリソースの作成手順に従うか、Foundryプロジェクトを作成することもできます。プロジェクトを作成すると、リソースが自動的に作成されます。
- リソース名を控えておきます。これは、
https://{resource}.services.ai.azure.com/anthropic/v1/*などのAPIエンドポイントにおける{resource}です。
ネットワークアクセスを制限するには、リソースをプライベートネットワーク(Azure Virtual Network)に追加できます。
Foundryデプロイメントの作成
リソースを作成したら、Claudeモデルをデプロイして、API呼び出しで利用できるようにします。以下の手順は、新しいFoundryポータル(New Foundryトグルがオン)について説明しています。
- Foundryポータルにサインインします。ポータルのホームページで、右上のナビゲーションにあるDiscoverを選択し、左ペインのModelsを選択してモデルカタログを開きます。
- Claudeモデル(例:
claude-opus-5-5)を検索して選択します。各モデルは、サポートするホスティングオプションの数に関係なく、カタログに1回だけ表示されます。 - モデルカードでDeployを選択し、次にCustom settingsを選択してデプロイメント設定ペインを開きます。代わりにDefault settingsを選択した場合、両方のホスティングオプションで利用可能なモデルについては、デプロイメントは自動的にHosted on Azureとして構成されます。
- 最初のClaudeデプロイメントでは、Azure Marketplaceの利用規約を確認し、業種を選択して、Agree and Proceedを選択して規約に同意し、Azure Marketplaceのオファーをサブスクライブします。
- デプロイメントを構成します。
- Deployment name: デフォルトはモデルIDですが、カスタマイズできます(例:
my-claude-deployment)。デプロイメント名は作成後に変更できません。 - Model version: この設定によってホスティングオプションが決まります。Model version settingsを展開し、Model versionドロップダウンメニューを開いて、希望するホスティングオプションのラベルが付いたバージョンを選択します。
- Region scope: Globalを選択するか、デプロイメントがAzureでホストされる場合はData Zoneを選択します。Data ZoneはUS Data Zone Standardデプロイメントを作成し、推論を米国内に留めます。料金については、推論の地理的範囲を参照してください。
- Deployment name: デフォルトはモデルIDですが、カスタマイズできます(例:
- Deployを選択し、プロビジョニングが完了するまで待ちます。
- デプロイが完了したら、右上のナビゲーションで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/*形式のエンドポイントを使用します。Claude Mythosモデルには、Entra IDトークンを使用してください。
APIキー認証
Foundry Claudeリソースをプロビジョニングした後、FoundryポータルからAPIキーを取得できます。
- Foundryポータルで、右上のナビゲーションにあるBuildを選択し、左ペインのModelsを選択します。
- Claudeデプロイメントを開き、Detailsタブを選択します。
- Keyの値をコピーします(エンドポイントのTarget URIも控えておきます)。
- リクエストで
api-keyまたはx-api-keyヘッダーのいずれかを使用するか、SDKに渡します。
SDKのFoundryクライアントには、APIキーと、リソース名またはベースURLのいずれかが必要です。以下の環境変数が定義されている場合は、それらから自動的に読み取ります。
ANTHROPIC_FOUNDRY_API_KEY- APIキーANTHROPIC_FOUNDRY_RESOURCE- リソース名(例:example-resource)ANTHROPIC_FOUNDRY_BASE_URL- C#を除くすべてのSDKで使用できる、リソース名の代替:完全なベース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-opus-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message.content)Microsoft Entra認証
Entra ID認証を使用すると、Azure RBACでアクセスを管理し、組織のID管理と統合し、APIキーを手動で扱う必要がなくなります。Entra IDトークンを使用するには:
- FoundryリソースでMicrosoft Entra ID認証を有効にします。
- Entra IDからアクセストークンを取得します。
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-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の機能が記載されており、各機能のページの利用可能状況セクションでは、Foundryがその機能をサポートしているかどうか、またどのホスティングオプションでサポートしているかを確認できます。
コンテキストウィンドウ
Microsoft Foundryでは、Claude Opus 4.5、Claude Sonnet 4.5(非推奨)、Claude Haiku 4.5を除くすべての利用可能なモデルが100万トークンのコンテキストウィンドウを備えています。これら3つのモデルのコンテキストウィンドウは20万トークンです。
Microsoft FoundryのClaudeでサポートされていないClaude機能
- Admin API
- アドバイザーツール
- Claude Managed Agents
- Compliance API
- Models API
- Message Batches API
- サーバー側フォールバック(
fallbacksパラメータ。代わりにクライアント側フォールバックパターンを使用してください) - ユーザープロファイルエンドポイント(
/v1/user_profiles。代わりにClaude APIでプロファイルを作成してください)
Azureでホストされる場合にサポートされない追加機能
以下の機能は、Anthropicでホストされるデプロイメントでは利用可能ですが、Azureでホストされるデプロイメントではサポートされていません。
- コード実行
web_search_20250305およびweb_fetch_20250910より後のウェブ検索およびウェブフェッチツールのバージョン。Azureでホストされるデプロイメントはこれらの基本バージョンのみをサポートするため、動的フィルタリング、レスポンスの包含、キャッシュバイパスは利用できません。- Agent Skills
- プログラムによるツール呼び出し
- Files API
Azureでホストされるデプロイメントに対してこれらの機能を使用するリクエストは、設計上400 Bad Requestエラーを返します。Claude CodeはAzureでホストされるデプロイメントを検出し、機能セットを自動的に適応させます。
APIレスポンス
Microsoft FoundryのClaudeからのAPIレスポンスは、usageオブジェクトを含め、標準のClaude APIレスポンス形式API リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。に従います。
Foundry固有のレスポンスヘッダーの詳細については、相関リクエストIDを参照してください。
APIモデルIDとデプロイメント
ライフサイクル用語(非推奨、廃止済み)はモデルの非推奨で定義されています。Microsoft FoundryはClaude APIのライフサイクルスケジュールに従います。
以下のClaudeモデルがFoundryを通じて利用可能です。
| モデル | デフォルトのデプロイ名 | Azure でホスト | Anthropic でホスト |
|---|---|---|---|
| Claude Fable 5.2 | claude-fable-5-2 | ✓ | |
| Claude Mythos 5.2(限定提供(新しいタブで開く)) | claude-mythos-5-2 | ✓ | |
| Claude Fable 5.1 | claude-fable-5-1 | ✓ | |
| Claude Mythos 5.1(限定提供(新しいタブで開く)) | claude-mythos-5-1 | ✓ | |
| Claude Fable 5 | claude-fable-5 | ✓ | |
| Claude Mythos 5(限定提供(新しいタブで開く)) | claude-mythos-5 | ✓ | |
| Claude Opus 5.5 | claude-opus-5-5 | ✓ | ✓ |
| Claude Opus 5 | claude-opus-5 | ✓ | ✓ |
| Claude Opus 4.8 | claude-opus-4-8 | ✓ | ✓ |
| 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 5.5 | claude-sonnet-5-5 | ✓ | ✓ |
| Claude Sonnet 5 | claude-sonnet-5 | ✓ | ✓ |
| Claude Sonnet 4.6 | claude-sonnet-4-6 | ✓ | |
| Claude Sonnet 4.5(非推奨) | claude-sonnet-4-5 | ✓ | |
| Claude Haiku 5.5 | claude-haiku-5-5 | ✓ | ✓ |
| Claude Haiku 4.5 | claude-haiku-4-5 | ✓ | ✓ |
デフォルトでは、デプロイメント名は上記の表に示されているモデルIDと一致します。ただし、Foundryポータルで異なる名前のカスタムデプロイメントを作成して、異なる構成、バージョン、またはレート制限を管理できます。APIリクエストでは、デプロイメント名(必ずしもモデルIDではありません)を使用してください。
Claude Code
Claude Codeに新しいモデルへのコード移行を任せる
/claude-api migrate このプロジェクトを最新のClaude Opusモデルに移行してください請求
Microsoft FoundryのClaudeは、Azure Marketplaceを通じて請求されます。使用量はClaude Consumption Units(CCU)で表され、1時間ごとに計測され、Azureの請求書で毎月後払いで請求されます。CCUはプリペイドクレジットではありません。CCUの残高やコミットメントはありません。
CCUの価格、換算の仕組み、モデルごとのトークンレートについては、Microsoft FoundryのClaudeの料金を参照してください。
ホスティングオプション間の移行
既存のデプロイメントを一方のホスティングオプションからもう一方に移行するには:
- モデルのもう一方のホスティングバージョン(AzureでホストまたはAnthropicでホスト)の新しいデプロイメントを作成します。これは同じFoundryリソース内でも、新しいリソース内でもかまいません。
modelパラメータに新しいデプロイメント名を渡すようにアプリケーションを更新します。- トラフィックが移行したら、古いデプロイメントを削除します。
新しいデプロイメントが同じ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または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-5)を使用してください。 - 解決策: モデル/デプロイメントがお使いのAzureリージョンで利用可能であることを確認してください。
エラー: Invalid model parameter
- 解決策:
modelパラメータにはデプロイメント名を含める必要があり、これはFoundryポータルでカスタマイズできます。デプロイメントが存在し、適切に構成されていることを確認してください。
次のステップ
追加リソース
FoundryカタログでAnthropicのモデルを閲覧します。
Microsoft Foundryに関するMicrosoftの料金詳細を表示します。
Anthropicのモデルごとの料金詳細を表示します。
Azureリソースを管理します。
このページは役に立ちましたか?