Domande frequenti su Claude Code

Domanda

Risposta

1.1 Come lo installo?

macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash
​Windows PowerShell: irm https://claude.ai/install.ps1 | iex
​Homebrew: brew install --cask claude-code
​WinGet: winget install Anthropic.ClaudeCode
Quindi esegui claude da qualsiasi repository.

Riferimento: Quickstart

1.2 Installato, ma "claude: command not found"

L'installer nativo posiziona il binario in ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin). Aggiungi quella directory al tuo PATH, ad esempio export PATH="$PATH:$HOME/.local/bin" in ~/.zshrc o ~/.bashrc, quindi riavvia il terminale.

Riferimento: Risoluzione dei problemi: PATH

1.3 L'accesso apre un browser sulla macchina sbagliata / Sono su SSH

Premi c al prompt di accesso per copiare l'URL di autenticazione. Aprilo in un browser locale, quindi incolla il codice nel terminale.

Riferimento: Risoluzione dei problemi: autenticazione

1.4 Errori di autenticazione subito dopo l'accesso, ma ho accesso

400 "organization disabled": una variabile d'ambiente ANTHROPIC_API_KEY errata sta sovrascrivendo il tuo accesso. Annullala, rimuovila dal profilo della shell, riavvia. Esegui /status per confermare quale autenticazione è attiva.
​403 Forbidden: il tuo amministratore non ha ancora abilitato Claude Code per il tuo workspace, oppure un proxy aziendale sta interferendo.

Riferimento: Risoluzione dei problemi: autenticazione

1.5 Claude Code è incluso nel mio piano?

Sì. È incluso con i posti Team ed Enterprise e con l'accesso Console (API). Accedi con il tuo account di lavoro; SSO viene gestito automaticamente. Un errore 403 dopo l'accesso di solito significa che il tuo amministratore deve ancora abilitarlo per il workspace.

Riferimento: Autenticazione

1.6 Claude Code vs. app desktop vs. claude.ai?

Claude Code: agente terminale che legge il tuo repository, modifica i file, esegue i comandi.
​Desktop / claude.ai: interfacce di chat per conversazioni e domande occasionali.
Stessa famiglia di modelli sottostante, forma diversa di strumento.

Riferimento: Panoramica

1.7 Funziona nel mio IDE?

Sì. Le estensioni sono disponibili per VS Code e IDE JetBrains (IntelliJ, PyCharm, ecc.). Stesse funzionalità, integrate nell'editor invece di un terminale separato.

Riferimento: VS Code · JetBrains

1.8 Come è diverso da Copilot/Cursor autocomplete?

L'autocompletamento suggerisce le prossime righe. Claude Code è un agente: dagli un compito ("correggi i test falliti") e legge i file, esegue i comandi e fa modifiche multi-file fino al completamento. Meno "completa la mia frase", più "ecco un problema, vai a risolverlo".

Riferimento: Panoramica

1.9 Cosa dovrei provare per primo?

Puntalo su un bug tedioso ma non difficile che hai rimandato. Esempio: "il test in [file] è instabile, scopri perché." Lascia che legga il codice invece di spiegarglielo tu.

Riferimento: Casi d'uso comuni

1.10 Come lo aggiorno?

Gli install nativi si aggiornano automaticamente in background. Per forzarne uno adesso, esegui claude update.
Homebrew/WinGet non si aggiornano automaticamente: esegui brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode periodicamente.

Riferimento: Setup: aggiornamenti

Domanda

Risposta

2.1 Continua a chiedere il permesso per gli stessi comandi

Le approvazioni durano per la sessione corrente per impostazione predefinita. Per renderle persistenti:
• Scegli "consenti sempre" al prompt
• Aggiungi il pattern a permissions.allow in .claude/settings.json
• Oppure esegui /permissions per gestire in modo interattivo

Riferimento: Permessi

2.2 Modalità di permesso e come passare da una all'altra

Premi Shift+Tab per ciclo le modalità:
• default · chiede prima di modifiche o comandi rischiosi
• accept-edits · le modifiche ai file passano; chiede ancora prima di eseguire i comandi
• plan · sola lettura; propone un piano e attende l'approvazione
• auto (se abilitato dalla tua organizzazione) · approva automaticamente con un controllo di sicurezza in background

Riferimento: Modalità di permesso

2.3 Cos'è /init e quando lo eseguo?

Eseguilo una volta, all'inizio, in qualsiasi repository su cui lavorerai più di una volta. Scansiona il progetto e scrive CLAUDE.md con comandi di build, architettura e convenzioni. Ogni sessione futura lo carica automaticamente, quindi Claude inizia con il contesto.

Riferimento: Memoria e CLAUDE.md

2.4 Cosa va in CLAUDE.md?

