תיעוד 109

הרצת Claude Code דרך שער

ניתוב Claude Code דרך שער שמתארח אצלכם, לריכוז פרטי גישה, מעקב שימוש ובקרות עלות. הדף מכסה את הארכיטקטורה, את שער אפליקציות Claude של Anthropic, ושימוש במוצרי שער אחרים.

שער הוא פרוקסי שהארגון מפעיל בין Claude Code לספק המודל. Claude Code שולח את תעבורת ה-API לשער במקום ישירות לספק, והשער מעביר אותה באמצעות פרטי גישה שהארגון מחזיק. מפתחים מאמתים את עצמם מול השער במקום להחזיק פרטי גישה של הספק, כך שאימות, מעקב שימוש, תקציבים ורישום ביקורת מתרחשים במקום אחד שבשליטתכם.

Claude Code כולל שער שמתארח אצלכם, שער אפליקציות Claude, בתוך הבינארי claude, כך שאין צורך לאמץ מוצר שער נפרד כדי להפעיל אחד. אם הארגון כבר מפעיל שער LLM, Claude Code עובד גם איתו.

הדף הזה מכסה:

#איך שער עובד

Claude Code של כל מפתח שולח את הבקשות שלו לכתובת השער ומאמת אותן באמצעות פרטי גישה שהשער הנפיק.

השער מאמת את המפתח, מחיל את כללי הגישה והתקציב שאתם מגדירים, ומעביר את הבקשה לספק שלכם עם פרטי הגישה של הארגון. הספק יכול להיות ה-API של Anthropic או ספק ענן כמו Amazon Bedrock, Agent Platform של Google Cloud, או Microsoft Foundry. ההגדרה של השער קובעת זאת. עם שער אפליקציות Claude, או שער אחר שחושף נקודת קצה אחת בפורמט Anthropic, החלפת ספק לא דורשת נגיעה במחשבי המפתחים.

שני סוגים של פרטי גישה מעורבים:

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

#בחירת שער

Claude Code עובד עם השער של Anthropic עצמה או עם שער שהארגון כבר מפעיל.

#שער אפליקציות Claude

שער אפליקציות Claude הוא השער של Anthropic שמתארח אצלכם, והוא כלול בבינארי claude. הוא מנתב אל Amazon Bedrock, Claude Platform on AWS, Google Cloud, Microsoft Foundry, או ה-API של Anthropic בתור ה-upstream. מפתחים נכנסים עם ספק הזהות הארגוני שלכם דרך /login, השער אוכף גישה למודלים והגדרות מנוהלות לפי קבוצת IdP, והוא פולט מדדי שימוש ב-OpenTelemetry Protocol (OTLP) אל מחסנית התצפית שלכם.

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

הכניסה לשער היא שלב SSO בדפדפן, ואין זרימת service-token, ולכן צינור CI שאין בו מפתח שיאשר את הכניסה לא יכול להזדהות דרכו. הגדירו אותם מול הספק ישירות. הפעלות Agent SDK והרצות claude -p במכונה שבה מפתח נכנס משתמשות בהפעלת השער של אותה מכונה וכפופות למדיניות שלה. ראו צינורות CI ומכונות מרוחקות.

ראו שער אפליקציות Claude כדי לפרוס אותו.

#שערים אחרים

אם הארגון כבר מפעיל שער LLM או שער API, אפשר להשתמש בו במקום זאת. Anthropic לא ממליצה, לא מתחזקת ולא מבקרת מוצרי שער אחרים, ולא תומכת בניתוב Claude Code למודלים שאינם Claude דרך שום שער. ראו שערי LLM אחרים לרשימת הבדיקה לפריסה למנהלים, למה ששער חייב לממש, ואיך לכוון את Claude Code אליו.

#מנויים ושערים

