SpyBara
Go Premium

ultrareview.md 2026-10-01 23:59 UTC to 2026-10-02 13:58 UTC

This page contains 55 additions and 54 deletions.

2026
Thu 1 23:59 Fri 2 15:01

Trova bug con ultrareview

Esegui una revisione del codice profonda e multi-agente nel cloud con /code-review ultra per trovare e verificare i bug prima di eseguire il merge.

Ultrareview è una revisione del codice profonda che viene eseguita come una sessione cloud sull'infrastruttura di Anthropic. Quando esegui /code-review ultra, Claude Code avvia una flotta di agenti revisori in una sandbox cloud per trovare bug nel tuo branch o pull request.

Rispetto a una /code-review locale, ultrareview offre:

  • Segnale più elevato: ogni risultato segnalato viene riprodotto e verificato in modo indipendente, quindi i risultati si concentrano su bug reali piuttosto che su suggerimenti di stile
  • Copertura più ampia: una flotta più grande di agenti revisori esplora il cambiamento in parallelo, il che fa emergere i problemi che una revisione locale può perdere
  • Nessun utilizzo di risorse locali: la revisione viene eseguita interamente in una sandbox cloud, quindi il tuo terminale rimane libero per altri lavori mentre viene eseguita

Ultrareview richiede l'autenticazione con un account claude.ai perché viene eseguito come una sessione cloud sull'infrastruttura di Anthropic. Se sei connesso solo con una chiave API, esegui /login e autentica prima con claude.ai. Ultrareview non è disponibile quando si utilizza Claude Code con Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry, e non è disponibile per le organizzazioni che hanno abilitato Zero Data Retention. Quando ultrareview non è disponibile, /code-review ultra esegue invece una revisione locale nella tua sessione.

Esegui ultrareview dalla CLI

Avvia una revisione da qualsiasi repository git:

/code-review ultra

Senza argomenti, ultrareview esamina il diff tra il tuo branch attuale e il branch predefinito, incluse le modifiche non committate e in staging.

Per una revisione di branch, Claude Code raggruppa lo stato del repository e lo carica in una sandbox cloud secondo le regole per caricare un repository locale in una sessione cloud, che coprono i limiti di dimensione, i requisiti del checkout e cosa succede alle modifiche non committate nei file con nomi simili a credenziali o chiavi, come i file .env e *.tfvars. Quando esamini una pull request, Claude Code non carica nulla dalla tua macchina.

Prima dell'avvio, Claude Code mostra una finestra di dialogo di conferma con l'ambito della revisione, i run gratuiti rimanenti e il costo stimato; per una revisione di branch, l'ambito include il numero di file e di righe. Dopo la conferma, la revisione continua in background mentre continui a usare la tua sessione.

Il comando viene eseguito solo quando lo richiami con /code-review ultra; Claude non avvia un ultrareview di sua iniziativa.

Revisione rispetto a una base diversa

Per confrontare rispetto a una base diversa dal branch predefinito, passa il nome del branch. Questo esempio esamina invece il tuo branch attuale rispetto a develop:

/code-review ultra develop

Il branch base non deve necessariamente esistere nel tuo clone locale; Claude Code lo recupera da origin. Se il nome contiene un errore di battitura, Claude Code suggerisce nell'errore il nome del branch più simile.

Anche un ID di commit o un tag funziona come base, e in tal caso la revisione copre le modifiche sul tuo branch a partire da quel commit.

Esamina una pull request

Per esaminare una pull request di GitHub invece di un branch locale, passa il numero della PR:

/code-review ultra 1234

Il comando accetta anche #1234, PR 1234 e URL di PR incollati; un URL incollato deve puntare al repository nella tua directory attuale.

In modalità PR, la sandbox cloud clona la pull request direttamente dall'host invece di raggruppare il tuo albero di lavoro locale. La modalità PR funziona con i repository su github.com e sulle istanze di GitHub Enterprise Server che un Owner ha collegato a Claude Code.

Per i repository su github.com, la sandbox clona con l'account GitHub collegato al tuo account Claude, quindi l'account deve poter leggere il repository della PR.

Esegui /web-setup per collegare il tuo login della GitHub CLI al tuo account Claude.

Pubblica i risultati sulla pull request

Su Claude Code v2.1.227 o successivo, quando esamini una pull request su github.com, puoi fare in modo che Claude pubblichi i risultati finali sulla PR come un singolo commento semplice dal tuo account GitHub. Il commento non è una review né un'approvazione, e termina con una nota "Generated by Claude Code". Quando esamini un branch o una pull request di GitHub Enterprise Server, Claude Code mostra i risultati solo nella tua sessione.

