📘 תיעוד 29

סקירת קוד

תפסו באגים ב-pull requests ב-GitHub עם Code Review: Claude סוקר כל שינוי, מאמת את הממצאים שלו, ומוסיף הערות בשורה. לתוכניות Team ו-Enterprise

עם Code Review, Claude סוקר את ה-pull requests במאגרי GitHub שלכם. כמה סוכנים קוראים כל שינוי לצד הקוד שמסביב, ומחפשים בעיות כמו שגיאות לוגיקה, פרצות אבטחה, או מקרי קצה שבורים. שלב אימות בודק את הממצאים מול הקוד לפני שהם מדווחים.

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

[!NOTE]

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

כדי להפעיל את Code Review, Owner של ארגון Claude שלכם עוקב אחרי הגדרת Code Review. Claude יכול גם לסקור קוד בלי השירות הזה. הריצו /code-review בסשן Claude Code שלכם בכל תוכנית, או השוו את כל האפשרויות.

#זמינות

ודאו שהארגון שלכם עומד בתנאים לפני שאתם מגדירים את Code Review:

• תוכניות: Team ו-Enterprise
• מארחי קוד: מאגרים שמתארחים ב-GitHub, כולל GitHub Enterprise Server ו-GitHub Enterprise Cloud עם data residency. עבור data residency, על Owner לעקוב אחרי הגדרת המנהל של GitHub Enterprise Server ולהזין את שם המארח ghe.com של ה-enterprise שלכם.
• שמירת נתונים: Code Review לא זמין לארגונים שבהם Zero Data Retention מופעל או שתצורת HIPAA חלה עליהם, והוא לא מכוסה תחת הסכם השותף העסקי (Business Associate Agreement, BAA) של Anthropic.
• מפתחות הצפנה: Code Review עדיין לא זמין לארגונים שמשתמשים במפתחות הצפנה בניהול הלקוח (CMEK).
• ספקי ענן: אתם צריכים ארגון Claude באחת מהתוכניות האלה גם אם המפתחים שלכם משתמשים ב-Claude Code דרך Amazon Bedrock, Agent Platform של Google Cloud, או Microsoft Foundry

#הגדרה ושימוש ב-Code Review

בחרו את הדף לפי מה שאתם צריכים לעשות:

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

#איך סקירות עובדות

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

סקירה רצה על תשתית Anthropic בארבעה שלבים:

1. איתור: כמה סוכנים בוחנים את ה-diff ואת הקוד שמסביב במקביל.
2. אימות: שלב אימות בודק את הממצאים המועמדים מול הקוד ומסנן החוצה תוצאות חיוביות שגויות.
3. דירוג: הממצאים שנשארים עוברים הסרת כפילויות ומדורגים לפי חומרה.
4. פרסום: הסקירה מפרסמת את התוצאות שלה על ה-pull request.

כל סקירה משאירה את אלה על ה-pull request:

• ממצאים: הערות בשורה על השורות הנוגעות בדבר, עם סיכום בגוף הסקירה
• check run: בשם Claude Code Review, והממצאים רשומים בפרטים שלו. ה-check run לא מסתיים ככישלון.
• הערה במקום ממצאים: מתפרסמת כשכותרת ה-check run היא Code review found no issues

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

אחרי ש-Owner מפעיל את Code Review, לכל מאגר יש הגדרה למועד הרצת הסקירות: פעם אחת כש-pull request נפתח, אחרי כל push, או רק לפי בקשה. בכל אחת מהאפשרויות, מישהו עם גישת כתיבה למאגר יכול להגיב @claude review על pull request כדי להתחיל סקירה.

#רמות סקירה

רמת הסקירה קובעת כמה יסודית כל סקירה, וסקירה יסודית יותר עולה יותר:

• Quick: מעבר קל יותר. הרמה המהירה ביותר, בעלות הנמוכה ביותר.
• Standard: עומק, מהירות ועלות מאוזנים. רמת ברירת המחדל.
• Deep: המעבר היסודי ביותר. נמשך הכי הרבה זמן ועולה הכי הרבה.

Owner בוחר רמה אחת לארגון ויכול לתת למאגר בודד רמה משלו, למשל Quick לבסיס קוד שגרתי ו-Deep לבסיס קוד קריטי. למה עוד קובע את העלות של כל סקירה, ראו עלויות ושימוש ב-Code Review.

#למה יש לסקירה גישה

סקירה מגיעה למאגר שלכם דרך Claude GitHub App ש-Owner מתקין במהלך ההגדרה:

• איפה זה רץ: על תשתית Anthropic, בסביבה מנוהלת. סקירות לא רצות בסביבות באירוח עצמי.
• מה זה קורא וכותב: בתוך סקירה, הגישה למאגר שלכם היא לקריאה בלבד, וסקירה לא דוחפת commits. על ה-pull request היא מפרסמת הערות ואת ה-check run, פותרת שרשורי הערות קודמים שלה, ויכולה להגיב לפקודת תגובה ב-👀. לאפליקציה עצמה יש סט הרשאות רחב יותר שתכונות אחרות של Claude חולקות.
• איך זה בוחן את הקוד שלכם: סקירה עובדת מקריאה של ה-diff ושל הקוד שמסביב, בלי לבנות את הקוד שלכם ובלי להריץ אותו.

#מי שולט בסקירה

• מי יכול להתחיל סקירה: במקום שבו סקירות רצות אוטומטית, פתיחה של pull request או push אליו מתחילים סקירה, למעט טיוטות ו-forks. אחרי חלק מה-push, Code Review שומר את התוצאה הקודמת במקום. פקודת תגובה מתחילה סקירה רק כשהיא מגיעה מאדם עם גישת כתיבה למאגר.
• אילו הוראות היא עוקבת אחריהן: REVIEW.md מענף הבסיס או מענף ברירת המחדל, ולעולם לא מהשינויים של ה-pull request עצמו.

#השוואה בין דרכים לקבל סקירה

כדי למצוא את האפשרויות שפתוחות בפניכם, בדקו את העמודה מי יכול להשתמש בזה מול התוכנית ומארח הקוד שלכם:

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

• GitHub Enterprise Server: שימוש ב-Code Review עם מופע GitHub באירוח עצמי
• הרשאות GitHub App: סט ההרשאות המלא ש-Claude GitHub App מבקש
• איך Anthropic מאבטחת את מחזור חיי פיתוח התוכנה מבוסס הבינה המלאכותית שלה: איך סקירה אוטומטית משתלבת כשכבה אחת בתהליך הפיתוח המאובטח של Anthropic