Claude Code - Domande frequenti

Domanda

Risposta

1.1 Come lo installo?

Più facile: scarica Claude Desktop, accedi con il tuo piano e apri la scheda "Code". Claude Code è integrato, quindi non c'è nient'altro da installare.

Terminale:

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: Guida rapida

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 es. 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 nei piani Claude a pagamento e nell'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. chat in Claude?

Claude Code: un agente di codifica che legge il tuo repository, modifica i file ed esegue comandi. È la scheda "Code" in Claude Desktop e funziona anche nel tuo terminale o IDE.
​Chat in Claude (web, Claude Desktop o mobile): chat per conversazioni e domande occasionali.
Stessi modelli sottostanti, forma diversa di strumento.

Riferimento: Panoramica

1.7 Funziona nel mio IDE?

Sì. Sono disponibili estensioni 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 differisce 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 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 stai rimandando. Esempio: "il test in [file] è instabile, scopri perché." Lascia che legga il codice invece di farti spiegare il codice.

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 permanenti:
• 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à:

Riferimento: Modalità di autorizzazione

2.3 Che 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 applicare 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 sfogliato.

Riferimento: Memoria e CLAUDE.md

2.5 Claude non segue 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 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 o premi Ctrl+V. Su Mac è Ctrl, non Cmd (Cmd+V incolla il testo). Funziona per finestre di dialogo 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 sono 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 ogni sessione.

Riferimento: Configurazione del modello

2.11 Pensiero esteso

Attivo per impostazione predefinita. Il ragionamento stesso è nascosto nella vista normale; premi Ctrl+O per passare alla trascrizione dettagliata se vuoi leggerlo. 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 Che 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 o 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 desktop quando Claude ha bisogno di input. Lo stesso meccanismo può eseguire il tuo linter dopo ogni modifica, pubblicare su Slack o bloccare le modifiche ai percorsi protetti.

Riferimento: Guida agli hook

3.4 Crea un prompt/skill riutilizzabile

Crea .claude/skills/ship/SKILL.md e il nome della cartella diventa il comando: /ship. Inglese semplice, nessuna sintassi speciale. Percorso più facile: chiedi a Claude di scriverlo per te. (Il percorso legacy .claude/commands/ship.md funziona ancora.)

Riferimento: Skill

3.5 Skill vs. comandi legacy

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

Riferimento: Skill

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: Subagents

3.7 Esecuzione non interattiva (CI / script)

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

Riferimento: Utilizzo in stile Unix

3.8 Annulla le modifiche

/rewind ripristina un checkpoint precedente. I checkpoint vengono creati automaticamente ad ogni prompt inviato. Per qualsiasi cosa già sottoposta a commit, usa un normale git revert.

Riferimento: Checkpointing

3.9 Condividi la tua configurazione con il team

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

Riferimento: Plugin

Domanda

Risposta

4.1 Impossibile trovare file / la ricerca non restituisce nulla

Claude Code include una copia integrata di ripgrep, quindi non è necessario installarlo. Il binario integrato può fallire su sistemi Alpine/musl; in tal caso installa una copia di sistema (apk add ripgrep) e imposta USE_BUILTIN_RIPGREP=0 affinché Claude la utilizzi.

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 ignorarlo, oppure configura tmux per passare gli eventi del mouse. /copy e /export aggirano completamente il problema.

4.3 Lentezza su WSL

La lettura dei file Windows tramite /mnt/c/ ha 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 prima, controlla cosa è stato scritto nelle impostazioni, quindi generalizza.

Riferimento: Pattern di autorizzazioni

4.6 La modalità non interattiva -p si comporta diversamente

Per esecuzioni non interattive/CI, preferisci l'autenticazione tramite chiave API e 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, dividi 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 intero repository 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 specifici file, aggiungi una regola di negazione della lettura in .claude/settings.json (ad es. "Read(.env*)"). I file negati non possono essere letti nemmeno se li chiedi accidentalmente.

Riferimento: Autorizzazioni

5.5 Cosa può fare la modalità "acceptEdits" 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 directory di lavoro. Per un controllo più rigoroso, rimani in modalità predefinita.

Riferimento: Permissions

Risorsa

A cosa serve

/help

Comando integrato che elenca ciò che è disponibile nella tua sessione

/feedback

Segnala un problema dal terminale (alias per /bug)

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

Permissions

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