📘 תיעוד 30

הגדרת Code Review

הפעלת Code Review לארגון Claude שלך: חיבור GitHub, התקנת Claude GitHub App, בחירת מאגרים, והגדרה מתי הסקירות רצות

כ-Owner של ארגון Claude שלך, מפעילים את Code Review בAdmin settings > Claude Code ב-claude.ai. הסקירות רצות על תשתית של Anthropic, ולכן לא מוסיפים קובצי workflow למאגרים.

אחרי ההגדרה, בוחרים כמה הסקירות מעמיקות ומתי הן רצות בכל מאגר. מוציאים יותר ברמת סקירה גבוהה יותר וכשהסקירות רצות לעתים קרובות יותר. ראו עלויות Code Review.

#מה צריך כדי להפעיל את Code Review

קודם בודקים שהארגון עומד בתנאי Code Review. אחר כך מוודאים שיש את הגישה הזו, או מישהו שיש לו אותה:

#הפעלת Code Review

1. לחצו על מתג Allow code review

עברו לאזור Code review בAdmin settings > Claude Code ולחצו על מתג Allow code review.

אם Code Review נדלק מיד בלי תיבת דו שיח, לארגון כבר מקושר Claude GitHub App או שכבר נוספו מאגרים. עברו אל הוספת מאגרים נוספים, ואז חזרו לשלב האחרון.

2. חיבור חשבון GitHub

אם נפתחת תיבת דו שיח Connect GitHub, לחצו Connect. אם הארגון משתמש ב-GitHub Enterprise Server, בחרו קודם את המופע בתיבת הדו שיח. GitHub מבקש לאשר את Claude, ואז מחזיר לדף הניהול כשתיבת הדו שיח Add a repository פתוחה.

אם Add a repository נפתח מיד, החשבון כבר מחובר, ולכן ממשיכים לשלב הבא.

3. התקנת Claude GitHub App

אם המאגרים הרצויים מופיעים בתיבת הדו שיח Add a repository, או שמוצאים אותם בחיפוש שם, ממשיכים לשלב הבא. תיבת הדו שיח מציגה מאגר רק אם Claude GitHub App יכולה לגשת אליו, ולכן אם הם לא שם, מתקינים את האפליקציה:

• לחצו Install GitHub App. כשאין מאגרים ברשימה, זה כפתור בתיבת הדו שיח. אחרת, הוא בתחתית תפריט הסינון של ארגון GitHub בתיבת הדו שיח. דף ההתקנה של GitHub נפתח בלשונית חדשה.
• בחרו את ארגון GitHub שבבעלותו המאגרים.
• בחרו לאילו מאגרים האפליקציה יכולה לגשת.
• אשרו את ההרשאות המבוקשות. הסט רחב ממה שסקירה משתמשת בו, ומשותף לתכונות Claude אחרות, כגון GitHub Actions. ראו למה סקירה יכולה לגשת ואת רשימת ההרשאות המלאה.
• כשההתקנה מסתיימת, הלשונית חוזרת ל-Claude. אם מופיע כפתור Finish connecting GitHub, לחצו עליו כדי לקשר את ההתקנה לארגון Claude.
• חזרו ללשונית של דף הניהול, שם הרשימה בתיבת הדו שיח מתרעננת.

4. בחירת מאגרים

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

5. לחצו Finish

אחרי זה מופיעה תיבת דו שיח Code review is set up. לחצו Finish כדי להפעיל את Code Review. אם סוגרים את תיבת הדו שיח בדרך אחרת, המאגרים נשארים נוספים אבל Allow code review נשאר כבוי, ומפעילים אותו מהמתג.

כל מאגר מתחיל בהגדרה לסקירה אחרי כל push, וזה מריץ הכי הרבה סקירות. כדי להריץ פחות, הגדירו מתי הסקירות רצות.

6. אימות עם pull request לבדיקה

פתחו pull request לבדיקה באחד המאגרים שהוספתם, ואל תסמנו אותו כטיוטה. check run בשם Claude Code Review מופיע תוך כמה דקות. אם כבר הגדרתם את המאגר ל-Manual (@claude review), כתבו תגובה @claude review ב-pull request כדי להתחיל את הסקירה הראשונה.

אם לא מופיע check run, ראו לא מופיע check run ב-pull request לבדיקה.

