📘 תיעוד 29

סקירת קוד

הגדרת סקירות PR אוטומטיות שמזהות שגיאות לוגיות, פגיעויות אבטחה ונסיגות (regressions) באמצעות ניתוח מרובה סוכנים של כל בסיס הקוד שלך.

הערה: Code Review נמצא בתצוגה מקדימה למחקר (research preview), וזמין למנויי Team ו-Enterprise. הוא אינו זמין לארגונים שבהם מופעל Zero Data Retention. בתוכניות אחרות, עדיין ניתן לסקור diff באופן מקומי באמצעות הפקודה /code-review.

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

הממצאים מתויגים לפי רמת חומרה ואינם מאשרים או חוסמים את ה-PR שלך, כך שתהליכי הסקירה הקיימים נשארים ללא שינוי. ניתן לכוונן את מה ש-Claude מסמן על ידי הוספת קובץ CLAUDE.md או REVIEW.md למאגר שלך.

כדי להריץ את Claude בתשתית ה-CI שלך במקום להשתמש בשירות מנוהל זה, ראה GitHub Actions או GitLab CI/CD. עבור מאגרים במופע GitHub באירוח עצמי (self-hosted), ראה GitHub Enterprise Server.

דף זה מכסה:

• כיצד פועלות סקירות
• הגדרה
• הפעלת סקירות באופן ידני באמצעות @claude review ו-@claude review always
• התאמה אישית של סקירות באמצעות CLAUDE.md ו-REVIEW.md
• תמחור
• פתרון בעיות עבור ריצות שנכשלו והערות חסרות
• סקירת diff באופן מקומי באמצעות הפקודה /code-review

#כיצד פועלות סקירות

ברגע שבעלים (Owner) מפעיל את Code Review עבור הארגון שלך, סקירות מופעלות בעת פתיחת PR, בכל דחיפה (push), או כאשר מבקשים זאת ידנית, בהתאם להתנהגות המוגדרת של המאגר. כתיבת תגובה עם @claude review מתחילה סקירה על PR בכל מצב.

כאשר סקירה רצה, מספר סוכנים מנתחים במקביל את ה-diff ואת הקוד שמסביבו בתשתית של Anthropic. כל סוכן מחפש סוג שונה של בעיה, ולאחר מכן שלב אימות בודק מועמדים מול התנהגות הקוד בפועל כדי לסנן תוצאות חיוביות שגויות (false positives). התוצאות עוברות הסרת כפילויות, מדורגות לפי רמת חומרה, ומפורסמות כהערות בתוך השורות בשורות הספציפיות שבהן נמצאו בעיות, עם סיכום בגוף הסקירה. אם לא נמצאו בעיות, Code Review מעדכן את ה-check run ב-GitHub כדי להראות שלא זוהו בעיות. Claude עשוי גם לפרסם תגובת אישור קצרה ב-PR.

עלות הסקירות משתנה בהתאם לגודל ה-PR ולמורכבותו, והן מסתיימות בממוצע תוך 20 דקות. בעלי תפקיד Owner יכולים לעקוב אחר פעילות הסקירות וההוצאות דרך לוח הבקרה של הניתוח.

#רמות חומרה

כל ממצא מתויג ברמת חומרה:

הממצאים כוללים מקטע נימוק מורחב שניתן לכיווץ, שתוכל להרחיב כדי להבין מדוע Claude סימן את הבעיה וכיצד הוא אימת אותה.

#דירוג ממצאים ומענה עליהם

כל הערת סקירה מ-Claude מגיעה כאשר הסימונים 👍 ו-👎 כבר מצורפים אליה, כך ששני הכפתורים מופיעים בממשק של GitHub לדירוג בלחיצה אחת. לחץ על 👍 אם הממצא היה מועיל, או על 👎 אם הוא היה שגוי או רועש. חברת Anthropic אוספת את ספירת התגובות לאחר מיזוג ה-PR ומשתמשת בהן כדי לכוונן את הסוקר. תגובות אלו אינן מפעילות סקירה מחדש ואינן משנות דבר ב-PR.

