📘 תיעוד 27

מציאת באגים עם ultrareview

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

[!NOTE]

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

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

לעומת /code-review מקומי, ultrareview מציע:

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

Ultrareview דורש אימות עם חשבון claude.ai כי הוא רץ כסשן ענן על התשתית של Anthropic. אם אתם מחוברים עם מפתח API בלבד, הריצו /login ואמתו עם claude.ai קודם. Ultrareview לא זמין כשמשתמשים ב-Claude Code עם Amazon Bedrock, Google Cloud's Agent Platform, או Microsoft Foundry, והוא לא זמין לארגונים שהפעילו Zero Data Retention או שהוחלה עליהם הגדרת HIPAA. במקרים אלה, /code-review ultra מריץ סקירה מקומית בסשן שלכם. ארגונים שמשתמשים במפתחות הצפנה בניהול הלקוח (CMEK) לא יכולים להריץ ultrareview. כדי לסקור את השינויים שלכם באופן מקומי, הריצו /code-review.

#הרצת ultrareview מה-CLI

התחילו סקירה מכל מאגר git:

/code-review ultra

בלי ארגומנטים, ultrareview סוקר את ה-diff בין הענף הנוכחי לענף ברירת המחדל, כולל שינויים שלא עברו commit ושינויים שנמצאים ב-staging.

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

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

הפקודה רצה רק כשאתם מפעילים אותה עם /code-review ultra. Claude לא מתחיל ultrareview מעצמו.

#סקירה מול בסיס אחר

כדי להשוות מול בסיס שאינו ענף ברירת המחדל, העבירו את שם הענף. הדוגמה הזו סוקרת את הענף הנוכחי מול develop:

/code-review ultra develop

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

גם מזהה commit או תג עובדים כבסיס, ואז הסקירה מכסה את השינויים בענף שלכם מאז אותו commit.

#סקירת בקשת משיכה

כדי לסקור בקשת משיכה ב-github.com ולא ענף מקומי, העבירו את מספר ה-PR:

/code-review ultra 1234

הפקודה מקבלת גם את #1234, את PR 1234, וכתובות URL של PR שהודבקו. כתובת URL שהודבקה חייבת להצביע על המאגר בתיקייה הנוכחית שלכם.

מצב PR דורש מאגר ב-github.com. למאגר במופע GitHub Enterprise Server, הריצו /code-review ultra בלי מספר PR כדי לסקור את הענף המקומי שלכם.

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

הריצו /web-setup כדי לחבר את ההתחברות של GitHub CLI לחשבון Claude שלכם.

#פרסום ממצאים לבקשת המשיכה

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

Claude Code לא מפרסם אלא אם בחרתם בכך באותה הרצה, ו---no-post הוא ברירת המחדל. הפרסום הוא בחירה שאתם עושים לכל הרצה:

• אינטראקטיבי: בתיבת ההפעלה, בחרו Run and post the findings to the PR as me. אם תוסיפו --post לפקודה, כמו ב-/code-review ultra 1234 --post, Claude Code מסמן מראש את הבחירה הזו ועדיין שואל לפני ההפעלה.
• לא אינטראקטיבי: הריצו את פקודת המשנה claude ultrareview עם --post. אתם מסכימים לפרסום על ידי הרצת פקודת המשנה עם הדגל, ולכן Claude Code מפרסם בלי לשאול. בהרצה של claude -p '/code-review ultra', Claude Code יוצא לפני שהממצאים מגיעים, ולכן הוא לא מפרסם דבר. השתמשו בפקודת המשנה.

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

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

כשהפרסום מסתיים, Claude אומר לכם את התוצאה:

• פורסם: Claude נותן לכם קישור לתגובה.
• כבר פורסם: פרסום קודם של אותה סקירה כבר שם את התגובה ב-PR, ולכן Claude מקשר אתכם לבקשת המשיכה ולא מפרסם שוב.
• נכשל: Claude אומר לכם למה, והממצאים נשארים בטרמינל כדי שתוכלו לפרסם אותם ידנית.

#העברת בקשה במילים רגילות

אפשר גם לתאר במה אתם עובדים במילים רגילות:

/code-review ultra check my auth changes

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