Claude Code non pubblica mai a meno che tu non lo scelga per quell'esecuzione, e --no-post è l'impostazione predefinita. La pubblicazione è una scelta che fai per ogni esecuzione:

  • Interattivo: nella finestra di dialogo di avvio, seleziona Run and post the findings to the PR as me. Se aggiungi --post al comando, come in /code-review ultra 1234 --post, Claude Code preseleziona quella scelta e chiede comunque conferma prima dell'avvio.
  • Non interattivo: esegui il subcommand claude ultrareview con --post. Acconsenti alla pubblicazione eseguendo il subcommand con il flag, quindi Claude Code pubblica senza chiedere. In un'esecuzione claude -p '/code-review ultra', Claude Code termina prima che arrivino i risultati, quindi non pubblica nulla; usa invece il subcommand.

Claude Code non pubblica dalla tua macchina. Invia l'ID di sessione della revisione all'API Anthropic, che pubblica i risultati salvati della revisione come commento tramite l'account GitHub che hai collegato a Claude. La pubblicazione richiede lo stesso accesso a claude.ai della revisione stessa e non è disponibile con provider di terze parti o quando imposti CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

In una sessione interattiva, Claude Code avvia la pubblicazione quando arrivano i risultati, quindi mantieni la sessione aperta fino al completamento della revisione. Claude Code conserva la scelta di pubblicazione solo in quella sessione. Se la sessione termina prima che la revisione finisca, Claude Code non pubblica nulla, anche se riprendi la conversazione in seguito.

Quando la pubblicazione termina, Claude ti comunica il risultato:

  • Pubblicato: Claude ti fornisce un link al commento.
  • Già pubblicato: una pubblicazione precedente della stessa revisione ha già inserito il commento sulla PR, quindi Claude ti fornisce un link alla pull request invece di pubblicare di nuovo.
  • Non riuscito: Claude ti spiega il motivo, e i risultati restano nel tuo terminale così puoi pubblicarli manualmente.

Passa una richiesta in parole semplici

Su Claude Code v2.1.218 o successivo, puoi anche descrivere in parole semplici ciò su cui stai lavorando:

/code-review ultra check my auth changes

La revisione copre comunque il tuo branch attuale, lo stesso ambito dell'esecuzione senza argomenti. Claude conserva il tuo testo come nota, mostrata nella finestra di dialogo di avvio, e mette in relazione i risultati con essa quando arrivano.

Claude Code tratta il tuo testo come nota solo quando contiene più di una parola e non è un nome di branch o un riferimento a una PR. Interpreta una singola parola come nome di branch o riferimento a una PR, quindi un nome di branch digitato male produce l'errore del branch più simile descritto in Revisione rispetto a una base diversa invece di avviare la revisione con una nota. Se il tuo testo combina un riferimento a una PR con altre parole, come check PR 123 again, Claude Code non avvia nemmeno la revisione; ti chiede di rieseguire il comando con il solo numero della PR per esaminare quella PR, oppure senza il riferimento per esaminare il tuo branch attuale.

Limiti del diff e fallback

Ultrareview controlla il diff prima che inizi qualsiasi lavoro di revisione e ti avvisa quando non può esaminarlo così com'è:

  • Diff troppo grande: una revisione di branch può includere per impostazione predefinita fino a 500 file modificati e 8.000 righe modificate. I valori esatti possono cambiare, e il rifiuto indica quelli in vigore, la dimensione del tuo diff e i file con il maggior numero di righe modificate. Claude Code rifiuta allo stesso modo una pull request troppo grande, indicandone il numero di file e di righe ma non il dettaglio per file

  • Nulla da esaminare: quando il diff rispetto alla base è vuoto, ultrareview rifiuta e indica il branch o il commit usato per il confronto e il caso in cui ti trovi, ad esempio se sei sul branch base stesso senza nulla di non committato, o su un branch i cui commit fanno già tutti parte della base. Suggerisce anche come uscire da quel caso, ad esempio passando al branch con il tuo lavoro, mettendo in staging o facendo il commit delle modifiche locali, oppure passando una base diversa

  • Primo commit: il primo commit di un repository non ha nulla di precedente con cui confrontarsi, quindi ultrareview esamina ogni file al suo interno dopo la tua conferma nella finestra di dialogo di avvio. Se hai file non tracciati, invece rifiuta e ti dice di eseguire git add su quelli che vuoi far esaminare. Si applicano gli stessi limiti di dimensione.

    Un primo commit viene esaminato per intero solo dopo quella conferma, quindi il subcommand claude ultrareview e claude -p lo rifiutano e ti indirizzano invece a una sessione interattiva. Richiede Claude Code v2.1.277 o successivo

  • Nessuna base di merge: quando il tuo branch non condivide alcuna cronologia con il branch base, o il repository non ha un branch base con cui confrontarsi, ultrareview esamina invece ogni file tracciato nel repository. Il fallback richiede un clone completo e applica gli stessi limiti di dimensione. Si avvia solo quando confermi nella finestra di dialogo di avvio o esegui tu stesso il subcommand claude ultrareview. In claude -p e ovunque non avvenga nessuna delle due cose, ultrareview rifiuta, indica che la revisione coprirebbe ogni file e ti indirizza a una sessione interattiva.

    Su un checkout senza branch o altri ref, come un HEAD staccato creato facendo il checkout di FETCH_HEAD dopo il fetch di un URL, Claude Code rifiuta la revisione e suggerisce di creare prima un branch