מענה להערה בתוך השורה אינו גורם ל-Claude להגיב או לעדכן את ה-PR. כדי לפעול על פי ממצא, תקן את הקוד ובצע דחיפה (push). אם ה-PR מנוי לסקירות המופעלות בדחיפה, הריצה הבאה תסמן את השרשור כפתור (resolves the thread) כאשר הבעיה תתוקן. כדי לבקש סקירה חדשה מבלי לדחוף קוד, כתוב תגובה עם @claude review כתגובת PR ברמה העליונה.

#פלט ה-check run

מעבר להערות הסקירה בתוך השורות, כל סקירה מעדכנת את בדיקת ה-check run של Claude Code Review שמופיעה לצד בדיקות ה-CI שלך. הרחב את הקישור Details שלה כדי לראות סיכום של כל ממצא במקום אחד, ממוין לפי רמת חומרה:

כל ממצא מופיע גם כהערה (annotation) בלשונית Files changed, מסומן ישירות על גבי שורות ה-diff הרלוונטיות. ממצאים ברמת Important מוצגים עם סימון אדום, הערות Nit מוצגות עם אזהרה צהובה, ובאגים מסוג Pre-existing מוצגים עם הודעה אפורה. ההערות וטבלת החומרה נכתבות ל-check run באופן עצמאי וללא תלות בהערות הסקירה שבתוך השורות, כך שהן נשארות זמינות גם אם GitHub דוחה הערה בתוך השורה בשל שורה שזזה.

ה-check run מסתיים תמיד במסקנה ניטרלית (neutral conclusion), כך שהוא לעולם אינו חוסם מיזוג דרך כללי הגנת ענפים (branch protection rules). אם ברצונך להתנות מיזוגים בממצאי Code Review, קרא את פירוט החומרה מפלט ה-check run ב-CI שלך. השורה האחרונה בטקסט של Details היא הערה קריאה למכונה שתהליך העבודה שלך יכול לנתח באמצעות gh ו-jq. כדי למצוא את מזהה ה-check run, הצג את בדיקות ה-check run של ה-commit באמצעות gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}' וקח את ה-id של הריצה Claude Code Review. החלף את OWNER, REPO ו-CHECK_RUN_ID בבעלי המאגר שלך, שם המאגר והמזהה הזה:

gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

פקודה זו מחזירה אובייקט JSON עם ספירות לפי רמת חומרה, לדוגמה {"normal": 2, "nit": 1, "pre_existing": 0}. המפתח normal מחזיק את ספירת ממצאי ה-Important. ערך שאינו אפס אומר ש-Claude מצא לפחות באג אחד ששווה לתקן לפני המיזוג.

#מה Code Review בודק

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

#הגדרת Code Review

בעל תפקיד Owner מפעיל את Code Review פעם אחת עבור הארגון ובוחר אילו מאגרים לכלול.

1. פתח את הגדרות הניהול של Claude Code: עבור אל claude.ai/admin-settings/claude-code ומצא את המקטע Code Review. דרוש לך תפקיד Owner או Primary Owner בארגון ה-Claude שלך, והרשאה להתקין אפליקציות GitHub בארגון ה-GitHub שלך.

2. התחל בהגדרה: לחץ על Setup. פעולה זו מתחילה את תהליך ההתקנה של אפליקציית GitHub.

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

   כדי לסקור בקשת משיכה, Claude קורא את תוכן המאגר שלך דרך גישת הקריאה של האפליקציה, ומפרסם הערות ואת ה-check run דרך גישת הכתיבה שלו לבקשות משיכה ולבדיקות. במהלך ההתקנה, אתה מעניק קבוצת הרשאות רחבה יותר המשותפת לתכונות נוספות של Claude, כגון GitHub Actions. ראה הרשאות GitHub App לרשימה המלאה.

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

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

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

   בכל אפשרות שתבחר, Claude סוקר בקשת משיכה מ-fork רק כאשר מישהו כותב עליה תגובה עם @claude review.

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

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

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

#הפעלת סקירות באופן ידני

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

השתמש ב-@claude review always כאשר אתה רוצה שכל דחיפה עוקבת ל-PR תתחיל סקירה חדשה, למשל ב-PR בעדיפות גבוהה במאגר שמוגדר למצב Manual. מכיוון שהפקודה הבסיסית אינה רושמת את ה-PR, באפשרותך לבקש חוות דעת שנייה באופן חד פעמי מבלי לשנות את האופן שבו דחיפות מאוחרות יותר יפעילו סקירות.

