メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
前提条件

Microsoft Foundry で Claude Code を構成する前に、以下を確認してください：
  • Microsoft Foundry へのアクセス権を持つ Azure サブスクリプション
  • Microsoft Foundry リソースとデプロイメントを作成するための RBAC 権限
  • Azure CLI がインストールされ、構成されている（オプション - 認証情報を取得する別のメカニズムがない場合のみ必要）
Claude Code を複数のユーザーにデプロイする場合は、モデルバージョンをピン留めして、Anthropic が新しいモデルをリリースしたときの破損を防いでください。

​
セットアップ

​
1. Microsoft Foundry リソースをプロビジョニングする

まず、Azure で Claude リソースを作成します：
  1. Microsoft Foundry ポータルに移動します
  2. 新しいリソースを作成し、リソース名をメモします
  3. Claude モデルのデプロイメントを作成します：
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

​
2. Azure 認証情報を構成する

Claude Code は Microsoft Foundry の 2 つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください。 オプション A：API キー認証
  1. Microsoft Foundry ポータルでリソースに移動します
  2. エンドポイントとキーセクションに移動します
  3. API キーをコピーします
  4. 環境変数を設定します：
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key
オプション B：Microsoft Entra ID 認証 ANTHROPIC_FOUNDRY_API_KEY が設定されていない場合、Claude Code は Azure SDK デフォルト認証情報チェーンを自動的に使用します。 これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。 ローカル環境では、一般的に Azure CLI を使用できます： 
az login
Microsoft Foundry を使用する場合、認証が Azure 認証情報を通じて処理されるため、/login および /logout コマンドは無効になります。

​
3. Claude Code を構成する

Microsoft Foundry を有効にするには、以下の環境変数を設定します： 
# Microsoft Foundry 統合を有効にする
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure リソース名（{resource} をリソース名に置き換えます）
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# または完全なベース URL を提供します：
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

​
4. モデルバージョンをピン留めする

すべてのデプロイメントに対して特定のモデルバージョンをピン留めしてください。モデルエイリアス（sonnet、opus、haiku）をピン留めなしで使用する場合、Claude Code は Foundry アカウントで利用できない新しいモデルバージョンを使用しようとする可能性があり、Anthropic がアップデートをリリースしたときに既存のユーザーが破損します。Azure デプロイメントを作成するときは、「最新に自動更新」ではなく、特定のモデルバージョンを選択してください。
モデル変数をステップ 1 で作成したデプロイメント名と一致するように設定します。 ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、Foundry の opus エイリアスは Opus 4.6 に解決されます。最新のモデルを使用するために Opus 4.7 ID に設定します： 
export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
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 リソースに接続します。Bedrock および Vertex AI とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。

​
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 を設定してください。

​
その他のリソース