SpyBara
Go Premium

fast-mode.md 2026-11-12 23:02 UTC to 2026-11-13 00:00 UTC

No changes for this document in this history range.

2026
Mon 2 23:57 Fri 6 23:01 Mon 9 23:02 Tue 10 21:57 Thu 12 23:02

Accelera le risposte con la modalità veloce

Ottieni risposte più veloci di Opus e Fable in Claude Code attivando la modalità veloce con /fast.

[!NOTE]

La modalità veloce per Claude Fable 5.2 e Claude Opus 5.5 è disponibile. La modalità veloce per Claude Opus 5 e Claude Opus 4.8 è in anteprima di ricerca.

La modalità veloce è una configurazione ad alta velocità per i modelli supportati, che rende il modello fino a 2,5 volte più veloce a un costo per token più elevato. Attivala con /fast quando hai bisogno di velocità per il lavoro interattivo come l'iterazione rapida o il debug in tempo reale, e disattivala quando il costo è più importante della latenza.

La modalità veloce utilizza lo stesso modello con una configurazione API diversa che dà priorità alla velocità rispetto all'efficienza dei costi, quindi qualità e capacità restano le stesse. Sull'API Anthropic, la modalità veloce è supportata su Fable 5.2, Opus 5.5, Opus 5 e Opus 4.8, ma non su Sonnet, Haiku o altri modelli. Per i modelli su Agent Platform di Google Cloud, consulta Usare la modalità veloce su Agent Platform.

[!WARNING]

La modalità veloce per Opus 4.8 è stata deprecata il 30 ottobre 2026 e verrà rimossa il 30 novembre 2026. Se dopo tale data il tuo modello è ancora Opus 4.8 con la modalità veloce attiva, l'API rifiuta le tue richieste. Entro quella data, passa a Opus 5.5 oppure disattiva la modalità veloce nella tua sessione:

Opus 4.7 non supporta la modalità veloce, quindi il passaggio ad esso disattiva la modalità veloce. La modalità veloce per Opus 4.7 è stata deprecata il 25 giugno 2026 e rimossa il 24 luglio 2026.

Cosa sapere:

  • Usa /fast per attivare/disattivare la modalità veloce in Claude Code CLI. L'estensione VS Code offre un comando Toggle fast mode quando il modello selezionato supporta la modalità veloce. Sull'API Anthropic, Claude Code salva tale attivazione/disattivazione nella tua impostazione fastMode.
  • I prezzi della modalità veloce di Anthropic per MTok input/output sono $16/$80 su Fable 5.2, $8/$40 su Opus 5.5 e $10/$50 su Opus 5 e Opus 4.8.
  • Disponibile per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise), su Claude Console e su Agent Platform di Google Cloud a determinate condizioni. Le organizzazioni Team ed Enterprise hanno bisogno che un Owner la abiliti prima, e le organizzazioni Console hanno bisogno che l'accesso sia fornito prima di poterla usare con Opus 5 o Opus 4.8. Requisiti descrive entrambi i casi.
  • Per gli utenti di Claude Code sui piani di abbonamento (Pro/Max/Ultra/Team/Enterprise), la modalità veloce è disponibile solo tramite crediti di utilizzo e non è inclusa nei rate limit dell'abbonamento.

Attivare o disattivare la modalità veloce

Su Agent Platform, /fast e l'impostazione fastMode funzionano diversamente, quindi segui invece Usare la modalità veloce su Agent Platform.

Nella CLI, attiva o disattiva la modalità veloce in uno di questi modi:

  • Esegui /fast, premi Space per attivarla o disattivarla, quindi premi Enter per confermare
  • Su un modello che supporta la modalità veloce, imposta "fastMode": true nel tuo file di impostazioni utente. Se la imposti su qualsiasi altro modello, rimani su quel modello con la modalità veloce disattivata. Su Fable 5.2, quell'impostazione da sola non ha effetto finché non esegui /fast mentre usi Fable 5.2.