אחרי שהסקירה מגיעה, שלחו למפתחים את קריאה ובקשת סקירות ב-pull request, שמכסה את רמות החומרה, פקודות התגובה, ואיך להגיב על ממצאים.

#הגדרת ברירות מחדל לארגון

כ-Owner, מחליטים כמה הסקירות מעמיקות ובאיזו תדירות הן רצות. שניהם באזור Code review בAdmin settings > Claude Code.

#הגדרת רמת הסקירה כברירת מחדל

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

• ברירת מחדל של הארגון: בחרו רמה תחת Review level ואשרו עם Change level. כל מאגר משתמש בה אלא אם נותנים למאגר הזה רמה משלו.
• מאגר אחד: לחצו Edit בשורת המאגר, ואז בחרו שם Review level. האפשרות הראשונה, Default, עוקבת אחרי הארגון. הרמה נשמרת ברגע שבוחרים אותה.

רמה חדשה חלה על סקירות שמתחילות אחרי השינוי. למה עוד משפיע על העלות של כל סקירה, ראו עלויות Code Review ושימוש.

#הגדרה מתי הסקירות רצות {#set-when-reviews-run}

לכל מאגר יש הגדרת Review runs משלו, שקובעת מתי ה-pull requests שלו נסקרים.

• Once after PR creation: סקירה רצה כש-pull request נפתח, נפתח מחדש, או מסומן כמוכן לסקירה
• After every push: סקירה רצה על push לענף של ה-pull request, תופסת בעיות חדשות כשה-pull request מתפתח ופותרת אוטומטית שרשורים כשמתקנים בעיות שסומנו
• Manual (@claude review): פתיחה או push ל-pull request לא מתחילים סקירה. כתבו תגובה @claude review כדי לבקש אחת, או @claude review always כדי גם לרשום את ה-pull request לסקירות ב-push הבאים.

Manual שימושי למאגרים עם תנועה גבוהה שבהם רוצים לבחור pull requests מסוימים לסקירה, או כדי להתחיל לסקור pull requests רק כשהם מוכנים. כדי להשוות מה כל אפשרות עושה להוצאה, ראו באיזו תדירות הסקירות רצות.

כדי לשנות את ההגדרה, לחצו Edit בשורת המאגר בטבלת Repositories ובחרו אפשרות Review runs. הבחירה נשמרת ברגע שבוחרים אותה, ועמודת Review runs בטבלה מציגה אותה בקיצור: Once per PR, Every push, או Manual.

• טיוטות ו-pull requests מ-forks: בכל אפשרות שבוחרים, סקירות אוטומטיות מדלגות על שתיהן
• מאגרים חדשים: מאגר שמוסיפים מתיבת הדו שיח Add a repository מתחיל ב-After every push. אם ארגון GitHub שלו מכוסה כולו, הוא מקבל את ההגדרה של שורת הארגון במקום זאת.

#הפעלה או כיבוי של תגובות טיפ

תגובת טיפ היא תגובה קצרה ש-Claude מפרסם ב-pull request כשלא מתחילה סקירה, ואומרת למה ומה לעשות אחר כך. Show tips on pull requests פועל כברירת מחדל. כשהוא פועל, Claude מפרסם טיפ בכל אחד מהמקרים האלה, ומסביר:

• המאגר מוגדר ל-Manual: איך לבקש סקירה בתגובה
• ה-pull request מגיע מ-fork: שמתחזק יכול לבקש את הסקירה
• בוט, או מישהו בלי הרשאת כתיבה שאינו מחבר ה-pull request, מגיב @claude review: שלא התחילה סקירה, ומי יכול לבקש אחת
• ארגון GitHub לא מקושר לארגון Claude: שהסקירות מושהות, ואיך לקשר אותו

כבו את ההגדרה כדי לעצור את התגובות האלה.

#מה מפתחים יכולים לשנות

מפתחים פונים אליכם כדי לשנות את רמת הסקירה, את הגדרת Review runs, או אילו מאגרים מקבלים סקירות. מ-GitHub, בלי תפקיד Owner, הם יכולים לעשות את אלה:

• לבקש סקירה: לכתוב תגובה @claude review ב-pull request. זה דורש הרשאת כתיבה למאגר, וזה עובד על טיוטות ו-pull requests מ-forks, שסקירות אוטומטיות מדלגות עליהם.
• לרשום pull request אחד לסקירה בכל push: לכתוב תגובה @claude review always ב-pull request שאינו טיוטה או מ-fork, למשל במאגר שמוגדר ל-Manual
• לשנות מה הסקירות מסמנות: לבצע commit של הקבצים REVIEW.md ו-CLAUDE.md למאגר, למשל כדי להוסיף בדיקה

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