Cose che gli strumenti non possono forzare e che un nuovo collega sbaglierebbe il primo giorno: "distribuisci da release, non da main", "tutti gli ID sono stringhe", "non chiamare mai il DB direttamente da un gestore di route". Mantienilo sotto due schermate; più lungo viene scorso.

Riferimento: Memory e CLAUDE.md

2.5 Claude non sta seguendo il mio CLAUDE.md

• Troppo lungo o troppo vago: riduci alle regole che contano davvero
• Sepolto nella prosa: metti le regole dure in alto, usa il linguaggio imperativo ("Mai X. Sempre Y.")

Riferimento: Best practice

2.6 Puntalo a un file specifico senza incollarlo

Digita @ seguito dal percorso (completamento con tab). Il file menzionato viene letto prima che Claude risponda.

Riferimento: Flussi di lavoro comuni

2.7 Incolla uno screenshot nel prompt

Trascina l'immagine nel terminale, oppure premi Ctrl+V. Su Mac è Ctrl, non Cmd (Cmd+V incolla il testo). Funziona per finestre di errore, mockup UI, foto di lavagna.

Riferimento: Lavorare con le immagini

2.8 Copia la risposta di Claude dal terminale

/copy mette l'ultima risposta negli appunti. /export scrive l'intera conversazione in un file.

2.9 Recupera una sessione precedente

claude --continue riprende quella più recente. claude --resume apre un elenco da cui scegliere. Le sessioni vengono archiviate localmente per directory di progetto.

Riferimento: Flussi di lavoro comuni: riprendi

2.10 Cambia modello

/model apre il selettore. Imposta un valore predefinito in .claude/settings.json se vuoi lo stesso modello in ogni sessione.

Riferimento: Configurazione del modello

2.11 Pensiero esteso

Attivo per impostazione predefinita; vedrai il ragionamento di Claude prima delle risposte più difficili. Usa /effort per aumentare o diminuire la profondità. Vale la latenza extra per il debug complicato o le decisioni architettoniche.

Riferimento: Pensiero esteso

2.12 Fermalo a metà compito

Premi Ctrl+C per annullare la generazione corrente, quindi digli cosa fare invece. Non è necessario ricominciare la conversazione.

Domanda

Risposta

3.1 Cos'è MCP?

MCP connette Claude Code ai tuoi strumenti esterni: GitHub, Linear, Slack, il tuo database, il tuo stack di osservabilità. Una configurazione .mcp.json e Claude può leggere i tuoi problemi, interrogare i tuoi dati e utilizzare gli stessi strumenti che usi tu. Primo connettore comune: il tuo tracker di problemi.

Riferimento: MCP

3.2 Configura il tuo primo server MCP

• Aggiungi un .mcp.json alla radice del progetto, oppure usa claude mcp add
• Ogni voce nomina un pacchetto server più eventuali variabili di ambiente (solitamente un token di autenticazione)
• Riavvia Claude Code ed esegui /mcp per confermare che è connesso

Riferimento: Configurazione MCP

3.3 A cosa servono gli hook?

Script di shell che si attivano su eventi (prima che uno strumento venga eseguito, dopo una modifica di file, quando Claude è in attesa di te). Primo hook comune: un hook di Notifica che avvisa il tuo desktop quando Claude ha bisogno di input. Lo stesso meccanismo può eseguire il tuo linter dopo ogni modifica, inviare a Slack o bloccare le modifiche ai percorsi protetti.

Riferimento: Guida agli hook

3.4 Crea un prompt riutilizzabile / comando slash

Rilascia un file markdown in .claude/commands/. Il nome del file diventa il comando: .claude/commands/ship.md diventa /ship. Inglese semplice, nessuna sintassi speciale. Percorso più facile: chiedi a Claude di scriverlo per te.

Riferimento: Comandi slash

3.5 Competenze vs. comandi slash

Stesso meccanismo; i comandi sono stati uniti alle competenze. .claude/commands/foo.md e .claude/skills/foo/SKILL.md creano entrambi /foo. La forma di competenza ti dà una cartella per i file di supporto (documenti di riferimento, modelli, script di supporto).

Riferimento: Competenze

3.6 A cosa servono i subagent?

Lavoro parallelo: cerca diverse parti della codebase, esamina un diff secondo dimensioni separate, o genera implementazioni concorrenti contemporaneamente. La sessione principale aggrega i risultati.

Riferimento: Subagent

3.7 Esegui headless (CI / script)

claude -p "il tuo prompt" viene eseguito una volta e stampa il risultato. Utile per hook CI, controlli pre-commit o piping in altri strumenti. Autenticazione tramite la tua sessione connessa o ANTHROPIC_API_KEY.

Riferimento: Utilizzo in stile Unix

3.8 Annulla quello che ha fatto

/rewind ripristina un checkpoint precedente. I checkpoint vengono acquisiti automaticamente ad ogni prompt che invii. Per qualsiasi cosa già sottoposta a commit, utilizza un normale git revert.

Riferimento: Checkpointing

