本記事では、Microsoft Foundry上にClaude系モデルをデプロイし、ローカル環境のClaude Codeからそのモデルを向け先として接続・利用する手順を紹介します。
概要
Claude Codeは、Anthropicが提供するターミナルベースのAIコーディングアシスタントです。対話形式でコードの生成・編集・レビューなどを行えるため、日々の開発作業を大幅に効率化できます。
通常、Claude Codeを利用するにはAnthropicのAPIキーを直接取得する必要があります。しかし、企業の環境ではAPIキーの管理やコストの一元管理、ガバナンスの観点から、既存のクラウド基盤を経由して利用したいというニーズがあります。
Microsoft Foundry（旧Azure AI Foundry）では、Claudeシリーズを含む複数のAIモデルをマネージドサービスとしてデプロイでき、Azureサブスクリプションに紐づく課金体系で利用料を管理できます。これにより、Anthropicと個別にAPI契約を結ぶことなく、Azure側の既存の請求・権限管理の仕組みに統合した形でClaude Codeを運用できるようになります。
事前準備
Claude Codeを利用したいローカル環境のWindowsマシンと、Azure Portalで使用可能なサブスクリプションを用意し、Microsoft FoundryリソースをAzure環境にデプロイしておきます。
Claude Code（AI）の利用料は、対象のMicrosoft Foundryに紐づくサブスクリプションから引き落とされます。
Microsoft Foundry側の設定
Microsoft Foundryのポータルページから、以下の2点を確認して控えておきます。
- デプロイ名
- プロジェクトAPIキー
Microsoft Foundryのタブから、[ビルド]-[モデル]を選択します。[基本モデルをデプロイする]を選択し、この中からClaude系のモデルを選択してデプロイします。
今回はclaude-opus-4-6をデプロイします。必要に応じて、その他のClaudeモデルもデプロイします。
Claude Codeインストール&環境変数設定
最初に、Claude Codeのインストールを以下のコマンドで行います。
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
コード実行時にインストールしたパスが出てくるはずなので、これを永続的にローカルPCの環境変数にセットします。
setx PATH "%PATH%;C:\Users\<ユーザー名>\.local\bin"
新しいウィンドウを開いて、パスが通ったことを確認します。
claude
1~6を入力し、画面表示を好みのモードに設定します。
1~3を入力しますが、今回はMicrosoft Foundryを使用するため3番を選択します。この場合、ドキュメントのURLを取得できます。
以下、こちらのドキュメントに従って変数をセットします。
参考：Claude公式ドキュメント code.claude.com
設定コマンドは以下の通りです。sonnetやhaikuについては、設定したい場合は別途デプロイしてここに入力します。
setx ANTHROPIC_FOUNDRY_API_KEY <Microsoft Foundry api-key> setx ANTHROPIC_FOUNDRY_RESOURCE <Microsoft Foundryリソース名> setx CLAUDE_CODE_USE_FOUNDRY 1 setx ANTHROPIC_DEFAULT_SONNET_MODEL <デプロイしたモデル名> setx ANTHROPIC_DEFAULT_HAIKU_MODEL <デプロイしたモデル名> setx ANTHROPIC_DEFAULT_OPUS_MODEL claude-opus-4-6
Claude Codeの設定
環境変数をセットした後、新規にウィンドウを立ち上げてclaudeコマンドを再び実行します。
適切に設定されていれば以下のような画面になるため、1を選択します。
実際にチャットできる画面に遷移します。
今回インストールしたバージョンでは、Claude Sonnet 4.5 が推奨モデルとして選択されるようです。
使用したいのは、Microsoft FoundryでデプロイしたClaude Opus 4.6のため、モデルを変更する必要があります。
モデルを変更したい場合は、/modelと入力し、Enterキーを入力します。
Opus 4.6を使用したいため、これを選択します。これで環境変数ANTHROPIC_DEFAULT_OPUS_MODELで設定したモデルが使用されます。
テキスト欄に任意のチャットメッセージを指定すると、レスポンスが返ってきます。
以降、このモデルを使用してClaude Codeの機能を活用することができるようになります。
おわりに
本記事では、Microsoft FoundryにデプロイしたClaudeモデルを、ローカルのClaude Codeから利用する手順を紹介しました。
環境変数を数個セットするだけで接続先をMicrosoft Foundryに切り替えられるため、導入のハードルは比較的低いといえます。Azureサブスクリプション経由での課金となるため、組織内の既存のコスト管理やアクセス制御の枠組みに乗せやすい点も大きなメリットです。
Claudeモデルの利用料はMicrosoft Foundry経由で請求されます。トークン数の利用状況をモニター等で確認するなどして、コスト管理には気を付けてください。またTPMの消費量なども、Microsoft Foundryの上限が適用される点に注意してください。