Per impostazione predefinita sull'API Anthropic, la modalità veloce che attivi in una sessione interattiva persiste tra le sessioni su un modello supportato. Su Fable 5.2, persiste solo se l'hai attivata mentre usavi Fable 5.2. Puoi configurare la modalità veloce in modo che si reimposti a ogni sessione. Consulta richiedere l'attivazione per sessione per i dettagli.

Al di fuori di una sessione cloud, in modalità non interattiva con il flag -p, /fast funziona solo in una sessione avviata con la modalità veloce nel valore di --settings, ad esempio claude -p --settings '{"fastMode": true}'; l'attivazione o disattivazione si applica quindi solo a quella sessione e non viene salvata come impostazione predefinita. La forma con -p richiede Claude Code v2.1.205 o successiva. Altrove in modalità non interattiva, il comando segnala che la modalità veloce non è disponibile.

Puoi eseguire /fast mentre Claude sta lavorando, e Claude Code attiva o disattiva la modalità veloce senza attendere la fine del turno. Claude Code completa il turno in corso alla velocità originale, quindi il cambio di velocità ha effetto dal tuo turno successivo. Se il tuo modello attuale non supporta la modalità veloce, attivarla cambia anche il modello, e Claude Code usa il nuovo modello dalla sua richiesta successiva in quel turno.

Per la migliore efficienza dei costi, attiva la modalità veloce all'inizio di una sessione anziché cambiarla a metà conversazione. Consulta comprendere il compromesso sui costi per i dettagli.

Quando attivi la modalità veloce con /fast:

  • Sull'API Anthropic, se il tuo modello attuale non supporta la modalità veloce, Claude Code passa a Opus
  • La modalità veloce su Fable 5.2 richiede Claude Code v2.1.321 o successiva
  • Vedrai un messaggio di conferma: "Fast mode ON"
  • Una piccola icona ↯ appare accanto al prompt mentre la modalità veloce è attiva
  • Esegui di nuovo /fast in qualsiasi momento per verificare se la modalità veloce è attiva o disattivata

Sull'API Anthropic, Opus 5.5 è il modello predefinito della modalità veloce in Claude Code v2.1.280 e successive. Prima della v2.1.280, la modalità veloce usava come predefinito Opus 5 a partire dalla v2.1.219.

Quando disattivi la modalità veloce eseguendo di nuovo /fast, rimani sul tuo modello attuale. Per passare a un modello diverso, usa /model.

Cambiare modello mentre la modalità veloce è attiva

La modalità veloce segue i tuoi cambi di modello:

  • Passaggio a un altro modello: quando passi a un modello che non supporta la modalità veloce, Claude Code disattiva la modalità veloce. Questo include Opus 4.7; prima della v2.1.221, la modalità veloce rimaneva attiva dopo il passaggio a Opus 4.7 e l'API rifiutava le richieste.
  • Ritorno: la modalità veloce si riattiva su un modello Opus supportato quando la tua preferenza salvata è attiva. Con l'attivazione per sessione, esegui invece /fast.
  • Passaggio a Fable 5.2: la modalità veloce si disattiva a meno che tu non l'abbia attivata mentre usavi Fable 5.2. Per attivarla, esegui /fast su Fable 5.2. A meno che tu non abbia impostato l'attivazione per sessione, questa scelta persiste tra le sessioni sull'API Anthropic finché non disattivi la modalità veloce o non la attivi con un altro modello.

Ogni volta che un cambio di modello attiva o disattiva la modalità veloce, Claude Code mostra una conferma Fast mode ON o Fast mode OFF, e l'icona ↯ appare mentre la modalità veloce è attiva. Questo vale sia che cambi modello con /model, con /config model=<model>, o da un dispositivo connesso tramite Remote Control.

Usare la modalità veloce nelle sessioni cloud

La modalità veloce funziona nelle sessioni cloud quando è disponibile sul tuo account, sia che la sessione venga eseguita su infrastruttura gestita da Anthropic sia su un runner self-hosted sull'API Anthropic. Richiede Claude Code v2.1.271 o successiva nell'ambiente della sessione.

