Cos'è ultracode in Claude Code: cosa fa e quanto costa

Ultracode è un'impostazione di Claude Code, non un livello di sforzo: attivo, Claude scrive un dynamic workflow, uno script che lancia più subagenti, per ogni attività consistente. Come attivarlo e disattivarlo, perché non è lo sforzo max, e la stessa revisione del codice eseguita due volte su Opus 5.5, una in xhigh e una con ultracode: circa quattro volte i token, più del doppio del tempo e una verifica mai tornata con claude -p.

«What is ultracode in Claude Code» sale su Google Trends da quattordici notti di fila, e Google ora suggerisce «what does ultracode do in claude code», «what does opus ultracode do» e «what does ultracode mode do». Le pagine che rispondono si contraddicono: una lo presenta come la modalità di sforzo più alta, un'altra dice che è xhigh. Nessuna delle due ha ragione oggi.

Risposta breve: ultracode è un'impostazione di Claude Code che fa organizzare a Claude ogni attività consistente come un dynamic workflow, più subagenti guidati da uno script, invece di affrontarla turno dopo turno in una sola conversazione. Non è un livello di sforzo, e costa più token. Quanti in più, l'abbiamo misurato su un'attività reale.

Tutto quello che segue è stato verificato il 19 novembre 2026 nella documentazione di Anthropic (code.claude.com, pagine Model configuration e Dynamic workflows), nel changelog di Claude Code e su Claude Code 2.1.318 installato sulla nostra macchina.

Ultracode in un paragrafo

Un dynamic workflow è uno script JavaScript che Claude scrive per la tua attività. Un runtime lo esegue in background: lo script lancia subagenti, spesso diversi alla volta, assegna a ciascuno la sua parte del lavoro e conserva i risultati in variabili dello script invece di accumularli nella tua conversazione. Con ultracode attivo, Claude decide da solo quando un'attività è abbastanza consistente da meritare un workflow e, con le parole di Anthropic, «una singola richiesta può trasformarsi in più workflow di seguito: uno per capire il codice, uno per fare la modifica e uno per verificarla». La pagina di configurazione dei modelli di Anthropic lo riassume in una riga: ultracode è «un'impostazione di Claude Code e non un livello di sforzo del modello».

Come attivarlo e disattivarlo

Ci sono due modi di usarlo, e non durano lo stesso tempo.

Per un'attività: la parola chiave. Metti ultracode in un prompt che scrivi, per esempio ultracode: audit every API endpoint under src/routes/ for missing auth checks. Claude Code evidenzia la parola e Claude scrive un workflow solo per quell'attività, senza cambiare il livello di sforzo della sessione. Anche dire «use a workflow» con parole tue funziona. Se l'hai scritta per sbaglio, Option+W su macOS o Alt+W su Windows e Linux toglie l'evidenziazione per quel prompt.

Per tutta la sessione: l'impostazione.

  • /effort ultracode lo attiva per la sessione corrente, /effort ultracode off lo disattiva. Nel cursore di /effort, Tab commuta l'interruttore Ultracode e Invio lo applica.
  • claude --effort ultracode avvia una sessione con ultracode attivo, e imposta anche il livello di sforzo su xhigh.
  • "ultracode": true in un file di impostazioni lo attiva per ogni sessione. Claude Code legge questa chiave ma non la scrive mai.

Per fermarlo definitivamente. Disattiva «Ultracode keyword trigger» in /config e la parola smette di avviare workflow. Disattiva «Dynamic workflows» in /config, imposta "disableWorkflows": true oppure CLAUDE_CODE_DISABLE_WORKFLOWS=1, e i workflow spariscono insieme a ultracode. Un'organizzazione può fare lo stesso nelle impostazioni gestite.

Due casi in cui semplicemente non viene proposto: i workflow sono disattivati, oppure il modello non supporta lo sforzo xhigh. I workflow in sé sono disponibili su tutti i piani a pagamento, con accesso all'API di Anthropic, e su Amazon Bedrock, Google Cloud e Microsoft Foundry; su Pro devi prima attivare la riga Dynamic workflows in /config.

Ultracode non è lo sforzo max

