CLACOROO
EN IT
Scarica

Claude Config

La sezione Claude Config è un editor visuale per ~/.claude/settings.json — il file che Claude Code legge per conoscere le tue preferenze (modello di default, tema, lingua, stile di output, …). Invece di modificare il JSON a mano, accendi/spegni, scegli e regoli valori in un form reale, e CLACOROO scrive il file in modo atomico.

Questo è l’unico file che CLACOROO scrive direttamente. Ogni altra modifica passa per i comandi claude .... Include anche un editor dei permessi dedicato per le regole allow / ask / deny (vedi sotto).

Panoramica

La sezione Claude Config, con righe per modello, tema, lingua e altre impostazioni, ognuna col valore corrente e il controllo per modificarlo.

Una lista di righe, ognuna legata a una chiave di settings.json:

  • Una label breve in italiano (o inglese) leggibile
  • Una descrizione (“~/.claude/settings.json → <key>”)
  • Il valore corrente, più il controllo per modificarlo (campo testo, dropdown, dots-slider, toggle, a seconda del tipo della chiave)

La sezione legge settings.json da disco all’apertura e lo riscrive a ogni modifica. Token always-on della Dashboard e diversi KPI possono cambiare come effetto collaterale delle modifiche qui.

Cosa mostra

Impostazioni comuni

L’elenco esatto dipende dalla versione di Claude Code, ma di solito trovi:

ImpostazioneCosa fa
ModelIl modello di default usato da Claude Code (Sonnet 4.x, Opus 4.x, Haiku 4.x, …)
ThemeDark / light / auto
LanguageLingua dell’UI di Claude Code (distinta dalla lingua dell’UI di CLACOROO)
Output styleCome Claude Code formatta le sue risposte
API key path / helperDove prendere la chiave API (se impostata)
EffortLivello di ragionamento per i modelli che lo supportano (dots-slider da minimo a massimo)
Verbosity / tool budget / autoUpdateVari toggle e tweak numerici

La descrizione di ogni riga ti dice la chiave JSON letterale in modifica — utile quando vuoi farci riferimento in uno script o in uno snippet di config.

Controlli

  • Campo testo — per stringhe o path liberi
  • Dropdown — per valori enumerati (theme, language, famiglia di modello)
  • Dots-slider — per valori ordinali (effort, tool budget) — cinque step, in stile dot come VS Code
  • Toggle — per flag booleani

Come le modifiche vengono scritte

Quando cambi un valore, CLACOROO:

  1. Legge il settings.json corrente da disco
  2. Applica la modifica all’oggetto JSON
  3. Riscrive il file in modo atomico (file temporaneo + rename) così il file non resta mai a metà
  4. Aggiorna la riga per mostrare il nuovo valore
  5. Triggera un refresh delle sezioni dipendenti (KPI Dashboard, ecc.)

Se due finestre CLACOROO sono aperte, solo una dovrebbe modificare settings.json alla volta — il file watcher recepirà comunque i cambi.

Editor dei permessi

L'editor dei permessi in Claude Config: liste comprimibili Allow, Ask e Deny con campo di ricerca, un pulsante copia e uno rimuovi per regola, e un selettore della modalità di default.

CLACOROO include un editor dedicato per le regole di permesso di Claude Code — il blocco permissions di settings.json che decide cosa Claude Code può fare da solo. Invece di scrivere a mano gli array di regole, gestisci tre liste più una modalità di default:

  • Allow — azioni che Claude Code può eseguire senza chiedere
  • Ask — azioni per cui deve chiedere ogni volta
  • Deny — azioni vietate del tutto
  • Modalità di default — la modalità di permesso iniziale per le nuove sessioni (default, acceptEdits, plan, bypassPermissions)

La precedenza è deny → ask → allow: vince la prima lista che corrisponde a un’azione, quindi un deny batte sempre un allow per la stessa regola. CLACOROO lo segnala — se aggiungi una regola già presente in un’altra lista, ti avvisa (la stessa azione può legittimamente stare in due liste; decide la precedenza).

Ogni lista è comprimibile, con un campo di ricerca quando cresce oltre poche regole. Ogni regola ha un pulsante copia (comodo per spostare una regola da Allow a Deny senza riscriverla) e un pulsante rimuovi. Il campo di aggiunta valida il formato mentre scrivi e avvisa quando una regola è insolitamente ampia (es. un Bash nudo) o distruttiva.

Le regole usano la sintassi di Claude Code — un nome di tool (Read, Edit, WebFetch), un tool con matcher (Bash(npm run test:*)), o un tool MCP (mcp__server__tool).