Claude Code מתייחס לטקסט שלכם כהערה רק כשיש בו יותר ממילה אחת והוא אינו שם ענף או הפניה ל-PR. הוא קורא מילה בודדת כשם ענף או כהפניה ל-PR, ולכן שם ענף עם שגיאת כתיב מקבל את שגיאת הענף הקרוב ביותר מתוך סקירה מול בסיס אחר ולא מופעל עם הערה. אם הטקסט שלכם משלב הפניה ל-PR עם מילים אחרות, כמו check PR 123 again, Claude Code לא מפעיל. הוא מבקש מכם להריץ שוב עם מספר ה-PR לבד כדי לסקור את ה-PR הזה, או בלי ההפניה כדי לסקור את הענף הנוכחי.

[!TIP]

אם המאגר שלכם גדול מדי לאריזה, Claude Code מנחה אתכם להשתמש במצב PR. למאגר ב-github.com, דחפו את הענף ופתחו טיוטת PR, ואז הריצו /code-review ultra <PR-number>.

#מגבלות diff וחלופות

Ultrareview בודק את ה-diff לפני שרצה עבודת סקירה כלשהי, ואומר לכם מתי אי אפשר לסקור אותו כמו שהוא:

• Diff גדול מדי: סקירת ענף יכולה לכלול עד 500 קבצים שהשתנו ו-8,000 שורות שהשתנו כברירת מחדל. הערכים המדויקים יכולים להשתנות, והסירוב מציין את הערכים שבתוקף, את גודל ה-diff שלכם, ואת הקבצים עם הכי הרבה שורות שהשתנו. Claude Code מסרב לבקשת משיכה גדולה מדי באותו אופן, ומציין את מספר הקבצים והשורות שלה, בלי הפירוט לפי קובץ

• אין מה לסקור: כשה-diff מול הבסיס ריק, ultrareview מסרב ומציין את הענף או ה-commit שהשווה מולם ואת המצב שבו אתם נמצאים, כמו להיות על ענף הבסיס עצמו בלי דבר שלא עבר commit, או ענף שכל ה-commits שלו כבר חלק מהבסיס. הוא גם מציע את הדרך לצאת מהמצב הזה, כמו מעבר לענף עם העבודה שלכם, staging או commit לעריכות מקומיות, או העברת בסיס אחר

• Commit ראשון: ל-commit הראשון של מאגר אין משהו מוקדם יותר להשוות אליו, ולכן ultrareview סוקר כל קובץ בו אחרי שאתם מאשרים בתיבת ההפעלה. אם יש לכם קבצים שלא במעקב, הוא מסרב ואומר לכם לבצע git add לאלה שאתם רוצים שייסקרו. אותן מגבלות גודל חלות.

  Commit ראשון נסקר בשלמותו רק אחרי האישור הזה, ולכן פקודת המשנה claude ultrareview ו-claude -p מסרבים לו ומפנים אתכם לסשן אינטראקטיבי. נדרש Claude Code מגרסה v2.1.277 ומעלה

• אין בסיס מיזוג: כשהענף שלכם לא חולק היסטוריה עם ענף הבסיס, או שלמאגר אין ענף בסיס להשוואה, ultrareview סוקר כל קובץ במעקב במאגר. החלופה דורשת clone מלא ומחילה את אותן מגבלות גודל. היא מופעלת רק כשאתם מאשרים בתיבת ההפעלה או מריצים בעצמכם את פקודת המשנה claude ultrareview. ב-claude -p ובכל מקום אחר שבו אף אחד מאלה לא קורה, ultrareview מסרב, אומר שהסקירה תכסה כל קובץ, ומפנה אתכם לסשן אינטראקטיבי.

  ב-checkout בלי ענפים או refs אחרים, כמו detached HEAD שנוצר על ידי checkout של FETCH_HEAD אחרי fetch של כתובת URL, Claude Code מסרב לסקירה ומציע ליצור ענף קודם

#תמחור והרצות חינם

Ultrareview הוא תכונת פרימיום שמחויבת מול קרדיטי שימוש, ולא מול השימוש הכלול בתוכנית שלכם.

• הרצות חינם: שלוש ההרצות של Pro, Max ו-Ultra הן הקצאה חד פעמית לכל חשבון, והן לא מתחדשות.
• עלות לסקירה: אחרי שמשתמשים בהרצות החינם, בדרך כלל $5 עד $25 בקרדיטי שימוש לפי גודל השינוי, בהתאם להערכה שתיבת ההפעלה מציגה לפני כל הרצה.
• מתי הרצה נספרת: ברגע שסשן הענן מתחיל. סקירה שאתם עוצרים מוקדם, או שלא מגיעה לסיום, עדיין משתמשת בהרצה חינם. סקירה בתשלום מחויבת רק על החלק שרץ.

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

