📘 תיעוד 32

Claude Code עם GitHub Enterprise Server

חבר את Claude Code למופע GitHub Enterprise Server באירוח עצמי שלך עבור הפעלות רשת, סקירת קוד ושוקי תוספים.

הערה: תמיכה ב-GitHub Enterprise Server זמינה בתוכניות Team ו-Enterprise.

תמיכה ב-GitHub Enterprise Server‏ (GHES) מאפשרת לארגון שלך להשתמש ב-Claude Code עם מאגרים שמתארחים במופע GitHub בניהול עצמי במקום ב-github.com. ברגע ש-Owner מחבר את מופע ה-GHES שלך, מפתחים יכולים להריץ הפעלות רשת ולקבל סקירות קוד אוטומטיות ללא צורך בהגדרה ברמת המאגר הבודד. שוקי תוספים שמתארחים במופע שלך נתמכים גם הם; דרישות האישורים משתנות לפי הממשק, כפי שמתואר בסעיף שוקי תוספים ב-GHES.

עבור מאגרים ב-github.com, ראה Claude Code ברשת ו-סקירת קוד. כדי להריץ את Claude בתשתית ה-CI שלך, ראה GitHub Actions.

#מה עובד עם GitHub Enterprise Server

הטבלה להלן מציגה אילו תכונות של Claude Code תומכות ב-GHES וכל הבדל בהתנהגות לעומת github.com.

#הגדרת מנהל מערכת

Owner מחבר את מופע ה-GHES שלך ל-Claude Code פעם אחת. לאחר מכן, מפתחים בארגון שלך יכולים להשתמש במאגרי GHES ללא כל הגדרה נוספת. אתה זקוק לתפקיד Owner או Primary Owner בארגון ה-Claude שלך ולהרשאה ליצור יישומי GitHub Apps במופע ה-GHES שלך.

ההגדרה המודרכת מייצרת מניפסט של GitHub App ומפנה אותך אל מופע ה-GHES שלך כדי ליצור את היישום בלחיצה אחת. אם הסביבה שלך חוסמת את תהליך ההפניה, קיימת הגדרה ידנית חלופית.

1. פתח את הגדרות מנהל המערכת של Claude Code: עבור אל claude.ai/admin-settings/claude-code ומצא את הסעיף GitHub Enterprise Server.
2. התחל את ההגדרה המודרכת: לחץ על Connect. הזן שם תצוגה של עד 20 תווים עבור החיבור ואת שם המארח של ה-GHES שלך, לדוגמה github.example.com. אם מופע ה-GHES שלך משתמש ברשות אישורים (CA) בחתימה עצמית או פרטית, הדבק את תעודת ה-CA בשדה האופציונלי.
3. צור את ה-GitHub App: לחץ על Continue to GitHub Enterprise. הדפדפן שלך יפנה אותך אל מופע ה-GHES שלך עם מניפסט יישום ממולא מראש. סקור את התצורה ולחץ על Create GitHub App. מופע ה-GHES מפנה אותך בחזרה אל Claude כאשר אישורי היישום נשמרים באופן אוטומטי.
4. התקן את היישום במאגרים שלך: מדף ה-GitHub App במופע ה-GHES שלך, התקן את היישום במאגרים או בארגונים שאתה רוצה של-Claude תהיה גישה אליהם. אתה יכול להתחיל עם קבוצה חלקית ולהוסיף עוד מאוחר יותר.
5. הפעל תכונות: חזור אל claude.ai/admin-settings/claude-code והפעל את Code Review, את Claude Security ואת מדדי התרומה עבור מאגרי ה-GHES שלך באמצעות אותה תצורה כמו ב-github.com.

#הרשאות GitHub App

המניפסט מגדיר את ה-GitHub App עם ההרשאות ואירועי ה-webhook שלהלן, שיחד מכסים הפעלות רשת, Code Review, Claude Security, שוקי תוספים ומדדי תרומה:

היישום נרשם לאירועים pull_request, issue_comment, pull_request_review_comment, pull_request_review, check_run ו-status.

GitHub מחיל מניפסט רק כאשר היישום נוצר, כך שיישום שנוצר מגרסה מוקדמת יותר של המניפסט שומר על ההרשאות והאירועים שאיתם הוא נוצר. אם ביישום שלך חסרים הרשאות או אירועים כלשהם מהרשומים לעיל, הוסף אותם בהגדרות היישום במופע ה-GHES שלך. לאחר מכן, GitHub מבקש מבעלים (owner) של כל התקנה לאשר את ההרשאות החדשות, וההתקנה שומרת על הרשאותיה הישנות עד שהם עושים זאת.