Quando le modifiche hanno effetto. Le liste Allow / Ask / Deny si applicano subito, anche alle sessioni di Claude Code già aperte. La modalità di default vale solo per le sessioni nuove.

Operazioni comuni

Come cambiare il modello di default

  1. Trova la riga Model
  2. Clicca il dropdown
  3. Scegli un modello (es. claude-sonnet-4-6)
  4. CLACOROO scrive subito il cambio nel settings.json; Claude Code lo recepisce alla prossima sessione

Come cambiare la lingua dell’UI di Claude Code

  1. Trova la riga Language
  2. Scegli la lingua dal dropdown
  3. Riavvia Claude Code se serve (la lingua di CLACOROO è separata — si controlla da Impostazioni · Lingua)

Come regolare l’effort di ragionamento

  1. Trova la riga Effort (se il tuo modello lo supporta)
  2. Clicca i dot dal basso all’alto per alzare o abbassare il livello
  3. La label dello slider si aggiorna (“minimum”, “low”, “medium”, “high”, “maximum”) mentre ti muovi

Come aggiungere o spostare una regola di permesso

  1. Apri l’editor Permessi in Claude Config
  2. Nella lista di destinazione (Allow / Ask / Deny), scrivi la regola nel campo di aggiunta — es. Bash(git push:*)
  3. Guarda il feedback inline: un errore di formato blocca l’aggiunta, mentre un avviso “ampia”, “distruttiva” o “duplicato” è solo un consiglio
  4. Per spostare una regola tra liste, usa il suo pulsante copia, incollala nel campo di aggiunta dell’altra lista, poi rimuovi l’originale

Come editare il JSON grezzo (quando serve)

In questa sezione non c’è un editor JSON grezzo built-in — per design. Se devi modificare qualcosa che il form non espone:

  1. Trova il file in ~/.claude/settings.json (macOS/Linux) o %APPDATA%\Claude\settings.json (Windows)
  2. Aprilo nel tuo editor preferito
  3. Salva — CLACOROO recepisce il cambio al prossimo refresh

L’Editor CLAUDE.md (Impostazioni) è un editor inline separato per i file CLAUDE.md user-level e project-level; vedi Editor CLAUDE.md.

Suggerimenti e scorciatoie

  • La descrizione della riga è la fonte autorevole: anche se una label cambia, la chiave JSON resta la stessa — utile se script su quella stessa impostazione altrove
  • Alcune impostazioni sono costose da computare quando cambiano (es. cambiare modello significa una sessione fresca la prossima volta) — Claude Code le recepirà al prossimo avvio
  • I Token always-on della Dashboard sono sensibili ai cambi qui (es. cambio a un modello con system prompt diverso)
  • Questa sezione non cancella mai chiavi da settings.json — se una chiave è stata impostata da un altro tool, CLACOROO la lascia stare

Casi limite ed errori

  • Una riga che mi aspettavo manca. La tua versione di Claude Code non espone ancora quell’impostazione. Il form si basa su uno schema noto; chiavi nuove appaiono quando CLACOROO esce con un update che le conosce.
  • Il valore corrente mostra il default ma settings.json non ha la chiave. I default sono inferiti — Claude Code li usa quando la chiave è assente. Cambiare il valore la scrive esplicitamente nel file.
  • Il file watcher non si è accorto di un’edit manuale. Clicca Aggiorna nella topbar — la riga rilegge da disco.
  • CLACOROO lamenta un errore di parse JSON. Il tuo settings.json si è corrotto (spesso per un’edit manuale incompleta altrove). Sistema il JSON nel tuo editor; CLACOROO recepirà al prossimo refresh.
  • Permission denied scrivendo settings.json. Il tuo utente non può scrivere il file (raro). Controlla owner e permessi del file da shell.
  • Una regola di permesso che ho aggiunto non ha effetto. Allow/Ask/Deny si applicano subito alle sessioni aperte, ma la modalità di default cambia solo su una nuova sessione di Claude Code — riavvia la sessione se hai cambiato la modalità.
  • La stessa regola appare in due liste. È consentito: la precedenza è deny → ask → allow, quindi vince la lista più forte. CLACOROO avvisa solo perché tu te ne accorga.

Correlati

  • Notifiche quota — la lingua di CLACOROO è separata da quella di Claude Code e vive in Impostazioni
  • Editor CLAUDE.md — l’altro posto dove CLACOROO scrive file di config user-facing
  • Snapshot — esporta il tuo settings.json (e il resto del setup) per backup o migrazione
  • Gestione plugin — attivare/disattivare plugin si riflette in settings.json, ma è scritto dalla CLI, non da questa sezione