הערה: לפני עדכון מיולי 2026, הפקודה @claude review רשמה את ה-PR לסקירות המופעלות בדחיפה. אם הסתמכת על התנהגות זו, כתוב בתגובה @claude review always במקום זאת. הפקודה @claude review once עדיין עובדת ומתנהגת בדיוק כמו הפקודה הבסיסית.

כדי שכל אחת מהפקודות הללו תפעיל סקירה:

• פרסם אותה כתגובת PR ברמה העליונה, לא כהערה בתוך השורה על גבי שורת diff
• מקם את הפקודה בתחילת התגובה, כאשר once או always באותה שורה עם שאר הפקודה
• חייבות להיות לך הרשאות כתיבה (write), תחזוקה (maintain) או ניהול (admin) במאגר
• ה-PR חייב להיות פתוח

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

בשונה מטריגרים אוטומטיים, טריגרים ידניים רצים גם על טיוטות PR (draft PRs), מכיוון שבקשה מפורשת מסמנת שאתה מעוניין בסקירה כעת ללא קשר למצב הטיוטה.

אם סקירה כבר רצה על אותו PR, הבקשה נכנסת לתור עד להשלמת הסקירה שנמצאת בעיצומה. ניתן לעקוב אחר ההתקדמות דרך ה-check run ב-PR.

#סקירת בקשות משיכה מ-forks

Claude אינו סוקר בקשת משיכה מ-fork באופן אוטומטי, ללא קשר להגדרת Review Behavior של המאגר. כדי להתחיל סקירה, כתוב תגובה עם @claude review על גבי בקשת המשיכה. הדרישות לפקודות תגובה עדיין חלות, וגישת הכתיבה הנדרשת היא למאגר הבסיס, ולא ל-fork.

כדי לקבל סקירה נוספת של בקשת משיכה מ-fork, פרסם תגובה חדשה עם @claude review. גם הפקודה @claude review always עובדת, אך אינה רושמת את בקשת המשיכה לסקירות בדחיפות מאוחרות יותר. שום דבר מלבד פקודת תגובה אינו מתחיל סקירה על בקשת משיכה מ-fork:

• לחיצה על Re-run ב-check run אינה מתחילה סקירה
• דחיפת commits חדשים אינה מתחילה סקירה, אפילו במאגר שמוגדר ל-After every push

#התאמה אישית של סקירות

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

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

#CLAUDE.md

הכלי Code Review קורא את קובצי ה-CLAUDE.md של המאגר שלך ומתייחס להפרות חדשות שהוכנסו כממצאים ברמת nit. הדבר עובד בשני הכיוונים: אם ה-PR שלך משנה קוד באופן שהופך הצהרה ב-CLAUDE.md למיושנת, Claude מסמן שגם את התיעוד יש לעדכן.

Claude קורא קובצי CLAUDE.md בכל רמה בהיררכיית התיקיות שלך, כך שכללים ב-CLAUDE.md של תיקיית משנה חלים רק על קבצים תחת אותו נתיב. עיין בתיעוד הזיכרון (memory) למידע נוסף על אופן הפעולה של CLAUDE.md.

עבור הנחיות ספציפיות לסקירה שאינך רוצה שיוחלו על הפעלות כלליות של Claude Code, השתמש ב-REVIEW.md במקום זאת.

#REVIEW.md

הקובץ REVIEW.md הוא קובץ בשורש המאגר שלך שמתאים את Code Review למאגר שלך. הסוכנים בצינור הסקירה (review pipeline) שמוצאים ומאמתים ממצאים מקבלים את תוכנו כהנחיות הסקירה של המאגר שלך, לצד הנחיות ברירת המחדל של Code Review. הסוכנים שמדרגים ומדווחים על ממצאים מתייעצים בו לפני קביעת החומרה וכתיבת הסקירה.

הסוכנים קוראים את טקסט הקובץ כפי שהוא, כך ש-REVIEW.md הוא הנחיות פשוטות: תחביר ייבוא @ אינו מורחב, וקבצים שמצוינים בו אינם נקראים יחד איתו. שים את הכללים שברצונך לאכוף ישירות בתוך הקובץ.

#מה ניתן לכוונן

