یافتن باگها با ultrareview
Ultrareview یک بازبینیِ عمیقِ کد است که روی زیرساختِ Claude Code on the web اجرا میشود. وقتی /code-review ultra را اجرا میکنی، Claude Code یک ناوگان از ایجنتهای بازبین را در یک sandboxِ راهدور راه میاندازد تا در شاخه یا pull requestت باگ پیدا کنند.
در مقایسه با /review محلی، ultrareview اینها را ارائه میدهد:
- سیگنالِ بالاتر: هر یافتهی گزارششده بهصورت مستقل بازتولید و تأیید میشود، پس نتایج بهجای پیشنهادهای سبکنگارشی روی باگهای واقعی متمرکزند
- پوششِ گستردهتر: ایجنتهای بازبینِ متعددی بهموازات تغییر را کاوش میکنند، که مشکلاتی را آشکار میکند که یک بازبینیِ تکگذره ممکن است از دست بدهد
- بدونِ مصرفِ منابعِ محلی: بازبینی کاملاً در یک sandboxِ راهدور اجرا میشود، پس ترمینالت حین اجرا برای کارهای دیگر آزاد میماند
Ultrareview به احراز هویت با یک حسابِ Claude.ai نیاز دارد چون روی زیرساختِ Claude Code on the web اجرا میشود. اگر فقط با یک کلیدِ API وارد شدهای، اول /login را اجرا کن و با Claude.ai احراز هویت کن. Ultrareview هنگامِ استفاده از Claude Code با Amazon Bedrock، Google Cloud Vertex AI یا Microsoft Foundry در دسترس نیست، و برای سازمانهایی که Zero Data Retention را فعال کردهاند هم در دسترس نیست.
اجرای ultrareview از CLI
Section titled “اجرای ultrareview از CLI”از هر مخزنِ git در Claude Code CLI یک بازبینی شروع کن.
/code-review ultraبدونِ آرگومان، ultrareview تفاوتِ بینِ شاخهی فعلیات و شاخهی پیشفرض را بازبینی میکند، شاملِ هر تغییرِ کامیتنشده و staged در درختِ کاریات. Claude Code وضعیتِ مخزن را بستهبندی میکند و برای بازبینی به یک sandboxِ راهدور آپلود میکند.
برای بازبینیِ یک pull requestِ GitHub، شمارهی PR را پاس بده.
/code-review ultra 1234در حالت PR، sandboxِ راهدور بهجای بستهبندیِ درختِ کاریِ محلیات، pull request را مستقیماً از هاست clone میکند. حالت PR با مخزنهای روی github.com و روی نمونههای GitHub Enterprise Server که یک ادمین به Claude Code وصل کرده باشد کار میکند.
پیش از راهاندازی، Claude Code یک دیالوگِ تأیید با دامنهی بازبینی (شاملِ شمارِ فایل و خط هنگامِ بازبینیِ یک شاخه)، اجراهای رایگانِ باقیماندهات و هزینهی برآوردی نشان میدهد. پس از تأیید، بازبینی در پسزمینه ادامه مییابد و میتوانی به استفاده از نشستت ادامه دهی. این دستور فقط وقتی اجرا میشود که خودت با /code-review ultra فراخوانیاش کنی؛ Claude بهخودیِخود یک ultrareview شروع نمیکند.
قیمتگذاری و اجراهای رایگان
Section titled “قیمتگذاری و اجراهای رایگان”Ultrareview یک قابلیتِ پولی است که بهجای استفادهی شاملِ پلنت، روی اعتبارهای استفاده (usage credits) محاسبه میشود.
| پلن | اجراهای رایگانِ شامل | پس از اجراهای رایگان |
|---|---|---|
| Pro | ۳ اجرای رایگان | بهصورتِ usage credits محاسبه میشود |
| Max | ۳ اجرای رایگان | بهصورتِ usage credits محاسبه میشود |
| Team و Enterprise | هیچ | بهصورتِ usage credits محاسبه میشود |
مشترکانِ Pro و Max سه اجرای رایگانِ ultrareview میگیرند تا قابلیت را امتحان کنند. این سه اجرا یک سهمیهی یکباره برای هر حساب است و تازه نمیشود. پس از مصرفِ هر سه، یا پس از پایانِ دورهی اجرای رایگان، هر بازبینی روی usage credits محاسبه میشود و معمولاً بسته به اندازهی تغییر بین $5 تا $20 هزینه دارد. بهمحضِ شروعِ نشستِ ابری یک اجرا حساب میشود، پس بازبینیای که زود متوقفش کنی یا کامل نشود هم یک اجرای رایگان مصرف میکند. برای یک بازبینیِ پولی، usage credits فقط برای بخشی که اجرا شده محاسبه میشود.
چون ultrareview بیرون از اجراهای رایگان همیشه روی usage credits محاسبه میشود، حساب یا سازمانت باید پیش از راهاندازیِ یک بازبینیِ پولی، usage credits را روشن کرده باشد. اگر usage credits روشن نباشد، Claude Code راهاندازی را مسدود میکند و تو را به تنظیماتِ هزینه پیوند میدهد که میتوانی آن را روشن کنی. میتوانی /usage-credits را هم اجرا کنی تا تنظیمِ فعلیات را بررسی یا تغییر بدهی.
ردگیریِ یک بازبینیِ درحالِاجرا
Section titled “ردگیریِ یک بازبینیِ درحالِاجرا”یک بازبینی معمولاً ۵ تا ۱۰ دقیقه طول میکشد. بازبینی بهعنوانِ یک کارِ پسزمینه اجرا میشود، پس میتوانی به کار در نشستت ادامه دهی، دستورهای دیگری شروع کنی، یا حتی ترمینال را کاملاً ببندی.
از /tasks استفاده کن تا بازبینیهای درحالاجرا و کاملشده را ببینی، نمای جزئیاتِ یک بازبینی را باز کنی، یا بازبینیای را که در جریان است متوقف کنی. توقفِ یک بازبینی نشستِ ابری را آرشیو میکند و یافتههای ناقص برگردانده نمیشوند. وقتی بازبینی تمام شد، یافتههای تأییدشده بهصورتِ یک اعلان در نشستت ظاهر میشوند. هر یافته شاملِ محلِ فایل و توضیحِ مشکل است تا بتوانی از Claude بخواهی مستقیماً رفعش کند.
اجرای غیرتعاملیِ ultrareview
Section titled “اجرای غیرتعاملیِ ultrareview”از زیردستورِ claude ultrareview استفاده کن تا یک ultrareview را از CI یا یک اسکریپت، بدونِ یک نشستِ تعاملی، شروع کنی. این زیردستور همان بازبینیِ /code-review ultra را راه میاندازد، تا اتمامِ بازبینیِ راهدور بلوک میشود، یافتهها را روی stdout چاپ میکند، و با کدِ 0 در صورتِ موفقیت یا 1 در صورتِ شکست خارج میشود.
claude ultrareviewclaude ultrareview 1234claude ultrareview origin/mainبدونِ آرگومان، این زیردستور تفاوتِ بینِ شاخهی فعلیات و شاخهی پیشفرض را بازبینی میکند. یک شمارهی PR پاس بده تا یک pull request بازبینی شود، یا یک شاخهی پایه پاس بده تا بهجایش تفاوت در برابرِ آن شاخه بازبینی شود. فراخوانیِ این زیردستور بهمنزلهی رضایت برای درخواستِ هزینه و شرایطی است که دستورِ تعاملی نشان میدهد.
پیامهای پیشرفت و URL زندهی نشست به stderr میروند تا stdout قابلِپارس بماند. از این پرچمها برای کنترلِ خروجی و تایماوت استفاده کن:
| پرچم | توضیح |
|---|---|
--json | بهجای یافتههای قالببندیشده، payloadِ خامِ bugs.json را چاپ میکند |
--timeout <minutes> | بیشینهی دقایقِ انتظار برای اتمامِ بازبینی. پیشفرض 30 است |
اجرای claude ultrareview به همان احراز هویت و پیکربندیِ usage creditِ /code-review ultra نیاز دارد. این زیردستور با کدِ 0 خارج میشود وقتی بازبینی با یا بدونِ یافته کامل شود، با کدِ 1 وقتی بازبینی نتواند راه بیفتد یا نشستِ ابری خطا بدهد یا تایماوت سپری شود، و با کدِ 130 وقتی با Ctrl-C قطع شود. اگر زیردستور را قطع کنی، بازبینیِ راهدور به اجرا ادامه میدهد؛ URL نشست که روی stderr چاپ شده را دنبال کن تا در مرورگر تماشایش کنی.
برای بازبینیهای خودکار روی pull requestهای GitHub، Code Review مستقیماً با مخزنت یکپارچه میشود و یافتهها را بدونِ یک گامِ CLI بهصورتِ نظرهای درونخطیِ PR ثبت میکند.
مقایسهی ultrareview با /review
Section titled “مقایسهی ultrareview با /review”هر دو دستور کد را بازبینی میکنند، ولی مراحلِ متفاوتی از ورکفلوت را هدف میگیرند.
/review | /code-review ultra | |
|---|---|---|
| اجرا | محلی در نشستت | راهدور در یک sandboxِ ابری |
| عمق | بازبینیِ تکگذره | ناوگانِ چندایجنتی با تأییدِ مستقل |
| مدت | چند ثانیه تا چند دقیقه | تقریباً ۵ تا ۱۰ دقیقه |
| هزینه | روی استفادهی معمول حساب میشود | اجراهای رایگان، بعد تقریباً $5 تا $20 برای هر بازبینی بهصورتِ usage credits |
| بهترین برای | بازخوردِ سریع حین تکرار | اطمینانِ پیشازmerge روی تغییرهای قابلتوجه |
برای بازخوردِ سریع حین کار از /review استفاده کن. پیش از mergeِ یک تغییرِ قابلتوجه — وقتی یک گذرِ عمیقتر میخواهی که مشکلاتی را بگیرد که یک بازبینیِ تکی ممکن است از دست بدهد — از /code-review ultra استفاده کن.
منابعِ مرتبط
Section titled “منابعِ مرتبط”- Claude Code on the web: یاد بگیر نشستها و sandboxهای ابری چطور کار میکنند
- Plan complex changes with ultraplan: همتای برنامهریزیِ ultrareview برای کارِ طراحیِ اولیه
- Manage costs effectively: ردگیریِ استفاده و تنظیمِ سقفِ هزینه