ImpostazioneCosa cambia
low, medium, highQuanto ragiona una chiamata al modello prima di rispondere
xhighUn ragionamento più profondo, con più token spesi
maxIl livello di ragionamento più profondo, per problemi difficili che vuoi vedere risolti senza di te
ultracodeCome è organizzato il lavoro: un workflow di più agenti, al livello a cui gira la sessione

Un livello di sforzo agisce su ogni chiamata. Ultracode agisce sulla forma del lavoro. Puoi usare ultracode in medium e puoi usare max senza ultracode.

La confusione ha una storia. I dynamic workflow sono arrivati in Claude Code v2.1.154 a fine maggio 2026, con workflow come parola di attivazione. Pochi giorni dopo, v2.1.160 ha rinominato la parola chiave in ultracode. Fino a v2.1.284, a fine settembre, attivare ultracode portava anche la sessione in xhigh, e scegliere un altro livello lo disattivava. Ecco perché tante pagine scritte durante l'estate dicono «ultracode è xhigh». Da v2.1.284 è un interruttore a parte che resta attivo a qualsiasi livello. L'unico residuo: l'opzione di avvio --effort ultracode imposta ancora xhigh nello stesso momento.

Cosa cambia quando è attivo

Attivare ultracode equivale ad accettare esecuzioni grandi, quindi tre protezioni tacciono:

  • l'avviso «Large workflow», mostrato di solito quando un workflow prevede più di 25 agenti o più di 1,5 milioni di token, non compare più;
  • il limite di subagenti simultanei della sessione non viene applicato ai subagenti che Claude lancia con lo strumento Agent;
  • in modalità di permessi auto, non ti viene più chiesto di approvare il primo avvio di un workflow.

Quello che resta valido è la linea guida sulla dimensione e i tetti del runtime. La linea guida è un consiglio che Claude Code passa a Claude quando scrive lo script: small significa meno di 5 agenti, medium meno di 10, large meno di 50. Il valore predefinito è medium, oppure small su un piano Pro. Lo cambi in /config (Dynamic workflow size) o con la chiave workflowSizeGuideline. Il runtime, da parte sua, esegue al massimo 16 agenti alla volta per impostazione predefinita e si rifiuta di superare 1.000 agenti in una stessa esecuzione.

Durante un'esecuzione, /workflows apre la vista di avanzamento, con il consumo di token di ogni agente, e da lì puoi fermarla.

Abbiamo eseguito la stessa revisione due volte

La documentazione di Anthropic dice che ultracode fa consumare più token a ogni richiesta e la rende più lunga. Volevamo un numero nostro, su un'attività reale, così abbiamo eseguito lo stesso lavoro due volte.

L'attività. Sei script di questo stesso sito, gli strumenti che i nostri agenti notturni usano per controllare link, traduzioni e invii a IndexNow: tre file Python e tre file TypeScript, 1.394 righe in tutto. Il prompt, identico nelle due esecuzioni: revisionare la cartella in cerca di bug reali (logica sbagliata, errori non gestiti che farebbero crashare il programma, casi limite sbagliati), non modificare alcun file, indicare per ogni bug il file, la riga e una correzione in una riga, ordinati per gravità.

La configurazione. Claude Code 2.1.318, Opus 5.5 con la finestra di contesto da 1M, una copia nuova dei sei file in una cartella usa e getta, strumenti in sola lettura (Read, Grep, Glob, più Agent e Workflow), linea guida sulla dimensione impostata su small, avviato con claude -p. L'esecuzione A con --effort xhigh. L'esecuzione B con --effort ultracode, che, come visto sopra, implica anche xhigh. Stesso modello, stesso livello di sforzo: l'unica differenza è ultracode.

Esecuzione A: xhighEsecuzione B: ultracode
Tempo reale6 min 8 s14 min 14 s
Agenti1, la sessionela sessione e 4 agenti del workflow
Token di input elaborati99.400735.111
Token di output (di cui ragionamento)39.054 (35.105)148.602 (126.222)
Costo di quei token a prezzo di listino1,20 dollari4,87 dollari
Cosa ha stampato il comando14 bug, ordinati per gravitàun messaggio che diceva che l'esecuzione era partita