הקובץ REVIEW.md הוא markdown במבנה חופשי, כך שכל דבר שתוכל לבטא כהנחיית סקירה נמצא בטווח האפשרי. לדפוסים הבאים יש את ההשפעה הרבה ביותר בפועל.

חומרה (Severity): הגדר מחדש מה המשמעות של 🔴 Important עבור המאגר שלך. כיול ברירת המחדל מכוון לקוד ייצור, מאגר תיעוד, מאגר תצורה או אב טיפוס עשויים לרצות הגדרה צרה בהרבה. ציין במפורש אילו סוגי ממצאים הם Important ואילו הם Nit לכל היותר. ניתן גם להחמיר בכיוון ההפוך, למשל להתייחס לכל הפרה של CLAUDE.md כאל Important במקום ברירת המחדל של nit.

נפח ה-Nits: הגבל את מספר הערות ה-🟡 Nit שסקירה בודדת מפרסמת. קובצי מלל ותצורה אפשר ללטש בלי סוף. מגבלה כמו "דווח על לכל היותר חמש הערות nit, וציין את השאר כמספר בסיכום" שומרת על הסקירות מעשיות.

כללי דילוג (Skip rules): ציין נתיבים, דפוסי ענפים וקטגוריות ממצאים שבהם Claude לא צריך לפרסם שום ממצאים. מועמדים נפוצים הם קוד שנוצר אוטומטית (generated code), קובצי נעילה (lockfiles), תלויות מוטמעות (vendored dependencies) וענפים שנכתבו על ידי מכונה, לצד כל דבר שה-CI שלך כבר אוכף כגון linting או בדיקת איות. עבור נתיבים שמצדיקים סקירה מסוימת אך לא בדיקה מדוקדקת מלאה, קבע רף גבוה יותר במקום לדלג לחלוטין: "ב-scripts/, דווח רק אם יש ודאות כמעט מוחלטת והבעיה חמורה".

בדיקות ייעודיות למאגר (Repo-specific checks): הוסף כללים שברצונך שיסומנו בכל PR, כגון "נתיבי API חדשים חייבים לכלול בדיקת אינטגרציה". מכיוון ש-REVIEW.md מגיע ישירות לכל סוכן מציאה ואימות, כללים אלה מיושמים באופן אמין יותר מאשר אותם כללים בקובץ CLAUDE.md ארוך.

רף אימות (Verification bar): דרוש ראיות לפני פרסום סוג מסוים של ממצא. לדוגמה, "טענות לגבי התנהגות דורשות ציטוט של file:line במקור, ולא הסקה מתוך שמות" מפחית תוצאות חיוביות שגויות שאלמלא כן היו גוזלות מהכותב סבב עבודה נוסף.

התכנסות בסקירה חוזרת (Re-review convergence): הנחה את Claude כיצד להתנהג כאשר PR כבר נסקר. כלל כמו "לאחר הסקירה הראשונה, השקט הערות nit חדשות ופרסם ממצאי Important בלבד" מונע מתיקון של שורה אחת להגיע לסבב שביעי בגלל סגנון בלבד.

מבנה הסיכום (Summary shape): בקש שגוף הסקירה ייפתח בסיכום בשורה אחת כגון 2 factual, 4 style, ושיפתח ב-"ללא בעיות עובדתיות" כאשר זהו המצב. הכותב רוצה לדעת את תמונת המצב הכללית של העבודה לפני הפרטים.

#דוגמה

קובץ REVIEW.md זה מכייל מחדש את רמת החומרה עבור שירות backend, מגביל הערות nit, מדלג על קבצים שנוצרו אוטומטית, ומוסיף בדיקות ייעודיות למאגר.

# Review instructions

## What Important means here

Reserve Important for findings that would break behavior, leak data,
or block a rollback: incorrect logic, unscoped database queries, PII
in logs or error messages, and migrations that aren't backward
compatible. Style, naming, and refactoring suggestions are Nit at
most.

## Cap the nits

Report at most five Nits per review. If you found more, say "plus N
similar items" in the summary instead of posting them inline. If
everything you found is a Nit, lead the summary with "No blocking
issues."

## Do not report

- Anything CI already enforces: lint, formatting, type errors
- Generated files under `src/gen/` and any `*.lock` file
- Test-only code that intentionally violates production rules

## Always check

- New API routes have an integration test
- Log lines don't include email addresses, user IDs, or request bodies
- Database queries are scoped to the caller's tenant

