M
microsoft-foundry.md
2026-07-15 22:00 UTC to 2026-07-16 22:59 UTC
8 added, 2 removed.
2026
Claude Code on Microsoft Foundry
Microsoft Foundry を通じて Claude Code を構成する方法について学びます。セットアップ、構成、トラブルシューティングを含みます。
export const ContactSalesCard = ({surface}) => {
const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content};
const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
;
const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } };
return <div className="cc-cs not-prose">
<div className="cc-cs-card">
<div className="cc-cs-text">
Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.
<div className="cc-cs-actions">
<a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost">
View plans
<a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay">
Contact sales {iconArrowRight()}
;
};
前提条件
Microsoft Foundry で Claude Code を構成する前に、以下を確認してください:
- Microsoft Foundry へのアクセス権を持つ Azure サブスクリプション
- Microsoft Foundry リソースとデプロイメントを作成するための RBAC 権限
- Azure CLI がインストールされ、構成されている(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)
セットアップ
1. Microsoft Foundry リソースをプロビジョニングする
まず、Azure で Claude リソースを作成します:
- Microsoft Foundry ポータルに移動します
- 新しいリソースを作成し、リソース名をメモします
- Claude モデルのデプロイメントを作成します。各デプロイメントに付与する名前をメモしてください。ステップ 4 でこれらの名前をモデル変数として設定します:
- Claude Opus
- Claude Sonnet
- Claude Haiku
Claude Code は Microsoft Foundry の 3 つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください。
オプション A:API キー認証
- Microsoft Foundry ポータルでリソースに移動します
- エンドポイントとキーセクションに移動します
- API キーをコピーします
- 環境変数を設定します。
your-azure-api-key をコピーしたキーに置き換えます:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
オプション B:Microsoft Entra ID 認証
ANTHROPIC_FOUNDRY_API_KEY も ANTHROPIC_FOUNDRY_AUTH_TOKEN も設定されていない場合、Claude Code は Azure SDK デフォルト認証情報チェーンを自動的に使用します。
これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。
ローカル環境では、一般的に Azure CLI を使用できます:
az login
オプション C:ベアラートークン認証
{/* min-version: 2.1.203 */}Claude Code は、すべてのリクエストで ANTHROPIC_FOUNDRY_AUTH_TOKEN の値を Authorization: Bearer ヘッダーとして送信します。ホストアプリケーションやサインインスクリプトなど、別のプロセスがすでにアクセストークンを取得している場合に、このオプションを使用します。Claude Code v2.1.203 以降が必要です。
変数を、Microsoft Entra ID がリソース用に発行したベアラートークンに設定します:
export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token
ANTHROPIC_FOUNDRY_AUTH_TOKEN は ANTHROPIC_FOUNDRY_API_KEY およびデフォルト認証情報チェーンより優先されます。
Microsoft Foundry を有効にするには、以下の環境変数を設定します:
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
4. モデルバージョンをピン留めする
モデル変数をステップ 1 で作成したデプロイメント名と一致するように設定します。
ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、Foundry の opus エイリアスは Opus 4.6 に解決されます。最新のモデルを使用するために Opus 4.8 ID に設定します:
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-5'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
セッションタイトル生成などのバックグラウンドタスクは、通常は Haiku クラスモデルである小型/高速モデルを使用します。Foundry では、すべてのアカウントが Haiku デプロイメントを持っているわけではないため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、上記のように、アカウントで利用可能な Haiku デプロイメントに ANTHROPIC_DEFAULT_HAIKU_MODEL を設定します。
現在および従来のモデル ID については、モデル概要を参照してください。環境変数の完全なリストについては、モデル構成を参照してください。
プロンプトキャッシングは自動的に有効になります。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、以下の変数を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます:
export ENABLE_PROMPT_CACHING_1H=1
5. Claude Code を実行する
環境変数を設定したら、プロジェクトディレクトリから Claude Code を起動します:
claude
Claude Code は環境から CLAUDE_CODE_USE_FOUNDRY およびその他の Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Amazon Bedrock および Google Cloud の Agent Platform とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。
セットアップを確認するには、Claude Code 内で /status を実行します。API プロバイダー行に Microsoft Foundry が表示され、構成したリソース名またはベース URL が表示されます。
Azure RBAC 構成
Azure AI User および Cognitive Services User デフォルトロールには、Claude モデルを呼び出すために必要なすべての権限が含まれています。
より制限的な権限の場合は、以下を含むカスタムロールを作成します:
{
"permissions": [
{
"dataActions": [
"Microsoft.CognitiveServices/accounts/providers/*"
]
}
]
}
詳細については、Microsoft Foundry RBAC ドキュメントを参照してください。
トラブルシューティング
「Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed」というエラーが表示される場合:
- 環境で Entra ID を構成するか、
ANTHROPIC_FOUNDRY_API_KEY を設定してください。
最初のプロンプトで接続エラーが繰り返される場合、リクエストが失敗する場合:
ANTHROPIC_FOUNDRY_RESOURCE がプレースホルダーではなく、実際のリソース名に設定されていることを確認してください。Claude Code はこの値からエンドポイント URL を構築するため、不正な名前は存在しないホストを指します。
その他のリソース
104 104
1051. [Microsoft Foundry ポータル](https://ai.azure.com/)に移動します1051. [Microsoft Foundry ポータル](https://ai.azure.com/)に移動します
1062. 新しいリソースを作成し、リソース名をメモします1062. 新しいリソースを作成し、リソース名をメモします
1073. Claude モデルのデプロイメントを作成します:1073. Claude モデルのデプロイメントを作成します。各デプロイメントに付与する名前をメモしてください。ステップ 4 でこれらの名前をモデル変数として設定します:
108 * Claude Opus108 * Claude Opus
109 * Claude Sonnet109 * Claude Sonnet
110 * Claude Haiku110 * Claude Haiku
1201. Microsoft Foundry ポータルでリソースに移動します1201. Microsoft Foundry ポータルでリソースに移動します
1212. **エンドポイントとキー**セクションに移動します1212. **エンドポイントとキー**セクションに移動します
1223. **API キー**をコピーします1223. **API キー**をコピーします
1234. 環境変数を設定します:1234. 環境変数を設定します。`your-azure-api-key` をコピーしたキーに置き換えます:
124 124
125```bash theme={null}125```bash theme={null}
126export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key126export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
209 209
210Claude Code は環境から `CLAUDE_CODE_USE_FOUNDRY` およびその他の Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Amazon Bedrock および Google Cloud の Agent Platform とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。210Claude Code は環境から `CLAUDE_CODE_USE_FOUNDRY` およびその他の Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Amazon Bedrock および Google Cloud の Agent Platform とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。
211 211
212セットアップを確認するには、Claude Code 内で `/status` を実行します。API プロバイダー行に `Microsoft Foundry` が表示され、構成したリソース名またはベース URL が表示されます。
213
212<h2 id="azure-rbac-configuration">214<h2 id="azure-rbac-configuration">
213 Azure RBAC 構成215 Azure RBAC 構成
214</h2>216</h2>
239 241
240* 環境で Entra ID を構成するか、`ANTHROPIC_FOUNDRY_API_KEY` を設定してください。242* 環境で Entra ID を構成するか、`ANTHROPIC_FOUNDRY_API_KEY` を設定してください。
241 243
244最初のプロンプトで接続エラーが繰り返される場合、リクエストが失敗する場合:
245
246* `ANTHROPIC_FOUNDRY_RESOURCE` がプレースホルダーではなく、実際のリソース名に設定されていることを確認してください。Claude Code はこの値からエンドポイント URL を構築するため、不正な名前は存在しないホストを指します。
247
242<h2 id="additional-resources">248<h2 id="additional-resources">
243 その他のリソース249 その他のリソース
244</h2>250</h2>