Anthropicの Claude Code は、コードベースの読み取り、ファイルの編集、コマンドの実行、開発ツールとの統合を行うエージェントコーディング ツールです。 CLI ツールと VS Code 拡張機能として使用できます。 Microsoft Foundry で Claude Code を構成する場合は、コンプライアンス境界内にデータを保持しながら、Azure インフラストラクチャでコーディング エージェントを実行します。 この構成では、エンタープライズ レベルのセキュリティ、プライベート ネットワーク、ロールベースのアクセス制御、コスト管理が提供されます。
この記事では、次の方法について説明します。
- Microsoft Foundry 用の Claude Code CLI をインストールして構成する
- Claude Code VS Code 拡張機能を設定する
- Microsoft Entra IDキーまたは API キーを使用して認証する
- AI 支援を強化するためにプロジェクト コンテキスト ファイルを作成する
- CI/CD オートメーションのGitHub Actionsで Claude Code を実行する
Microsoft Foundry で Claude モデルを使用するには、Anthropicが購入モデルを提供する国または地域の課金アカウントを持つ有料Azureサブスクリプションが必要です。 サブスクリプション関連の一般的なエラーの一覧については、「 一般的なエラー メッセージと解決策」を参照してください。 現在、次のサブスクリプションの種類はサポートされていません。
- 韓国にあるエンタープライズ アカウント
- クラウド ソリューション プロバイダー サブスクリプション
- アクティブな従量課金制の課金方法がないAzureサブスクリプション(例えば、学生、無料試用版、スタートアップクレジットベースのアカウントなど)
- Azure クレジットのみを使用するスポンサーサブスクリプション。 注: アカウントに登録されたクレジットカードがある場合は、Azure クレジットではなく、そのクレジットカードに課金されます。
サポートされているリージョンの一覧については、 サポートされている地理的な場所を参照してください。 Anthropicの「サポートされているリージョン ポリシー」がリージョンの可用性に適用される場合があることに注意してください。詳細については、サポートされているリージョンを確認してください。
前提 条件
- 有効な支払い方法を持つAzure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、有料 Azure アカウントを作成してください。
- リソースを作成および管理するための共同作成者アクセス許可を持つ Microsoft Foundry へのアクセス。
- Microsoft Foundry プロジェクトクロード モデルのサポートされているリージョンのいずれかで作成されます。 クロード モデルは現在、 米国東部 2 と スウェーデン中部 でのみ使用できます。
- Foundry リソース グループの共同作成者または所有者ロール。 詳細については、「Azure RBAC ロールを参照してください。
- Azure Marketplace にアクセスして、パートナーから Foundry モデルをデプロイします。
- Windowsの場合は、Git Bash (
Git for Windows ) を使用するか、WSL2 をインストールします (Linux の完全な互換性のために推奨)。 WSL のインストールを参照してください。 - (省略可能) Microsoft Entra ID 認証のために完了した状態で Azure CLI をインストールしました。
システム要件
| 要件 | 詳細 |
|---|---|
| オペレーティング システム | macOS 13 以降、Ubuntu 20.04 以降/Debian 10 以降、Windows 10 以降 (Git Bash または WSL 経由でネイティブ) |
| RAM | 4 GB 以上 (8 GB を推奨) |
| Git (省略可能、推奨) | プルリクエストヘルパーにはバージョン2.23以上が必要です。 |
Foundry にクロード モデルをデプロイする
Claude Code を構成する前に、Claude Code に必要な使用可能な Claude モデル をデプロイします。 Foundry のクロード モデルは、 グローバル標準デプロイで使用できます。 Claude Code では、タスクごとに異なるモデルが使用されます。
重要
Microsoft Foundry のクロード モデルは現在プレビュー段階です。 モデルの可用性は変更される可能性があります。 使用可能なモデルの最新の一覧については、 パートナーの Foundry モデル のページを参照してください。
| Claude Code ロール | 推奨される展開 | 目的 |
|---|---|---|
| プライマリ モデル | claude-sonnet-4-6 |
一般的なコーディング — バランスの取れた速度と品質 |
| 高速モデル | claude-haiku-4-5 |
クイック操作 — ファイルの読み取り、小さな編集 |
| 拡張思考 | claude-opus-4-6 |
複雑な推論タスク (省略可能) |
Foundry で使用できるその他のクロード モデルには、 claude-sonnet-4-5、 claude-opus-4-5、 claude-opus-4-1などがあります。
Foundry にモデルを直接デプロイする
モデルをデプロイするには:
Foundry ポータルで Microsoft Foundry モデルをデプロイする の手順に従って、Opus 4.6 などのクロード モデルをデプロイします。
デプロイ後、デプロイの [詳細 ] タブを選択し、 ターゲット URI と キーをメモします。 これらの値は構成に必要です。
代替手段: モデル ルーターを使用してモデルをデプロイする
モデル ルーター は、クエリの複雑さ、コスト、パフォーマンスに基づいて、各プロンプトを最適な基になるモデルにインテリジェントにルーティングする Foundry モデルです。 モデル ルーター バージョン 2025-11-18 では、他の Foundry モデルと共に、選択したクロード モデル (claude-haiku-4-5、 claude-opus-4-1、 claude-sonnet-4-5) がサポートされます。
メモ
モデル ルーターは現在、 claude-sonnet-4-6 または claude-opus-4-6をサポートしていません。 これらのモデルが必要な場合は、モデル ルーターを使用する代わりに、モデルを直接デプロイして参照します。
Claude Code ユーザーの利点:
- 自動モデル選択:シンプルなプロンプトは、より高速で安価なモデルにルーティングします。 複雑なコーディング タスクは、より高度なモデルにルーティングされます。
- コストの最適化: 基準パフォーマンスを維持しながら、ルーティング プロファイルを使用して品質とコストのバランスを取ります。
- 単一エンドポイント: 1 つのデプロイで、モデルフリート全体のすべてのルーティング決定が処理されます。
Claude Code でモデル ルーターを使用するには、まずサポートされている Claude モデルをデプロイしてから、モデル ルーターをデプロイし、 モデル サブセット構成を使用して有効にします。
Claude Code CLI のインストール
Claude Code CLI をインストールして、ターミナルで直接 Claude Code を操作します。 次に、claudeを実行して、claude --versionが PATH 内にあることを確認します。
メモ
Anthropic npm のインストール方法が非推奨になりました。 代わりにネイティブ インストーラーまたは Homebrew を使用してください。 npm 経由で既にインストールされている場合は、 claude install を実行してネイティブ メソッドに移行します。
ネイティブ インストール (推奨)
ネイティブ インストールはバックグラウンドで自動的に更新され、最新バージョンが維持されます。
macOS または Windows (Git Bash または WSL) でインストーラー スクリプトを実行し、claude バイナリをダウンロードして構成します。
curl -fsSL https://claude.ai/install.sh | bash
claude --version # verify installation
Homebrew を使用したインストール
macOS を使用している場合:
brew install --cask claude-code
claude --version # verify installation
Homebrew のインストールは自動更新されません。
brew upgrade claude-code定期的に実行して、最新の機能とセキュリティ修正プログラムを取得します。
インストール場所のトラブルシューティング
claude --version コマンドが見つからない場合は、次のようにインストール場所を PATH に追加します。
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
インストール オプションの詳細については、 Claude Code のドキュメントを参照してください。
Foundry のクロード コードを構成する
Foundry リソース名またはベース URL を使用して、Foundry の Claude Code を構成します。
Foundry ポータルから Foundry リソース名を検索するには:
- 左上のナビゲーションに移動し、project名 >Project details を選択します。
- 親リソースの値を Project details ページからコピーします。
Foundry ポータルからベース URL を検索するには:
- Foundry ポータルのホーム ページに移動する
-
Project エンドポイントを見つけて、
/api/projects/<your-project-name>より前の URL の一部をコピーします。 ベース URL は、https://<your-resource-name>.services.ai.azure.com形式です。/anthropicを使用すると、Claude Code によってこの URL にANTHROPIC_FOUNDRY_RESOURCEが自動的に追加されます。
Claude Code を Microsoft Foundry デプロイに接続するように環境変数を設定します。
# Required: Enable Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure resource name (replace <your-resource-name> with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE=<your-resource-name>
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://<your-resource-name>.services.ai.azure.com
# Optional: Specify model deployment names if different from defaults
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
次の表では、各変数について説明します。
| 変数 | 説明 |
|---|---|
CLAUDE_CODE_USE_FOUNDRY |
Microsoft Foundry 統合を有効にするには、1 に設定します。 |
ANTHROPIC_FOUNDRY_RESOURCE |
Foundry リソース名。 Claude Code は、エンドポイント URL を https://<resource-name>.services.ai.azure.com/anthropicとして構築します。 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
Claude Sonnet モデル (プライマリ コーディング モデル) のデプロイ名。 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
Claude Haiku モデルのデプロイメント名 (高速処理用)。 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
「Claude Opus」モデルのデプロイ名(複雑な推論)。 |
これらの変数をターミナル セッション間で保持するには、それらをシェル プロファイル ( ~/.bashrc や ~/.zshrcなど) に追加します。
Foundry で認証する
Claude Code では、Microsoft Foundry の 2 つの認証方法がサポートされています。
- Microsoft Entra ID (推奨): Azure CLI資格情報を使用します。 シークレットを管理せずに一元化された ID 管理が必要なエンタープライズ環境、チーム アクセス、CI/CD パイプラインに最適です。
- API キー: Foundry ポータルのプロジェクト API キーを使用します。 クイック テストや、Azure CLIが利用できない環境に最適です。
オプション A: Microsoft Entra ID (推奨)
Microsoft Entra ID認証では、Azure CLI資格情報が自動的に使用されます。 Claude Code を開始する前に、 az login を実行します。
Azure CLIでサインインします。
az loginヒント
Foundry リソースが既定のAzure CLI テナントとは異なるテナントにある場合は、テナント ID を指定します。
az login --tenant <tenant-id>サインインが正しいサブスクリプションをターゲットにされていることを確認します。
az account show
Microsoft Foundry を使用すると、Claude Code 内の /login コマンドと /logout コマンドが無効になります。 認証は、Azure資格情報によって処理されます。
Claude Code は、Azure CLI セッションを検出し、追加の構成なしで認証に使用します。
オプション B: API キー
API キー認証を使用する場合は、環境変数でキーを設定します。
- Microsoft Foundry ポータルで、リソースを開きます。
- Home ページで、Project API キー フィールドを見つけます。
-
Copy Project API キー を選択して値をコピーします。 これは、
ANTHROPIC_FOUNDRY_API_KEY環境変数に使用するキーです。 - ターミナルで環境変数を設定します。
export ANTHROPIC_FOUNDRY_API_KEY="<your-foundry-api-key>"
ヒント
また、Foundry ポータルのモデル デプロイの [詳細 ] タブで API キーを見つけることもできます。
VS Code 拡張機能を構成する
Claude Code VS Code 拡張機能は、IDE で直接 Claude Code 用のネイティブ グラフィカル インターフェイスを提供します。
VS Code Marketplace から拡張機能をインストールします。
VS Code の設定 (Ctrl + またはCmd +) を開き、 Claude Code: 環境変数を検索します。
settings.jsonで [編集] を選択し、次の構成を追加します。
{ "Claude Code: Environment Variables": { "CLAUDE_CODE_USE_FOUNDRY": "1", "ANTHROPIC_FOUNDRY_RESOURCE": "<your-resource-name>", "ANTHROPIC_FOUNDRY_API_KEY": "<optional-for-non-entra-auth>" } }サイドバーの Spark アイコン を選択して、Claude Code パネルを開きます。
Claude Code は、Azure資格情報を使用して認証します。 Microsoft Entra ID認証を使用している場合は、最初に
az loginを実行します。
この拡張機能では、編集モード、プラン モード、拡張思考、ファイル管理を @メンションで自動的に受け入れ、Microsoft Foundry デプロイ経由でルーティングできます。
構成を検証する
Microsoft Foundry を使用するように Claude Code が正しく構成されていることを確認します。
ターミナルを開き、プロジェクト ディレクトリに移動します。
cd your-projectClaude コードを起動します。
claude一般的なコーディングでは、Claude Code は既定で Sonnet モデルに設定されます。 3 つのモデルをすべてまだデプロイしていない場合は、デプロイされたモデルを直接指定できます。
claude --model claude-opus-4-6/statusコマンドを実行します。> /status出力は次の例のようになります。 正確な形式は、Claude Code のバージョンによって異なる場合があります。
───────────────────────────────────── Version: 2.1.52 Session name: /rename to add a name Session ID: <your-session-ID> cwd: C:\WINDOWS\system32 API provider: Microsoft Foundry Microsoft Foundry Resource: <your-resource-name> Model: Default (claude-sonnet-4-6) Memory: Setting sources: ─────────────────────────────────────状態の出力で次の内容を確認します。
フィールド 予期される値 API プロバイダー Microsoft Foundry ファウンドリーリソース Foundry のリソース名 モデル デプロイされたモデル (たとえば、 claude-sonnet-4-6)"このプロジェクトの構造を要約する" などのテスト プロンプトを送信します。
Claude Code がプロジェクトの分析で応答することを確認します。 接続が成功すると、認証エラーのない Claude Code の対話型プロンプトが表示されます。
Claude Code に "トークンの取得に失敗しました" や "モデルが使用できません" などのエラーが表示される場合は、「トラブルシューティング」セクション を 参照してください。
CLAUDE.md を使用してプロジェクト コンテキストを作成する
CLAUDE.md ファイルを使用して、Claude Code に追加の手順とガイダンスを提供できます。 Claude Code は、次の場所で CLAUDE.md ファイルを検索し、それらをトップダウン (つまり、ファイルが順番に読み込まれるように、後のファイルが以前のファイルをオーバーライドして) マージし、個人設定、プロジェクト固有の詳細、および現在のタスクに関するコンテキストを提供します。
-
~/.claude/CLAUDE.md– すべてのプロジェクトのグローバルな既定値 -
./CLAUDE.md– リポジトリのルート設定 -
./current-dir/CLAUDE.md– 現在のディレクトリの詳細
Claude Code では、より詳細な制御を行うプロジェクト ルール (.claude/rules/*.md) とローカル メモリ (CLAUDE.local.md) もサポートされています。 完全なメモリ階層については、 Claude Code メモリのドキュメントを参照してください。
次の例は、CLAUDE.md プロジェクトの ファイルを示しています。 Claude Code がコードベースを理解できるように、プロジェクト ルートに同様のファイルを作成します。
# Project: Customer Service Agent
## Overview
Multi-agent system using Microsoft Agent Framework with Foundry Agent Service.
## Tech Stack
- Python 3.11+
- agent-framework (Microsoft Agent Framework Python SDK)
- Microsoft Foundry for hosted agents
- MCP tools for enterprise data access
## Architecture
- `src/agents/` - Agent definitions (triage, specialist, escalation)
- `src/tools/` - MCP tool implementations
- `src/workflows/` - Multi-agent orchestration
- `tests/` - pytest with async fixtures
## Commands
```bash
# Run locally
python -m src.main
# Test
pytest tests/ -v
# Deploy to Foundry Agent Service
az ai agent deploy --config deploy.yaml
```
## Code Patterns
Use `AzureAIAgentClient` with `AzureCliCredential`:
```python
async with AzureAIAgentClient(async_credential=AzureCliCredential()) as client:
agent = client.create_agent(instructions="...", tools=[...])
```
## Current Sprint
- Implementing RAG grounding with Foundry IQ
- Adding Fabric connector for sales data
CLAUDE.md ファイルを作成したら、プロジェクト ディレクトリで Claude Code を起動してコンテキストを読み込みます。
# Start Claude Code in your project
cd your-project
claude
# Or run a one-off command
claude "explain the agent orchestration in src/workflows/"
Azure RBAC の構成
Foundry でホストされる Claude モデルへのアクセス権をチーム メンバーに付与するには、次のいずれかの組み込みロールを割り当てます。
| 役割 | 権限 |
|---|---|
| Azure AI ユーザー | モデルの呼び出し、デプロイの表示 |
| Cognitive Services ユーザー | モデルの呼び出し、デプロイの表示 (レガシ Azure AI サービス ロール) |
Azure AI User ロールは、推奨される Foundry ネイティブ ロールです。 Cognitive Services User ロールは、Azure リソース レベルでのモデル呼び出しアクセス許可も付与するレガシ ロールです。
これらのロールには、Foundry で Claude Code を実行するために必要なすべてのアクセス許可が含まれます。
より制限の厳しいアクセスを実現するには、チームが必要とする特定のデータ アクションを対象とするカスタム ロールを作成します。 カスタム ロールの定義に関するガイダンスについては、Microsoft Foundry の
GitHub Actionsでクロード コードを実行する
Claude Code は、CI/CD オートメーション用のGitHub Actionsと統合されます。 これらのワークフローを使用する前に、リポジトリのシークレット ストアに API キーを格納します。
プル要求でテストを生成する
エージェントまたはツール ファイルが変更されたときにテストを生成するワークフローを作成します。
name: Generate Agent Tests
on:
pull_request:
paths:
- 'src/agents/**'
- 'src/tools/**'
jobs:
generate-tests:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- uses: actions/checkout@v4
- name: Run Claude Code
uses: anthropics/claude-code-action@v1
with:
prompt: |
Review the changed agent files and generate pytest tests.
Use async fixtures for AIProjectClient mocking.
Follow patterns in tests/conftest.py.
allowed_tools: "edit,write,bash"
env:
CLAUDE_CODE_USE_FOUNDRY: "1"
ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}
PR レビューを @claude を使用してトリガーする
プルリクエストのコメントで @claude メンションに反応するワークフローを作成します。
name: Claude PR Assistant
on:
issue_comment:
types: [created]
jobs:
respond:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: read
pull-requests: write
steps:
- uses: actions/checkout@v4
- name: Claude Review
uses: anthropics/claude-code-action@v1
with:
prompt: ${{ github.event.comment.body }}
context: "PR #${{ github.event.issue.number }}"
env:
CLAUDE_CODE_USE_FOUNDRY: "1"
ANTHROPIC_FOUNDRY_RESOURCE: ${{ secrets.AZURE_FOUNDRY_RESOURCE }}
ANTHROPIC_FOUNDRY_API_KEY: ${{ secrets.AZURE_FOUNDRY_API_KEY }}
使用状況の監視
Foundry ポータルで Claude Code の使用状況を監視します。
Microsoft Foundry に移動し、プロジェクトを開きます。
[操作] に移動して使用状況メトリックを表示します。
- モデル別のトークン使用量
- 要求の待機時間
- エラー レートとレート制限ヒット数
要求ごとにトークン制限を設定するには、 ANTHROPIC_MAX_TOKENS 環境変数を構成します。
メモ
ANTHROPIC_MAX_TOKENS変数は、すべての Claude Code バージョンでサポートされていない場合があります。 サポートされている最新の環境変数については、 Claude Code のドキュメント を参照してください。
export ANTHROPIC_MAX_TOKENS=100000
モデル固有のトークン制限など、トークンの使用とコストを制御する構成オプションについては、 Claude Code の構成ドキュメントを参照してください。
リソースのクリーンアップ
Claude モデルのデプロイが不要になった場合は、それらを削除して、リソース内のデプロイ スロットとクォータを解放します。 Claude モデルでは、トークンごとの課金で Global Standard デプロイが使用されるため、アイドル状態のデプロイでは料金は発生しません。 ただし、各デプロイは、リソースあたり 32 の デプロイ制限 に対してカウントされます。
Foundry ポータルでデプロイを削除する
次のいずれかのナビゲーション パスを使用します。
- 上部のナビゲーションから [操作] を選択し、左側のナビゲーションから [Assets>Models ] を選択します。 削除するデプロイを選択し、[削除] を選択 します。
- 上部のナビゲーションから [ビルド ] を選択し、左側のナビゲーションから [モデル ] を選択します。 展開名を選択して詳細ページを開き、[ 詳細 ] タブを選択し、上部のパネルから [削除 ] を選択します。
Azure CLIを使用してデプロイを削除する
デプロイごとに az cognitiveservices account deployment delete コマンドを実行します。
az cognitiveservices account deployment delete \
--deployment-name <deployment-name> \
--name <resource-name> \
--resource-group <resource-group-name>
<deployment-name>をモデル デプロイ名 (claude-sonnet-4-6 など) に置き換え、<resource-name>を Foundry リソース名に置き換え、<resource-group-name>を Foundry リソースを含むリソース グループに置き換えます。
トラブルシューティング
| 問題 | ソリューション |
|---|---|
| 承認に失敗しました (HTTP 401/403) |
az login正常に完了したか、API キーが正しく設定されていることを確認します。 アカウントが Foundry リソースにアクセスできるかどうかを確認します。 |
| Claude Code は開始されますが、モデルが見つかりません |
ANTHROPIC_FOUNDRY_RESOURCEがリソース名と一致し、ANTHROPIC_DEFAULT_*_MODELの値がデプロイ名と一致することを確認します。 |
| レート制限を超えました (HTTP 429) | Foundry ポータルの [操作]>Quotas でクォータを確認します。 Claude Code 構成ドキュメントに従ってトークンの制限を調整することを検討してください。 |
| VS Code 拡張機能が接続していない | VS Code を起動する前に環境変数が設定されていることを確認します。 変数を設定した後、ターミナルから VS Code を起動してみてください。 |
| WSL + VS Code 拡張機能の問題 | 拡張機能は、WSL 内ではなく、Windows ホストで API キーを確認する場合があります。 Windows ホストと WSL の両方で環境変数を設定し、WSL から新しいターミナルを起動し、code . |
| リージョン エラー | クロード モデルは、米国東部 2 とスウェーデン中部でのみ使用できます。 |
| "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed" (AzureADTokenProvider からトークンを取得できませんでした: ChainedTokenCredential 認証に失敗しました) |
az loginでサインインするか、API キー認証のANTHROPIC_FOUNDRY_API_KEYを設定します。 |
お客様のファウンドリ環境ではモデル<model-name>は利用できません。 |
Foundry ポータルで不足しているモデルをデプロイします。 Claude Code では、各モデル ロール (Sonnet、Haiku、Opus) に対応するデプロイが必要です。 |
| "トークン テナントがリソース テナントと一致しない" | Azure CLIが Foundry リソースとは異なるテナントにサインインしています。
az login --tenant <tenant-id>を実行して、適切なテナントにサインインします。 |
| Foundry ポータルでのデプロイの作成が失敗する | リソース グループに Contributor または Owner ロールがあり、サブスクリプションで Azure Marketplace アクセスが有効になっていることを確認します。 |
| Anthropic ログインの Claude Code プロンプト |
CLAUDE_CODE_USE_FOUNDRY=1が設定されていることを確認します。 この変数がない場合、Claude Code は既定の Anthropic API を使用します。 |