#שמור על הקובץ ממוקד

לאורך יש מחיר: קובץ REVIEW.md ארוך מדלל את הכללים החשובים ביותר. הגבל אותו להנחיות שמשנות את התנהגות הסקירה, והשאר הקשר פרויקט כללי ב-CLAUDE.md.

#צפייה בשימוש

עבור אל claude.ai/analytics/code-review כדי לראות את פעילות Code Review בארגון שלך. לוח הבקרה מציג:

נתוני העלות בלוח הבקרה הם הערכות לצורך מעקב אחר פעילות. לקבלת נתוני הוצאה מדויקים לצורך חשבונית, עיין בחשבונית של Anthropic.

#תמחור

החיוב עבור Code Review מתבסס על שימוש באסימונים (tokens). כל סקירה עולה בממוצע 15 עד 25 דולר, ומשתנה בהתאם לגודל ה-PR, מורכבות בסיס הקוד ומספר הבעיות הדורשות אימות. השימוש ב-Code Review מחויב בנפרד דרך קרדיטים לשימוש (usage credits) ואינו נספר כחלק מהשימוש הכלול בתוכנית שלך.

טריגר הסקירה שתבחר משפיע על העלות הכוללת:

• Once after PR creation: רץ פעם אחת לכל PR
• After every push: רץ בכל דחיפה, ומכפיל את העלות במספר הדחיפות
• Manual: אין סקירות בעת פתיחה או דחיפה, כך שהעלות מצטברת רק מסקירות שמישהו מבקש

במצב Once after PR creation או במצב Manual, כתיבת תגובה עם @claude review always מצרפת את ה-PR לסקירות המופעלות בדחיפה, כך שעלות נוספת מצטברת בכל דחיפה שלאחר תגובה זו. במצב After every push, דחיפות כבר מפעילות סקירות, כך שההרשמה אינה משנה את העלות לכל דחיפה. כתיבת תגובה עם @claude review מריצה סקירה יחידה מבלי להירשם לדחיפות עתידיות. Claude סוקר בקשת משיכה מ-fork רק כאשר מישהו כותב תגובה עם @claude review, כך שבקשת משיכה מ-fork לעולם אינה צוברת עלות לכל דחיפה באף מצב.

העלויות מופיעות בחשבונית של Anthropic ללא קשר לשאלה אם הארגון שלך משתמש ב-Amazon Bedrock או ב-Google Cloud's Agent Platform עבור תכונות אחרות של Claude Code. כדי להגדיר תקרת הוצאה חודשית עבור Code Review, עבור אל claude.ai/admin-settings/usage והגדר את המגבלה עבור שירות Claude Code Review.

עקוב אחר ההוצאות דרך תרשים העלות השבועי ב-ניתוח (analytics) או בעמודת העלות הממוצעת לכל מאגר בהגדרות הניהול.

#פתרון בעיות

ריצות סקירה פועלות במתכונת של מאמץ מרבי (best-effort). ריצה שנכשלה לעולם אינה חוסמת את ה-PR שלך, אך היא גם אינה מנסה שוב מעצמה. מקטע זה מכסה כיצד להתאושש מריצה שנכשלה והיכן לחפש כאשר ה-check run מדווח על בעיות שאינך מוצא.

#הפעלה מחדש של סקירה שנכשלה או שזמנה פג

כאשר תשתית הסקירה נתקלת בשגיאה פנימית או חורגת ממגבלת הזמן שלה, ה-check run מסתיים עם הכותרת Code review encountered an error או Code review timed out. המסקנה היא עדיין ניטרלית, כך ששום דבר אינו חוסם את המיזוג שלך, אך לא מפורסמים ממצאים.

כדי להריץ את הסקירה שוב, כתוב תגובה עם @claude review על גבי ה-PR. פעולה זו מתחילה סקירה חדשה מבלי לרשום את ה-PR לדחיפות עתידיות. אם ה-PR אינו מ-fork, תוכל במקום זאת ללחוץ על Re-run בבדיקת Claude Code Review בלשונית Checks ב-GitHub. הרצה מחדש מתחילה גם היא סקירה חדשה מבלי לרשום את ה-PR.

#הסקירה לא רצה וה-PR מציג הודעה על תקרת הוצאה