La maggior parte dei token di input sono letture dalla cache (47.730 nell'esecuzione A, 424.037 nella B). La riga del costo è il prezzo di listino che Claude Code ha calcolato per quei token nel suo output JSON: con un abbonamento non si paga nulla a token, è una misura di quanto l'esecuzione attinge dai tuoi limiti.

Cosa ha fatto Claude con ultracode attivo. Per prima cosa ha letto da solo i sei file e ha elencato 23 bug sospetti. Poi ha scritto uno script di workflow in due fasi che rispettava la linea guida small: tre cercatori in parallelo, uno per gruppo di file (i due file TypeScript accoppiati, il controllore dei link, i tre script Python), poi uno scettico il cui unico compito era provare a confutare ogni candidato, compresi i suoi 23. È lo schema di verifica incrociata descritto dalla documentazione di Anthropic e, sulla carta, è esattamente quello che vuoi da una caccia ai bug.

Cosa hanno trovato i cercatori. 23 risultati. Coprono tutti i bug dell'esecuzione A che contano (file nuovi che non arrivano mai a IndexNow, la coda cancellata oltre 10.000 URL, il crash su un titolo senza virgolette, la rimozione della locale che non riconosce zh-TW, i link verso sé stessa che nascondono le pagine orfane) più 8 che l'esecuzione A non aveva segnalato, quasi tutti di gravità bassa: un controllo nofollow che si ferma al primo > dentro un attributo JSX, una regex di namespace che si ferma a un trattino, un audit che lascia fuori gli articoli del blog. Niente di grave che l'esecuzione A avesse mancato.

Cosa non è mai tornato. Con claude -p, Claude ha lanciato il workflow in background e ha chiuso il suo turno con «I'll send the final list, sorted by severity, when it finishes». Quella frase è ciò che il comando ha stampato. Il processo ha poi atteso ed è uscito 601 secondi dopo, mentre lo scettico stava ancora verificando: la lista verificata non è mai arrivata, e i risultati dei cercatori si potevano leggere solo nei file dell'esecuzione, sotto ~/.claude/projects/. Non abbiamo trovato alcun limite di attesa documentato per il lavoro in background in -p nelle pagine che abbiamo letto; è quello che abbiamo visto su 2.1.318. In una sessione interattiva la conversazione resta aperta e il risultato torna quando l'esecuzione finisce.

La nostra lettura. Su una revisione di sei file che una sola sessione può leggere per intero, ultracode ha comprato otto candidati in più di gravità bassa per circa quattro volte i token e più del doppio del tempo, e in uno script non ha consegnato la sua lista verificata. Sull'audit di un intero repository, che una sola conversazione non riesce a contenere, il conto è diverso. Su questa attività, xhigh semplice ha reso di più.

Cosa consuma e quando lasciarlo disattivato

Anthropic è esplicita sul prezzo: con ultracode attivo, «ogni richiesta consuma più token e richiede più tempo della stessa richiesta senza workflow», e con un abbonamento «una sessione con ultracode attivo raggiunge prima un limite di sessione o settimanale rispetto allo stesso lavoro senza». La nostra esecuzione è un singolo dato su un'attività, non un benchmark, ma va nella stessa direzione.

Lascialo disattivato:

  • per il lavoro di routine: una rinomina, una piccola correzione, una domanda sul codice;
  • quando la tua finestra di 5 ore o il tuo limite settimanale è già basso, perché una richiesta può trasformarsi in più workflow di seguito;
  • negli script e nelle attività pianificate: lì la parola chiave viene ignorata, e con l'opzione la nostra esecuzione claude -p è uscita prima che tornasse la verifica;
  • su Pro, dove Anthropic imposta già la dimensione predefinita su small.

Attivalo, preferibilmente per un'attività con la parola chiave invece che per tutta la sessione:

  • per lavori troppo ampi per una sola conversazione: l'audit di un intero repository, la migrazione di centinaia di file, una ricerca le cui fonti vanno confrontate tra loro;
  • quando vuoi che agenti indipendenti verifichino i risultati gli uni degli altri prima che tu li legga.

Prima di un'esecuzione grande, il consiglio della documentazione stessa è quello giusto: prova prima il workflow su una piccola porzione, tieni d'occhio /workflows e ferma l'esecuzione se il conteggio dei token ti sfugge di mano.

Come vediamo un agente ultracode da AgentsRoom

Facciamo girare la maggior parte dei nostri agenti in AgentsRoom, uno accanto all'altro, e ultracode ha rotto qualcosa prima di tutto nel nostro prodotto. Mentre un workflow è in esecuzione, il ciclo principale di Claude Code torna al suo prompt: l'unico segno di vita che resta è una riga di avanzamento nel pannello delle attività, qualcosa come 6/7 agents done · 5m 45s · 411.6k tokens, oppure «Waiting for 1 dynamic workflow to finish». Il nostro rilevamento dello stato leggeva quel prompt silenzioso come «finito» e segnava l'agente come inattivo mentre i subagenti del workflow stavano ancora lavorando. Ora AgentsRoom legge quella riga di avanzamento, quindi un agente che esegue un workflow resta «al lavoro» sulla sua scheda, sul desktop e sul telefono, finché non torna l'ultimo subagente.

Due note pratiche se fai lo stesso:

  • AgentsRoom avvia Claude Code con lo sforzo di ragionamento predefinito che scegli per ogni CLI, da low a max. Ultracode non è uno di questi livelli, perché non è un livello: scrivi /effort ultracode nel terminale dell'agente quando un'attività lo merita, e /effort ultracode off dopo.
  • La riga di avanzamento ti dà il conteggio dei token dell'esecuzione man mano che cresce. Il nostro contatore di token mostra accanto il consumo della sessione, e la finestra di 5 ore è la prima cosa che una lunga esecuzione ultracode intacca.

Domande frequenti

Cos'è ultracode in Claude Code?

Un'impostazione di Claude Code, non un livello di sforzo di ragionamento. Quando è attivo, Claude pianifica un dynamic workflow per ogni attività consistente: un breve script che lancia più subagenti e gira in background mentre la tua sessione resta utilizzabile. La parola chiave ultracode in un prompt scritto fa la stessa cosa solo per quell'attività.

Ultracode è la stessa cosa dello sforzo max?

No. I livelli di sforzo stabiliscono quanto ragiona una chiamata al modello. Ultracode stabilisce come è organizzato il lavoro, con più agenti invece di una sola conversazione. Da v2.1.284 resta attivo a qualsiasi livello di sforzo; l'opzione di avvio --effort ultracode è l'unico punto in cui arriva ancora insieme a xhigh.

Come attivo e disattivo ultracode?

Per un'attività, la parola chiave in un prompt che scrivi. Per la sessione, /effort ultracode e /effort ultracode off, oppure Tab nel cursore di /effort. All'avvio, claude --effort ultracode. Per ogni sessione, "ultracode": true in un file di impostazioni. Ultracode keyword trigger in /config disattiva la parola chiave; disableWorkflows toglie insieme i workflow e ultracode.

Ultracode consuma più token?

Sì. La documentazione di Anthropic dice che con un workflow ogni richiesta consuma più token e richiede più tempo, e che con un abbonamento raggiungi prima un limite di sessione o settimanale. Nella nostra esecuzione misurata, la stessa revisione di sei file su Opus 5.5 ha prodotto 148.602 token di output con ultracode contro 39.054 in xhigh semplice, circa quattro volte il costo a prezzo di listino (4,87 dollari contro 1,20), perché Claude ha letto i file da solo e poi ha lanciato altri quattro agenti.

Perché la parola ultracode non fa nulla con claude -p o in un'attività pianificata?

La parola conta solo quando l'ha scritta una persona: prompt interattivo, pannello dell'IDE, client Remote Control o un'app Agent SDK che segna l'input come umano. Con -p, un'attività pianificata, un webhook o un commento di pull request inoltrato, usa --effort ultracode o l'impostazione ultracode.

Ultracode c'entra qualcosa con il piano Claude Ultra o con ultrareview?

No. Ultra è l'abbonamento che Anthropic ha rinominato a partire da Max 20x, a 200 dollari al mese. Ultrareview è una revisione del codice nel cloud condotta da più agenti (/code-review ultra), in research preview, con tre esecuzioni gratuite su Pro, Max e Ultra e poi crediti di utilizzo. Ultracode è un'impostazione della tua sessione locale di Claude Code.

Scarica AgentsRoom

Esegui tutti i tuoi agenti AI, su tutti i tuoi progetti, da una sola finestra.

Scarica AgentsRoomGratis

App companion: monitora i tuoi agenti in movimento

Usa Claude, Codex, Antigravity CLI o un altro provider IA.

Invia bug e richieste direttamente nel tuo backlog pubblico.

Continua a leggere