📘 תיעוד 26

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

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

הערה: ultrareview היא תכונה בתצוגה מקדימה למחקר (research preview). התכונה, התמחור והזמינות עשויים להשתנות בהתבסס על משוב. הפקודה היא /code-review ultra. כאשר ultrareview זמין בחשבון שלך, /ultrareview משמש ככינוי מקוצר (alias).

ultrareview היא סקירת קוד עמוקה שרצה על תשתית Claude Code on the web. כאשר אתה מריץ /code-review ultra, Claude Code מפעיל צי של סוכני סקירה בסביבת ארגז חול (sandbox) מרוחקת כדי למצוא באגים בענף שלך או ב-pull request.

בהשוואה ל-/code-review מקומי, ultrareview מציע:

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

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

#הרצת ultrareview מה-CLI

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

/code-review ultra

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

עבור סקירת ענף, Claude Code אורז את מצב המאגר ומעלה אותו לארגז חול מרוחק; כאשר אתה סוקר pull request, Claude Code אינו מעלה דבר מהמחשב שלך.

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

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

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

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

/code-review ultra develop

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

#סקירת pull request

כדי לסקור pull request של GitHub במקום ענף מקומי, העבר את מספר ה-PR:

/code-review ultra 1234

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

במצב PR, ארגז החול המרוחק משכפל את ה-pull request ישירות מהמארח במקום לארוז את עץ העבודה המקומי שלך. מצב PR עובד עם מאגרים ב-github.com ובמופעי GitHub Enterprise Server שבעלים (Owner) חיבר ל-Claude Code.

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

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

#פרסום ממצאים ב-pull request

ב-Claude Code מגרסה v2.1.227 ואילך, כאשר אתה סוקר pull request ב-github.com, אתה יכול לגרום ל-Claude לפרסם את הממצאים שהסתיימו ב-PR כתגובה פשוטה אחת מחשבון ה-GitHub שלך. התגובה אינה סקירה או אישור, והיא מסתיימת בהערה "Generated by Claude Code". כאשר אתה סוקר ענף או pull request ב-GitHub Enterprise Server, 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 אינו מפרסם מהמחשב שלך. הוא שולח את הממצאים להפעלה ב-Claude Code on the web, אשר מפרסמת את התגובה דרך חשבון ה-GitHub שחיברת ל-Claude. הפרסום דורש את אותה כניסה לחשבון claude.ai כמו הסקירה עצמה. מכיוון שהפרסום רץ דרך Claude Code on the web, הוא אינו זמין בספקי צד שלישי או כאשר אתה מגדיר את CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

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

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

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

ב-Claude Code מגרסה v2.1.218 ואילך, תוכל גם לתאר על מה אתה עובד במילים פשוטות:

/code-review ultra check my auth changes

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

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

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

#מגבלות diff ונתיבי חלופה

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

• Diff גדול מדי: סקירת ענף יכולה לכלול עד 500 קבצים ששונו ו-8,000 שורות ששונו כברירת מחדל. הערכים המדויקים יכולים להשתנות, והודעת הסירוב מציינת את הערכים שבתוקף, את גודל ה-diff שלך ואת הקבצים עם מספר השורות הרב ביותר ששונו. Claude Code מסרב ל-pull request גדול מדי באותו אופן, ומציין את ספירת הקבצים והשורות שלו אך ללא הפירוט לפי קובץ
• אין מה לסקור: כאשר ה-diff מול הבסיס ריק, Claude Code מציין זאת ומציע להעביר ל-stage או לבצע commit לשינויים מקומיים, או להעביר בסיס שונה
• אין בסיס מיזוג: כאשר הענף שלך אינו חולק היסטוריה משותפת עם ענף הבסיס, Claude Code עובר לחלופה של סקירת כל קובץ במעקב במאגר במקום זאת; החלופה דורשת שכפול מלא ומחילה את אותן מגבלות גודל. ב-checkout ללא ענפים או הפניות אחרות, כגון detached HEAD שנוצר על ידי ביצוע checkout ל-FETCH_HEAD לאחר משיכת URL, Claude Code מסרב לסקירה ומציע ליצור ענף תחילה

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

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

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

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

• אם אתה יכול לנהל את החיוב עבור החשבון שלך, Claude Code מקשר אותך להגדרות החיוב שבהן תוכל להפעיל קרדיטים לשימוש.
• בתוכניות Team ו-Enterprise, חברים ללא גישה לחיוב שולחים בקשה מה-CLI ומבקשים ממנהל המערכת שלהם להפעיל קרדיטים לשימוש.

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

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

#מעקב אחר סקירה פעילה

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

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

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

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

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

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

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

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

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

הודעות התקדמות וכתובת ה-URL של ההפעלה החיה נשלחות ל-stderr כדי ש-stdout יישאר קריא לעיבוד. השתמש בדגלים אלה כדי לשלוט בפלט, בזמן הקצוב (timeout), ובשאלה האם לפרסם את הממצאים:

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

תת-הפקודה מסתיימת עם אחד משלושה קודים:

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

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

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

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

#השוואה בין ultrareview לבין /code-review

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

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

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

• Claude Code on the web: למד כיצד פועלות הפעלות ענן וארגזי חול בענן
• ניהול עלויות בצורה יעילה: מעקב אחר שימוש והגדרת מגבלות הוצאה