כאשר מגיעים לתקרת ההוצאה החודשית של הארגון שלך, Code Review מפרסם תגובה בודדת על גבי ה-PR המסבירה שהסקירה דולגה. הסקירות מתחדשות אוטומטית בתחילת תקופת החיוב הבאה, או באופן מיידי כאשר מנהל מעלה את התקרה בכתובת claude.ai/admin-settings/usage.

#איתור בעיות שאינן מופיעות כהערות בתוך השורות

אם כותרת ה-check run מציינת שנמצאו בעיות אך אינך רואה הערות סקירה בתוך השורות על גבי ה-diff, חפש במיקומים האחרים שבהם הממצאים מוצגים:

• פרטי ה-check run (Details): לחץ על Details לצד בדיקת Claude Code Review בלשונית Checks. טבלת החומרה מפרטת כל ממצא עם הקובץ, השורה והסיכום שלו ללא קשר לשאלה אם ההערה בתוך השורה התקבלה.
• הערות בלשונית Files changed (Annotations): פתח את הלשונית Files changed ב-PR. ממצאים מוצגים כהערות המצורפות ישירות לשורות ה-diff, בנפרד מהערות הסקירה.
• גוף הסקירה (Review body): אם דחפת קוד ל-PR בזמן שסקירה רצה, ייתכן שחלק מהממצאים מתייחסים לשורות שכבר אינן קיימות ב-diff הנוכחי. ממצאים אלה מופיעים תחת הכותרת Additional findings בטקסט גוף הסקירה ולא כהערות בתוך השורות.

#סקירת diff באופן מקומי

הפקודה /code-review סוקרת diff במסוף שלך ללא התקנת ה-GitHub App. היא מדווחת על באגים של נכונות (correctness) ועל ניקיונות של שימוש חוזר, פישוט ויעילות.

הפקודה /review היא כינוי (alias) עבור /code-review. לפני גרסה v2.1.223, היא הייתה פקודה נפרדת שהריצה סקירה לקריאה בלבד במעבר יחיד של בקשת משיכה ב-GitHub.

1. הרץ את /code-review: מההפעלה שבה אתה עובד, הרץ את הפקודה:

   העתק

   /code-review

   היא סוקרת את ה-commits של הענף שלך שמקדימים את ה-upstream שלו בתוספת שינויים שלא נשמרו (uncommitted changes), כך שנדרשת עבודה על הענף או בעץ העבודה כדי שיהיה לה על מה לדווח. כדי לסקור משהו אחר, העבר יעד: נתיב קובץ, מספר PR, שם ענף או טווח הפניות כגון main...my-feature.

   תוכל גם להוסיף דגלים:

   • --fix: מחיל את הממצאים על עץ העבודה שלך לאחר הסקירה
   • --comment: מפרסם את הממצאים כהערות בתוך השורות ב-PR
   • --post: בסקירת ענן מסוג ultra של בקשת משיכה ב-github.com, בוחר מראש פרסום של הממצאים שהסתיימו אל ה-PR בתיבת הדו שיח של ההפעלה. ראה פרסום ממצאים לבקשת המשיכה. דורש Claude Code בגרסה v2.1.227 ואילך

2. המשך לעבוד: הסקירה רצה כסוכן משנה (subagent) ברקע עם חלון הקשר משלו, כך שהיא אינה ממלאת את השיחה שלך. הממצאים מגיעים לשיחה שלך כאשר הסקירה מסתיימת.

3. פעל בהתאם לממצאים: בקש מ-Claude לתקן את מה שהסקירה מצאה. אם העברת את --fix או --comment, הסקירה כבר החילה או פרסמה את ממצאיה.

הכלי Claude מדווח על הממצאים כטקסט בתשובה בשתי הריצות הללו, גם כאשר יישום מארח מבקש את רשימת הממצאים המתוארת להלן:

• בהפעלת מסוף, שבה /code-review מריץ את הסקירה כסוכן משנה מפוצל (forked subagent)
• בריצה עם הדגל -p עם פלט טקסט או פלט JSON

