Skip to main content

Claude Code บน Microsoft Foundry

เรียนรู้เกี่ยวกับการกำหนดค่า Claude Code ผ่าน Microsoft Foundry รวมถึงการตั้งค่า, การกำหนดค่า และการแก้ไขปัญหา

สิ่งที่ต้องมีก่อน​

ก่อนกำหนดค่า Claude Code กับ Microsoft Foundry ตรวจสอบว่าคุณมี:

  • Azure subscription ที่เข้าถึง Microsoft Foundry ได้
  • RBAC permissions เพื่อสร้าง Microsoft Foundry resources และ deployments
  • Azure CLI ติดตั้งและกำหนดค่าแล้ว (ไม่บังคับ)
note

หากกำลัง deploy Claude Code ให้ผู้ใช้หลายคน pin model versions ก่อน rollout

การตั้งค่า​

1. จัดเตรียม Microsoft Foundry Resource​

สร้าง Claude resource ใน Azure:

  1. ไปที่ Microsoft Foundry portal
  2. สร้าง resource ใหม่
  3. สร้าง deployments สำหรับ Claude models:
    • Claude Opus
    • Claude Sonnet
    • Claude Haiku

2. กำหนดค่า Azure Credentials​

Claude Code รองรับสองวิธีการยืนยันตัวตนสำหรับ Microsoft Foundry:

Option A: API key authentication

  1. ไปที่ resource ของคุณใน Microsoft Foundry portal
  2. ไปที่ส่วน Endpoints and keys
  3. คัดลอก API Key
  4. ตั้งค่า environment variable:
export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

Option B: Microsoft Entra ID authentication

เมื่อ ANTHROPIC_FOUNDRY_API_KEY ไม่ได้ตั้งค่า Claude Code จะใช้ Azure SDK default credential chain โดยอัตโนมัติ

สำหรับ local environments สามารถใช้ Azure CLI:

az login

3. กำหนดค่า Claude Code​

ตั้งค่า environment variables ต่อไปนี้เพื่อเปิดใช้งาน Microsoft Foundry:

# เปิดใช้งาน Microsoft Foundry integration
export CLAUDE_CODE_USE_FOUNDRY=1

# ชื่อ Azure resource
export ANTHROPIC_FOUNDRY_RESOURCE={resource}
# หรือระบุ base URL เต็ม:
# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic

4. Pin Model Versions​

warning

Pin model versions เฉพาะสำหรับทุก deployment โดยไม่ต้อง pin model aliases เช่น sonnet และ opus จะ resolve ไปยัง Claude Code's built-in default สำหรับ Foundry ซึ่งอาจล้าหลังเวอร์ชันใหม่สุดและอาจยังไม่พร้อมในบัญชีของคุณ

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'

Prompt caching เปิดใช้งานโดยอัตโนมัติ หากต้องการ 1-hour cache TTL แทนค่าเริ่มต้น 5 นาที:

export ENABLE_PROMPT_CACHING_1H=1

5. รัน Claude Code​

claude

การกำหนดค่า Azure RBAC​

Role Azure AI User และ Cognitive Services User มี permissions ที่จำเป็นทั้งหมดสำหรับ invoke Claude models

สำหรับ permissions ที่จำกัดมากขึ้น สร้าง custom role:

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

การแก้ไขปัญหา​

หากได้รับข้อผิดพลาด "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

  • กำหนดค่า Entra ID บน environment หรือตั้งค่า ANTHROPIC_FOUNDRY_API_KEY

แหล่งข้อมูลเพิ่มเติม​