Impostazioni di Claude Code

​

File di impostazioni

• Impostazioni utente sono definite in ~/.claude/settings.json e si applicano a tutti i progetti.
• Impostazioni di progetto sono salvate nella directory del tuo progetto:
  • .claude/settings.json per le impostazioni che vengono controllate nel controllo del codice sorgente e condivise con il tuo team
  • .claude/settings.local.json per le impostazioni che non vengono controllate, utili per preferenze personali e sperimentazione. Claude Code configurerà git per ignorare .claude/settings.local.json quando viene creato.
• Per le distribuzioni enterprise di Claude Code, supportiamo anche impostazioni di policy gestite dall’enterprise. Queste hanno la precedenza sulle impostazioni utente e di 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
• Le distribuzioni enterprise possono anche configurare server MCP gestiti che sostituiscono i server configurati dall’utente. Vedi Configurazione MCP Enterprise:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Linux e WSL: /etc/claude-code/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.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

​

Impostazioni di permesso

​

Impostazioni sandbox

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker"],
    "network": {
      "allowUnixSockets": [
        "/var/run/docker.sock"
      ],
      "allowLocalBinding": true
    }
  },
  "permissions": {
    "deny": [
      "Read(.envrc)",
      "Read(~/.aws/**)"
    ]
  }
}

• Le regole di negazione Read bloccano le letture di file nella sandbox
• Le regole di consentimento Edit permettono le scritture di file (in aggiunta ai valori predefiniti, ad es. la directory di lavoro corrente)
• Le regole di negazione Edit bloccano le scritture all’interno dei percorsi consentiti

• Le regole di consentimento WebFetch permettono i domini di rete
• Le regole di negazione WebFetch bloccano i domini di rete

​

Precedenza delle impostazioni

1. Policy gestite dall’enterprise (managed-settings.json)
   • Distribuite da IT/DevOps
   • Non possono essere sovrascritte
2. Argomenti della riga di comando
   • Override temporanei per una sessione specifica
3. Impostazioni di progetto locale (.claude/settings.local.json)
   • Impostazioni personali specifiche del progetto
4. Impostazioni di progetto condivise (.claude/settings.json)
   • Impostazioni di progetto condivise dal team nel controllo del codice sorgente
5. Impostazioni utente (~/.claude/settings.json)
   • Impostazioni globali personali

​

Punti chiave sul sistema di configurazione

• File di memoria (CLAUDE.md): Contengono istruzioni e contesto che Claude carica all’avvio
• File di impostazioni (JSON): Configurano permessi, variabili di ambiente e comportamento degli strumenti
• Comandi slash: Comandi personalizzati che possono essere invocati durante una sessione con /command-name
• Server MCP: Estendono Claude Code con strumenti e integrazioni aggiuntivi
• Precedenza: Le configurazioni di livello superiore (Enterprise) sostituiscono quelle di livello inferiore (User/Project)
• Eredità: Le impostazioni vengono unite, con impostazioni più specifiche che si aggiungono o sostituiscono quelle più ampie

​

Disponibilità del prompt di sistema

​

Esclusione di file sensibili

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

​

Configurazione subagent

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

​

Configurazione plugin

​

Impostazioni plugin

{
  "enabledPlugins": {
    "formatter@company-tools": true,
    "deployer@company-tools": true,
    "analyzer@security-plugins": false
  },
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": "github",
      "repo": "company/claude-plugins"
    }
  }
}

​

enabledPlugins

• Impostazioni utente (~/.claude/settings.json): Preferenze personali dei plugin
• Impostazioni di progetto (.claude/settings.json): Plugin specifici del progetto condivisi con il team
• Impostazioni locali (.claude/settings.local.json): Override per macchina (non committati)

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "deployment-tools@team-tools": true,
    "experimental-features@personal": false
  }
}

​

extraKnownMarketplaces

1. I membri del team vengono invitati a installare il marketplace quando si fidano della cartella
2. I membri del team vengono quindi invitati a installare i plugin da quel marketplace
3. Gli utenti possono saltare marketplace o plugin indesiderati (archiviati nelle impostazioni utente)
4. L’installazione rispetta i confini di fiducia e richiede il consenso esplicito

{
  "extraKnownMarketplaces": {
    "company-tools": {
      "source": {
        "source": "github",
        "repo": "company-org/claude-plugins"
      }
    },
    "security-plugins": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/security/plugins.git"
      }
    }
  }
}

• github: Repository GitHub (usa repo)
• git: Qualsiasi URL git (usa url)
• directory: Percorso del filesystem locale (usa path, solo per lo sviluppo)

​

Gestione dei plugin

• Sfoglia i plugin disponibili dai marketplace
• Installa/disinstalla plugin
• Abilita/disabilita plugin
• Visualizza i dettagli del plugin (comandi, agenti, hook forniti)
• Aggiungi/rimuovi marketplace

​

Variabili di ambiente

​

Strumenti disponibili per Claude

​

Estensione degli strumenti con hook

​

Vedi anche

• Identity and Access Management - Scopri il sistema di permessi di Claude Code
• IAM e controllo di accesso - Gestione delle policy enterprise
• Risoluzione dei problemi - Soluzioni per i problemi di configurazione comuni