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 di 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 impostazioni che sono incluse nel controllo di versione e condivise con il tuo team
  • .claude/settings.local.json per impostazioni che non sono incluse nel controllo di versione, 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:*)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}

​

Impostazioni disponibili

settings.json supporta diverse opzioni:

​

Impostazioni permessi

​

Precedenza delle impostazioni

Le impostazioni sono 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 progetto locali (.claude/settings.local.json)

   • Impostazioni personali specifiche del progetto

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

   • Impostazioni progetto condivise dal team nel controllo di versione

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 di 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 (Aziendali) sovrascrivono quelle di livello inferiore (Utente/Progetto)
• Ereditarietà: Le impostazioni sono unite, con impostazioni più specifiche che aggiungono o sovrascrivono quelle più ampie

​

Configurazione subagenti

Claude Code supporta subagenti AI personalizzati che possono essere configurati sia a livello utente che 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 subagenti definiscono assistenti AI specializzati con prompt personalizzati e permessi degli strumenti. Scopri di più sulla creazione e uso dei subagenti nella documentazione 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 permessi.

​

Estendere strumenti con hooks

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

Per esempio, potresti eseguire automaticamente un formattatore Python dopo che Claude modifica file Python, o prevenire modifiche a file di configurazione di produzione bloccando operazioni Write a 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