3.9 Condividi la tua configurazione con il team

Aggiungi .claude/ al repository (CLAUDE.md, commands, MCP config). Chiunque cloni il repository ottiene automaticamente la stessa configurazione. Le skill possono anche essere pacchettizzate come un plugin che i team installano tramite /plugin.

Riferimento: Plugins

Domanda

Risposta

4.1 Impossibile trovare file / la ricerca non restituisce nulla

Claude Code utilizza ripgrep sotto il cofano. Se manca, la ricerca si degrada. Installalo (brew install ripgrep o apt install ripgrep) e imposta USE_BUILTIN_RIPGREP=0 per utilizzare la copia di sistema.

Riferimento: Risoluzione dei problemi: ricerca

4.2 Copia/incolla e scorrimento non funzionano su SSH o in tmux

L'interfaccia del terminale cattura gli eventi del mouse. Tieni premuto Maiusc mentre selezioni per bypassarlo, oppure configura tmux per passare gli eventi del mouse. /copy e /export aggirano completamente il problema.

4.3 Lento su WSL

La lettura dei file Windows tramite /mnt/c/ è una penalità nota. Sposta il repository nel filesystem WSL (~/ invece di /mnt/c/...). La differenza di velocità è drammatica.

Riferimento: Risoluzione dei problemi: WSL

4.4 L'incolla di immagini non funziona su Mac

Usa Ctrl+V, non Cmd+V. Cmd+V incolla il testo; Ctrl+V è il percorso per l'immagine dagli appunti.

4.5 La regola di autorizzazione con wildcard non corrisponde

Costruisci le regole in modo incrementale: approva i comandi in modo interattivo per primo, controlla cosa è stato scritto nelle impostazioni, quindi generalizza.

Riferimento: Modelli di autorizzazioni

4.6 La modalità headless -p si comporta diversamente

• I server MCP che necessitano di OAuth non possono richiedere conferma in modalità headless
• Le approvazioni interattive non vengono trasferite
Per headless/CI, preferisci l'autenticazione con chiave API e i server MCP configurati con token di variabili d'ambiente.

4.7 Contesto esaurito a metà attività

/compact riassume la conversazione precedente per liberare spazio. /clear ricomincia da capo mantenendo CLAUDE.md e le impostazioni caricate. Per attività lunghe, suddividi in passaggi con un /clear tra le fasi.

Riferimento: Gestione del contesto

Domanda

Risposta

5.1 Anthropic addestra i modelli sul mio codice?

No. Secondo i termini Team/Enterprise della tua organizzazione, il tuo codice e le tue conversazioni non vengono utilizzati per addestrare i modelli.

Riferimento: Utilizzo dei dati

5.2 Dove va effettivamente il mio codice?

Claude Code viene eseguito sulla tua macchina. I file sorgente vengono letti localmente e solo le porzioni necessarie per l'attività corrente vengono inviate all'API per generare una risposta. Nulla viene indicizzato, caricato come repository completo o utilizzato per l'addestramento.

Riferimento: Utilizzo dei dati

5.3 Qualcun altro può vedere le mie conversazioni?

No. Le sessioni vengono archiviate localmente sulla tua macchina, per directory di progetto, e non vengono condivise con i compagni di team o visibili in alcuna dashboard. Usa /export se vuoi condividere una conversazione.

Riferimento: Utilizzo dei dati

5.4 Come mantengo i segreti e i file .env fuori dalla conversazione?

Claude legge solo i file di cui ha bisogno per l'attività; non scansiona l'intero repository. Per bloccare duramente file specifici, aggiungi una regola di negazione della lettura in .claude/settings.json (ad es. "Read(.env*)"). I file negati non possono essere letti nemmeno se accidentalmente li chiedi.

Riferimento: Autorizzazioni

5.5 Cosa può fare la modalità "accept-edits" senza chiedermi?

Le modifiche ai file vengono applicate senza una richiesta. Chiede comunque prima di eseguire comandi shell, effettuare chiamate di rete o toccare qualsiasi cosa al di fuori della tua directory di lavoro. Per un controllo più stretto, rimani in modalità predefinita.

Riferimento: Autorizzazioni

Risorsa

A cosa serve

/help

Elenco di comandi integrati di ciò che è disponibile nella tua sessione

/bug

Segnala un problema dal terminale (alias per /feedback)

Documentazione completa

Tutto qui, in dettaglio

Il canale #claude-code del tuo team

Piccoli successi e strani errori appartengono entrambi lì

Pagina

Link

Guida rapida

code.claude.com/docs/en/quickstart

Risoluzione dei problemi

code.claude.com/docs/en/troubleshooting

Autorizzazioni

code.claude.com/docs/en/permissions

Memoria e CLAUDE.md

code.claude.com/docs/en/memory

MCP

code.claude.com/docs/en/mcp

Utilizzo dei dati

code.claude.com/docs/en/data-usage