כשמפתחים מתחברים דרך שער עם פרטי גישה של השער, השימוש מחויב לחשבון הספק של הארגון בתעריפי API, ומנויי claude.ai שלהם לא בשימוש ולא מחויבים. הגדרת ANTHROPIC_AUTH_TOKEN לשער שאתם מפעילים, או כניסה לשער אפליקציות Claude עם /login, מכבה את כניסת המנוי לאותה הפעלה. כל בקשה שמועברת תחת פרטי הגישה האלה מחויבת לחשבון שמאחורי פרטי הגישה של הספק בשער.

החריג הוא הגדרה של ANTHROPIC_BASE_URL בלבד, בלי פרטי גישה של שער. הבקשות עדיין מנותבות דרך השער, אבל כניסת claude.ai שמורה נשארת פרטי הגישה הפעילים, ולכן מגבלות השימוש והחיוב של המנוי חלים. שערי LLM אחרים מכסה את ההגדרה הזו ואת מה שהשער חייב להעביר כדי שזה יעבוד.

#הגדרה בנפרד מהשער

שער מנתב בקשות API של מודל. כמה דברים שאפשר לצפות שהוא יטפל בהם מוגדרים במקום אחר:

איזה מודל עונה: בחרו את המודל עם הפקודה /model או עם משתני סביבה של מודל. השער מחליט לאן הבקשות הולכות, לא איזה מודל המפתח בוחר. שער אפליקציות Claude יכול לתחום את הבחירה עם רשימת היתר availableModels לכל קבוצה, אבל המפתח עדיין בוחר בתוכה.
תעבורת רשת אחרת: Claude Code עצמו שולח בדיקות גרסה והורדות ישירות אל Anthropic, בנפרד מנתיב השער. הרשת עדיין צריכה יציאה אל הדומיינים הנדרשים, או הגדירו CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC כדי לכבות את הזרמים האופציונליים.
טלמטריה של הלקוח: Claude Code מכבה את אנליטיקת הלקוח שמיועדת ל-Anthropic כשהפעלה נכנסת לשער אפליקציות Claude. כדי שגם אנליטיקת ההפעלה שלפני הכניסה תישאר כבויה, העבירו DISABLE_TELEMETRY בהגדרות המנוהלות בצד הלקוח בכל מכשיר.
טלמטריה של הלקוח בשערים אחרים: אם Claude Code שולח את זרם טלמטריית הלקוח האופציונלי תלוי בספק שלכם, וטבלת ברירות המחדל של הטלמטריה מכסה כל מקרה.
יעדי טלמטריה: לאן Claude Code שולח טלמטריה של הפעלת שער תלוי באופן שבו ההפעלה נכנסה, ומה נאכף על מפתחים מציין לאן הייצוא של כל סוג הפעלה הולך.
פרוקסי HTTP ארגוניים: HTTPS_PROXY יושב בין Claude Code לכל שרת שהוא מדבר איתו, כולל השער. אם הרשת דורשת אחד, הגדירו את הפרוקסי בנוסף לשער. עבור שער אפליקציות Claude שאתם מארחים, הכניסה בודקת שגם מארח הפרוקסי נמצא ברשת פרטית. אם הוא לא, הוסיפו את מארח השער ל-NO_PROXY כדי שה-CLI יתחבר אליו ישירות.

#הצעדים הבאים

הדף הבא תלוי במי שמפעיל את השער. השער של Anthropic רץ מהבינארי claude ויש לו מדריך התקנה משלו. שער שהארגון כבר מפעיל דורש מדריך תאימות ורשימת בדיקה לפריסה למנהלים.

שער אפליקציות Claude כדי לפרוס את השער של Anthropic שמתארח אצלכם, עם כניסת SSO וטלמטריית OTLP
שערי LLM אחרים למה ששער שהארגון כבר מפעיל חייב לממש, ואיך לכוון את Claude Code אליו
הגדרת Claude Code לארגון להחלטות הפריסה הרחבות יותר, שהשער הוא חלק אחד מהן