Dove si è bloccato? Leggi la schermata, poi esamina il processo
# in the session
Esc # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep # child processes still running?
top -o cpu # is claude spinning or idle?
claude --debug # next time: timestamps for every request and tool call
claude -c # resume the last session after a killUna CPU inattiva con un prompt bloccato indica che sta aspettando qualcosa di esterno: un flusso di rete, un server MCP, un processo figlio, un prompt che non riesci a vedere. Una CPU costantemente al massimo indica che sta lavorando su qualcosa di interno: l'analisi di un risultato enorme di uno strumento, il backtracking di un'espressione regolare, il caricamento di una sessione di grandi dimensioni. Una memoria che aumenta costantemente indica che il risultato di uno strumento o un file di sessione viene caricato interamente.
Cause note nel tracker
- `/rewind` si blocca, `Ctrl+C` viene ignorato, serve `kill -9` (#53011, 21 reazioni, in sessioni di qualsiasi dimensione nelle build 2.1.1xx). Un ingegnere di Anthropic non è riuscito a riprodurre il problema su 2.1.233, quindi aggiorna prima; su una build precedente, termina il processo e riprendi con
claude -cinvece di riavvolgere la sessione. - Le sessioni Remote Control si bloccano durante l'esecuzione e solo un `Esc` locale le riattiva (#51267, aperto). Qualsiasi strumento o sottoprocesso che si blocca congela l'intera sessione remota, senza possibilità di annullamento da remoto; mantieni brevi queste sessioni ed evita strumenti che potrebbero richiedere un input.
- La richiesta di autenticazione MCP si blocca su `Enter` (#42707, aperto). Autentica il server tramite un comando
claude mcpseparato o il browser, quindi riavvia la sessione. - `grep` tramite il motore di corrispondenza integrato esaurisce tutta la memoria (#54394): nelle build native ogni comando di shell
grepviene eseguito all'interno di un processoclaudecon un proprio heap V8; una regex con backtracking su una lunga riga minificata fa crescere l'uso di memoria fino a diversi gigabyte e il killer OOM termina anche la sessione, sia su WSL2 sia su Linux. Evita regex senza limiti sui file minificati, escludi l'output della build enode_modules, oppure installa la versione di sistema diripgrepe richiamala esplicitamente. - Ciclo di tentativi bloccato su `400 thinking blocks cannot be modified` (#63231) — la cronologia della conversazione non è valida e ogni nuovo tentativo fallisce nello stesso modo.
/rewindfino a prima del turno, oppure/clear; consulta la guida a 400. - **Esecuzioni cloud / pianificate bloccate su *Configurazione di un container cloud*** (#53691, #54528) — il problema è lato servizio; non c'è nulla da fare localmente, annulla e controlla lo stato.claude.com.
- La ripresa di una sessione di grandi dimensioni richiede minuti — la trascrizione viene ripercorsa all'avvio. Riprendi la sessione specifica che ti serve (
claude -r) invece della più grande e lascia che la compattazione riduca quelle enormi.
Blocchi all'avvio
Una schermata vuota subito dopo claude senza alcun prompt indica solitamente che la prima chiamata API non restituisce una risposta: una variabile proxy che punta a un proxy non funzionante, una VPN, il DNS o un ANTHROPIC_BASE_URLirraggiungibile. Esegui il controllo con curl descritto nella guida agli errori di connessione, quindi claude doctor. Gli avvii lenti in cui alla fine compare un prompt sono dovuti all'avvio dei server MCP; claude mcp list e rimuovi quelli che vanno in timeout.
Processi figli che non terminano mai
Uno strumento di shell che apre un editor, attende una password, segue un log o avvia un server di sviluppo non termina mai e il turno rimane in attesa. Chiedi all'agente di eseguire i server in background e di aggiungere --no-pager, -y o < /dev/null quando un comando potrebbe richiedere un input. Se è già successo, Esc annulla lo strumento; se il processo figlio ignora l'annullamento, terminalo tramite il suo PID da un altro terminale e il turno proseguirà riportando l'errore.
Utilizzo elevato di memoria e CPU
- I risultati degli strumenti vengono conservati in memoria e su disco per tutta la sessione; leggere un file da 200 MB significa avere una sessione da 200 MB. Leggi solo le parti che ti servono.
- Molti sottoagenti in parallelo moltiplicano tutto;
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2sulle macchine con risorse limitate. - Gli emulatori di terminale con rendering lento (alcune console Windows, tmux remoto su una connessione a bassa capacità) fanno sembrare bloccato l'output in streaming;
claude --debugmostra se i token stanno ancora arrivando. - Se la memoria aumenta durante l'inattività, cerca eventuali processi
clauderimasti da sessioni IDE terminate in modo anomalo e terminali (processo terminato con codice 1 tratta il caso dei processi orfani su Windows).
Quando il problema è l'API, non il client
Una sessione che si blocca a ogni turno nello stesso punto, con un piccolo indicatore di caricamento e una riga di nuovo tentativo che compare dopo un po', indica un percorso verso l'API lento o soggetto a interruzioni, anziché un bug del client: 529 sovraccarico, limitazione delle richieste lato server o una connessione reimpostata. Tramite un gateway (ANTHROPIC_BASE_URL=https://aiprimetech.io), quando un account a monte è saturo, le richieste vengono dirottate su un altro, riducendo proprio questi tempi di attesa.
Stanco di lottare con questo problema?
Esegui invece Claude Code tramite il gateway di AI Prime Tech: gli stessi modelli Claude sugli account a monte del gateway, due variabili d'ambiente per passare al gateway, e i nuovi account ricevono $5 di credito API gratuito con il codice FIXIT — senza carta.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyDomande frequenti
Perché Claude Code è bloccato e non risponde?
Sta aspettando qualcosa: uno stream API, uno strumento che ha avviato, un server MCP o una richiesta di approvazione fuori schermo. Premi Esc per annullare lo strumento, Ctrl+C due volte per interrompere; se nulla reagisce, termina il processo e riprendi con claude -c.
Come risolvo il blocco di Claude Code su /rewind?
Aggiorna a una build recente; il blocco è stato segnalato su 2.1.1xx e Anthropic non è riuscita a riprodurlo su 2.1.233. Su una build precedente, termina il processo e usa claude -c invece di /rewind.
Perché Claude Code usa così tanta memoria?
I risultati voluminosi degli strumenti e le trascrizioni delle sessioni vengono conservati per intero, i sottoagenti li moltiplicano e nelle build native una regex grep con backtracking viene eseguita all'interno di un processo claude con un grande heap V8. Leggi meno dati, escludi l'output della build e riduci la concorrenza.
Claude Code si blocca all'avvio senza mostrare un prompt. Cosa devo controllare?
La prima richiesta API non restituisce una risposta: variabili proxy, VPN, DNS o un ANTHROPIC_BASE_URL irraggiungibile. Esegui una richiesta curl all'endpoint, poi claude doctor, e rimuovi i server MCP che vanno in timeout.
Esegui Claude Code sul gateway
Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice FIXIT.
Ottieni una chiave API Scopri i piani illimitatiAI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.