Impostazioni di Claude Code

Claude Code offre una varietà di impostazioni per configurare il suo comportamento per soddisfare le tue esigenze. Puoi configurare Claude Code eseguendo il comando /config quando usi il REPL interattivo.

​

File delle impostazioni

Il file settings.json è il nostro meccanismo ufficiale per configurare Claude Code attraverso impostazioni gerarchiche:

• Impostazioni utente sono definite in ~/.claude/settings.json e si applicano a tutti i progetti.
• Impostazioni progetto sono salvate nella directory del tuo progetto:
  • .claude/settings.json per le impostazioni che vengono inserite nel controllo del codice sorgente e condivise con il tuo team
  • .claude/settings.local.json per le impostazioni che non vengono inserite, utili per preferenze personali e sperimentazione. Claude Code configurerà git per ignorare .claude/settings.local.json quando viene creato.
• Per distribuzioni aziendali di Claude Code, supportiamo anche impostazioni di policy gestite dall’azienda. Queste hanno precedenza sulle impostazioni utente e progetto. Gli amministratori di sistema possono distribuire policy a:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Linux e WSL: /etc/claude-code/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

Impostazioni disponibili

settings.json supporta una serie di opzioni:

​

Impostazioni dei permessi

​

Precedenza delle impostazioni

Le impostazioni vengono applicate in ordine di precedenza (dal più alto al più basso):

1. Policy gestite dall’azienda (managed-settings.json)

   • Distribuite da IT/DevOps
   • Non possono essere sovrascritte

2. Argomenti della riga di comando

   • Sovrascritture temporanee per una sessione specifica

3. Impostazioni locali del progetto (.claude/settings.local.json)

   • Impostazioni personali specifiche del progetto

4. Impostazioni condivise del progetto (.claude/settings.json)

   • Impostazioni del progetto condivise dal team nel controllo del codice sorgente

5. Impostazioni utente (~/.claude/settings.json)

   • Impostazioni globali personali

Questa gerarchia assicura che le policy di sicurezza aziendali siano sempre applicate permettendo comunque ai team e agli individui di personalizzare la loro esperienza.

​

Punti chiave del sistema di configurazione

• File di memoria (CLAUDE.md): Contengono istruzioni e contesto che Claude carica all’avvio
• File delle impostazioni (JSON): Configurano permessi, variabili d’ambiente e comportamento degli strumenti
• Comandi slash: Comandi personalizzati che possono essere invocati durante una sessione con /nome-comando
• Server MCP: Estendono Claude Code con strumenti e integrazioni aggiuntive
• Precedenza: Configurazioni di livello superiore (Azienda) sovrascrivono quelle di livello inferiore (Utente/Progetto)
• Ereditarietà: Le impostazioni vengono unite, con impostazioni più specifiche che aggiungono o sovrascrivono quelle più ampie

​

Disponibilità del prompt di sistema

​

Escludere file sensibili

Per impedire a Claude Code di accedere a file contenenti informazioni sensibili (ad es., chiavi API, segreti, file d’ambiente), usa l’impostazione permissions.deny nel tuo file .claude/settings.json:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Read(./build)"
    ]
  }
}

Questo sostituisce la configurazione deprecata ignorePatterns. I file che corrispondono a questi pattern saranno completamente invisibili a Claude Code, prevenendo qualsiasi esposizione accidentale di dati sensibili.

​

Configurazione dei subagenti

Claude Code supporta subagenti AI personalizzati che possono essere configurati sia a livello utente che di progetto. Questi subagenti sono memorizzati come file Markdown con frontmatter YAML:

• Subagenti utente: ~/.claude/agents/ - Disponibili in tutti i tuoi progetti
• Subagenti progetto: .claude/agents/ - Specifici per il tuo progetto e possono essere condivisi con il tuo team

I file dei subagenti definiscono assistenti AI specializzati con prompt personalizzati e permessi degli strumenti. Scopri di più sulla creazione e l’uso dei subagenti nella documentazione dei subagenti.

​

Variabili d’ambiente

Claude Code supporta le seguenti variabili d’ambiente per controllare il suo comportamento:

​

Opzioni di configurazione

Per gestire le tue configurazioni, usa i seguenti comandi:

• Elenca impostazioni: claude config list
• Vedi un’impostazione: claude config get <chiave>
• Cambia un’impostazione: claude config set <chiave> <valore>
• Aggiungi a un’impostazione (per liste): claude config add <chiave> <valore>
• Rimuovi da un’impostazione (per liste): claude config remove <chiave> <valore>

Per impostazione predefinita config cambia la configurazione del tuo progetto. Per gestire la tua configurazione globale, usa il flag --global (o -g).

​

Configurazione globale

Per impostare una configurazione globale, usa claude config set -g <chiave> <valore>:

​

Strumenti disponibili per Claude

Claude Code ha accesso a un set di strumenti potenti che lo aiutano a comprendere e modificare la tua base di codice:

Le regole di permesso possono essere configurate usando /allowed-tools o nelle impostazioni dei permessi.

​

Estendere gli strumenti con gli hook

Puoi eseguire comandi personalizzati prima o dopo l’esecuzione di qualsiasi strumento usando gli hook di Claude Code.

Ad esempio, potresti eseguire automaticamente un formattatore Python dopo che Claude modifica file Python, o impedire modifiche a file di configurazione di produzione bloccando operazioni Write su certi percorsi.

​

Vedi anche

• Gestione Identità e Accesso - Scopri il sistema di permessi di Claude Code
• IAM e controllo accessi - Gestione policy aziendali
• Risoluzione problemi - Soluzioni per problemi di configurazione comuni