Digita /fast on nella sessione per attivare la modalità veloce. Rimane attiva solo per quella sessione e non viene salvata come impostazione predefinita. I requisiti si applicano anche nelle sessioni cloud.

Nel browser su claude.ai/code, puoi anche attivare e disattivare la modalità veloce dal menu del modello nella casella dei messaggi. Il menu mostra l'interruttore quando il tuo piano include la modalità veloce e il modello selezionato la supporta.

Comprendi il compromesso di costo

La modalità veloce ha un prezzo per token più elevato rispetto alla velocità standard. Queste sono le tariffe di Anthropic:

Modello Input (MTok) Output (MTok)
Fable 5.2 $16 $80
Opus 5.5 $8 $40
Opus 5 $10 $50
Opus 4.8 $10 $50

I prezzi della modalità veloce sono fissi su tutta la finestra di contesto di 1M token. Per il tasso standard da confrontare, consulta il riferimento sui prezzi di Claude.

La prima volta che abiliti la modalità veloce in una conversazione, paghi il prezzo completo del token di input non memorizzato nella cache della modalità veloce per l'intero contesto della conversazione. Più avanti sei nella conversazione, più questo costa, quindi l'addebito è minimo quando abiliti la modalità veloce all'inizio. La modalità veloce e la velocità standard mantengono cache separate, quindi ogni passaggio successivo rilegge di nuovo una parte o l'intera conversazione senza cache.

Vedi dove appare la spesa della modalità veloce

Vedi la spesa della modalità veloce in un posto diverso a seconda di come hai effettuato l'accesso, quindi prima esegui /status per verificare. Se mostra una riga Login method come Claude Max account, hai effettuato l'accesso con un abbonamento Claude. Se mostra invece una riga API key, le tue richieste vengono fatturate a un'organizzazione Claude Console.

  • Pro, Max e Ultra: paghi la modalità veloce dai tuoi crediti di utilizzo. Vai a Settings > Usage su claude.ai, dove la sezione Usage credits mostra quanto hai speso in crediti di utilizzo questo mese. Quella cifra include la modalità veloce ma non la separa singolarmente.
  • Team ed Enterprise: la tua organizzazione paga l'utilizzo della modalità veloce dai suoi crediti di utilizzo. Per vedere la tua spesa in crediti di utilizzo, esegui /usage. Per vedere dove la tua organizzazione vede quella spesa, consulta Claude per Teams ed Enterprise.
  • Claude Console: la tua organizzazione paga la modalità veloce insieme al resto dell'utilizzo della sua API. Sulle pagine Usage e Cost di Console, seleziona Speed nel menu Group by per separare la modalità veloce dall'utilizzo a velocità standard. Vedi quell'opzione solo quando l'intervallo di date selezionato include l'utilizzo della modalità veloce.

Decidi quando usare la modalità veloce

La modalità veloce è migliore per il lavoro interattivo dove la latenza della risposta è più importante del costo:

  • Iterazione rapida su modifiche del codice
  • Sessioni di debug in tempo reale
  • Lavoro sensibile al tempo con scadenze strette

La modalità standard è migliore per:

  • Attività autonome lunghe dove la velocità è meno importante
  • Elaborazione batch o pipeline CI/CD
  • Carichi di lavoro sensibili ai costi

Modalità veloce rispetto al livello di sforzo

La modalità veloce e il livello di sforzo influenzano entrambi la velocità di risposta, ma in modo diverso:

Impostazione Effetto
Modalità veloce Stessa qualità del modello, latenza inferiore, costo più elevato
Livello di sforzo inferiore Meno tempo di riflessione, risposte più veloci, potenzialmente qualità inferiore su attività complesse

Puoi combinare entrambi: usa la modalità veloce con un livello di sforzo inferiore per la massima velocità su attività semplici.

Requisiti

