Riepilogo rapido: Avviare Claude Code nel terminale è semplice: installalo usando un comando da riga singola dal sito ufficiale, autenticati con il tuo account Anthropic e digita ‘claude’ per avviare una sessione interattiva. Lo strumento CLI funziona su macOS, Linux e Windows, consentendo agli sviluppatori di creare funzionalità, correggere bug e automatizzare attività tramite comandi in linguaggio naturale direttamente nel loro ambiente terminale.
Claude Code rappresenta un cambiamento nel modo in cui gli sviluppatori interagiscono con l'assistenza AI. Invece di copiare codice tra schede del browser e editor di testo, questo strumento basato su terminale vive all'interno del flusso di lavoro di sviluppo, comprendendo intere codebase ed eseguendo attività complesse tramite comandi conversazionali.
Il processo di configurazione richiede meno di cinque minuti per la maggior parte degli sviluppatori. Ma c'è di più nell'avviare Claude Code in modo efficace rispetto alla semplice installazione.
Questa guida copre tutto, dall'installazione iniziale all'avvio di sessioni produttive, con esempi pratici che funzionano su progetti reali.
Cosa fa effettivamente Claude Code
Secondo la documentazione ufficiale, Claude Code è uno strumento di codifica agentivo che legge le codebase, modifica file, esegue comandi e si integra con gli strumenti di sviluppo. L'interfaccia del terminale funge da punto di interazione principale per la maggior parte degli sviluppatori.
Lo strumento gestisce attività di sviluppo routinarie: creazione di funzionalità, correzione di bug, automazione di flussi di lavoro e spiegazione di sezioni di codice complesse. Opera con il pieno contesto dei file di progetto, della cronologia git e dei processi in esecuzione.
A differenza degli assistenti AI basati su browser, Claude Code esegue comandi direttamente nell'ambiente della shell. Quando gli viene chiesto di correggere un errore di compilazione, non si limita a suggerire soluzioni, ma può effettivamente eseguire la correzione, testare il risultato e applicare le modifiche.
Terminale vs. Altre Piattaforme
Claude Code funziona su più piattaforme: terminale CLI, applicazione desktop, interfaccia web, estensioni IDE per VS Code e JetBrains e un'estensione Chrome per il debug di applicazioni live. La versione terminale offre il controllo più diretto.
Le sessioni terminale forniscono scorciatoie da tastiera, esecuzione di attività in background e integrazione con le configurazioni della shell esistenti. Gli sviluppatori che vivono sulla riga di comando trovano questa l'interfaccia più veloce.
| Piattaforma | Ideale per | Vantaggio chiave |
|---|---|---|
| Terminale CLI | Sviluppatori a proprio agio con la riga di comando | Interazione più veloce, piena integrazione della shell |
| App Desktop | Preferenza visiva con sessioni persistenti | Interfaccia GUI, navigazione più semplice |
| Estensione VS Code | Sviluppatori che raramente lasciano il loro IDE | Integrazione perfetta dell'editor |
| Interfaccia Web | Accesso rapido senza installazione | Funziona su qualsiasi dispositivo con browser |
Requisiti di installazione
Prima di installare Claude Code, verifica che il sistema soddisfi i requisiti di base. Lo strumento funziona su macOS, Linux e Windows (incluso WSL2).
È richiesto un account Anthropic attivo. Se non ne hai uno, crealo sul sito ufficiale di Anthropic prima di procedere con l'installazione.
Il terminale deve avere connettività Internet e l'autorizzazione per scaricare ed eseguire script. Alcune reti aziendali limitano l'esecuzione di script: contatta l'IT in caso di fallimento dell'installazione.
Sistemi Operativi Supportati
Rimuovi questa affermazione - non trovata nel materiale sorgente ufficiale L'installazione funziona tramite Terminale o qualsiasi emulatore di terminale come iTerm2.
Le distribuzioni Linux richiedono una shell moderna (bash o zsh). La maggior parte delle installazioni recenti di Ubuntu, Debian, Fedora e Arch funzionano senza modifiche.
Gli utenti Windows dovrebbero prima installare Windows Subsystem for Linux (WSL2). Il supporto nativo per Windows esiste, ma WSL2 fornisce una migliore compatibilità con gli strumenti di sviluppo.
Riduci i costi degli strumenti AI con Get AI Perks mentre inizi
Iniziare con Claude Code spesso significa provare anche altri strumenti AI. Get AI Perks aiuta i fondatori a trovare crediti per startup e sconti software su prodotti AI e cloud. La piattaforma riunisce oltre 200 offerte, inclusi vantaggi per Claude, Anthropic, OpenAI, Gemini, ElevenLabs e altri, insieme alle condizioni per ciascuno.
Vuoi vedere i vantaggi disponibili per gli strumenti AI?
Controlla Get AI Perks per:
- sfogliare le offerte di Claude e altri strumenti AI
- vedere quali vantaggi si adattano alla tua azienda
- seguire guide per richiedere i crediti disponibili
👉 Visita Get AI Perks per confrontare i vantaggi software AI disponibili.
Processo di installazione passo dopo passo
Il metodo di installazione ufficiale utilizza un singolo comando che rileva il sistema operativo e installa la versione appropriata.
Per macOS e Linux
Apri una finestra del terminale ed esegui questo comando:
| curl -fsSL claude.ai/install.sh | bash |
Lo script di installazione scarica il binario di Claude Code, lo posiziona in una directory di sistema e configura l'integrazione della shell. Il processo solitamente si completa in meno di 30 secondi.
Se l'installazione ha successo, il terminale visualizza un messaggio di conferma. Testa l'installazione digitando:
| claude –version |
Questo comando dovrebbe restituire il numero di versione corrente. Se invece appare un errore del tipo "comando non trovato", è necessario regolare la configurazione del PATH.
Per Windows con WSL2
Innanzitutto, assicurati che WSL2 sia installato e configurato. Apri un terminale WSL2 (Ubuntu è consigliato) ed esegui lo stesso comando di installazione di Linux:
| curl -fsSL install.claude.ai | sh |
Problemi di rete specifici di Windows a volte si verificano con WSL2. Secondo la documentazione di risoluzione dei problemi, le regole del firewall potrebbero dover essere regolate per consentire la comunicazione tra i processi WSL2 e Windows.
Risoluzione dei problemi di installazione
Il problema di installazione più comune è la configurazione del PATH. Quando il terminale mostra "comando non trovato" dopo l'installazione, il binario di Claude non è nel percorso eseguibile della shell.
Controlla la posizione di installazione con:
| which claude |
Se questo non restituisce nulla, aggiungi manualmente la directory di installazione al PATH. Per bash, aggiungi questa riga a ~/.bashrc:
| export PATH=”$HOME/.local/bin:$PATH” |
Per gli utenti zsh, aggiungi la stessa riga a ~/.zshrc. Riavvia il terminale o esegui source ~/.bashrc per applicare immediatamente le modifiche.
I fallimenti di installazione relativi alla rete spesso si manifestano come "errore di connessione TLS" o interruzioni del download. Questi indicano restrizioni del firewall o certificati obsoleti. Aggiorna i certificati di sistema o contatta gli amministratori di rete se lavori su una rete aziendale.
Autenticazione e Primo Avvio
Dopo l'installazione riuscita, l'autenticazione collega la CLI locale a un account Anthropic. Avvia il processo di autenticazione eseguendo:
| claude |
Il primo avvio attiva automaticamente l'autenticazione. Si apre una finestra del browser che mostra una pagina di accesso. Accedi con le credenziali del tuo account Anthropic.
Dopo il completamento dell'autenticazione tramite browser, la sessione del terminale si attiva. Un messaggio di benvenuto conferma la connessione e visualizza le istruzioni di base per l'uso.
Gestione delle Sessioni
Ogni volta che claude viene eseguito in un terminale, inizia una nuova sessione. Le sessioni persistono finché non vengono terminate esplicitamente con Ctrl+D o digitando exit.
Il token di autenticazione viene memorizzato localmente, quindi i lanci successivi non richiedono l'accesso tramite browser. Il token rimane valido finché non viene revocato manualmente tramite le impostazioni dell'account sul sito web Anthropic.
Avvio della Modalità Interattiva
La modalità interattiva rappresenta il modo principale in cui gli sviluppatori utilizzano Claude Code. Avviala digitando claude senza argomenti aggiuntivi.
Il terminale passa a un prompt interattivo in cui i comandi in linguaggio naturale dirigono l'AI. Questa modalità mantiene il contesto della conversazione, ricorda le richieste precedenti e può eseguire flussi di lavoro multi-step.
Comandi Interattivi Essenziali
Diversi comandi integrati controllano il comportamento della sessione. Digitali al prompt di Claude Code:
- /model – Passa tra diversi modelli Claude (Opus, Sonnet)
- /status – Visualizza il modello corrente, l'ID della sessione e la configurazione
- /btw – Poni domande laterali senza modificare il contesto del task
- ? – Visualizza le scorciatoie da tastiera e le informazioni di aiuto
Le scorciatoie da tastiera migliorano la produttività. Premi Ctrl+L per pulire lo schermo del terminale senza terminare la sessione. Usa Ctrl+C per annullare una generazione in corso. Ctrl+F interrompe tutte le attività in background (premi due volte per confermare).
La riga di stato in basso mostra i processi in background attivi, il modello corrente e l'utilizzo dei token. Queste informazioni aiutano a monitorare il consumo delle risorse durante attività complesse.
Esecuzione di Attività in Background
Claude Code può eseguire operazioni di lunga durata in background rimanendo reattivo ai nuovi comandi. Le attività in background mostrano indicatori di progresso e si completano in modo asincrono.
Quando più operazioni vengono eseguite contemporaneamente, l'elenco delle attività ne tiene traccia. Premi Ctrl+F per visualizzare e gestire i processi in background.
Esecuzione di Comandi Singoli
Non ogni attività richiede una sessione interattiva. Per operazioni rapide, Claude Code accetta comandi direttamente come argomenti:
| claude “spiega la logica di autenticazione in src/auth.js” |
Questo comando avvia Claude Code, elabora la richiesta, visualizza l'output ed esce immediatamente. Non viene avviata alcuna sessione interattiva.
I comandi singoli funzionano bene per scripting e automazione. Possono essere incorporati in hook git, pipeline CI/CD o script di shell che necessitano di assistenza AI per sotto-task specifici.
Modalità di sola query
Il flag -p esegue la modalità di sola query, che risponde alle domande senza apportare modifiche ai file:
| claude -p “quali dipendenze utilizza questo progetto?” |
Questa modalità legge i file di progetto ma non modifica, crea o elimina nulla. Fornisce solo informazioni, rendendola sicura per l'esplorazione senza rischio di modifiche indesiderate.
Selezione e Configurazione del Modello
Claude Code supporta più modelli AI con diverse capacità e caratteristiche di velocità. Secondo la documentazione ufficiale, i modelli supportati includono Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 e Sonnet 4.5.
Cambia il modello attivo usando il comando /model durante una sessione interattiva. Un menu interattivo elenca le opzioni disponibili con brevi descrizioni dei punti di forza di ciascun modello.
Per una preferenza del modello permanente, imposta una variabile d'ambiente prima di avviare Claude Code:
| export ANTHROPIC_MODEL=”claude-opus-4-6″ claude |
Questa configurazione persiste tra le sessioni finché la variabile non viene modificata o annullata.
Configurazione della Modalità Veloce
La modalità veloce dà priorità alla velocità di risposta rispetto all'analisi completa. È utile per iterazioni rapide e attività semplici dove l'analisi completa del contesto non è necessaria.
Abilita la modalità veloce tramite la configurazione delle impostazioni o utilizzando varianti del modello ottimizzate per la velocità. Controlla la documentazione ufficiale per le opzioni correnti della modalità veloce, poiché evolvono con il rilascio di nuovi modelli.
Lavorare con i Progetti
Claude Code comprende la struttura del progetto analizzando i file nella directory corrente e nelle sottodirectory. Naviga in una directory di progetto prima di iniziare:
| cd /percorso/del/tuo/progetto claude |
Lo strumento legge automaticamente i file di progetto, comprende la struttura della codebase e riconosce pattern comuni come gestori di pacchetti, configurazioni di framework e strumenti di build.
Esclusione di File Sensibili
Alcuni file non dovrebbero essere analizzati o modificati da strumenti AI: credenziali, chiavi API, file binari di grandi dimensioni o contenuti generati. Crea un file .claudeignore nella root del progetto per escludere percorsi specifici:
| .env .env.local node_modules/ dist/ build/ *.log |
Questo funziona in modo simile alla sintassi di .gitignore. I file esclusi rimangono invisibili a Claude Code sia durante l'analisi che durante l'esecuzione.
Suggerimenti per la configurazione del terminale
Claude Code funziona meglio con alcune configurazioni del terminale. La maggior parte dei problemi deriva da impostazioni della shell incompatibili o funzionalità mancanti.
Integrazione della Shell
Soften: alcuni terminali moderni supportano funzionalità opzionali di integrazione della shell come il rilevamento del prompt tramite sequenze OSC 133, sebbene queste non siano richieste
Per una compatibilità ottimale, utilizza versioni recenti di emulatori di terminale popolari: iTerm2 su macOS, Alacritty, Kitty o WezTerm su Linux. Windows Terminal funziona bene con WSL2.
Personalizzazione delle scorciatoie da tastiera
Le scorciatoie da tastiera predefinite potrebbero entrare in conflitto con le associazioni di tasti del terminale o della shell esistenti. Personalizzale tramite il file di configurazione delle impostazioni situato in ~/.claude/settings.json.
Il file delle impostazioni utilizza il formato JSON e supporta la rimappatura di qualsiasi comando integrato a diverse combinazioni di tasti. Dopo averlo modificato, riavvia Claude Code affinché le modifiche abbiano effetto.
Flussi di lavoro comuni per la prima sessione
Parliamoci chiaro: la prima sessione di Claude Code spesso comporta sperimentazione. Ecco punti di partenza pratici che dimostrano le capacità principali.
Esplora la Codebase
Inizia chiedendo a Claude Code di spiegare la struttura del progetto:
“Dammi una panoramica di questa codebase. Quali sono i componenti principali e come interagiscono?”
Questa richiesta non modifica nulla: analizza e spiega semplicemente. La risposta aiuta a verificare che Claude Code comprenda correttamente l'organizzazione del progetto.
Apporta una Modifica Semplice
Prova una modifica a basso rischio per vedere la modifica dei file in azione:
“Aggiungi un commento in cima a README.md che spieghi cosa fa questo progetto”
Claude Code legge il file, genera il contenuto appropriato ed esegue la modifica. Rivedi la modifica con git diff per vedere esattamente cosa è successo.
Correggi un Problema Esistente
Se il progetto ha bug noti o elementi TODO, chiedi a Claude Code di occuparsene:
“Correggi il bug di validazione del login descritto nel problema #42”
Lo strumento legge i file sorgente pertinenti, identifica il problema, implementa una soluzione e può persino eseguire test per verificare che la soluzione funzioni.
Autorizzazioni e Sicurezza
Claude Code richiede l'autorizzazione prima di eseguire operazioni potenzialmente rischiose. Il sistema di autorizzazione categorizza i comandi per livello di impatto.
La lettura dei file avviene senza richieste di autorizzazione: leggere il codice è sempre sicuro. Scrittura, eliminazione di file ed esecuzione di comandi shell richiedono l'approvazione esplicita alla prima occorrenza.
Le scelte di autorizzazione possono essere salvate per la sessione o permanentemente. Le autorizzazioni permanenti vengono memorizzate nei file di configurazione e si applicano a tutte le sessioni future.
Configurazione del Sandboxing
Secondo la documentazione ufficiale delle impostazioni, il sandboxing limita dove Claude Code può apportare modifiche. Configura i prefissi dei percorsi sandbox per limitare l'accesso al file system a directory specifiche.
Questo livello di sicurezza impedisce modifiche accidentali ai file di sistema o alle directory al di fuori dell'ambito del progetto. I team che lavorano su codebase sensibili dovrebbero configurare il sandboxing prima della distribuzione.
| Tipo di Autorizzazione | Comportamento Predefinito | Consigliato per |
|---|---|---|
| Lettura File | Sempre consentita | Tutti i casi d'uso |
| Scrittura/Modifica File | Richiesta la prima volta | Sviluppo attivo |
| Eliminazione File | Richiesta ogni volta | Solo utenti esperti |
| Comandi Shell | Richiesta con anteprima | Flussi di lavoro automatizzati |
| Accesso di Rete | Richiesta la prima volta | Lavoro di integrazione API |
Domande Frequenti
Claude Code funziona offline dopo l'installazione?
No. Claude Code richiede la connettività Internet per tutte le operazioni perché i modelli AI vengono eseguiti sui server di Anthropic. Il client terminale invia richieste all'API e riceve risposte. Senza connessione, lo strumento non può funzionare.
Quanto costa eseguire Claude Code?
Il prezzo dipende dal piano dell'account Anthropic e dal volume di utilizzo. Controlla il sito web ufficiale di Anthropic per i dettagli sui prezzi attuali, poiché piani e tariffe cambiano nel tempo. Il consumo di token varia in base alle dimensioni della codebase e alla complessità delle richieste.
Claude Code può accedere a file esterni alla directory corrente?
Per impostazione predefinita, sì. Claude Code può accedere a qualsiasi file che l'account utente ha l'autorizzazione di leggere. Tuttavia, la configurazione del sandboxing limita l'accesso a directory specifiche. Per ambienti sensibili alla sicurezza, configura le impostazioni sandbox prima del primo utilizzo.
Cosa succede se Claude Code commette un errore?
Tutte le modifiche ai file sono visibili tramite i normali comandi git diff. Prima di eseguire il commit di qualsiasi modifica di Claude Code, rivedi attentamente le modifiche. Poiché tutto avviene in un repository git (consigliato), annullare gli errori è semplice con i comandi git.
Possono essere eseguite più sessioni di Claude Code contemporaneamente?
Sì. Ogni finestra del terminale può eseguire una sessione indipendente di Claude Code. Le sessioni non interferiscono tra loro, anche se modifiche simultanee allo stesso file da sessioni diverse potrebbero causare conflitti.
Come interrompo un'attività di Claude Code in corso?
Premi Ctrl+C per annullare l'operazione corrente. Per le attività in background, premi Ctrl+F per aprire il gestore attività, quindi conferma l'annullamento. La sessione rimane attiva dopo l'annullamento: solo l'attività specifica si interrompe.
Claude Code ricorda le conversazioni precedenti?
All'interno di una singola sessione, sì. Claude Code mantiene il contesto della conversazione e ricorda le richieste e le modifiche precedenti. L'avvio di una nuova sessione (chiusura e riapertura) cancella questo contesto. Per una conoscenza persistente del progetto, utilizza le funzionalità di istruzioni e memorie documentate nelle guide ufficiali.
Passi Successivi all'Installazione
Una volta che Claude Code funziona correttamente, esplora le sue funzionalità estese. La documentazione ufficiale copre argomenti avanzati come sub-agent personalizzati, sviluppo di plugin e automazione di attività pianificate.
Le "skills" forniscono un modo per estendere Claude Code con comandi e flussi di lavoro specifici del progetto. Creare skills nella directory .claude/skills/ aggiunge capacità personalizzate adattate a specifiche esigenze di sviluppo.
L'integrazione del Model Context Protocol (MCP) consente a Claude Code di interagire con strumenti e servizi esterni. Ciò apre possibilità per query di database, test API e gestione dell'infrastruttura tramite la stessa interfaccia conversazionale.
Le funzionalità di controllo remoto consentono di continuare le sessioni su più dispositivi. Inizia il lavoro su una macchina desktop, quindi riprendi la stessa sessione su un laptop o un dispositivo mobile. Controlla la documentazione delle integrazioni della piattaforma per le istruzioni di configurazione.
Ottenere Aiuto Quando si è Bloccati
La documentazione ufficiale per la risoluzione dei problemi affronta la maggior parte dei problemi comuni. Quando si verificano problemi, consultala prima di approfondire la configurazione del sistema.
Le discussioni della community su piattaforme come Reddit forniscono soluzioni reali da parte di altri sviluppatori. Molti utenti condividono le loro modifiche di configurazione e le ottimizzazioni del flusso di lavoro in questi forum.
Per problemi di installazione o autenticazione, verifica lo stato dell'account sul sito web di Anthropic. Abbonamenti scaduti o restrizioni dell'account impediscono una connessione riuscita anche con una corretta configurazione locale.
I problemi specifici del terminale spesso riguardano la configurazione della shell o la compatibilità. Testare con una configurazione terminale predefinita (senza personalizzazioni della shell) aiuta a isolare se il problema deriva da modifiche locali.
Conclusione
Avviare Claude Code nel terminale richiede solo pochi minuti una volta completata l'installazione. La combinazione di comandi in linguaggio naturale e integrazione diretta della codebase crea un flusso di lavoro di sviluppo che gestisce sia query semplici che complessi refactoring multi-file.
L'interfaccia del terminale mantiene gli sviluppatori nel loro ambiente preferito senza cambi di contesto verso schede del browser o applicazioni separate. L'esecuzione di attività in background significa che le operazioni di lunga durata non bloccano altro lavoro.
Come con qualsiasi strumento di sviluppo, la competenza si acquisisce con la pratica. Inizia con semplici query di sola lettura per capire come Claude Code interpreta la struttura del progetto. Passa a modifiche di file e flussi di lavoro automatizzati man mano che la fiducia cresce. Il sistema di autorizzazione impedisce errori irreversibili durante la fase di apprendimento.
Pronto a trasformare il tuo flusso di lavoro di codifica? Installa Claude Code oggi stesso e sperimenta lo sviluppo assistito dall'AI direttamente nel tuo terminale.