ביישום מארח שמבקש את רשימת הממצאים, כגון אפליקציית שולחן העבודה, Claude מדווח על ממצאי הסקירה דרך הכלי ReportFindings במקום זאת. הכלי Claude Code מציג את הדוח כרשימת ממצאים, וכל רשומה מציגה את מיקום הקובץ, סיכום במשפט אחד ותגית קטגוריה כגון correctness כאשר הממצא נושא תגית כזו. בקשת מארח חלה בכל רמת מאמץ ודורשת Claude Code בגרסה v2.1.218 ואילך.

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

#מה הסקירה קוראת ועורכת

הסקירה פועלת לפי קובץ ה-CLAUDE.md שלך כמו כל הפעלה של Claude Code, אך היא אינה קוראת את REVIEW.md. סקירה ברקע מחילה את עריכות ה---fix שלה מחוץ לנקודות הבדיקה (checkpoints) של ההפעלה שלך, כך שהפקודה /rewind אינה מבטלת אותן. השתמש ב-git כדי להחזיר אותן לקדמותן. כאשר הסקירה רצה בחזית, היא עורכת את עץ העבודה שלך במהלך התור שלך, כך שהפקודה /rewind משחזרת את עריכותיה כרגיל.

#כוונון מאמץ וארגומנטים

העבר רמת מאמץ כדי להמיר כיסוי בביטחון. ברמות low ו-medium, הסקירה מדווחת רק על הממצאים שבהם היא בטוחה ביותר, כך שאתה רואה פחות תוצאות חיוביות שגויות. רמות high עד max מרחיבות את הכיסוי ועשויות לכלול ממצאים שהסקירה פחות בטוחה לגביהם.

כאשר אינך מקליד רמה, הסקירה עושה שימוש חוזר ברמה האחרונה מ-low עד max שהקלדת, אפילו בהפעלה קודמת, ו-Claude Code מציג הודעה כגון Reusing high effort, the level you typed last time. הקלד רמה, כמו /code-review high, כדי לשנות במה ריצות מאוחרות יותר יעשו שימוש חוזר. רמה שאתה מעביר בריצה לא אינטראקטיבית עם הדגל -p אינה מעדכנת זאת. הרמה ultra אינה מעדכנת ואינה משתמשת ברמה הזכורה. אם מעולם לא הקלדת רמה, הסקירה משתמשת במאמץ הנוכחי של ההפעלה. לפני גרסה v2.1.223, הפקודה /code-review ללא רמה השתמשה תמיד במאמץ הנוכחי של ההפעלה.

לאחר רמת המאמץ והדגלים, Claude Code קורא את שאר השורה באחת משתי דרכים:

• ללא ultra: כל מה שנשאר הוא יעד הסקירה, גם כאשר הוא מתחיל בשם של פקודה אחרת. הפקודה /code-review /fix-issue 123 סוקרת כאשר /fix-issue 123 משמש כטקסט היעד במקום לטעון את /fix-issue כמיומנות מוערמת שנייה (stacked skill). לפני גרסה v2.1.218, פקודה שנערמה לאחר /code-review הורחבה כמיומנות עצמאית.
• עם ultra: הכלי Claude Code קורא מילה בודדת כשם ענף בסיס או מספר PR, והופך טקסט ארוך יותר שאינו מציין ענף או PR להערה המצורפת לסקירה. הפקודה /code-review ultra check my auth changes סוקרת את הענף הנוכחי שלך, ו-Claude מקשר את הממצאים להערה שלך.

#הרצה בחזית

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

• אתה מריץ את /code-review שוב בזמן שסקירה קודמת עדיין בעיצומה
• אתה מריץ אותה במצב לא אינטראקטיבי, עם הדגל -p או ה-Agent SDK. הכלי Claude Code ממתין לסקירה וכולל את הממצאים בתגובה, למעט ultra, שמפעיל את סקירת הענן מבלי להמתין
• אתה מגדיר את משתנה הסביבה CLAUDE_CODE_DISABLE_BACKGROUND_TASKS לערך 1, מה שמכבה גם כל תכונה אחרת של משימות רקע

#אפשר ל-Claude להתחיל את הסקירה

Claude יכול להתחיל את /code-review בעצמו. בקש ממנו לסקור את השינויים שלך בשפה פשוטה והוא יכול להריץ את המיומנות מבלי שתקליד את הפקודה, ומשימה מתוזמנת עם /code-review כהנחיה שלה מריצה את הסקירה.

