Errori comuni di Claude Code: da dove partire e come risolverli

Quali comandi usare per primi?

Questi quattro rispondono a quasi tutte le domande iniziali, e nessuno modifica niente.

Comando	Che cosa dice
/status	Versione, modello, account, connessione
/context	Che cosa occupa la conversazione: il tuo CLAUDE.md c’è? Quanto pesano skill e server?
/doctor	Controllo di installazione, impostazioni, estensioni e CLAUDE.md, con le correzioni proposte
/usage	Quanto stai consumando e che cosa pesa

/memory invece non serve a controllare che cosa è stato letto: apre i CLAUDE.md per modificarli e gestisce la memoria automatica.

Se sospetti le tue impostazioni, claude –safe-mode parte con le personalizzazioni spente: CLAUDE.md, skill, plugin, hook, server MCP, comandi e agenti tuoi, memoria automatica. Accesso, modello e permessi restano normali. Se così il problema sparisce, la causa è fra quelle, e si riaccendono una alla volta.

Ricontrollato l’8 novembre 2026 su Claude Code 2.1.319.

Perché ignora le mie istruzioni?

La prima domanda è se le ha caricate, e la risposta sta in /context. Le cause più frequenti, in ordine:

1. Cartella sbagliata. Il CLAUDE.md di progetto si carica se apri Claude lì o in una sua sottocartella.
2. Sottocartella non ancora toccata. Il CLAUDE.md di una sottocartella arriva solo quando Claude legge o scrive un file lì dentro.
3. File troppo lungo. Oltre la lunghezza consigliata viene seguito peggio. Dalla versione 2.1.309 i file caricati su richiesta hanno anche un limite vero.
4. Regola vaga o in contrasto. «Scrivi codice pulito» non si può verificare; due regole opposte si annullano.
5. Conversazione lunga. Dopo tanti scambi la regola è sepolta: meglio una conversazione nuova.

Ricorda però che un CLAUDE.md è un testo che il modello legge, non un blocco. Se una regola non deve avere eccezioni va in un permesso o in un hook, come spiega la guida a hook e permessi; come scrivere il file è nella guida su come si scrive il CLAUDE.md.

Perché continua a chiedere i permessi?

Di solito perché la risposta data non vale come si crede, o perché la regola non corrisponde al comando.

Sintomo	Causa probabile	Che cosa fare
Richiede di nuovo la modifica dei file	«Sì, e non chiedermelo più» sulle modifiche vale solo per la sessione	Modalità acceptEdits («Edit automatically» in VS Code) o una regola allow
Una regola sul comando non scatta	Il testo del comando è diverso da quello scritto nella regola	Controlla il comando esatto che lancia
Un divieto batte un permesso	L’ordine è deny, ask, allow	È voluto: restringi il divieto
Un percorso Windows non corrisponde	I percorsi vanno in forma Unix	Scrivi //c/cartella/**
Una regola in un file sembra ignorata	Le liste si sommano fra i file	Cerca lo stesso comando negli altri file

In uno script la situazione è opposta: non chiede, nega. La guida al lavoro in automatico spiega come indicare i permessi con claude -p.

Che cosa significa il messaggio sul limite?

Che hai raggiunto un limite del piano. Dalla versione 2.1.312 il limite delle cinque ore si chiama «5-hour limit», prima «session limit». C’è poi quello settimanale.

Quei due sono comuni a tutti i modelli: cambiare modello non serve. Il messaggio dice quando si azzera, e se stavi lavorando Claude Code può aspettare e ripartire da solo, con l’impostazione «Continue automatically at usage limit», purché lasci la sessione aperta. Con un limite legato a una famiglia, come «You’ve hit your Opus limit», basta invece passare a un altro modello con /model.

Per non arrivarci così spesso la leva principale è la lunghezza delle conversazioni: la guida su modelli, contesto e costi spiega perché /clear fra un lavoro e l’altro fa risparmiare più di ogni altra cosa.

Altri problemi che capitano spesso

Qui sotto quelli che fanno perdere più tempo, con il primo controllo da fare.

Problema	Primo controllo
Una skill non parte	Compare in /skills? Parte con /nome? Se sì, il problema è la description
Un server MCP non risponde	/mcp mostra lo stato. Un server di progetto va approvato; uno registrato in locale vale solo in quella cartella
Il ripristino non rimette a posto i file	/rewind segue solo i file che Claude ha modificato con i suoi strumenti di scrittura, e su quei file annulla anche i comandi successivi; un file toccato solo da comandi del terminale, sed -i compreso dalla 2.1.309, resta com’è
«No files were restored»	Non è stato ripristinato nulla: manca il backup del punto, oppure un file non si poteva aggiornare
Un hook non blocca	L’evento può bloccare? Il comando esce con il codice 2? Provalo su un file di prova
Comando sconosciuto	Versione: una funzione può richiedere una versione più nuova della tua

Sulle skill il dettaglio è nella guida alle skill. Se invece ciò che non torna è un risultato, e non lo strumento, non fidarti della spiegazione: chiedi di rifare il conto su pochi casi. Su dati di vendita e margini, un errore di formula non dà nessun messaggio. Per capire dove un assistente aiuta e dove no, c’è la pagina su Claude per e-commerce.

Domande frequenti

Fonti

• Claude Code: Error reference
• Claude Code: Commands
• Claude Code: CLI reference
• Claude Code: Checkpointing
• Claude Code: Changelog
• Claude Code: modalità dei permessi