「Azureのサブスクリプション持ってるけど、Claude Codeってそのままじゃ使えないの？」——Entra ID認証なら、基本的にはFoundry用の環境変数を2つ設定するだけで、Anthropic直契約からMicrosoft Foundry（Azure）経由に切り替えられる。APIキー認証を使う場合は、APIキー用の環境変数も追加で設定する。請求もAzureにまとまり、セキュリティ境界もAzure側で管理できる。以下では、Foundryポータルでのモデルデプロイ、認証方式の選択、環境変数の設定と動作確認までを3ステップで通して案内する。
直契約とFoundry、何が違うのか
Claude Codeは標準だとAnthropicのAPIに直結している。でもAzureのサブスクリプションを既に持っているなら、Microsoft Foundry経由でもClaude Codeを動かせる——しかも、切り替えに必要なのは環境変数2つだけだ。
Foundry経由に切り替えると、ざっと次が変わる。
- 請求先がAzureになる：Anthropicへの個別支払いが不要で、Azureサブスクリプションにまとまる
- セキュリティ境界がAzure側に置かれる：会社のコンプライアンス要件に合わせやすい
- Azureのアクセス制御がそのまま使える：Entra ID（旧Azure AD）での認証やRBACが利用可能
逆に、Azureアカウントを持っていない場合は直契約の方がシンプルだ。この記事は「Azureを既に使っている人」向けに、Foundry経由でClaude Codeを動かす3ステップをまとめる。
事前に必要なもの
手順に入る前に、以下が揃っているか確認しておく。
- Azureサブスクリプション：従量課金またはEnterprise Agreementのもの。無料試用版やCSP（クラウドソリューションプロバイダー）経由のサブスクリプションは、モデルデプロイに対応していない場合がある。Azureポータルの「サブスクリプション」画面で種類を確認できる
- 対応リージョンのリソース：Claudeモデルをデプロイできるリージョンは 米国東部2（eastus2） または スウェーデン中部（swedencentral）。他のリージョンだとClaudeモデルがデプロイの選択肢に出てこない
- Claude Code CLI：Windows用のネイティブインストーラーで導入済みであること。npm経由のインストールは非推奨になっている。
claude --versionでバージョンが返ってくれば準備OK - Windows 10 または 11：この記事はWindows前提で進める
サブスクリプションの種類が分からない場合は、Azureポータルの左メニュー「サブスクリプション」を開くと「種類」の列に「従量課金」「Enterprise」等が表示される。ここが「無料試用」や「CSP」となっている場合は、従量課金サブスクリプションの作成を検討した方がスムーズに進む。
Step 1: FoundryポータルでClaudeモデルをデプロイする
まずFoundryポータルでClaudeモデルのエンドポイントを作る。操作は多いが、画面の案内に沿って進めれば5分程度で終わる。
- ブラウザで Microsoft Foundryポータル を開き、Azureアカウントでサインインする
- 左メニューの「モデルカタログ」を開き、検索欄に
Claudeと入力する - 利用したいモデル（例：
claude-sonnet-4-6）を選び、「デプロイ」をクリックする - デプロイ方法として「直接デプロイ（Real-time endpoint）」を選ぶ
- リソースグループとリージョン（eastus2 または swedencentral）を選択し、デプロイ名を決めて「作成」をクリックする
- デプロイが完了したら、デプロイ詳細画面の 「ターゲットURI」 と 「キー」 をメモする
期待される結果：デプロイ一覧画面にステータス「成功」と表示され、ターゲットURI（https://〜.eastus2.models.ai.azure.com/v1 のような形式）とAPIキーが確認できる状態になる。
なぜ直接デプロイなのか：モデルルーターという手段もある。これは1つのエンドポイントで複数モデルを切り替えられる便利な仕組みだが、執筆時点では
claude-opus-4-7等の最新モデルが未対応の場合がある。直接デプロイの方がモデルの選択肢が広いため、この記事では直接デプロイを前提に進める。
ターゲットURIはこの後のStepで環境変数に設定する。ブラウザのタブをそのまま残しておくと作業がスムーズだ。
Step 2: 認証方式を選ぶ（Entra IDかAPIキーか）
デプロイが終わった。次はClaude CodeがFoundryにアクセスするための「鍵」を設定する。鍵の渡し方には2つの選択肢がある。
Option A：Azure CLI（az login）経由のEntra ID認証
会社のAzure環境を使っている場合、こちらが基本になる。Azure CLIでログインするだけで、Entra IDのトークンが自動で使われる仕組みだ。
- Azure CLI をインストール済みであることを確認する。コマンドプロンプトまたはPowerShellで
az --versionを実行してバージョン情報が返ってくればOK - 次のコマンドを実行する：
az login
- ブラウザが開くのでAzureアカウントでサインインする
- ターミナルにサブスクリプション情報が一覧表示されれば成功
期待される結果：ターミナルにJSON形式でサブスクリプション一覧が表示される。複数サブスクリプションがある場合は、az account set --subscription "サブスクリプション名" で正しいものを指定しておく。
Option B：APIキー認証
個人で試す、またはAzure CLIを入れたくない場合は、Step 1でメモしたAPIキーを環境変数に直接設定する方法もある。
環境変数 ANTHROPIC_FOUNDRY_API_KEY にキーを設定する。具体的な設定方法は次のStepで一緒に行う。
大まかな判断基準：組織のAzureならOption A、個人で手軽に試すならOption B。Option Aの方がセキュリティ上の管理がしやすい（キーのローテーションが不要、アクセス権限をAzure側で制御できる等）が、Azure CLIのインストールが前提になる。
Step 3: 環境変数を設定してClaude Codeを起動する
認証の準備ができたら、あとはFoundryへの経路を環境変数で教えるだけだ。
設定する環境変数は次の通り。
| 環境変数 | 値 | 役割 |
|---|---|---|
CLAUDE_CODE_USE_FOUNDRY |
1 |
Foundry経由を使うことをClaude Codeに伝える |
ANTHROPIC_FOUNDRY_RESOURCE |
Foundryのリソース名 | Claude Codeが接続するFoundryリソースを指定する |
ANTHROPIC_FOUNDRY_API_KEY |
Step 1のAPIキー | Option Bの場合のみ |
ターゲットURIからホスト名を取り出す
Step 1でメモしたターゲットURIが https://my-deploy.eastus2.models.ai.azure.com/v1 だとする。このうち my-deploy の部分がFoundryのリソース名だ。Foundryポータルのデプロイ詳細画面で確認できる。
環境変数の設定（一時的）
まずは動作確認用に一時的な設定を試す。ターミナルを閉じると消える。
コマンドプロンプトの場合：
set CLAUDE_CODE_USE_FOUNDRY=1
set ANTHROPIC_FOUNDRY_RESOURCE=my-foundry-resource
PowerShellの場合：
$env:CLAUDE_CODE_USE_FOUNDRY = "1"
$env:ANTHROPIC_FOUNDRY_RESOURCE = "my-foundry-resource"
Option B（APIキー認証）の場合は、さらに ANTHROPIC_FOUNDRY_API_KEY も設定する。
環境変数の設定（永続的）
動作確認ができたら、毎回設定し直さなくて済むように setx で永続化する。
setx CLAUDE_CODE_USE_FOUNDRY 1
setx ANTHROPIC_FOUNDRY_RESOURCE my-foundry-resource
setx はレジストリに書き込むため、既に開いているターミナルには反映されない。設定後に新しくターミナルを開き直すこと。
動作確認
環境変数を設定した状態でClaude Codeを起動する。
claude
期待される結果：Claude Codeが起動し、プロンプト（>）が表示される。ここで質問を投げて応答が返ってくれば、Foundry経由での通信ができている。Option Aの場合は、事前に az login を済ませておくこと。
応答が返ってこない、またはエラーが出る場合は次のセクションを参照してほしい。
うまくいかない時の対処法
設定はシンプルだが、つまずきやすいポイントがいくつかある。当てはまるものがないか確認してみてほしい。
「ChainedTokenCredential」の認証失敗
Option Aで az login を使っている場合、ログインの有効期限が切れていることがある。
対処：az login をもう一度実行してログインし直す。複数のサブスクリプションを持っている場合は az account set --subscription "サブスクリプション名" で正しいものを指定する。
「モデルが見つかりません」エラー
環境変数のホスト名が間違っている、またはデプロイが完了していない可能性がある。
対処：Foundryポータルでデプロイのステータスが「成功」になっていることを確認する。ホスト名に https:// や /v1 が混ざっていないかも見直す。
それでも解決しない場合、Claude Codeに頼むだけで、プログラムのエラー修正はどこまでできる？の記事で紹介しているようなエラーメッセージの詳細な解析方法も参考になる。
リージョン制限エラー
「このリージョンでは利用できません」等のメッセージが出る場合。
対処：デプロイ先のリージョンが eastus2 または swedencentral になっているか確認する。他のリージョンに作成したリソースではClaudeモデルをデプロイできない。
claude コマンドが見つからない
Claude Code CLIがPATHに登録されていない。
対処：ネイティブインストーラーでインストールし直す。インストール後にターミナルを開き直して claude --version で確認する。
サブスクリプション種別の制限
「このサブスクリプションではモデルをデプロイできません」等のエラーが出る場合。
対処：無料試用版やCSP経由のサブスクリプションは一部のモデルデプロイに対応していない場合がある。Azureポータルでサブスクリプションの種類を確認し、必要に応じて従量課金のサブスクリプションを作成する。
設定完了後の確認と次のステップ
ここまでで、デプロイ → 認証 → 環境変数設定の3ステップが完了した。対応するAzureサブスクリプションとFoundryの利用権限があれば、Anthropicとの個別契約を増やさずに、Foundry経由でClaude Codeを使える状態になる（モデル利用料はAzureの従量課金として別途かかる）。
念のため、起動したClaude Codeでいくつか質問を投げてみて、応答の安定性を確認しておくと安心だ。最初の質問で正しく応答が返ってくれば、基本的な設定は問題ない。
次にやること：
- Claude Codeの基本的な使い方に慣れる——プロジェクトディレクトリを開いて、ファイルの読み書きやコマンド実行を試してみる
- 複数のClaudeモデルを使い分けたい場合——まずはClaude Code内の
/modelで切り替える。Foundry環境でモデルを固定したい場合は、ANTHROPIC_DEFAULT_SONNET_MODELなどのモデル別環境変数を使う - Claude Codeのスキル機能で繰り返し作業を自動化する方法——環境変数設定のような定型作業をコマンド一つで実行できるようにする
- Claude CodeにMCPサーバーを追加して外部ツールと連携する方法——Azure以外の外部ツールとも連携させたい場合に参考になる
- Azureの請求ダッシュボードで利用状況を確認する——Foundry経由の利用料金はAzureのコスト管理画面に集約される
まとめ
Claude CodeをMicrosoft Foundry経由で使うには、Foundryポータルでのモデルデプロイ、認証方式の選択、Foundry用の環境変数設定——この3つが基本になる。Entra ID認証なら主に2つ、APIキー認証ならAPIキー用の環境変数も追加で設定する。Azureを既に使っている環境であれば、新たに契約を増やすことなくClaude Codeを導入できる。うまく動かないときは「うまくいかない時の対処法」を見直すと解決の糸口が見つかりやすい。