La modalità veloce richiede tutti i seguenti elementi:

  • Provider supportato: la modalità veloce è disponibile tramite l'API Anthropic Console, per i piani di abbonamento Claude utilizzando i crediti di utilizzo, e su Google Cloud's Agent Platform con alcune condizioni. Non è disponibile su Amazon Bedrock, Microsoft Foundry o Claude Platform su AWS, dove /fast segnala "Fast mode is not available on this provider". Le organizzazioni Console devono anche avere l'accesso alla modalità veloce abilitato per usarla con Opus 5 o Opus 4.8.
  • Crediti di utilizzo attivati per i piani di abbonamento: su un piano Pro, Max, Ultra, Team o Enterprise, il tuo account deve avere i crediti di utilizzo attivati, il che consente la fatturazione oltre l'utilizzo incluso nel tuo piano. Finché non sono attivati, /fast segnala "Fast mode requires usage credits". Per attivarli, segui il passaggio relativo al tuo piano:
    • Su Pro, Max e Ultra, attivali nella sezione Usage credits di Settings > Usage su claude.ai, oppure esegui /usage-credits per aprire quella pagina.
    • Su Team e Enterprise, un membro con accesso alla fatturazione li attiva per l'organizzazione in Organization settings > Usage, e un membro senza accesso esegue /usage-credits per inviare una richiesta agli amministratori dell'organizzazione.

[!NOTE]

L'utilizzo della modalità veloce viene fatturato direttamente dai crediti di utilizzo, anche se hai un utilizzo rimanente nel tuo piano.

  • Organizzazione Console a pagamento: gli account Claude Console non utilizzano crediti di utilizzo e la tua organizzazione paga la modalità veloce per token insieme al resto dell'utilizzo dell'API. Nel piano Evaluation gratuito della Console, /fast mostra "Fast mode unavailable during evaluation. Please purchase credits." Per cancellarlo, acquista crediti nelle tue impostazioni di fatturazione della Console.

    La modalità veloce con Fable 5.2 o Opus 5.5 dipende anche dal livello di utilizzo della tua organizzazione.

  • Abilitazione del proprietario per Team e Enterprise: la modalità veloce è disabilitata per impostazione predefinita per le organizzazioni Team e Enterprise. Un proprietario deve esplicitamente abilitare la modalità veloce prima che gli utenti possano accedervi.

[!NOTE]

Quattro impostazioni organizzative possono bloccare l'attivazione della modalità veloce con /fast:

  • Modalità veloce non abilitata: se la modalità veloce non è stata abilitata per la tua organizzazione, l'attivazione della modalità veloce con /fast mostra "Fast mode has been disabled by your organization."
  • Modalità veloce disattivata dalle impostazioni gestite: se la tua organizzazione distribuisce impostazioni gestite che impostano fastMode: false, l'attivazione della modalità veloce con /fast mostra lo stesso messaggio "Fast mode has been disabled by your organization".
  • Opt-in per sessione richiesto: le impostazioni gestite che impostano fastModePerSessionOptIn: true rifiutano /fast on con lo stesso messaggio ovunque tranne in una sessione di terminale interattiva.
  • Modello modalità veloce non consentito: se l'allowlist availableModels della tua organizzazione esclude il modello a cui /fast passa, l'attivazione viene rifiutata con "is not in your organization's allowed models". In una sessione già in esecuzione su un modello consentito che supporta la modalità veloce, /fast abilita invece la modalità veloce sul tuo modello attuale senza cambiare modelli.

Abilita la modalità veloce per la tua organizzazione

Dove abiliti la modalità veloce dipende da quale prodotto utilizza la tua organizzazione:

Le organizzazioni Console che utilizzano Claude Opus 5 o Claude Opus 4.8 necessitano anche di un accesso abilitato, come descritto in modalità veloce sull'API Claude. Senza tale accesso, le richieste di modalità veloce su questi modelli incorrono nel rate limit della modalità veloce e tornano alla velocità standard finché l'accesso non viene abilitato.

Un'altra opzione per disabilitare completamente la modalità veloce è impostare CLAUDE_CODE_DISABLE_FAST_MODE=1. Vedi Variabili di ambiente.

