Skip to main content
Questa pagina copre i problemi di prestazioni, stabilità e ricerca una volta che Claude Code è in esecuzione. Per altri problemi, inizia con la pagina che corrisponde a dove sei bloccato: Se non sei sicuro di quale si applica, esegui /doctor all’interno di Claude Code per un controllo automatico della tua installazione, impostazioni, estensioni e utilizzo del contesto; propone correzioni che può applicare dopo che le hai confermate. Se claude non si avvia affatto, esegui claude doctor dalla tua shell. Esegui /mcp per controllare lo stato del server MCP.

​
Performance and stability

Queste sezioni coprono i problemi relativi all’utilizzo delle risorse, alla reattività e al comportamento della ricerca.

​
High CPU or memory usage

Claude Code è progettato per funzionare con la maggior parte degli ambienti di sviluppo, ma potrebbe consumare risorse significative durante l’elaborazione di grandi basi di codice. Se stai riscontrando problemi di prestazioni:
  1. Usa /compact regolarmente per ridurre la dimensione del contesto. Se restituisce Not enough messages to compact., la conversazione ha troppi pochi turni per essere riassunta; questo può accadere anche con un contesto pieno quando un singolo grande incolla lo ha riempito
  2. Chiudi e riavvia Claude Code tra i compiti principali
  3. Considera di aggiungere grandi directory di build al tuo file .gitignore
  4. Riavvia con claude --safe-mode per verificare se un plugin, un server MCP o un hook è la fonte. Disabilita tutte le personalizzazioni per la sessione; se l’utilizzo diminuisce, vedi Debug your configuration per trovare quale sia
Se l’utilizzo della memoria rimane elevato dopo questi passaggi, esegui /heapdump per scrivere due file su ~/Desktop: uno snapshot dell’heap JavaScript denominato <session-id>.heapsnapshot e una suddivisione della memoria denominata <session-id>-diagnostics.json. Claude Code nasconde il comando dal menu dei comandi; digitalo per intero. Su Linux senza una cartella Desktop, i file vengono scritti nella tua directory home.
Il file .heapsnapshot contiene ogni stringa nel processo, inclusa la tua conversazione completa e le credenziali. Non allegarlo a un problema pubblico o condividerlo.
Il comando stampa anche un riepilogo nella conversazione, mostrando la dimensione del resident set, l’heap JS, i buffer di array e la memoria nativa non contabilizzata, più eventuali indicatori di perdita che ha rilevato, come un alto tasso di crescita della memoria o un numero insolitamente alto di handle aperti. Il riepilogo indica se la maggior parte della memoria è nell’heap JS, che lo snapshot cattura, o nella memoria nativa, che non cattura. Fai una di due cose con l’output:
  • Segnalalo: apri un problema GitHub e allega solo il file -diagnostics.json, che contiene le statistiche dietro il riepilogo stampato e nessun contenuto di conversazione o credenziali
  • Investigalo tu stesso: se il riepilogo dice che la maggior parte della memoria è nell’heap JS, apri il file .heapsnapshot in Chrome DevTools in Memory → Load e ordina per dimensione trattenuta per vedere cosa sta trattenendo la memoria
Se il riepilogo dice che la maggior parte della memoria è nativa, lo snapshot non può mostrarla; includi invece gli indicatori di perdita del riepilogo nella tua segnalazione.

​
Large tables are cut off in the terminal

Una tabella Markdown con più di 200 righe renderizza le sue prime 200 righe seguite da una riga … N more rows not shown. Solo la visualizzazione è limitata: la tabella completa rimane nella conversazione, e /copy copia ogni riga. Per una tabella troppo grande per essere letta nel terminale, chiedi a Claude di scriverla in un file. Prima della v2.1.208, Claude Code renderizzava ogni riga, quindi riprendere una sessione che conteneva una tabella molto grande potrebbe bloccarsi mentre la ri-renderizzava.

​
Auto-compaction stops with a thrashing error

Se vedi Autocompact is thrashing: the context refilled to the limit..., la compattazione automatica è riuscita ma un file o un output dello strumento ha immediatamente riempito la finestra di contesto più volte di seguito. Claude Code smette di riprovare per evitare di sprecare chiamate API su un ciclo che non sta facendo progressi. Per recuperare:
  1. Chiedi a Claude di leggere il file di grandi dimensioni in blocchi più piccoli, come un intervallo di righe specifico o una funzione, invece dell’intero file
  2. Esegui /compact con un focus che elimina l’output di grandi dimensioni, ad esempio /compact keep only the plan and the diff
  3. Sposta il lavoro su file di grandi dimensioni a un subagent in modo che venga eseguito in una finestra di contesto separata
  4. Esegui /clear se la conversazione precedente non è più necessaria

​
Command hangs or freezes

Se Claude Code sembra non reattivo:
  1. Premi Ctrl+C per tentare di annullare l’operazione corrente
  2. Se non reattivo, potrebbe essere necessario chiudere il terminale e riavviare
Il riavvio non perde la tua conversazione. Esegui claude --resume nella stessa directory per riprendere la sessione.

​
Garbled or corrupted text in an editor’s integrated terminal

Se i caratteri vengono visualizzati come caselle, macchie o glifi errati quando esegui Claude Code nel terminale integrato di VS Code, Cursor o Devin Desktop, il renderer GPU del terminale è probabilmente la causa. Esegui /terminal-setup all’interno di Claude Code per impostare terminal.integrated.gpuAcceleration su "off", oppure impostalo manualmente nelle impostazioni dell’editor e ricarica la finestra. Vedi Terminal configuration per le altre impostazioni che /terminal-setup scrive.

