📘 תיעוד 105

Claude Code ב-Microsoft Foundry

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

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

הצג תוכניות צור קשר עם המכירות

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

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

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

[!NOTE]

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

#הגדרה

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

קודם, צור משאב Claude ב-Azure:

1. עבור אל פורטל Microsoft Foundry

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

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

   • Claude Opus
   • Claude Sonnet
   • Claude Haiku

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

#2. הגדרת אישורי Azure

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

• מפתח API: מעתיקים מפתח מפורטל Microsoft Foundry ומגדירים אותו כ-ANTHROPIC_FOUNDRY_API_KEY
• Microsoft Entra ID: Claude Code מקבל אסימונים דרך שרשרת האישורים ברירת המחדל של Azure SDK, לדוגמה מסשן az login, כך שאין מפתח API לאחסון
• אסימון Bearer: תהליך אחר משיג אסימון גישה של Microsoft Entra ID ומעבירים אותו ב-ANTHROPIC_FOUNDRY_AUTH_TOKEN

[!NOTE]

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

#שימוש במפתח API

העתק מפתח מפורטל Microsoft Foundry, ואז הגדר אותו כמשתנה סביבה:

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

export ANTHROPIC_FOUNDRY_API_KEY=your-azure-api-key

#שימוש ב-Microsoft Entra ID

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

במחשב מקומי, התחבר עם Azure CLI:

az login

לתפקידים שהזהות שלך צריכה, ראה הגדרת Azure RBAC.

#שימוש באסימון Bearer

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

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

export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

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

#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

הגדר את ANTHROPIC_FOUNDRY_RESOURCE לשם המשאב בלבד, כגון my-resource. Claude Code מסרב לכתובת URL או לשם מארח כשאתה שולח הודעה.

#4. קיבוע גרסאות מודל

[!WARNING]

קבע גרסאות מודל ספציפיות לכל פריסה. בלי קיבוע, כינויי מודל כגון 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'

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

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

שמירת מטמון של הנחיות מופעלת אוטומטית. כדי לבקש 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, יחד עם שם המשאב או כתובת ה-URL הבסיסית שהגדרת.

#הגדרת Azure RBAC

תפקידי ברירת המחדל Azure AI User ו-Cognitive Services User כוללים את כל ההרשאות הנדרשות להפעלת מודלי Claude.

להרשאות מגבילות יותר, צור תפקיד מותאם אישית עם הדברים הבאים:

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

לפרטים, ראה תיעוד RBAC של Microsoft Foundry.

#חלון הקשר של 1M אסימונים

ב-Microsoft Foundry, כש-Claude Code יכול לזהות איזה מודל הפריסה שלך משרתת, מודלי Fable, Sonnet 5 ואילך, ו-Opus 4.7 ואילך רצים עם חלון הקשר של 1M אסימונים כברירת מחדל, בלי צורך בסיומת [1m]. Claude Code קורא את המודל משם הפריסה במשתני המודל שלך. תן לכל פריסה שם לפי מזהה המודל שלה, כגון claude-opus-4-8, או מפה את המודל לשם הפריסה שלך עם modelOverrides. לשם פריסה שאי אפשר להתאים למודל, Claude Code מניח חלון של 200K אלא אם מצהירים על חלון אחר.

רשומת settings.json הזו אומרת ל-Claude Code שפריסה בשם team-opus-prod משרתת את Opus 4.8:

{
  "modelOverrides": {
    "claude-opus-4-8": "team-opus-prod"
  }
}

כדי לשמור על חלון של 200K, הגדר CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Opus 4.6 ו-Sonnet 4.6 מגיעים לחלון של 1M כשמוסיפים [1m] לשם הפריסה ב-ANTHROPIC_DEFAULT_OPUS_MODEL או ב-ANTHROPIC_DEFAULT_SONNET_MODEL, כפי שמתואר ב-קיבוע מודלים לפריסות צד שלישי. לפני v2.1.287, גם מודלי Fable ו-Opus 4.7 ואילך נזקקו לסיומת הזו ב-Microsoft Foundry ורצו עם חלון של 200K כברירת מחדל בלעדיה.

#פתרון בעיות

אם מתקבלת השגיאה "Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed":

• הגדר את Entra ID בסביבה, או הגדר את ANTHROPIC_FOUNDRY_API_KEY.

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

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

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

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