Usa la modalità veloce su Agent Platform

Su Google Cloud's Agent Platform, puoi attivare la modalità veloce per Fable 5.2, con /fast in una sessione interattiva o con i flag di avvio in modalità non interattiva. Richiede Claude Code v2.1.322 o versioni successive.

La modalità veloce richiede che la regione per Fable 5.2 sia global, us o eu. In un'altra regione, /fast segnala Fast mode needs Vertex region global, us or eu e claude -p viene eseguito a velocità standard. Imposta la regione nella tua shell prima di avviare Claude Code, ad esempio su global:

export VERTEX_REGION_CLAUDE_FABLE_5_2=global

Quindi attiva la modalità veloce:

  • In una sessione interattiva: esegui /fast. Ti fa passare a Fable 5.2 da un modello Opus o da un altro modello senza modalità veloce su Agent Platform. La modalità veloce non viene salvata come impostazione predefinita.
  • In modalità non interattiva: passa Fable 5.2 come --model e la modalità veloce in --settings, ad esempio claude -p "Summarize this project" --model claude-fable-5-2 --settings '{"fastMode": true}'

Su Agent Platform, "fastMode": true nelle tue impostazioni utente, di progetto, locali o gestite non ha alcun effetto.

Se Agent Platform rifiuta la modalità veloce, Claude Code torna alla velocità standard. Una sessione interattiva mostra quindi uno di questi messaggi nel terminale:

  • Using standard speed on Fable 5.2 · fast mode wasn't available: esegui /fast on per provare di nuovo la modalità veloce
  • Fast mode was refused for this project · trying again in 30m: Agent Platform ha risposto a una richiesta di modalità veloce con un errore 403 o 404. Per riprovare prima, esegui /fast on.

Usa la modalità veloce dietro proxy e gateway LLM

Prima di offrire la modalità veloce sull'API Anthropic, Claude Code verifica la disponibilità della modalità veloce della tua organizzazione con una richiesta diretta a api.anthropic.com. Il controllo non segue ANTHROPIC_BASE_URL, quindi su una rete che instrada il traffico Claude attraverso un gateway LLM e blocca l'uscita diretta a api.anthropic.com, il controllo fallisce anche se le richieste di inferenza funzionano.

Il controllo utilizza invece un proxy HTTP configurato, quindi un blocco di rete fallisce il controllo solo dove api.anthropic.com è irraggiungibile anche attraverso il proxy. Se la tua organizzazione ha la modalità veloce abilitata e /fast indica il contrario, trova il messaggio che mostra tra questi casi.

Fast mode unavailable due to network connectivity issues

Il controllo di disponibilità è fallito, ad esempio perché la tua rete blocca api.anthropic.com, e le richieste vengono eseguite a velocità standard. Un controllo che ha avuto successo in passato continua a funzionare dal suo risultato memorizzato nella cache, quindi un controllo bloccato influisce principalmente sulle nuove installazioni.

Per ripristinare la modalità veloce, aggiungi all'allowlist l'uscita diretta a api.anthropic.com, oppure imposta CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1, che tratta un controllo fallito come disponibile e rispetta comunque una risposta "disabled by your organization".

Fast mode is currently unavailable

Dietro un gateway, verifica la presenza di queste configurazioni, in cui Claude Code non invia il controllo di disponibilità e non ha in cache alcun controllo precedente riuscito:

Per ripristinare la modalità veloce in entrambe le configurazioni, imposta CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1.

Fast mode has been disabled by your organization

Dietro un gateway, puoi vedere questo messaggio anche quando la tua organizzazione ha la modalità veloce abilitata, in una di queste configurazioni:

  • Ti autentichi solo con ANTHROPIC_AUTH_TOKEN, senza accesso a claude.ai, senza chiave API e senza un controllo riuscito in cache. Claude Code tratta quindi la modalità veloce come disabilitata dalla tua organizzazione senza inviare la richiesta.
  • Un proxy intercetta il controllo e risponde con la sua stessa pagina, ad esempio un proxy che ispeziona TLS restituendo una pagina di blocco HTTP 200. Claude Code legge quella pagina come una risposta che indica che la tua organizzazione ha la modalità veloce disabilitata.

