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

​

Impostazioni disponibili

settings.json supporta una serie di opzioni:

​

Impostazioni permessi

​

Precedenza delle impostazioni

Le impostazioni sono applicate in ordine di precedenza:

1. Policy aziendali (vedi documentazione IAM)
2. Argomenti della riga di comando
3. Impostazioni progetto locali
4. Impostazioni progetto condivise
5. Impostazioni utente

​

Configurazione 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 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 <key>
• Cambia un’impostazione: claude config set <key> <value>
• Aggiungi a un’impostazione (per liste): claude config add <key> <value>
• Rimuovi da un’impostazione (per liste): claude config remove <key> <value>

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 <key> <value>:

​

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 impedire 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