קורן בן עזרא
מה Claude יכול לעשות עם GitHub
חיבור GitHub ל-Claude Code נותן לו לקרוא קוד, issues ו-pull requests בריפו שאישרתם, ולבדוק למה build נכשל. בחיבור המומלץ במדריך הגישה היא לקריאה בלבד, דרך מפתח שמוגבל לריפו אחד, ומי שרוצה ש-Claude גם יפתח issue או יציע שינוי קוד צריך מפתח נפרד עם הרשאות כתיבה. הכלי מתאים בעיקר למי שכבר עובד עם GitHub.
- קוד וקבצים בריפוזיטורי שיש הרשאה אליו
- issues ו pull requests, פתוחים וסגורים
- סטטוס build של GitHub Actions וסיבת כישלון
שום דבר. זה חיבור לקריאה בלבד.
מה צריך לפני שמתחילים
- חשבון GitHub עם גישה לריפו שרוצים לחבר
- אפליקציית Claude למחשב, Mac או Windows, עם לשונית Code. היא כלולה בתוכניות בתשלום, Pro ומעלה
- ב-Windows מומלץ להתקין Git for Windows מ-git-scm.com/downloads/win, כדי ש-Claude Code יעבוד עם Bash
- אם הריפו שייך לארגון, ייתכן שמנהל הארגון יצטרך לאשר את המפתח
- כ-15 דקות
איך מחברים את GitHub ל-Claude.
הדרך הרשמית היא שרת ה-MCP של GitHub עצמה. GitHub כותבת בתיעוד שהשרת המרוחק שלה עוד לא עובד כמחבר מותאם אישית באתר של Claude, ולכן מחברים אותו דרך Claude Code באפליקציית Claude למחשב, בכתובת של מצב קריאה בלבד. בדפדפן יוצרים מפתח גישה לקריאה בלבד לריפו אחד, ואת החלק הטכני Claude Code עושה משני פרומפטים שמדביקים.
- 1
פותחים טופס מפתח עם הרשאות קריאה מוכנות
המפתח (fine-grained personal access token) הוא סיסמה מיוחדת שמאפשרת ל-Claude Code לקרוא מהריפו בלי הסיסמה שלכם. הקישור ממלא מראש שם, תוקף של 90 יום והרשאות קריאה בלבד לקוד, ל-issues, ל-pull requests ול-Actions. נכנסים עם חשבון GitHub שיש לו גישה לריפו.
- פותחים את הקישור. אם GitHub מבקשת, מתחברים ומאשרים שוב את הסיסמה
- בודקים שב-Token name כתוב claude-code ושב-Expiration התוקף הוא 90 יום מהיום
איפה:https://github.com/settings/personal-access-tokens/new?name=claude-code&description=Read-only+access+for+Claude+Code&expires_in=90&contents=read&issues=read&pull_requests=read&actions=read - 2
מגבילים את המפתח לריפו אחד
מפתח שרואה רק ריפו אחד, ורק לקריאה, לא יכול להזיק גם אם יגיע למקום הלא נכון. בוחרים את הריפו שרוצים ש-Claude יכיר.
- ב-Resource owner בוחרים את החשבון או את הארגון שהריפו שייך לו
- ב-Repository access בוחרים Only select repositories
- בתפריט Selected repositories בוחרים את הריפו
- תחת Permissions מוודאים שליד Contents, Issues, Pull requests ו-Actions כתוב Read-only, ושלא נוספה אף הרשאת כתיבה
אם הריפו שייך לארגון שדורש אישור למפתחות, יופיע גם שדה להסביר למה צריך את המפתח. כותבים משהו כמו: קריאה בלבד עבור Claude Code.
- 3
יוצרים את המפתח ומעתיקים אותו
GitHub מציגה את המפתח פעם אחת בלבד, מיד אחרי היצירה, ולכן מעתיקים אותו מיד. בשלב הבא תדביקו אותו בקובץ שמור, לא בצ'אט.
- גוללים למטה ולוחצים Generate token
- אם נפתח חלון סיכום, בודקים את הפרטים ולוחצים שוב Generate token
- מעתיקים את המפתח החדש, שמתחיל ב-github_pat_
אם הריפו שייך לארגון שדורש אישור, המפתח יהיה במצב pending עד שמנהל יאשר, ועד אז הוא יקרא רק ריפואים ציבוריים. מי שהוא owner בארגון מאושר אוטומטית.
- 4
Claude Code מכין קובץ שמור למפתח
מכאן Claude Code עושה את החלק הטכני. פותחים את אפליקציית Claude במחשב ועוברים ללשונית Code. ב-Environment בוחרים Local, כ-Project folder בוחרים את תיקיית הבית שלכם, ובבורר ההרשאות שליד כפתור השליחה בוחרים Manual, כדי ש-Claude Code יבקש אישור לפני כל פקודה. מדביקים את הפרומפט, ואם אתם על Windows מחליפים בו את Mac ב-Windows. Claude Code ייצור קובץ קטן ויפתח אותו לכם, ואתם תדביקו בו את המפתח בעצמכם, כך שהמפתח לא עובר בצ'אט.
מדביקים ב-Claude Codeאני רוצה לחבר את GitHub ל-Claude Code דרך השרת הרשמי של GitHub (github.com/github/github-mcp-server). המחשב שלי הוא Mac. 1. תיצור תיקייה בשם github-mcp בתוך תיקיית הבית שלי, ובתוכה קובץ טקסט בשם .env עם שורה אחת בלבד: GITHUB_PAT=paste-here 2. תפתח לי את הקובץ בעורך טקסט רגיל (ב-Mac עם open -e, ב-Windows עם notepad) ותגיד לי להחליף את paste-here במפתח שהעתקתי, בלי רווחים, לשמור ולסגור. 3. תחכה שאכתוב לך שסיימתי. לפני כל פקודה תסביר מה היא עושה ותחכה לאישור שלי. אל תקרא את המפתח ואל תציג אותו.
הקובץ הזה הוא סוד. לא שולחים אותו לאף אחד ולא מעבירים אותו לתיקייה שמסונכרנת ל-iCloud, ל-OneDrive או ל-Dropbox.
- 5
מוסיפים את GitHub ל-Claude Code לקריאה בלבד
עכשיו Claude Code מוסיף את השרת בכתובת של מצב קריאה בלבד, api.githubcopilot.com/mcp/readonly, וקורא את המפתח מהקובץ בלי להציג אותו. כותבים באותה שיחה שסיימתם ומדביקים את הפרומפט.
מדביקים ב-Claude Codeסיימתי להדביק את המפתח בקובץ github-mcp/.env. עכשיו תוסיף ל-Claude Code את השרת הרשמי של GitHub בהיקף user, כדי שיהיה זמין בכל תיקייה, בכתובת של מצב קריאה בלבד ובלי להציג את המפתח. זו הפקודה, לפי התיעוד של GitHub ל-Claude Code: claude mcp add --scope user --transport http github https://api.githubcopilot.com/mcp/readonly --header "Authorization: Bearer $(grep '^GITHUB_PAT=' ~/github-mcp/.env | cut -d '=' -f2-)" ב-Windows תקרא את המפתח מהקובץ בדרך שמתאימה ל-PowerShell. אחר כך תריץ claude mcp list ותוודא ש-github מחובר. אם לא, תבדוק מה חסר ותתקן, בלי להציג את המפתח. לפני כל פקודה תסביר מה היא עושה ותחכה לאישור שלי.
המפתח נשמר גם בהגדרות של Claude Code במחשב שלכם. אם המפתח דלף או שאתם מפסיקים להשתמש בחיבור, נכנסים ל-github.com/settings/personal-access-tokens ולוחצים Delete ליד claude-code.
- 6
בודקים שהחיבור עובד
פותחים שיחה חדשה בלשונית Code, כדי שהחיבור ייטען, ומדביקים את פרומפט הבדיקה שמופיע כאן למטה. מוסיפים בסוף את שם הריפו בפורמט owner/repo, למשל my-company/website.
- 7
מחליפים מפתח לפני שהוא פג
המפתח תקף 90 יום. כשהוא פג, GitHub מחזירה שגיאת Bad credentials והחיבור מפסיק לעבוד. ההחלפה לוקחת כמה דקות.
- פותחים שוב את הקישור מהשלב הראשון, משנים את Token name ל-claude-code-2, ויוצרים מפתח עם אותן הגדרות
- פותחים את הקובץ github-mcp/.env, מחליפים את המפתח הישן בחדש ושומרים
- כותבים ל-Claude Code: המפתח של GitHub התחלף, תעדכן את החיבור github מהקובץ github-mcp/.env בלי להציג אותו
- בעמוד Fine-grained tokens לוחצים Delete ליד המפתח הישן
איפה:https://github.com/settings/personal-access-tokens
מדביקים ב-Claude. אם מתקבלת תשובה עם נתונים אמיתיים מהחשבון, הכל מחובר.
תראה לי אילו pull requests פתוחים יש בריפו הזה ומי פתח כל אחד, בלי לשנות שום דברפרומפטים מוכנים לעבודה
טיוטת issue
תנסח לי issue שמתאר את הבאג הזה, כולל שלבים לשחזור, ואני אפתח אותו בעצמיבדיקת build אחרון
תבדוק מה הסטטוס של ה-build האחרון ב-GitHub Actions ותגיד לי אם הוא נכשל ולמהסקירת pull requests פתוחים
תראה לי אילו pull requests פתוחים מחכים לי לריוויוהסבר קובץ
תסביר לי בשפה פשוטה מה עושה קובץ ה-README בריפו הזה ומה חסר בוסיכום שינויים אחרונים
תסכם לי מה השתנה בקוד בשבוע האחרון בריפו הזהבדיקת issues ישנים
תראה לי אילו issues פתוחים כבר יותר מחודש בלי מענההשוואת ענפים
תבדוק מה ההבדל בין ענף ה-main לענף הפיתוח הנוכחידרכים נוספות להתחבר (למתקדמים)
הדרך המומלצת: השרת של GitHub דרך Claude Code, לקריאה בלבד
בעלי עסקים ומפתחים שרוצים ש-Claude יקרא ריפו אחד בלי יכולת לשנות אותו
- יוצרים ב-GitHub מפתח fine-grained personal access token לריפו אחד, עם הרשאות Read-only ל-Contents, Issues, Pull requests ו-Actions
- שומרים את המפתח בקובץ מקומי, כמו שמתואר במדריך, כדי שלא יעבור בצ'אט
- מוסיפים ל-Claude Code את השרת בכתובת של מצב קריאה בלבד, עם המפתח בכותרת Authorization
- פותחים שיחה חדשה ובודקים עם שאלה על הריפו
claude mcp add --scope user --transport http github https://api.githubcopilot.com/mcp/readonly --header "Authorization: Bearer YOUR_GITHUB_PAT"
אין מחבר של GitHub בספריית המחברים של Claude, ולפי GitHub השרת המרוחק דורש אפליקציית OAuth רשומה, ולכן לא עובד כמחבר מותאם אישית באתר של Claude. כדי לאפשר גם כתיבה מחליפים את הכתובת ב-https://api.githubcopilot.com/mcp/ ומשתמשים במפתח עם הרשאות כתיבה.
אופציה מקומית עם Docker
מי שמעדיף שהשרת ירוץ על המחשב שלו
- מתקינים את Docker ומוודאים שהוא פועל
- מריצים את פקודת ההוספה. בפעם הראשונה השרת פותח התחברות ל-GitHub בדפדפן, או משתמש במפתח אישי אם נותנים לו אחד
claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server
רישיון MIT ותחזוקה פעילה. דורש Docker מותקן ופועל במחשב.
בעצמכם: Personal Access Token מול ה-API של GitHub
מי שבונה אוטומציה מותאמת אישית בלי Claude Code ובלי MCP
- לוחצים על תמונת הפרופיל, בוחרים Settings ואז Developer settings
- תחת Personal access tokens בוחרים Fine-grained tokens ולוחצים Generate new token
- בוחרים ריפו והרשאות מינימליות ולוחצים Generate token
GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_xxx
קריאה ל-API עצמה חינמית בכל התוכניות. משתמש מאומת מקבל חמשת אלפים בקשות לשעה, לעומת שישים בלבד ללא אימות.
איך מחברים בלי לסכן את החשבון
- משתמשים ב-fine-grained token שמוגבל לריפו אחד ולקריאה בלבד, ולא ב-Token classic שפותח גישה לכל הריפואים
- מחברים בכתובת readonly, ועוברים לכתיבה רק אם באמת צריך, עם מפתח נפרד ובדיקה של כל פעולה
- שומרים את המפתח בקובץ מקומי ולא מדביקים אותו בצ'אט. אם הוא דלף, מוחקים אותו ב-Fine-grained tokens עם Delete
כמה זה עולה
קריאה ל API של GitHub חינמית בכל תוכנית, כולל החינמית. תוכניות בתשלום כמו Team ו Enterprise נותנות יכולות ארגוניות נוספות, ותוספי Copilot נמכרים בנפרד. פרטים מלאים ב github.com/pricing.
תקלות נפוצות
מתקבלת השגיאה Bad credentials
Claude Code מציג Leading or trailing whitespace in: headers.Authorization
מתקבלת השגיאה Resource not accessible by personal access token
Claude רואה רק ריפואים ציבוריים
Claude מנסה לפתוח issue ונכשל
שאלות ותשובות
יש מחבר מוכן של GitHub באתר של Claude?
צריך מנוי Copilot כדי להשתמש בחיבור?
מה ההבדל בין fine-grained token ל-Token classic?
אפשר להריץ את השרת בלי Docker?
כמה זה עולה?
מקורות. את העמוד כתב קורן בן עזרא לפי התיעוד הרשמי של GitHub ושל Anthropic, נכון ל-30.09.2026. ממשקים משתנים מהר, ולכן אם משהו נראה אחרת, התיעוד הרשמי הוא הקובע. המקורות: 1 · 2 · 3 · 4 · 5 · 6