Prezzi e run gratuiti

Ultrareview è una funzione premium che viene fatturata rispetto all'utilizzo extra piuttosto che all'utilizzo incluso nel vostro piano.

Piano Run gratuiti inclusi Dopo i run gratuiti
Pro 3 run gratuiti fatturato come utilizzo extra
Max 3 run gratuiti fatturato come utilizzo extra
Team e Enterprise nessuno fatturato come utilizzo extra
  • Run gratuiti: i tre run Pro e Max sono un'allocazione una tantum per account e non si rinnovano.
  • Costo per revisione: dopo aver utilizzato i run gratuiti, in genere da $5 a $25 in crediti di utilizzo a seconda della dimensione della modifica, corrispondente alla stima che la finestra di dialogo di avvio mostra prima di ogni run.
  • Quando un run viene conteggiato: una volta che la sessione cloud inizia. Una revisione che interrompete anticipatamente o che non riesce a completarsi utilizza comunque un run gratuito; una revisione a pagamento viene fatturata solo per la parte che è stata eseguita.

Poiché ultrareview viene sempre fatturato come crediti di utilizzo al di fuori dei run gratuiti, il vostro account o la vostra organizzazione deve avere i crediti di utilizzo abilitati prima di poter avviare una revisione a pagamento. Se i crediti di utilizzo non sono abilitati, Claude Code blocca l'avvio e come attivarli dipende dal vostro accesso alla fatturazione:

  • Se potete gestire la fatturazione per il vostro account, Claude Code vi collega alle impostazioni di fatturazione dove potete attivare i crediti di utilizzo.
  • Nei piani Team e Enterprise, i membri senza accesso alla fatturazione inviano una richiesta dalla CLI chiedendo al loro amministratore di attivare i crediti di utilizzo.

Potete anche eseguire /usage-credits per controllare o modificare l'impostazione dei crediti di utilizzo.

Claude Code vi chiede di confermare la fatturazione dei crediti di utilizzo una volta per conversazione: quando avviate una nuova conversazione, ad esempio con /clear, Claude Code mostra di nuovo la conferma per la prossima revisione a pagamento.

Traccia una revisione in esecuzione

Una revisione in genere richiede da 5 a 10 minuti. La revisione viene eseguita come attività in background, quindi puoi continuare a lavorare nella tua sessione o avviare altri comandi. Se hai scelto di pubblicare i risultati nella pull request, mantieni la sessione aperta fino al termine della revisione; se la sessione termina prima, Claude Code non pubblica nulla.

Utilizzate /tasks per visualizzare le revisioni in esecuzione e completate, aprire la vista dettagli per una revisione o interrompere una revisione in corso. Se interrompete una revisione, Claude Code archivia la sessione cloud e non restituisce risultati parziali.

Claude può anche comunicarvi che una revisione è stata interrotta o che la sua sessione non è stata trovata:

  • Se la sessione cloud della revisione viene interrotta o archiviata su claude.ai prima del termine della revisione, Claude vi comunica che è stata interrotta.
  • Se la sessione cloud della revisione è stata eliminata, oppure avete effettuato l'accesso a un account Claude o a un'organizzazione diversa da quando l'avete avviata, Claude vi comunica che la sessione non è stata trovata.
  • Se avete cambiato account, la revisione potrebbe comunque terminare con l'account che l'ha avviata. Se la revisione è ancora in esecuzione, effettuate di nuovo l'accesso come quell'account e riprendete la conversazione con claude --resume per riallegare la revisione.

Quando la revisione termina, Claude Code mostra i risultati verificati come notifica nella vostra sessione. Ogni risultato include la posizione del file e una spiegazione del problema in modo da poter chiedere a Claude di risolverlo direttamente.

Eseguire ultrareview in modo non interattivo