In entrambi i casi, imposta CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1, che salta completamente il controllo, anziché CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS, che non si applica a nessuno dei due.

[!NOTE]

Le variabili di salto modificano solo il controllo lato client. Quando la tua organizzazione ha la modalità veloce disabilitata, l'API rifiuta le richieste di modalità veloce indipendentemente dal fatto che siano impostate o meno. Claude Code quindi riprova la richiesta a velocità standard, disattiva la modalità veloce, e /fast segnala che la tua organizzazione ha disabilitato la modalità veloce.

Richiedi opt-in per sessione

Per impostazione predefinita sull'API Anthropic, la modalità veloce che un utente attiva in una sessione interattiva persiste tra le sessioni su un modello supportato. Su Fable 5.2, la modalità veloce persiste solo se l'utente l'ha attivata mentre usava Fable 5.2.

Per fare in modo che ogni sessione inizi con la modalità veloce disattivata, imposta fastModePerSessionOptIn a true in qualsiasi file di impostazioni. Gli utenti la abilitano quindi con /fast in ogni sessione. Gli Owner sui piani Team o Enterprise possono distribuirlo a livello organizzativo tramite impostazioni gestite dal server.

{
  "fastModePerSessionOptIn": true
}

Questo è utile per controllare i costi nelle organizzazioni in cui gli utenti eseguono più sessioni simultanee. La preferenza della modalità veloce dell'utente è ancora salvata, quindi rimuovere questa impostazione ripristina il comportamento persistente predefinito.

Quando le impostazioni gestite impostano la chiave, /fast on funziona solo in una sessione di terminale interattiva. Ovunque altro, inclusa la modalità non interattiva, l'estensione VS Code e le sessioni cloud, viene rifiutato con un messaggio che la tua organizzazione ha disabilitato la modalità veloce.

Gestisci i limiti di velocità

La modalità veloce ha rate limit separati dalla velocità standard; per le organizzazioni Console, la pagina rate limit della Claude Platform li descrive. Quando raggiungi il rate limit della modalità veloce:

  1. La modalità veloce torna automaticamente alla velocità standard
  2. L'icona ↯ diventa grigia per indicare il raffreddamento
  3. Continui a lavorare a velocità e prezzi standard
  4. Quando il raffreddamento scade, la modalità veloce si riabilita automaticamente

Per disabilitare manualmente la modalità veloce invece di aspettare il raffreddamento, esegui /fast di nuovo.

Se esaurisci i crediti di utilizzo durante una sessione, Claude Code ritenta ogni richiesta della modalità veloce rifiutata a velocità e prezzi standard, quindi continui a lavorare e non c'è raffreddamento. Il modo in cui vedi il rifiuto dipende dal tipo di sessione:

  • In una sessione interattiva, Claude Code mostra una notifica "Fast mode disabled · Out of usage credits" e disattiva la modalità veloce. La tua preferenza di modalità veloce salvata non cambia; esegui /fast per riattivare la modalità veloce.
  • In modalità non interattiva con --output-format stream-json e tramite l'Agent SDK, Claude Code emette lo stesso testo sul flusso di messaggi come messaggio system con sottotipo notification. Il messaggio arriva una volta per turno mentre sei senza crediti di utilizzo. La modalità veloce rimane attiva.

Anteprima di ricerca

La modalità veloce per Claude Opus 5 e Claude Opus 4.8 è una funzione di anteprima di ricerca. Ciò significa:

  • La funzione potrebbe cambiare in base al feedback
  • La disponibilità e i prezzi sono soggetti a modifiche
  • La configurazione API sottostante potrebbe evolversi

Segnala problemi o feedback attraverso i tuoi soliti canali di supporto Anthropic.

Vedi anche