משימה מתוזמנת לעולם אינה מפעילה את סקירת הענן, לכן תזמן את /code-review ללא הארגומנט ultra.

כדי למנוע הן מ-Claude והן ממשימות מתוזמנות להתחיל את הסקירה, תוך שמירה על /code-review זמין להקלדה על ידך, הוסף רשומת skillOverrides לקובץ הגדרות כגון ~/.claude/settings.json:

{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}

לפני גרסה v2.1.246, Claude התחיל את /code-review בעצמו רק במקומות שבהם דגל תכונה (feature flag) שהובא מ-Anthropic הפעיל זאת. בהפעלות שאינן מביאות דגלי תכונות, הפקודה /code-review רצה רק כאשר הקלדת אותה, והפקודה המתוזמנת /code-review הגיעה ל-Claude כטקסט רגיל.

#הסלמה ל-ultrareview

הפקודה /code-review ultra --fix מריצה את ultrareview המעמיק יותר בענן, ולאחר מכן מחילה את ממצאיו על עץ העבודה שלך כאשר הם מגיעים בחזרה להפעלה שלך.

הכלי Ultrareview משתמש בטווח משלו: הענף הנוכחי שלך מול ענף ברירת המחדל של המאגר, בתוספת שינויים שלא נשמרו ושינויים בשלב ה-staging בעץ העבודה. עבור שינויים שלא נשמרו בקבצים בעלי שמות המעידים על אישורים (credentials) או מפתחות, כגון קובצי .env ו-*.tfvars, הכלי Claude Code פועל לפי הכללים של העלאת מאגר מקומי להפעלת ענן. העבר שם ענף, כגון /code-review ultra develop, כדי להשוות מול בסיס שונה.

כאשר היעד הוא בקשת משיכה ב-github.com, באפשרותך לגרום ל-Claude לפרסם את הממצאים שהסתיימו ל-PR כתגובה מחשבון ה-GitHub שלך. דורש Claude Code בגרסה v2.1.227 ואילך.

הערה: Ultrareview דורש אימות באמצעות חשבון claude.ai ואינו זמין ב-Amazon Bedrock, ב-Google Cloud's Agent Platform או ב-Microsoft Foundry, או לארגונים שבהם מופעל Zero Data Retention. כאשר ultrareview אינו זמין, הפקודה /code-review ultra מריצה סקירה מקומית בהפעלה שלך במקום זאת.

כדי להתחיל סקירת ענן מסקריפט או מ-CI, הרץ claude -p '/code-review ultra'. הכלי Claude Code מפעיל את הסקירה ומדפיס קישור למעקב אחריה. דורש Claude Code בגרסה v2.1.218 ואילך.

כאשר הסקירה עשויה לחייב קרדיטים לשימוש, הכלי Claude Code עוצר לפני ההפעלה, מכיוון שאישור החיוב דורש הפעלה אינטראקטיבית. הרץ את פקודת המשנה claude ultrareview במקום זאת. בעצם הרצתה, אתה מסכים לחיוב.

שם הפקודה היה /simplify לפני גרסה v2.1.147, כאשר היא החילה תיקונים כברירת מחדל. הפקודה /simplify מריצה סקירת ניקוי בלבד נפרדת שמחילה תיקונים מבלי לחפש באגים. אם השתמשת ב-/simplify בסקריפטים לצורך מציאת באגים, עבור אל /code-review --fix.

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

• פקודות: הרץ את /code-review בהפעלת Claude Code מקומית כדי לבדוק diff לפני דחיפה
• GitHub Actions: הרץ את Claude בתהליכי עבודה משלך ב-GitHub Actions לאוטומציה מותאמת אישית מעבר לסקירת קוד
• GitLab CI/CD: אינטגרציה באירוח עצמי של Claude עבור צינורות עבודה (pipelines) ב-GitLab
• זיכרון (Memory): כיצד קובצי CLAUDE.md פועלים ברחבי Claude Code
• ניתוח נתונים (Analytics): מעקב אחר השימוש ב-Claude Code מעבר לסקירת קוד
• כיצד Anthropic מאבטחת את מחזור חיי פיתוח התוכנה מבוסס ה-AI שלה (How Anthropic secures its AI-native software development lifecycle): כיצד סקירה אוטומטית משתלבת כשכבה אחת בתהליך הפיתוח המאובטח של Anthropic