🍣

Azure AI FoundryでClaude Codeを使う

に公開
AI
Azure
Claude
tech

はじめに

Claude CodeをAzure AI Foundry経由で利用する方法を紹介します。これにより、Azureのインフラストラクチャを活用しながらClaude Codeを使用できます。

前提条件

  • Azure AI Foundryのリソースが作成済みであること
  • Claudeモデルがデプロイ済みであること（claude-sonnet-4-5、claude-haiku-4-5、claude-opus-4-5など）
  • Claude Codeがインストール済みであること
  • Windowsの場合: Git Bashがインストール済みであること

Claude Codeのインストール

Claude Codeのインストールがまだの場合は、以下のコマンドでインストールできます。

macOS / Linux

npm install -g @anthropic-ai/claude-code

Windows

WinGetを使用してインストールします：

winget install Anthropic.ClaudeCode

環境変数の設定

Azure AI FoundryでClaude Codeを使用するには、以下の環境変数を設定します：

# Azure AI Foundry統合を有効化
export CLAUDE_CODE_USE_FOUNDRY=1

# リソース名
export ANTHROPIC_FOUNDRY_RESOURCE="<your-resource-name>"

# ベースURL（リソース名の部分を自分のリソース名に置き換え）
export ANTHROPIC_BASE_URL="https://<your-resource-name>.services.ai.azure.com/anthropic"

# APIキー
export ANTHROPIC_FOUNDRY_API_KEY="<your-api-key>"

# デプロイされているモデル名を指定
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"

重要なポイント

動作確認

設定が完了したら、以下のコマンドで動作確認できます：

claude -p "Hello, say 'test successful'"

正常に設定されていれば、Claudeからの応答が表示されます。

シェル設定への永続化

毎回環境変数を設定するのは面倒なので、シェルの設定ファイルに追加しておくと便利です。

bashの場合（~/.bashrc）

# Claude Code with Azure AI Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE="<your-resource-name>"
export ANTHROPIC_BASE_URL="https://<your-resource-name>.services.ai.azure.com/anthropic"
export ANTHROPIC_FOUNDRY_API_KEY="<your-api-key>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-5"

zshの場合（~/.zshrc）

同様の内容を ~/.zshrc に追加してください。

PowerShellの場合

方法1: $PROFILEに追加（セッション開始時に自動設定）

$PROFILEファイルに以下を追加します：

# Claude Code with Azure AI Foundry
$env:CLAUDE_CODE_USE_FOUNDRY = "1"
$env:ANTHROPIC_FOUNDRY_RESOURCE = "<your-resource-name>"
$env:ANTHROPIC_BASE_URL = "https://<your-resource-name>.services.ai.azure.com/anthropic"
$env:ANTHROPIC_FOUNDRY_API_KEY = "<your-api-key>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-4-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-4-5"

# Git Bashのパスを指定（Windowsで必須）
$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

$PROFILEファイルを編集するには：

# ファイルが存在しない場合は作成
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
# エディタで開く
notepad $PROFILE

方法2: システム環境変数に追加（すべてのアプリケーションで使用可能）

[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_USE_FOUNDRY", "1", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_FOUNDRY_RESOURCE", "<your-resource-name>", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://<your-resource-name>.services.ai.azure.com/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_FOUNDRY_API_KEY", "<your-api-key>", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "claude-sonnet-4-5", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "claude-haiku-4-5", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "claude-opus-4-5", "User")

# Git Bashのパスを指定（Windowsで必須）
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "User")

トラブルシューティング

Windows: Git Bashが見つからないエラー

以下のようなエラーが表示される場合：

Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win).

CLAUDE_CODE_GIT_BASH_PATH 環境変数を設定してください：

$env:CLAUDE_CODE_GIT_BASH_PATH = "C:\Program Files\Git\bin\bash.exe"

Git Bashがデフォルト以外の場所にインストールされている場合は、実際のパスに置き換えてください。

404エラーが発生する場合

ANTHROPIC_BASE_URLに /anthropic パスが含まれているか確認してください。

# ❌ 誤った設定
export ANTHROPIC_BASE_URL="https://<resource>.services.ai.azure.com"

# ✅ 正しい設定
export ANTHROPIC_BASE_URL="https://<resource>.services.ai.azure.com/anthropic"

デバッグモードで確認する

問題が発生した場合は、デバッグモードでリクエストの詳細を確認できます：

export ANTHROPIC_LOG=debug
claude -p "test"

リクエストURLやヘッダーの詳細がログに出力されます。

まとめ

Azure AI FoundryでClaude Codeを使用する設定は以下の5つの環境変数がポイントです：

  1. CLAUDE_CODE_USE_FOUNDRY=1 - Foundry統合を有効化
  2. ANTHROPIC_FOUNDRY_RESOURCE - リソース名
  3. ANTHROPIC_BASE_URL - ベースURL（/anthropicパスを含む）
  4. ANTHROPIC_FOUNDRY_API_KEY - APIキー
  5. ANTHROPIC_DEFAULT_*_MODEL - デプロイされたモデル名

これにより、Azureの課金・管理体系の中でClaude Codeを活用できます。

参考リンク

Discussion