#ניהול מאגרים

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

#הוספת מאגרים נוספים {#add-more-repositories}

כדי להוסיף מאגרים אחרי ההגדרה, לחצו Add מעל טבלת Repositories באזור Code review. נפתחת תיבת הדו שיח Add a repository. בחרו מאגרים ולחצו Continue.

• מאגר לא מופיע ברשימה: ראו מאגר לא מופיע ב-Add a repository.
• רוצים כל מאגר בארגון GitHub: כסו את הארגון במקום לבחור מאגרים אחד אחד

#כיסוי ארגון GitHub שלם {#cover-a-whole-github-organization}

כדי להפעיל Code Review לכל מאגר בארגון GitHub, הגדירו Review runs בשורת הארגון בטבלת Repositories. זה מכסה כל מאגר שם ש-Claude GitHub App יכולה לגשת אליו, כולל מאגרים שנוספים אחר כך. זה יכול להעלות את ההוצאה במידה משמעותית. זה דורש את כל אלה:

• חשבון GitHub שחיברתם ל-Claude הוא owner של ארגון GitHub הזה.
• הארגון נמצא ב-github.com. מופעים של GitHub Enterprise Server וחשבונות GitHub אישיים לא זכאים.
• מוגדרת מגבלת הוצאה חודשית, לארגון Claude או ל-Code Review.

כדי לכסות את הארגון, לחצו Edit בשורה שלו, בחרו אפשרות Review runs, ואשרו. האפשרויות הן שלוש מהגדרה מתי הסקירות רצות ועוד Off.

אחרי האישור, השינויים האלה נכנסים לתוקף:

• כיסוי: כל מאגר מכוסה מה-pull request הבא שלו. אם Claude GitHub App הותקנה על מאגרים נבחרים ולא על כולם, Claude סוקר את המאגרים האלה. שנו את גישת האפליקציה למאגרים ב-GitHub כדי לכסות את השאר.
• הגדרות קיימות: כל מאגר בארגון GitHub הזה מקבל את האפשרות שבוחרים, כולל מאגרים שהוגדרו בנפרד. הגדרת השורה שוב עושה את אותו הדבר. מאגרים שכיביתם בשורות שלהם נשארים כבויים.
• שינויים פרטניים אחר כך: מאגר שמגדירים אחר כך באופן שונה מהארגון שלו מסומן Custom בטבלה.
• רמת סקירה: לשורת ארגון אין רמת סקירה משלה.

#כיבוי Code Review או הסרת מאגר

באזור Code review בAdmin settings > Claude Code, בחרו את הפקד שמתאים למה שרוצים לעצור:

• מאגר אחד, והשארה שלו ברשימה: לחצו Edit בשורה שלו וכבו את Code review. הטבלה מציגה את המאגר כ-Off.
• מאגר אחד, והסרה שלו: לחצו Edit בשורה שלו, ואז Remove repository בתחתית תיבת הדו שיח. הסקירות נעצרות שם, וארגון Claude אחר יכול אחר כך להגדיר את המאגר. כל עוד ארגון GitHub של המאגר מכוסה כולו, אי אפשר להסיר אותו. כבו במקום זאת את מתג Code review שלו.
• ארגון GitHub שלם: לחצו Edit בשורת הארגון ובחרו Off. זה גם מכבה מאגרים בארגון הזה שהוספתם אחד אחד.
• הכל: כבו את Allow code review. לא מתחילות סקירות חדשות באף מאגר, ורשימת המאגרים נשארת כדי שאפשר יהיה להפעיל שוב אחר כך.

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

• עלויות Code Review ושימוש: איך רמת הסקירה ומתי הסקירות רצות משפיעים על ההוצאה, איך להגדיר מגבלת הוצאה, ואיפה לראות שימוש
• קריאה ובקשת סקירות ב-pull request: מה מפתחים רואים ב-pull request ופקודות התגובה
• התאמה אישית של Code Review: כוונון של מה ש-Claude מסמן עם REVIEW.md ו-CLAUDE.md
• GitHub Enterprise Server: חיבור מופע GitHub באירוח עצמי לפני ההגדרה