Usa il sottocomando claude ultrareview per avviare un'ultrareview da CI o da uno script senza una sessione interattiva. Il sottocomando avvia la stessa revisione di /code-review ultra, resta in attesa finché la revisione remota non termina e stampa i risultati su stdout.

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

Senza argomenti, il sottocomando esamina il diff tra il tuo branch corrente e il branch predefinito, con lo stesso fallback sull'intero repository di /code-review ultra quando non esiste una base di merge. Passa un numero di PR per esaminare una pull request, oppure un branch di base per eseguire la revisione rispetto a quello; la gestione del branch di base corrisponde a quella del comando interattivo.

Quando esegui il sottocomando, acconsenti al fallback sull'intero repository e al prompt relativo a fatturazione e termini, quindi l'esecuzione parte senza attendere input. È il fatto di eseguirlo tu stesso a valere come consenso. Quando invece è Claude a eseguire il sottocomando per te, ad esempio tramite lo strumento Bash, Claude Code rifiuta la revisione dell'intero repository.

claude -p '/code-review ultra' non ti restituisce i risultati, quindi negli script usa claude ultrareview. L'esecuzione con -p avvia la revisione cloud ed esce senza attenderla. Quando la revisione addebiterebbe crediti di utilizzo, l'esecuzione con -p si ferma senza avviarla. Prima della v2.1.218, /code-review ultra in una sessione non interattiva eseguiva una revisione locale.

claude ultrareview scrive i messaggi di avanzamento su stderr in modo che stdout resti analizzabile. Usa questi flag per controllarne l'output, il timeout e la pubblicazione dei risultati:

Flag Descrizione
--json Stampa il payload bugs.json grezzo invece dei risultati formattati
--timeout <minutes> Numero massimo di minuti di attesa per il completamento della revisione. Il valore predefinito è 45
--post Pubblica i risultati completati sulla pull request come un unico commento semplice dal tuo account GitHub. Funziona con pull request su github.com; con altre destinazioni, Claude Code ignora il flag e lo segnala. Richiede Claude Code v2.1.227 o successiva
--no-post Non pubblica i risultati. È il comportamento predefinito e, se passi entrambi i flag, Claude Code non pubblica. Richiede Claude Code v2.1.227 o successiva

L'esecuzione di claude ultrareview richiede la stessa autenticazione e la stessa configurazione dei crediti di utilizzo di /code-review ultra.

Il sottocomando termina con uno di tre codici:

  • 0: la revisione è stata completata, con o senza risultati
  • 1: la revisione non è riuscita ad avviarsi o è stata interrotta prima di terminare, la sessione cloud ha generato un errore oppure il timeout è scaduto
  • 130: hai interrotto il sottocomando con Ctrl-C

Se il sottocomando termina prima dell'arrivo dei risultati, questi non raggiungono mai il tuo terminale. La revisione potrebbe essere ancora in esecuzione nel cloud. Eseguire di nuovo il sottocomando avvia una nuova revisione anziché riprendere quella, e la nuova revisione usa un'esecuzione gratuita o viene addebitata come crediti di utilizzo.

Con --post, il sottocomando avvia la pubblicazione subito dopo aver stampato i risultati e stampa il link su stderr.

  • Se l'esecuzione non riesce, viene interrotta o scade per timeout, il sottocomando non pubblica nulla.
  • Se la revisione viene completata ma il commento non viene pubblicato, Claude Code stampa il motivo su stderr e i risultati restano su stdout, così puoi pubblicarli manualmente.

Per revisioni automatiche sulle pull request GitHub, Code Review si integra direttamente con il tuo repository e pubblica i risultati come commenti inline sulla PR senza alcun passaggio dalla CLI.

Come ultrareview si confronta con /code-review

Entrambe le revisioni esaminano il codice, ma le utilizzate in diverse fasi del vostro flusso di lavoro.

/code-review /code-review ultra
Destinazione il vostro diff di lavoro, una pull request, un branch o un percorso il vostro diff di lavoro o una pull request
Viene eseguito localmente nella vostra sessione in una sandbox cloud
Profondità scala con l'argomento effort flotta multi-agente con verifica indipendente
Durata da secondi a pochi minuti circa 5-10 minuti
Costo conta verso l'utilizzo normale run gratuiti, quindi circa $5 a $25 per revisione come crediti di utilizzo
Migliore per feedback rapido durante l'iterazione fiducia pre-merge su cambiamenti sostanziali

Utilizzate /code-review per un feedback rapido mentre lavorate, oppure passate un numero di PR per esaminare una pull request di un collega prima di approvarla. Utilizzate /code-review ultra prima di eseguire il merge di un cambiamento sostanziale quando desiderate un passaggio più profondo che catturi i problemi che una revisione locale potrebbe perdere.