Ultracode in Claude Code 2026: come attivarlo con un solo comando

Per informazioni su come lavorare con il servizio, consulta la documentazione di Ailoot.

Cos'è ultracode e a chi serve#

Fino al 28 maggio 2026, Claude Code aveva solo il parametro /effort, con i livelli low / medium / high / xhigh. Questo indica il livello di «pensiero» del modello: più è alto, più token vengono spesi per il ragionamento, più accurato è il risultato e più tempo impiega Claude a rispondere.

Ultracode non rientra nella scala /effort low → xhigh. Si affianca a essa. Quando è attivo, Claude esamina automaticamente la tua attività e decide: «È meglio suddividerla tra 30 agenti paralleli, così potrò assemblare il risultato». Prima dovevi farlo manualmente scrivendo un workflow personalizzato o assemblando un comando per subagenti. Ora Claude decide autonomamente quando ha senso farlo.

Il pubblico principale è composto da persone che hanno raggiunto il limite di un singolo prompt. Se hai:

• eseguito /code-review su un repo con 200 file e la sessione si è bloccata al file 50
• chiesto «trova tutti i punti in cui usiamo l'API deprecata» e Claude ne ha elencati tre dimenticandone altri quindici
• bisogno che Claude verifichi la propria ipotesi da tre prospettive prima di darti una risposta

ultracode fa al caso tuo. Se stai scrivendo una funzione e ti serve una sola soluzione, non ne hai bisogno: il normale /effort high farà il lavoro con un terzo dei token.

In cosa ultracode si differenzia dai normali livelli di effort low/medium/high/xhigh#

Ecco un confronto degli elementi essenziali:

La differenza principale in una riga: /effort xhigh significa «pensa più a lungo»; ultracode significa «pensa più a lungo E decidi autonomamente quando puoi gestire l'attività con un solo prompt e quando ti serve un team di 30 agenti». In sostanza, ultracode aggiunge un ulteriore livello a xhigh: l'orchestrazione automatica.

Anthropic lo dichiara esplicitamente nella documentazione ufficiale:

Questo significa che una tua richiesta può articolarsi in tre workflow consecutivi: comprendere il codice, apportare le modifiche e verificarle. Ognuno può avviare 10–30 agenti paralleli.

Quali versioni e modelli supportano ultracode#

Controlla la tua versione:

claude --version

Se è precedente a 2.1.154, aggiornala:

npm install -g @anthropic-ai/claude-code

Poi controlla l'elenco dei livelli di effort:

claude /effort

Se nel menu a discesa vedi ultracode, è tutto pronto. Se non compare, è molto probabile che:

• il modello attuale non sia Opus 4.8 (per esempio, Sonnet 4.7 non ha xhigh)
• tu abbia un piano Pro e la modalità sia disattivata in /config (attiva l'opzione «Dynamic workflows»)
• l'amministratore della tua organizzazione abbia disattivato i workflow nelle impostazioni gestite

Controlla il modello:

claude /model

Se il modello predefinito non è Opus 4.8, cambialo: seleziona Opus 4.8 nel menu dei modelli oppure impostalo come predefinito con il tasto d.

Come attivare ultracode: due metodi#

Metodo 1. Attivalo per l'intera sessione.

In una sessione di Claude Code:

/effort ultracode

Da quel momento, Claude deciderà autonomamente se avviare un workflow per ogni attività sostanziale. La sessione dura finché non la chiudi. Quando chiudi Claude Code e lo riapri, ultracode si reimposta. È intenzionale: dovresti attivare questa modalità consapevolmente, invece di averla «predefinita».

Metodo 2. Solo per una singola attività.

Metti ultracode all'inizio del prompt (prima della v2.1.160, la parola chiave era workflow; dopo il rilascio, Anthropic ha rinominato il trigger per evitare confusione con le esecuzioni normali):

ultracode: controlla tutti gli endpoint /api/* in src/routes/ e trova i punti in cui mancano i controlli di autorizzazione

Claude Code evidenzierà la parola ultracode e avvierà l'attività come workflow. Il livello di effort della sessione resta invariato (high o medium, a seconda di quello che hai impostato).

Anthropic scrive che funziona anche in linguaggio naturale:

Se hai digitato per errore ultracode e non volevi avviare un workflow, premi Option+W (macOS) o Alt+W (Windows/Linux) mentre il cursore è subito dopo la parola evidenziata. L'evidenziazione scomparirà e l'attività proseguirà normalmente.

Cosa cambia nel lavoro di Claude dopo l'attivazione#

Prima di ultracode: scrivi un prompt, Claude riflette per 30 secondi e risponde. Se l'attività è grande, il suo contesto si riempie di risultati intermedi e, verso la fine della sessione, tutto comincia a «deragliare».

Con ultracode: scrivi un prompt, Claude ne valuta la portata e scrive uno script. Lo script viene eseguito in isolamento: i risultati intermedi sono mantenuti nelle variabili dello script, non nel contesto della sessione. A te torna solo la risposta finale.

In pratica, questo ha tre effetti:

1. Il contesto della sessione non si riempie. Puoi lavorare più a lungo senza /compact.
2. Puoi parallelizzare. Un'esecuzione può avviare fino a 16 agenti contemporaneamente (meno sui computer con poca CPU). Il limite per l'intera esecuzione è 1000 agenti.
3. Il risultato viene controllato automaticamente. Claude può chiedere a un agente di scrivere una soluzione e a un altro di esaminarla criticamente. Questo riduce le allucinazioni nelle attività complesse.

Puoi seguire un'esecuzione in tempo reale:

/workflows

Si aprirà un elenco dei workflow in corso e completati. Usa i tasti freccia per selezionarne uno e Invio per aprire i dettagli delle sue fasi. Puoi vedere gli agenti, i token utilizzati da ciascuno e il tempo di esecuzione. Premi p per mettere in pausa, x per interrompere o r per riavviare un agente.

Quando attivare ultracode e quando no#

Tre situazioni in cui ultracode è giustificato:

1. Controllare una codebase estesa. Per esempio: «trova tutti i punti del progetto in cui registriamo le password nei log». Un solo prompt funziona solo su un repo piccolo. In un repo di 500 file, un singolo Claude ne dimenticherà metà, mentre un workflow avvierà 20 agenti in parallelo, ognuno dei quali gestirà 25 file.

2. Una migrazione che coinvolge molti file. Sostituire un'API deprecata, passare da una libreria a un'altra o rifattorizzare un pattern in tutto il progetto. Un workflow può elaborare i file in gruppi di 10, controllandosi dopo ogni gruppo.

3. Ricerche che richiedono il confronto incrociato delle fonti. Anthropic ha raccolto questa funzionalità nel workflow /deep-research: scompone una domanda in vari aspetti, trova le fonti, confronta i fatti e filtra tutto ciò che non è stato possibile verificare. L'ho eseguito per raccogliere dati sul mercato della programmazione con AI e ho ottenuto un report migliore di un'ora di lavoro manuale.

Tre situazioni in cui ultracode spreca token:

1. Correggere un bug in una singola funzione. Un solo prompt /effort high può farlo a un decimo del costo. Non avviare un workflow per questo.

2. Scrivere una singola funzione o un componente nuovo. Stessa cosa: usa /effort high o anche medium. La complessità non aumenta con il numero di agenti; aumenta con la profondità del ragionamento, che xhigh fornisce già da solo, senza orchestrazione.

3. Ti serve una risposta rapida. Per definizione, un workflow è più lento di un prompt normale: anche con agenti paralleli, il coordinamento richiede tempo. Se ti serve «subito, entro lo stesso minuto», non attivarlo.

La strategia dell'esempio descritto qui: usare /effort high come impostazione predefinita per le modifiche di routine. Attivo ultracode in modo selettivo per un'attività specifica, usando la parola nel prompt e non per l'intera sessione. Così non rischio di dimenticare di disattivarlo e continuare il lavoro di routine dopo l'attività in ultracode, consumando token senza motivo.

Quanti token e quanto denaro costa#

Facciamo una stima approssimativa. Un normale prompt su Opus 4.8 con effort high usa circa 5.000–15.000 token per il ragionamento, oltre alla risposta del modello. Un'attività ampia e impegnativa usa in totale 50.000–100.000 token.

Un workflow con 20 agenti significa 20 prompt paralleli, ognuno con il proprio contesto del prompt di sistema (~5–10K), il proprio ragionamento (xhigh — 10–30K) e la propria risposta. Una stima approssimativa è 600.000–1,5 milioni di token per un'esecuzione. Costa dalle 10 alle 30 volte più di un prompt «normale».

Ecco cosa significa in termini di denaro:

• Pro ($20/mese): nel febbraio 2026, Anthropic ha chiarito il divieto di accesso programmatico da software di terze parti e il 15 giugno 2026 ha separato il credito per i workflow dall'abbonamento chat. Pro include $20 di credito per i carichi di lavoro programmatici. Un workflow grande ne consumerà la metà. Quando il credito finisce, i workflow smettono di avviarsi finché non attivi gli addebiti per gli extra.
• Max 5x ($100/mese): $100 di credito. Bastano per 5–10 workflow grandi al mese.
• Max 20x ($200/mese): $200 di credito.
• Team ($30/$150 per membro): il credito rispecchia il piano di abbonamento di ciascun posto.
• API: paghi semplicemente la tariffa per i token.

Anthropic stessa consiglia di stimare il costo prima di avviare un workflow:

In altre parole, esegui prima il workflow su una cartella, controlla /workflows per vedere quanto è costato e poi decidi se eseguirlo sull'intero repo. Un'esecuzione ha un limite complessivo di 1000 agenti, ma anche 100 su un repo grande significano già centinaia di migliaia di token.

Se il tuo obiettivo è «ridurre l'utilizzo», puoi indirizzare esplicitamente le fasi secondarie a un modello più piccolo nello script del workflow. Nel prompt: «usa Sonnet 4.7 per la fase di classificazione dei file e Opus 4.8 solo per l'analisi finale». Anthropic lo supporta.

Cosa succede all'interno: workflow, /workflows e limiti#

Ogni esecuzione scrive il proprio script in un file in ~/.claude/projects/. Claude riceve il percorso dello script all'avvio dell'esecuzione. Questo significa che puoi:

• chiedere a Claude «mostrami lo script di questo workflow»
• aprirlo in un editor e ispezionarne la logica
• confrontarlo con l'esecuzione precedente
• modificarlo e chiedere a Claude di rieseguire la versione modificata

Il runtime impone questi limiti:

A ogni esecuzione viene applicata una modalità di autorizzazione. Per impostazione predefinita, Claude Code chiede il permesso ogni volta. Puoi scegliere «Sì e non chiedermelo più per <name> in <path>»; da quel momento, quel workflow specifico in quel progetto non chiederà più. In modalità Auto, chiede solo alla prima esecuzione e poi salva l'approvazione nelle impostazioni utente. In claude -p e nell'Agent SDK non chiede perché non c'è nessuno a cui chiedere.

Un dettaglio importante: i subagenti nei workflow vengono sempre eseguiti in modalità acceptEdits ed ereditano la tua allowlist di strumenti, indipendentemente dalla modalità di autorizzazione corrente. Le modifiche ai file vengono approvate automaticamente. Tienilo presente se stai lavorando a qualcosa di critico.

Come salvare un workflow funzionante come comando#

Scenario: ho eseguito /code-review tramite ultracode su un nuovo branch. Il workflow ha fatto tre esecuzioni: la prima era una revisione rapida dell'intero diff, la seconda un controllo approfondito delle funzioni di sicurezza e la terza ha eseguito i test sulle funzioni modificate. I risultati converge­vano bene e sono stati individuati due problemi.

Ora voglio eseguire questa procedura su ogni branch prima del merge. Apro:

/workflows

Seleziono l'esecuzione completata e premo s. Nella finestra di dialogo scelgo dove salvarla: .claude/workflows/ (nel progetto, in git, disponibile al team) oppure ~/.claude/workflows/ (personale, per qualsiasi progetto). Le assegno un nome, per esempio pre-merge-review. Premo Invio.

Ora, in qualsiasi sessione futura:

/pre-merge-review

E il workflow parte con lo stesso script che ho verificato.

Se il workflow si aspetta argomenti, descrivili nel prompt quando lo salvi; così lo script riceverà args come variabile globale. Puoi passare un elenco di percorsi, numeri di issue, ID di file o qualsiasi altra cosa.

Anthropic specifica che gli argomenti arrivano come dati strutturati:

Questo significa che puoi usare direttamente args.map(...) nello script, senza analizzare una stringa. È utile per attività di massa: un elenco di ticket, cartelle o endpoint.

Come disattivare ultracode e perché potresti farlo#

Il motivo principale per disattivarlo è tornare al lavoro di routine. Se sei passato a ultracode per un'attività grande e l'hai terminata, torna subito indietro:

/effort high

Altrimenti, la tua prossima piccola modifica verrà eseguita come workflow e consumerà token senza alcun vantaggio.

Per usare solo la parola chiave, lascia attivi i Dynamic workflows e mantieni un normale livello di effort, come /effort high; aggiungi ultracode soltanto all’attività scelta. Non usare a questo scopo la disattivazione globale qui sotto, perché disabilita anche la parola chiave. Se invece vuoi vietare sia i workflow della sessione sia quelli attivati dalla parola chiave, usa una di queste opzioni globali:

# nelle impostazioni del client
# /config → Dynamic workflows → off
# oppure
# ~/.claude/settings.json
{
  "disableWorkflows": true
}

# oppure tramite variabile d'ambiente
export CLAUDE_CODE_DISABLE_WORKFLOWS=1

Dopodiché, la parola chiave ultracode in un prompt non avvierà più un workflow e l'opzione ultracode scomparirà dal menu /effort. È utile se lavori in un team che vuole una regola condivisa: «nessun workflow automatico». In tal caso, configurala nelle impostazioni gestite dell'organizzazione.

Tengo /effort high come impostazione predefinita e attivo ultracode in modo selettivo. È un compromesso tra «fallo bene quando serve» e «non bruciare il budget senza motivo». Per le modifiche di routine nel progetto qui descritto, il livello high normale è sufficiente. Quando devo eseguire un audit di sicurezza esteso o raccogliere ricerche da 20 fonti, uso /effort ultracode oppure metto la parola all'inizio del prompt.

Cosa fare dopo#

Se stai usando Claude Code adesso e hai verificato che hai v2.1.154+ e il modello Opus 4.8, provalo subito. Non per l'intera sessione, ma per un'attività specifica:

ultracode: controlla tutti i file in src/components/ui/ e trova i punti in cui lo stesso pulsante è stilizzato in modo diverso

Controlla /workflows per vedere quanti agenti sono stati avviati e quanti token sono stati usati. Ti darà un'idea più realistica dei costi e dei vantaggi di quanto possa fare qualsiasi testo.

Fonti#

Vedi anche:

• Dynamic workflows in Claude Code: how to orchestrate hundreds of parallel agents
• Multi-agent in Claude Code: how to parallelize subagents
• Routines in Claude Code: automate with a schedule instead of cron
• Sonnet or Opus in Claude Code: which model to use for which task
• Goal mode in Claude Code and Codex: set a goal and work toward it

Scopri Ailoot.