Anthropic ha inserito oltre 125 chiavi in settings.json di Claude Code. La documentazione ufficiale ne copre circa 40.
14 di quelle mancanti si trovano a tre clic di profondità nell'interfaccia di Claude.ai. Altre 4 non compaiono affatto nella documentazione. Le scopri leggendo issue su GitHub, ascoltando gli ingegneri che le rivelano in Discord, o greppando il binario di Claude Code all'1 di notte.
La maggior parte degli utenti di Claude usa ciò che Anthropic ha rilasciato sei mesi fa. Il conto sale lentamente. I risultati si deteriorano. Incolpano il modello.
Qui di seguito: 18 impostazioni che controllano realmente il tuo Claude.
8 in Claude.ai.
7 in Claude Code.
3 in API e Console.
Per ciascuna: dove si trova, cosa fa, la soluzione in una riga.
Sezione 1: Claude (8 impostazioni)
1. Memoria: ambito, esclusioni e il comando "dimentica questo"
Dove: Impostazioni → Capacità → Memoria
Cosa fa: La memoria è stata introdotta per gli account Free e Pro a marzo 2026. Di default memorizza tutto ciò che Claude decide sia utile. Tre controlli che la maggior parte delle persone ignora: ambito per progetto, lista di esclusioni e il comando rapido per dimenticare.
Perché è importante: La memoria predefinita si deteriora. Dopo 4-6 settimane è piena di correzioni una tantum ("Preferisco i tab in Python", detto una volta per un file), fatti specifici di un progetto che finiscono in chat non correlate e contesto di ruolo obsoleto. La qualità dell'output cala perché Claude ora ottimizza per un "te" sbagliato.
La soluzione:
- Attiva la memoria per progetto: Impostazioni → Capacità → Memoria → Ambito per progetto. I ricordi all'interno di un progetto rimangono in quel progetto. Questo da solo risolve la maggior parte della deriva.
- Aggiungi alla lista di esclusione qualsiasi argomento che non vuoi venga visualizzato in chat non correlate. Esempi: divorzio, questioni mediche, cifre sullo stipendio, nomi dei clienti. Questi persistono indipendentemente dal contesto se non esclusi.
- Usa il comando rapido per dimenticare in qualsiasi chat:
forget what you remembered about [argomento]
Claude lo interpreta rispetto al tuo archivio di memoria e conferma cosa ha rimosso. Nessun menu, nessuna pagina di impostazioni.
2. Pensiero Esteso: attivazione per chat
Dove: input chat → menu a tendina del modello → Pensiero Esteso: Off / Light / Full
Cosa fa: Il Pensiero Esteso aggiunge un passaggio di ragionamento <thinking> prima della risposta. Anthropic lo attiva di default per Opus. L'attivazione a tre stati è per chat e sovrascrive l'impostazione globale.
Perché è importante: Il Pensiero Esteso è ottimo per matematica, debugging, pianificazione multi-step. È sprecato per sintesi, traduzioni, formattazione, riscritture e rapide consultazioni. In questi compiti aggiunge 3-12 secondi di latenza e il 20-40% di token in più per la stessa risposta.
La soluzione: imposta il default su Light (usa il pensiero solo quando il modello lo ritiene utile) e passa esplicitamente a Full per lavori complessi. La maggior parte degli utenti a cui mostro questa impostazione riduce la spesa di token su Opus del 18-25% nella prima settimana.
3. Stili Personalizzati: non "tono", ma veri e propri contratti di output
Dove: input chat → selettore stile → Crea nuovo stile
Cosa fa: Gli Stili sono nati come un interruttore di tono ("Formale / Conciso / Esplicativo"). Gli Stili Personalizzati sono in realtà un contratto di output. Incolli un file di istruzioni di 200-1500 parole. Ogni risposta in quello stile lo applica prima della generazione.
Perché è importante: La maggior parte delle persone usa gli Stili per "accorcia". Il vero utilizzo è imporre regole strutturali in ogni risposta senza doverle reinserire. Formato delle citazioni. Parole vietate. Sezioni obbligatorie. Linguaggi per i blocchi di codice. Limiti di lunghezza. Se fare domande di approfondimento.
La soluzione: crea uno Stile per ogni flusso di lavoro. I miei:
Tre di questi in rotazione (Bozza per X, Revisione codice, Riassumi PDF) sostituiscono l'80% dei miei prompt salvati.
4. Progetti: il campo "istruzioni" che molti lasciano vuoto
Dove: qualsiasi Progetto → ⋯ in alto a destra → Modifica istruzioni del progetto
Cosa fa: I Progetti sono spazi di lavoro persistenti. Il campo istruzioni è un equivalente del system prompt, iniettato in ogni chat del Progetto. Anthropic introduce i Progetti con la funzione di caricamento della conoscenza, che è ciò che la gente ricorda. Il campo istruzioni è sulla stessa pagina e il 70% dei Progetti che vedo in giro lo ha vuoto.
Perché è importante: Ogni chat in un Progetto parte a freddo senza di esso. Con esso, smetti di ristabilire il contesto. ("Questo è un flusso di lavoro per Polymarket. Default scettico. Mostra sempre la matematica delle probabilità. Non raccomandare mai un trade — inquadra solo il valore atteso.")
La soluzione: trattalo come un CLAUDE.md per Claude. Tienilo sotto le 400 parole. Specifica ruolo, livello di scetticismo predefinito, regole di formattazione, cosa non fare mai. Rileggilo una volta al mese e pota.
5. Cerca nelle chat passate (Pro+) e come cercare davvero
Dove: Impostazioni → Profilo → Cerca nelle chat passate (deve essere attivato)
Cosa fa: permette a Claude di cercare nella cronologia delle conversazioni quando rilevante. Solo Pro+.
Perché è importante: disattivato di default per i nuovi account anche su Pro. Una volta attivo, il trucco è sapere che fa corrispondenza per parole chiave, non semantica. "Cosa abbiamo discusso sui robot cinesi ieri" non restituisce nulla a meno che la chat passata non contenesse letteralmente "robot cinesi" o "Cina" e "robot".
La soluzione: attivalo. Poi impara la forma effettiva della query. Sostantivi di contenuto, non parole meta. "Polymarket Iran" funziona. "Quella cosa di cui abbiamo parlato la settimana scorsa" no.
6. Ricerca web: attivazione per conversazione e comportamento delle citazioni
Dove: input chat → + → Ricerca web: On / Off
Cosa fa: l'attivazione della ricerca web è per conversazione, ma il comportamento cambia in base a un'impostazione meno nota in Impostazioni → Capacità → Citazioni ricerca web: Inline / Note / Nascoste.
Perché è importante: il default è Inline. Le citazioni inline rompono il copia-incolla. Quando copi la risposta di Claude altrove, copi marcatori che non portano da nessuna parte. La modalità Note mantiene la risposta pulita ed elenca le fonti alla fine.
La soluzione: passa a Note se copi mai le risposte di Claude con ricerca web in un altro documento, email o messaggio. Tieni Inline solo se leggi tutto dentro Claude.
7. Connettori: la trappola "fidati di questa cartella" in Cowork
Dove: Impostazioni → Connettori → Cowork → Cartelle fidate
Cosa fa: Cowork (GA aprile 2026) dà a Claude accesso a una cartella sul tuo computer. Di default, Anthropic chiede prima di ogni sessione se fidarsi della cartella. La lista delle cartelle fidate è il bypass.
Perché è importante: una volta che una cartella è nelle fidate, Claude la legge in ogni sessione Cowork senza chiedere. Se hai aggiunto una cartella durante un test a marzo e te ne sei dimenticato, Claude l'ha letta silenziosamente in ogni sessione da allora.
La soluzione: apri le cartelle fidate. Rimuovi tutto ciò che non è un progetto attivo corrente. La lista cresce più velocemente di quanto pensi.
8. Modalità Incognito e cosa effettivamente salta
Dove: barra laterale → Nuova chat Incognito (o Cmd/Ctrl + Maiusc + N)
Cosa fa: una chat Incognito non viene salvata, memorizzata, cercata, né usata per miglioramenti del modello. La chat viene eliminata quando la chiudi.
Perché è importante: le persone pensano che Incognito nasconda solo la chat dalla barra laterale. In realtà salta quattro sistemi: scrittura della memoria, cronologia chat, indice di ricerca delle chat passate, consenso per l'addestramento (se attivo).
La soluzione: usala deliberatamente per qualsiasi dato sensibile: stipendio, questioni mediche, familiari, bozze legali, nomi dei clienti. Tre battute, nessun pensiero.
Sezione 2: Claude Code (7 impostazioni)
Queste si trovano in ~/.claude/settings.json (a livello utente) o .claude/settings.json (a livello progetto). Quest'ultimo ha la precedenza.
Ci sono oltre 125 chiavi totali nel binario v2.1.105. Le sette seguenti sono quelle che fanno davvero la differenza.
9. enabledPlugins - disabilita, non disinstallare
Dove: ~/.claude/settings.json → enabledPlugins
Cosa fa: imposta quali plugin installati vengono caricati all'avvio della sessione. Il marketplace dei plugin rende l'installazione facile. La disinstallazione è più difficile, e non necessaria se basta impostare il valore su false.
Perché è importante: ogni plugin attivo carica i suoi hook, il contenuto di SKILL.md e gli schemi degli strumenti nel tuo budget di contesto. Tre plugin dimenticati = 3-8K token di pre-carico prima ancora di aver scritto qualcosa.
Avevo 14 plugin abilitati quando ho iniziato questa verifica. Ora ne sono attivi 4.
La soluzione:
1"enabledPlugins": {2 "claude-code-plugin@marketplace": false,3 "claude-code-another@marketplace": false,4 ...5}
false mantiene il plugin installato ma non caricato. Riabilita per sessione con /plugin enable nome@marketplace quando ti serve davvero.
10. permissions.deny - cosa sapere sul bug
Dove: ~/.claude/settings.json → permissions.deny
Cosa fa: impedisce a Claude di eseguire strumenti specifici o accedere a file specifici. L'intento: prevenire rm -rf, impedire la lettura di .env, impedire la scrittura fuori dal progetto.
Perché è importante: c'è un bug noto. Le regole di diniego a volte non bloccano. Sono state aperte diverse issue su GitHub. La più citata (anthropics/claude-code#11544) documenta hook che non vengono caricati nonostante una configurazione valida; un pattern simile riguarda l'applicazione dei dinieghi. La regola è nella tua configurazione. Il log di debug mostra "0 matchers found." Claude legge il file comunque.
La soluzione:
Aggiungi un secondo livello a livello di filesystem. chmod 600 .env in modo che anche se Claude prova a leggerlo, il sistema operativo lo rifiuti. Non fidarti solo della lista dei dinieghi. Verifica con /permissions dentro Claude Code. Se le tue regole non compaiono, riavvia la sessione.
11. hooks.SessionStart - le 4 righe che hanno ridotto il mio gonfiore del contesto del 30%
Dove: ~/.claude/settings.json → hooks.SessionStart
Cosa fa: SessionStart si attiva quando apri Claude Code in una directory. Puoi eseguire qualsiasi cosa: stampare informazioni sull'ambiente, fare lint dello stato git, iniettare un file di contesto, riscaldare la cache.
Perché è importante: la maggior parte delle persone inietta troppo. CLAUDE.md cresce fino a 5K token perché ogni regola del progetto è stata inserita lì. SessionStart ti permette di caricare solo le regole pertinenti al branch o alla directory corrente.
La soluzione:
Il tuo branch principale carica context-main.md. Il tuo branch feat/auth carica context-feat-auth.md. Ogni file rimane piccolo. Il budget di contesto smette di sanguinare.
12. disableAllHooks - l'interruttore di emergenza
Dove: ~/.claude/settings.json → disableAllHooks: true
Cosa fa: disabilita tutti gli hook con un solo interruttore. Rilasciato nell'aggiornamento di marzo 2026. La maggior parte delle persone non sa che esiste.
Perché è importante: quando Claude Code inizia a comportarsi in modo strano (comandi fantasma in esecuzione, sessioni che si bloccano all'avvio, scritture misteriose di file), l'80% delle volte è un hook che non funziona correttamente. Disabilitare gli hook uno per uno è lento. Questo li uccide tutti insieme così puoi isolare il problema.
La soluzione: tienilo su false. Quando qualcosa si rompe, passa a true, riavvia, vedi se il problema scompare. Se sì, riabilita gli hook uno per uno. Se no, il bug è altrove.
13. modello per progetto (override)
Dove: .claude/settings.json (radice del progetto) → model
Cosa fa: imposta il modello predefinito per quel progetto. Sovrascrive l'impostazione globale.
Perché è importante: la maggior parte delle persone imposta Opus a livello globale perché lo vuole per i lavori complessi. Poi aprono un progetto che è per lo più editing di markdown o script shell. Pagano le tariffe di Opus per compiti che Haiku farebbe a 1/20 del costo.
La soluzione:
Le sovrascritture a livello di progetto vincono. Apri il progetto, ottieni il modello giusto. Vai avanti.
14. mcpServers con il flag enabled
Dove: ~/.claude/settings.json → mcpServers
Cosa fa: i server MCP collegano Claude a strumenti esterni. Ogni server connesso carica l'intero schema dei suoi strumenti nel tuo contesto. Da 800 a 6.000 token per server.
Perché è importante: le persone collegano server MCP per testarli e non li disconnettono mai. Dopo tre mesi ne hai 12 connessi, di cui ne usi attivamente 3. I 9 server inutilizzati ti costano ~25-40K token di schema di contesto ad ogni avvio di sessione.
La soluzione: usa il flag enabled per mantenere la connessione configurata ma non caricata.
1"mcpServers": {2 "server-name": {3 "command": "...",4 "args": [],5 "enabled": false6 }7}
Attiva true per sessione quando ti servono davvero. La maggior parte dei giorni ne ho 2-3 attivi. Nei giorni di pianificazione, 6.
15. cleanupPeriodDays - la cache di cui nessuno parla
Dove: ~/.claude/settings.json → cleanupPeriodDays
Cosa fa: imposta per quanti giorni Claude Code conserva trascrizioni, log di debug e dati di sessione intermedi. Il default è 30.
Perché è importante: Dreaming e la ricerca nelle chat passate si basano entrambi su queste trascrizioni. Con la finestra predefinita di 30 giorni, Dreaming può imparare solo da un mese di lavoro. Sei mesi gli danno 6 volte il segnale. Costo su disco: circa 200MB.
La soluzione:
1{2 "cleanupPeriodDays": 180,3 "dreaming": {4 "transcriptRetentionDays": 1805 }6}
180 giorni di cronologia sessioni disponibili per Dreaming, per il consolidamento della memoria e per i tuoi grep quando cerchi "cosa ho detto a Claude su quel bug di autenticazione a marzo".
L'artefatto di Claude Code: un settings.json con tutte e 7 le impostazioni applicate
Copia questo in ~/.claude/settings.json. Adatta i percorsi e i nomi dei plugin ai tuoi. Riavvia Claude Code. Riesegui /permissions e /hooks per verificare che tutto sia stato caricato.
Le sovrascritture a livello di progetto vanno in .claude/settings.json nella radice del progetto. La più utile da impostare lì:
Sezione 3: API e Console (3 impostazioni)
Queste si trovano nel codice o nella Console di Anthropic. Sono le impostazioni con il maggiore impatto sui costi in questo articolo. Ognuna può cambiare la tua fattura del 30-90%.
16. cache_control breakpoints: dove posizionarli
Dove: corpo della richiesta API, campo cache_control su qualsiasi blocco di contenuto
Cosa fa: contrassegna un prefisso del tuo prompt come cacheabile. Le richieste successive con lo stesso prefisso vengono addebitate a circa il 10% della tariffa di input invece che al prezzo pieno.
Perché è importante: è la leva di costo più grande nella API. La gente sa che esiste. La maggior parte posiziona il breakpoint in modo sbagliato e ottiene risparmi parziali invece che completi. Nella mia configurazione, correggere il breakpoint ha ridotto una fattura da $340/mese a $87.
La soluzione: il breakpoint va al confine tra contenuto statico e dinamico. Tutto ciò che sta prima del breakpoint viene memorizzato nella cache. Tutto ciò che sta dopo viene ricalcolato.
Sono disponibili due TTL: 5 minuti effimeri (default) e 1 ora. Usa 1 ora per i system prompt che non cambiano tra le sessioni:
"cache_control": {"type": "ephemeral", "ttl": 3600}
Le scritture in cache costano il 25% in più rispetto all'input base. Le letture dalla cache costano il 10% dell'input base. Il punto di pareggio: un prefisso cacheizzato si ripaga se lo leggi 2+ volte nella finestra TTL.
17. inference_geo e la tassa sulla residenza dei dati
Dove: richiesta API → parametro inference_geo
Cosa fa: instrada l'inferenza verso una regione geografica specifica. Solo residenza USA, solo UE, ecc.
Perché è importante: la residenza dei dati solo USA aggiunge un premio del 10% su Opus 4.7 e superiori. Non è sulla scheda dei prezzi standard. Lo vedi sulla fattura.
La soluzione: se il tuo regime di conformità non richiede effettivamente la residenza regionale, non impostare inference_geo. La maggior parte delle app lo imposta "per sicurezza" perché qualcuno dell'ufficio legale ha detto "assicurati che i dati rimangano negli USA". Verifica se il requisito è contrattuale o solo di principio. Se è di principio, ometti il parametro e risparmia il 10% su ogni chiamata Opus.
Se invece ti serve, includi il 10% nella scelta del modello. Sonnet a $3 base diventa effettivamente $3,30, il che sposta il punto di pareggio Opus vs Sonnet.
18. Limite di rate a livello di workspace (quello che previene l'interruzione alle 3 di notte)
Dove: Console → Impostazioni → Workspaces → [il tuo workspace] → Limiti di rate per funzionalità
Cosa fa: imposta un limite di rate per workspace, per funzionalità, separato dai limiti a livello di account.
Perché è importante: un limite a livello di account ti protegge dall'andare in bancarotta. Un limite a livello di workspace protegge il tuo prodotto interattivo quando un job batch impazzito tenta di consumare l'intera assegnazione ITPM. Rilasci una nuova funzionalità, ha un bug, va in loop, consuma tutto, la tua chat rivolta ai clienti inizia a restituire 429. I limiti per workspace impediscono a una funzionalità di affamare un'altra.
La soluzione: crea un workspace per superficie (chat interattiva, elaborazione batch, strumenti interni, sperimentale). Imposta il limite di rate di ciascun workspace al 60-70% del tuo tier account. Riserva il 30% per il workspace che deve poter aumentare il carico.
La quarta impostazione non documentata in questo articolo: c'è un limite a livello di funzionalità all'interno di ogni workspace che è visibile solo se fai clic su una specifica scheda della funzionalità, non sulla panoramica del workspace. Default = illimitato.
Se hai tre funzionalità in un workspace, una di esse può affamare le altre due e il limite a livello di workspace non lo intercetterà. Imposta limiti per funzionalità per tutto ciò che fa lavoro batch.
Sezione 4: La checklist in 18 punti
Percorrila una volta. 20 minuti. Qualsiasi cosa non tocchi in 12 mesi, probabilmente non la toccherai mai.
Sezione 5: Lo script di audit (eseguilo settimanalmente)
Inseriscilo in ~/bin/claude-audit.sh. Eseguilo settimanalmente. Segnala la metà della checklist relativa a Claude Code più la parte relativa a cache_control della metà API.
Salva, chmod +x ~/bin/claude-audit.sh, esegui settimanalmente finché ogni riga non è a target.
Sezione 6: Cosa è stato escluso
Ho rimosso quattro candidati prima di pubblicare. Vale la pena nominarli così non perdi tempo a inseguirli.
Attivazione/disattivazione del ragionamento adattivo. Anthropic l'ha rilasciato attivo di default. L'override esiste in Impostazioni → Capacità → Modalità di ragionamento. In 30 giorni di confronto non sono riuscito a trovare un flusso di lavoro in cui sovrascriverlo cambiasse i risultati in modo significativo. Fidati del default. Vai avanti.
Attivazione automatica delle skill. Puoi attivare o disattivare se Claude carica automaticamente le skill in base al rilevamento di pertinenza o se richiede un'invocazione esplicita. Mi aspettavo che fosse importante. Non lo è. L'attivazione automatica con divulgazione progressiva (caricare solo i metadati di SKILL.md finché non servono) è ben calibrata. Lasciala attiva.
Controllo del trasferimento da mobile a desktop. Funzione utile, non un elemento di audit delle impostazioni. O hai un flusso di lavoro in cui si adatta o non ce l'hai. Nessun interruttore nascosto cambia il risultato.
Limite massimo di token per workspace. Puoi forzare ogni risposta a troncare a 800, 2000 o 4000 token. Fa risparmiare soldi sui flussi di lavoro verbosi, ma corrompe la generazione di codice che richiede output lunghi. Vale la pena testarlo per workspace. Non vale la pena raccomandarlo come default.
T H E _ E N D
Percorri la checklist stasera. La maggior parte di voi sistemerà 6-8 cose. Alcuni ne sistemeranno 14+. I numeri nel tuo cruscotto di fatturazione e nel tuo grafico di utilizzo ti diranno se ne sono valsi i 20 minuti.
Aggiungi ai preferiti e percorri la checklist stasera. Se questo ti evita un mese di frustrazione per "Claude è diventato più stupido", ricondividilo. Telegram per consigli AI quotidiani: https://t.me/+_ZWrQN7GuDA3ZDEy