#הגדרה ידנית

אם תהליך ההפניה המודרך נחסם על ידי תצורת הרשת שלך, לחץ על Add manually במקום על Connect. צור GitHub App במופע ה-GHES שלך עם ההרשאות והאירועים שלעיל, ולאחר מכן הזן את פרטי החיבור בטופס: שם תצוגה, שם המארח של ה-GHES שלך ויציאה אופציונלית, וכן את מזהה היישום, מזהה הלקוח (client ID), סוד הלקוח (client secret), סוד ה-webhook ומפתח פרטי. הטופס מקבל גם תעודת CA מותאמת אישית אופציונלית ושמות מארחים של עותקי קריאה (read replica hostnames).

Claude מייצר את כתובת ה-webhook URL של היישום בעת שמירת החיבור. לאחר שתלחץ על Add configuration, פתח את תפריט More options של החיבור, בחר ב-Copy webhook URL, והדבק את כתובת ה-URL בהגדרות ה-webhook של היישום במופע ה-GHES שלך. השתמש באותו סוד webhook שהזנת בטופס.

#דרישות רשת

עבור הפעלות שמתארחות אצל Anthropic, מופע ה-GHES שלך חייב להיות נגיש מתשתית Anthropic כדי ש-Claude יוכל לשכפל מאגרים ולפרסם הערות סקירה. אם מופע ה-GHES שלך נמצא מאחורי חומת אש, הוסף לרשימת המורשים את כתובות ה-IP היוצאות של Anthropic. הפעלות בתוך סביבה באירוח עצמי משכפלות מתוך הרשת שלך במקום זאת, אלא אם ה-runner בוחר להשתמש ב-Anthropic git proxy, אשר מושך מהצד של Anthropic ודורש את אותה רמת נגישות; ה-SCM connector מכסה את תהליכי טרום ההפעלה המאורחים, כגון בורר המאגרים, עבור מארח GHES שניתן לניתוב פנימי בלבד.

#תהליך עבודה למפתחים

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

שכפל מאגר ממופע ה-GHES שלך כפי שאתה עושה בדרך כלל, תוך החלפת github.example.com ונתיב המאגר בשם המארח ובמאגר ה-GHES שלך:

git clone [email protected]:platform/api-service.git
cd api-service

לאחר מכן התחל הפעלת רשת. Claude מזהה את מארח ה-GHES מתוך ה-git remote שלך ומנתב את ההפעלה דרך המופע המוגדר של הארגון שלך:

claude --cloud "Add retry logic to the payment webhook handler"

ההפעלה משכפלת את המאגר שלך מ-GHES ודוחפת שינויים בחזרה לענף. עקוב אחר ההתקדמות בכתובת claude.ai/code. ראה Claude Code ברשת עבור תהליך העבודה המלא של הפעלת ענן כולל סקירת diff, תיקון אוטומטי ושגרות (routines).

#העברת הפעלות לטרמינל באמצעות Teleport

משוך הפעלת רשת אל הטרמינל המקומי שלך באמצעות claude --teleport. הפקודה Teleport מוודאת שאתה נמצא בתוך עותק עבודה (checkout) של אותו מאגר GHES לפני משיכת הענף וטעינת היסטוריית ההפעלה. ראה דרישות teleport לפרטים נוספים.

#שוקי תוספים ב-GHES

ארח שוקי תוספים במופע ה-GHES שלך כדי להפיץ כלי פיתוח פנימיים ברחבי הארגון שלך. מבנה השוק זהה לשווקים המתארחים ב-github.com, אך ההתקנה פועלת באופן שונה בהתאם למקום שבו אתה מוסיף את השוק, ואישורי הגישה שונים בין הממשקים השונים:

אזהרה: חיבורי GitHub Enterprise ב-claude.ai הם ברמת המשתמש כאשר שוק נוסף מתוך הגדרות משתמש. הגדרת מנהל המערכת מחברת את מופע ה-GHES שלך לארגון שלך, אך היא אינה מחברת חשבונות משתמשים בודדים: כל משתמש שמוסיף שוק GHES מההגדרות שלו חייב תחילה לחבר את חשבון ה-GitHub Enterprise שלו, וחיבור של משתמש אחד, כולל של ה-Owner, אינו מכסה אף אחד אחר. שווקים שנוספו על ידי Owner בהגדרות תוספי הארגון אינם מחייבים זאת מהמשתמשים, מכיוון שמשיכות שוטפות משתמשות ב-GitHub App של הארגון. ה-Owner שמוסיף את השוק עדיין צריך שחשבון ה-GitHub Enterprise שלו יהיה מחובר בעת ההוספה.