​
Mouse wheel scrolls one line at a time in fullscreen rendering

Nel fullscreen rendering, Claude Code scorre la conversazione stessa piuttosto che lasciarla al tuo terminale. Se ogni tacca della rotella muove meno righe di quanto desideri, esegui /scroll-speed per aumentare il numero di righe per tacca e salvarlo, oppure imposta la variabile di ambiente CLAUDE_CODE_SCROLL_SPEED, tranne nel terminale dell’IDE JetBrains, dove Claude Code applica il suo proprio gestore di scorrimento e nessuno dei due ha effetto. Vedi Mouse wheel scrolling per i valori che ciascuno accetta. Per muoverti più velocemente senza cambiare la velocità, premi PgUp e PgDn per scorrere mezza schermata alla volta. Per restituire lo scorrimento al backscroll nativo del tuo terminale, esegui /tui default per passare al renderer classico.

​
Clipboard commands such as pbcopy fail inside the sandbox

Quando il sandboxing è attivo, le utility degli appunti come pbcopy, xclip e wl-copy possono non riuscire a raggiungere gli appunti di sistema da un comando Bash in sandbox, lasciando gli appunti invariati dopo che Claude ha inviato il testo a loro. Per mettere l’output di Claude negli appunti, chiedi a Claude di stampare il contenuto nella sua risposta, quindi esegui /copy. /copy scrive negli appunti dal processo Claude Code stesso piuttosto che da un comando in sandbox, quindi il sandboxing non lo blocca. Può copiare un singolo blocco di codice invece dell’intera risposta, e scrive anche ciò che ha copiato in un file e stampa il percorso, il che ti dà un fallback quando la scrittura degli appunti non raggiunge il tuo terminale, ad esempio su SSH. Per consentire a un comando inviato di raggiungere direttamente gli appunti, aggiungi pbcopy *, wl-copy * o xclip * a excludedCommands in modo che il comando venga eseguito al di fuori della sandbox.

​
Copied text doesn’t reach your local clipboard over SSH

Quando Claude Code viene eseguito su una macchina remota tramite SSH, non può eseguire uno strumento degli appunti sulla tua macchina locale. Al di fuori di tmux, quando selezioni il testo nel fullscreen rendering o esegui /copy, Claude Code invia il testo al tuo terminale come una sequenza di escape OSC 52. Il tuo terminale decide se metterlo negli appunti. /copy segnala Copied to clipboard indipendentemente dal fatto che il testo sia arrivato, e al di fuori di tmux l’avviso di selezione legge sent N chars via OSC 52. Alcuni terminali non agiscono su OSC 52. iTerm2 lo ignora finché non attivi Settings > General > Selection > Applications in terminal may access clipboard, e macOS Terminal.app non lo supporta. Per ottenere il testo senza OSC 52:
  • Tieni premuto il tasto di selezione nativa del tuo terminale mentre trascini, quindi copia con il tuo solito scorciatoia, come Cmd+C. Il tasto è Fn in Terminal.app e Option in iTerm2. Keep native text selection lo elenca per altri terminali.
  • Imposta CLAUDE_CODE_DISABLE_MOUSE=1 sulla macchina remota in modo che il tuo terminale gestisca la selezione per l’intera sessione.

​
Search and discovery issues

Se lo strumento Search, le menzioni @file, gli agenti personalizzati o le skill personalizzate non trovano file, il binario ripgrep in bundle potrebbe non funzionare sul tuo sistema. Installa il pacchetto ripgrep della tua piattaforma e dì a Claude Code di usarlo:
Quindi imposta USE_BUILTIN_RIPGREP su 0, sia nel tuo environment della shell che nel blocco env del tuo settings.json:
Per confermare che il cambio ha avuto effetto, esegui claude doctor nel tuo terminale e verifica che la riga Search mostri il percorso del tuo ripgrep di sistema invece di OK (bundled).

​
Slow or incomplete search results on WSL

Le penalità di prestazioni di lettura del disco quando lavori tra file system su WSL possono risultare in meno corrispondenze del previsto quando usi Claude Code su WSL. La ricerca funziona ancora, ma restituisce meno risultati rispetto a un file system nativo.
claude doctor mostra Search come OK in questo caso.
Soluzioni:
  1. Invia ricerche più specifiche: riduci il numero di file cercati specificando directory o tipi di file: “Search for JWT validation logic in the auth-service package” o “Find use of md5 hash in JS files”.
  2. Sposta il progetto al file system Linux: se possibile, assicurati che il tuo progetto si trovi sul file system Linux (/home/) piuttosto che sul file system di Windows (/mnt/c/).
  3. Usa Windows nativo: considera di eseguire Claude Code nativamente su Windows invece che tramite WSL, per migliori prestazioni del file system.

​
Ottieni più aiuto

Se stai riscontrando problemi non affrontati qui:
  1. Esegui /doctor per un controllo della configurazione e /mcp per verificare lo stato del server MCP
  2. Usa il comando /feedback all’interno di Claude Code per segnalare i problemi direttamente ad Anthropic
  3. Controlla il repository GitHub per i problemi noti
  4. Chiedi a Claude direttamente sulle sue capacità e funzionalità. Claude ha accesso integrato alla sua documentazione.
Per problemi di account, fatturazione o abbonamento, contatta invece il supporto Anthropic: accedi a claude.ai (Utenti Console: platform.claude.com), fai clic sulle tue iniziali in basso a sinistra e seleziona Ottieni aiuto. Consulta Come ottenere supporto per il flusso completo, incluso chi può raggiungere un agente umano per ogni piano.