Claude Code روی Microsoft Foundry

پیش‌نیازها

پیش از پیکربندیِ Claude Code با Microsoft Foundry، مطمئن شو که این‌ها را داری:

یک اشتراکِ Azure با دسترسی به Microsoft Foundry
مجوزهای RBAC برای ساختِ منابع و استقرارهای Microsoft Foundry
Azure CLI نصب و پیکربندی‌شده (اختیاری — فقط اگر سازوکارِ دیگری برای گرفتنِ اعتبارنامه نداری لازم است)

راه‌اندازی

1. تأمینِ منبعِ Microsoft Foundry

اول، یک منبعِ Claude در Azure بساز:

به پورتالِ Microsoft Foundry برو
یک منبعِ جدید بساز و نامِ منبعت را یادداشت کن
برای مدل‌های Claude استقرار (deployment) بساز:
- Claude Opus
- Claude Sonnet
- Claude Haiku

2. پیکربندیِ اعتبارنامه‌های Azure

Claude Code برای Microsoft Foundry دو روشِ احراز هویت را پشتیبانی می‌کند. روشی را انتخاب کن که با نیازهای امنیتیِ تو بهترین تناسب را دارد.

گزینه‌ی A: احراز هویت با کلیدِ API

در پورتالِ Microsoft Foundry به منبعت برو
به بخشِ Endpoints and keys برو
مقدارِ API Key را کپی کن
متغیرِ محیطی را تنظیم کن:

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

3. پیکربندیِ Claude Code

برای فعال‌کردنِ Microsoft Foundry این متغیرهای محیطی را تنظیم کن:

# Enable Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# Azure resource name (replace {resource} with your resource name)
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# Or provide the full base URL:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. پین‌کردنِ نسخه‌های مدل

متغیرهای مدل را طوری تنظیم کن که با نام‌های استقراری که در گامِ ۱ ساختی بخوانند.

بدونِ ANTHROPIC_DEFAULT_OPUS_MODEL، نام مستعارِ opus روی Foundry به Opus 4.6 تبدیل می‌شود. برای استفاده از جدیدترین مدل، آن را روی شناسه‌ی Opus 4.8 بگذار:

export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'

کارهای پس‌زمینه مانند تولیدِ عنوانِ نشست از مدلِ کوچک/سریع استفاده می‌کنند که معمولاً مدلی از رده‌ی Haiku است. روی Foundry، Claude Code این را به مدلِ اصلی پیش‌فرض می‌گذارد، چون هر حسابی استقرارِ Haiku ندارد. برای استفاده از Haiku در کارهای پس‌زمینه، ANTHROPIC_DEFAULT_HAIKU_MODEL را روی یک استقرارِ Haiku که در حسابِ تو در دسترس است بگذار، مانندِ بالا.

برای شناسه‌های مدلِ کنونی و قدیمی، به Models overview مراجعه کن. برای فهرستِ کاملِ متغیرهای محیطی، Model configuration را ببین.

Prompt caching به‌صورت خودکار فعال است. برای درخواستِ TTLِ کشِ ۱‌ساعته به‌جای پیش‌فرضِ ۵‌دقیقه‌ای، متغیرِ زیر را تنظیم کن؛ نوشتنِ کش با 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 جادوگرِ راه‌اندازیِ تعاملی وجود ندارد، پس متغیرهای محیطیِ گام‌های ۳ و ۴ تنها مسیرِ پیکربندی هستند.

پیکربندیِ Azure RBAC

نقش‌های پیش‌فرضِ Azure AI User و Cognitive Services User همه‌ی مجوزهای لازم برای فراخوانیِ مدل‌های Claude را دربردارند.

برای مجوزهای محدودتر، یک نقشِ سفارشی با این محتوا بساز:

{
  "permissions": [
    {
      "dataActions": [
        "Microsoft.CognitiveServices/accounts/providers/*"
      ]
    }
  ]
}

برای جزئیات، به مستنداتِ RBACِ Microsoft Foundry مراجعه کن.

عیب‌یابی

اگر خطای «Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed» دریافت کردی:

Entra ID را روی محیط پیکربندی کن، یا ANTHROPIC_FOUNDRY_API_KEY را تنظیم کن.