#הוספת שוק GHES

הקיצור owner/repo מנותב תמיד אל github.com. עבור שווקים המתארחים ב-GHES, השתמש בכתובת git URL מלאה, תוך החלפת github.example.com ונתיב המאגר בפרטים שלך. מומלץ להשתמש בכתובות HTTPS URL:

/plugin marketplace add https://github.example.com/platform/claude-plugins.git

כתובות SSH URL עובדות אם המחשב כבר נותן אמון במארח ה-GHES שלך:

/plugin marketplace add [email protected]:platform/claude-plugins.git

Claude Code מריץ את git באופן לא אינטראקטיבי ודוחה חיבורי SSH למארחים שאינם מופיעים בקובץ known_hosts של המחשב. כתובת HTTPS URL עם מסייע אישורי git נמנעת מהדרישה לקובץ known_hosts.

ראה יצירה והפצה של שוק תוספים עבור המדריך המלא לבניית שווקים.

#רישום מראש של שוקי GHES באמצעות הגדרות מנוהלות

ההגדרה extraKnownMarketplaces רושמת שוק מראש כך שמפתחים מקבלים אותו ללא הגדרה ידנית. היא פועלת מתוך כל קובץ הגדרות, כולל קובץ .claude/settings.json של מאגר; הגדרות מנוהלות מספקות אותה בכל רחבי הארגון:

{
  "extraKnownMarketplaces": {
    "internal-tools": {
      "source": {
        "source": "git",
        "url": "https://github.example.com/platform/claude-plugins.git"
      }
    }
  }
}

Claude Code מתקין שווקים אלה מקומית: הוא רושם כל ערך ומשכפל את המאגר באמצעות אישורי ה-git הקיימים במחשב. נתיב זה אינו עובר דרך claude.ai, ולכן חיבור ה-GitHub Enterprise לפי משתמש אינו נדרש. לפריסה מוצלחת:

• השתמש בכתובת git URL מלאה. הקיצור owner/repo מנותב תמיד אל github.com ואינו יכול להפנות למארח GHES.
• העדף כתובות HTTPS URL. שכפול ב-SSH נכשל במחשבים שעדיין אינם נותנים אמון במפתח המארח של ה-GHES שלך. כתובת HTTPS URL עם מסייע אישורי ה-git הסטנדרטי של הארגון שלך עובדת בכל מחשב שבו מוגדרים אישורים.
• ודא שכל מחשב יכול לשכפל ממארח ה-GHES שלך. אם במחשב מסוים חסרים אישורים, השוק נרשם אך לעולם אינו מותקן, והתוספים שלו מדווחים כלא נמצאו במקום לבקש אישורים.
• ודא שההגדרה מגיעה לכל מחשב. קובץ הגדרות מנוהלות נכנס לתוקף רק במחשבים שאליהם הוא נפרס, לדוגמה באמצעות מערכת ניהול המכשירים שלך. ראה פריסת הגדרות מנוהלות עבור מיקומי קבצים.

#הוספת שוקי GHES לרשימת המורשים בהגדרות מנוהלות

אם הארגון שלך משתמש ב-הגדרות מנוהלות כדי להגביל לאילו שווקים מפתחים יכולים להוסיף, השתמש בסוג המקור hostPattern כדי לאפשר את כל השווקים ממופע ה-GHES שלך מבלי לפרט כל מאגר ומאגר. ראה מנגנוני מסירה עבור מיקומי קבצים בכל פלטפורמה. הוסף את ה-JSON לקובץ managed-settings.json שלך או למדיניות MDM מקבילה:

{
  "strictKnownMarketplaces": [
    {
      "source": "hostPattern",
      "hostPattern": "^github\\.example\\.com$"
    }
  ]
}

ראה את עיון ההגדרות עבור strictKnownMarketplaces ו-extraKnownMarketplaces עבור הסכמה המלאה.

#מגבלות

מספר תכונות מתנהגות ב-GHES באופן שונה מאשר ב-github.com. טבלת התכונות מסכמת את התמיכה; סעיף זה מכסה את המעקפים.

