📘 תיעוד 68

Claude Code ב-Microsoft Foundry

למד על הגדרת Claude Code דרך Microsoft Foundry, כולל התקנה, תצורה ופתרון בעיות.

פורס את Claude Code ברחבי הארגון שלך? שוחח עם צוות המכירות על תוכניות enterprise, רישום יחיד (SSO) וחיוב מרכזי.

• צפייה בתוכניות
• פנייה למכירות

#דרישות מוקדמות

לפני הגדרת Claude Code עם Microsoft Foundry, ודא שיש ברשותך:

• מנוי Azure עם גישה ל-Microsoft Foundry
• הרשאות RBAC ליצירת משאבים ופריסות של Microsoft Foundry
• Azure CLI מותקן ומוגדר (רשות, נחוץ רק אם אין לך מנגנון אחר להשגת פרטי הזדהות)

הערה: אם אתה פורס את Claude Code למספר משתמשים, קבע את גרסאות המודלים שלך לפני ההשקה.

#הגדרה

#1. הקצאת משאב Microsoft Foundry

תחילה, צור משאב Claude ב-Azure:

1. נווט אל פורטל Microsoft Foundry

2. צור משאב חדש, ורשום לעצמך את שם המשאב שלך

3. צור פריסות עבור דגמי Claude, ורשום לעצמך את שם הפריסה שאתה נותן לכל אחד, שמות אלה יוגדרו כמשתני המודל בשלב 4:

   • Claude Opus
   • Claude Sonnet
   • Claude Haiku

   כאשר אתה מגדיר פריסה, אתה בוחר גם את אפשרות האירוח שלה, הקובעת אם ההיקש (inference) ירוץ על תשתית Azure או על תשתית Anthropic.

#2. הגדרת פרטי הזדהות של Azure

Claude Code תומך בשלוש שיטות אימות עבור Microsoft Foundry. בחר את השיטה המתאימה ביותר לדרישות האבטחה שלך.

אפשרות A: אימות באמצעות מפתח API

1. נווט אל המשאב שלך בפורטל Microsoft Foundry
2. עבור אל המקטע Endpoints and keys
3. העתק את ה-API Key
4. הגדר את משתנה הסביבה, תוך החלפת your-azure-api-key במפתח שהעתקת:

export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

אפשרות B: אימות באמצעות Microsoft Entra ID

כאשר לא מוגדר ANTHROPIC_FOUNDRY_API_KEY וגם לא ANTHROPIC_FOUNDRY_AUTH_TOKEN, Claude Code משתמש באופן אוטומטי בשרשרת ברירת המחדל של פרטי ההזדהות של ה-SDK של Azure. שרשרת זו תומכת במגוון שיטות לאימות עומסי עבודה מקומיים ומרוחקים.

בסביבות מקומיות, נהוג לעיתים קרובות להשתמש ב-Azure CLI:

az login

אפשרות C: אימות באמצעות אסימון Bearer

Claude Code שולח את הערך של ANTHROPIC_FOUNDRY_AUTH_TOKEN בכל בקשה בתור כותרת Authorization: Bearer. השתמש באפשרות זו כאשר תהליך אחר, כגון יישום מארח או סקריפט התחברות, כבר השיג עבורך אסימון גישה. דורש את Claude Code בגרסה v2.1.203 ומעלה.

הגדר את המשתנה לאסימון bearer שהונפק על ידי Microsoft Entra ID עבור המשאב שלך:

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

המשתנה ANTHROPIC_FOUNDRY_AUTH_TOKEN מקבל קדימות על פני ANTHROPIC_FOUNDRY_API_KEY ועל פני שרשרת ברירת המחדל של פרטי ההזדהות.

הערה: בעת שימוש ב-Microsoft Foundry, הפקודה /logout אינה זמינה מכיוון שהאימות מנוהל דרך פרטי ההזדהות של Azure.

#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. קיבוע גרסאות מודלים

אזהרה: קבע גרסאות מודל ספציפיות עבור כל פריסה. ללא קיבוע, כינויי מודלים כגון sonnet ו-opus מופנים לברירת המחדל המובנית של Claude Code עבור Microsoft Foundry, אשר עשויה לפגר אחר הגרסה החדשה ביותר וייתכן שעדיין אינה זמינה בחשבון שלך. ל-Microsoft Foundry אין בדיקת מודל בעת ההפעלה, ולכן בקשות נכשלות כאשר ברירת המחדל אינה זמינה. בעת יצירת פריסות Azure, בחר גרסת מודל ספציפית במקום "auto-update to latest".

הגדר את משתני המודל כך שיתאימו לשמות הפריסות שיצרת בשלב 1.

ללא ANTHROPIC_DEFAULT_OPUS_MODEL, הכינוי opus ב-Microsoft Foundry מופנה אל Opus 4.6. הגדר אותו למזהה של מודל Opus חדש יותר, כגון Opus 4.8:

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

משימות רקע כגון יצירת כותרת הפעלה (session title generation) משתמשות במודל הקטן והמהיר, בדרך כלל מודל מסדרת Haiku. ב-Microsoft Foundry, Claude Code מגדיר זאת כברירת מחדל למודל הראשי מכיוון שלא בכל חשבון קיימת פריסת Haiku. כדי להשתמש ב-Haiku עבור משימות רקע, הגדר את ANTHROPIC_DEFAULT_HAIKU_MODEL לפריסת Haiku הזמינה בחשבון שלך, כפי שמוצג לעיל.

למזהי מודלים נוכחיים ומזהים ישנים (legacy), ראה סקירת מודלים. ראה הגדרת מודלים לרשימה המלאה של משתני הסביבה.

שמירת פרומפטים במטמון (Prompt caching) מופעלת באופן אוטומטי. כדי לבקש TTL של שעה אחת במטמון במקום ברירת המחדל של 5 דקות, הגדר את המשתנה הבא, פעולות כתיבה למטמון עם TTL של שעה מחויבות בתעריף גבוה יותר:

export ENABLE_PROMPT_CACHING_1H=1

כדי להגדיר ערכי TTL שונים עבור השיחה הראשית שלך ועבור הבקשות ש-Claude Code מבצע מחוצה לה, בחר את ה-TTL בעצמך.

#5. הפעלת Claude Code

כאשר משתני הסביבה מוגדרים, הפעל את Claude Code מתיקיית הפרויקט שלך:

claude

Claude Code קורא את CLAUDE_CODE_USE_FOUNDRY ואת שאר משתני Microsoft Foundry מהסביבה ומתחבר למשאב ה-Azure שלך בפרומפט הראשון. בשונה מ-Amazon Bedrock ומ-Agent Platform של Google Cloud, ב-Microsoft Foundry אין אשף הגדרה אינטראקטיבי, ולכן משתני הסביבה בשלבים 3 ו-4 הם נתיב ההגדרה היחיד.

כדי לאמת את ההגדרה שלך, הרץ /status בתוך Claude Code. שורת ספק ה-API מציגה Microsoft Foundry, יחד עם שם המשאב או כתובת ה-base URL שהגדרת.

#הגדרת 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.

אם בקשות נכשלות עם שגיאות חיבור חוזרות ונשנות בפרומפט הראשון:

• בדוק ש-ANTHROPIC_FOUNDRY_RESOURCE מוגדר לשם המשאב האמיתי שלך ולא לממלא מקום (placeholder). Claude Code בונה את כתובת ה-URL של נקודת הקצה (endpoint) מערך זה, ולכן שם שגוי מצביע על מארח שאינו קיים.

#משאבים נוספים

• תיעוד Microsoft Foundry
• מודלים של Microsoft Foundry
• תמחור Microsoft Foundry