אפשר גם להריץ /usage-credits כדי לבדוק או לשנות את הגדרת קרדיטי השימוש.

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

#מעקב אחרי סקירה שרצה

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

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

Claude יכול גם לומר לכם שסקירה נעצרה, או שהסשן שלה לא נמצא:

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

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

#הרצת ultrareview בלי אינטראקציה

השתמש בפקודת המשנה claude ultrareview כדי להתחיל ultrareview מ-CI או מסקריפט בלי סשן אינטראקטיבי. פקודת המשנה מפעילה את אותה סקירה כמו /code-review ultra, נחסמת עד שהסקירה המרוחקת מסתיימת, ומדפיסה את הממצאים ל-stdout. אם ההרצה יוצאת עם Error: Workspace not trusted, ראה לתת אמון בתיקייה לפני שהסקירה רצה.

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

בלי ארגומנטים, פקודת המשנה סוקרת את ה-diff בין הענף הנוכחי לענף ברירת המחדל, עם אותה חלופה של כל המאגר כמו /code-review ultra כשאין merge base. העבר מספר PR כדי לסקור pull request ב-github.com, או ענף בסיס כדי לסקור מולו. הטיפול בענף בסיס תואם את הפקודה האינטראקטיבית.

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

[!NOTE]

claude -p '/code-review ultra' לא מביא לך את הממצאים, לכן השתמש ב-claude ultrareview בסקריפטים. הרצה עם -p מפעילה את סקירת הענן ויוצאת בלי להמתין לה. כשהסקירה הייתה מחייבת קרדיטי שימוש, הרצת -p נעצרת בלי להפעיל אותה.

claude ultrareview כותב את הודעות ההתקדמות שלו ל-stderr כדי ש-stdout יישאר ניתן לפענוח.

הרצת claude ultrareview דורשת את אותה הגדרת אימות וקרדיטי שימוש כמו /code-review ultra.

פקודת המשנה יוצאת עם אחד משלושה קודים:

• 0: הסקירה הושלמה, עם ממצאים או בלי ממצאים
• 1: הסקירה נכשלה בהפעלה או נעצרה לפני שהסתיימה, סשן הענן החזיר שגיאה, או שחלף ה-timeout. הקוד הוא גם 1 כשהתיקייה לא מהימנה, כולל כשעונים n, לוחצים Enter, או לוחצים Ctrl-C בשאלת האמון.
• 130: לחצת Ctrl-C בזמן שפקודת המשנה הפעילה את הסקירה, המתינה לממצאים, או שלחה את תגובת --post, ולא בשאלת האמון

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

עם --post, פקודת המשנה מתחילה את הפרסום מיד אחרי הדפסת הממצאים, ומדפיסה את הקישור ל-stderr.

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

לסקירות אוטומטיות על pull requests ב-GitHub, Code Review משתלב עם המאגר שלך ישירות ומפרסם ממצאים כתגובות PR בשורה, בלי שלב CLI.

#לתת אמון בתיקייה לפני שהסקירה רצה

כש-claude ultrareview שואל Trust <folder>? [y/N], ענה y כדי לתת אמון בתיקייה. תן אמון רק אם אתה סומך על הקוד שלה, כי git ו-Claude Code יכולים אז להריץ תוכניות ששמן מופיע בהגדרות git ובהגדרות הפרויקט שלה.

כשהוא לא יכול לשאול אותך, למשל בעבודת CI או כשהפלט נשלח לקובץ, הוא יוצא עם Error: Workspace not trusted. הוסף --trust-workspace כדי לתת אמון בתיקייה להרצה הזו:

claude ultrareview 1234 --trust-workspace

כדי לסקור pull request שאינו מהימן, הרץ claude ultrareview <PR number> --trust-workspace מענף שאתה סומך עליו. ה-PR משוכפל בענן, ולכן אין צורך בענף שלו מקומית.

#איך ultrareview משתווה ל-/code-review

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

השתמש ב-/code-review למשוב מהיר בזמן העבודה, או העבר מספר PR כדי לסקור pull request של חבר צוות לפני שאתה מאשר אותו. השתמש ב-/code-review ultra לפני מיזוג שינוי מהותי כשאתה רוצה מעבר עמוק יותר שתופס בעיות שסקירה מקומית עלולה להחמיץ.

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

• שימוש ב-Claude Code בענן: למד איך סשנים בענן וארגזי חול בענן עובדים
• ניהול עלויות ביעילות: עקוב אחרי שימוש והגדר מגבלות הוצאה