• פקודת /install-github-app: בצע במקום זאת את תהליך הגדרת מנהל המערכת ב-claude.ai. אם אתה מעוניין גם בתהליכי עבודה של GitHub Actions ב-GHES, התאם את תהליך העבודה לדוגמה באופן ידני.
• שרת GitHub MCP: השתמש במקום זאת ב-CLI של gh המוגדר עבור מארח ה-GHES שלך. הרץ gh auth login --hostname github.example.com כדי לבצע אימות, ולאחר מכן Claude יוכל להשתמש בפקודות gh במהלך הפעלות.

#פתרון בעיות

#הפעלת רשת נכשלת בשכפול המאגר

אם claude --cloud נכשל עם שגיאת שכפול, ודא ש-Owner השלים את ההגדרה עבור מופע ה-GHES שלך ושה-GitHub App מותקן במאגר שבו אתה עובד. בקש מה-Owner שחיבר את המופע לוודא ששם המארח הרשום בהגדרות Claude תואם לשם המארח ב-git remote שלך.

#הוספת שוק נכשלת עם שגיאת מדיניות

אם הפקודה /plugin marketplace add חסומה עבור כתובת ה-URL של ה-GHES שלך, הארגון שלך הגביל את מקורות השוק. בקש ממנהל המערכת שלך להוסיף רשומת hostPattern עבור שם המארח של ה-GHES שלך ב-הגדרות מנוהלות.

#הוספת שוק ב-claude.ai נכשלת עם שגיאת גישה ל-GitHub

אם הוספת שוק GHES מהגדרות המשתמש שלך נכשלת עם שגיאה כללית כמו "Marketplace couldn't be added", בדוק תחילה את חיבור ה-GitHub Enterprise שלך. הודעה זו מופיעה כאשר חשבון ה-GitHub Enterprise שלך אינו מחובר ל-Claude, גם אם מופע ה-GHES של הארגון שלך מוגדר ומשתמשים אחרים מחוברים. תיבת הדו-שיח אינה מפנה לתהליך החיבור של GitHub Enterprise, והאפשרות "Connect to GitHub" בלשונית Browse מתחברת ל-github.com, דבר שאינו מעניק גישה למאגרי GHES.

כדי לחבר את חשבון ה-GitHub Enterprise שלך: בורר המאגרים בכתובת claude.ai/code מציע אפשרות התחברות עבור כל מופע GHES מוגדר, ומשתמשי Owner יכולים להתחבר גם מסעיף GitHub Enterprise ב-הגדרות מנהל המערכת של Claude Code. לאחר מכן הוסף את השוק מחדש. לחלופין, בקש מ-Owner להוסיף את השוק בהגדרות תוספי הארגון, דבר שמסיר את דרישת החיבור ברמת המשתמש הבודד.

בממשקים אחרים של claude.ai, שגיאה בנוסח "Repository not found. If it's private, GitHub access is required" בשוק GHES מעידה בדרך כלל על אותו חיבור חסר. חבר את חשבון ה-GitHub Enterprise שלך דרך אחד הנתיבים שלעיל, ולאחר מכן נסה שוב.

#מופע ה-GHES אינו נגיש

אם סקירות או הפעלות רשת באירוח Anthropic מגיעות ל-timeout, ייתכן שמופע ה-GHES שלך אינו נגיש מתשתית Anthropic. ודא שחומת האש שלך מאפשרת חיבורים נכנסים מ-כתובות ה-IP היוצאות של Anthropic. הפעלות בתוך סביבה באירוח עצמי מגיעות ל-GHES מתוך הרשת שלך, לכן עבורן בדוק במקום זאת את נתיב הרשת של ה-runner עצמו ואת ה-SCM connector.

#התחלת ההפעלה נכשלת עם Unable to get organization UUID

הפעלות רשת דורשות ארגון Team או Enterprise. היכנס באמצעות /login עם חשבון הארגון שלך. אם תבצע אימות באמצעות מפתח API במקום זאת, הפעלות רשת ייכשלו בשלב מוקדם יותר עם הודעה המבקשת ממך להריץ /login.

#משאבים קשורים

דפים אלה מכסים ביתר הרחבה את התכונות המוזכרות לאורך מדריך זה:

• Claude Code ברשת: הרצת הפעלות Claude Code על גבי תשתית ענן
• Code Review: סקירות PR אוטומטיות
• שוקי תוספים: בנייה והפצה של קטלוגי תוספים
• ניתוח נתונים (Analytics): מעקב אחר שימוש ומדדי תרומה
• הגדרות מנוהלות: הגדרת מדיניות בכל רחבי הארגון
• תצורת רשת: דרישות חומת אש ורשימת כתובות IP מורשות