Come installare Claude Code

Claude Code è un'interfaccia a riga di comando per Claude, il modello di Anthropic. Si usa nel terminale, legge i file del tuo progetto, e risponde nel contesto di quello che stai costruendo. Non è una chat generica: è uno strumento pensato per chi lavora su codice, workflow, automazioni.

Per usarlo in vibe coding su n8n, come descritto in Come vibe-codare un bot WhatsApp con Claude Code e n8n, serve installarlo e configurarlo con una chiave API. Il processo richiede dieci minuti.

Cosa serve prima di iniziare

Un account Anthropic. Si crea su console.anthropic.com. Richiede un indirizzo email e un numero di telefono per la verifica. Il piano a crediti (pay-as-you-go) è sufficiente per uso occasionale.

Node.js versione 18 o superiore. Claude Code si installa tramite npm, il gestore di pacchetti di Node. Se non hai Node installato, scaricalo da nodejs.org. La versione LTS va bene.

Un terminale. Su Mac, usa il Terminale o iTerm2. Su Windows, usa PowerShell o Windows Terminal. Su Linux, qualsiasi terminale funziona.

Installazione

Apri il terminale e lancia:

npm install -g @anthropic-ai/claude-code

Il flag -g installa Claude Code come strumento globale: lo puoi usare da qualsiasi cartella del sistema, non solo dal progetto corrente. L'installazione scarica alcune dipendenze e richiede 30-60 secondi.

Per verificare che l'installazione sia andata a buon fine:

claude --version

Dovrebbe restituire il numero di versione. Se restituisce «command not found», c'è un problema con il PATH di Node. Su Mac con nvm, può servire aggiungere la cartella bin di npm al PATH del profilo shell.

Configurazione della chiave API

Claude Code ha bisogno della tua chiave API Anthropic per funzionare.

Ottieni la chiave. Vai su console.anthropic.com > API Keys > Create Key. Dai un nome alla chiave (ad esempio «claude-code») e copiala. La chiave inizia con sk-ant-. Non la puoi vedere di nuovo dopo aver chiuso la pagina, quindi copiala subito.

Configura la chiave. La prima volta che lanci claude nel terminale, ti chiede direttamente la chiave API. Inseriscila e premi Invio. Viene salvata in modo sicuro sulla macchina locale.

In alternativa, puoi impostarla come variabile d'ambiente:

export ANTHROPIC_API_KEY="sk-ant-la-tua-chiave"

Per renderla permanente su Mac/Linux, aggiungi quella riga al file ~/.zshrc o ~/.bashrc.

Primo avvio

Vai nella cartella di un progetto qualsiasi:

cd /percorso/del/tuo/progetto
claude

Si apre una sessione interattiva. Claude legge il contenuto della cartella corrente e risponde nel contesto di quei file. Puoi fare domande sul codice, chiedere modifiche, chiedere di generare nuovi file.

Per uscire dalla sessione interattiva: /exit oppure Ctrl+C.

Come usarlo per vibe codare workflow n8n

La modalità più utile per costruire workflow n8n è la sessione interattiva con una cartella di progetto dedicata. Crea una cartella per il progetto, mettici dentro un file di testo con la descrizione dell'architettura (quale database usi, che campi hai, come è strutturato il bot), e lancia claude in quella cartella.

Claude legge il file di contesto e usa quelle informazioni per ogni risposta successiva. Quando chiedi di generare un workflow n8n, il risultato rifletterà la struttura specifica del tuo progetto invece di un esempio generico.

Un prompt di esempio per iniziare:

«Genera il JSON di un workflow n8n con un Webhook trigger che riceve un messaggio WhatsApp da ManyChat. Il payload ha i campi phone (stringa), message (stringa) e timestamp. Per ora, rispondi sempre con "Messaggio ricevuto" tramite una HTTP Request a https://api.manychat.com/fb/sending/sendContent con autenticazione Bearer.»

Importa il JSON in n8n, testa il webhook con un client HTTP come Postman o Hoppscotch, e da lì in poi costruisci step per step.

Leggi anche: Come creare un'automazione n8n per capire come funziona n8n e come importare un workflow.

Costi

Claude Code usa la tua chiave API Anthropic. Il costo dipende dal modello usato e dal volume di token (caratteri in input e output) per sessione.

Per uso occasionale (qualche sessione a settimana per costruire e correggere workflow n8n), il costo mensile è tipicamente sotto i 5 euro. Sessioni lunghe con molti file nel contesto possono costare di più.

Anthropic pubblica i prezzi per modello su anthropic.com/pricing. Il modello Claude Sonnet è il bilanciamento migliore tra costo e capacità per questo tipo di lavoro.

Domande frequenti

Claude Code è gratuito? No. Usa la tua chiave API Anthropic e addebita in base ai token consumati (caratteri in input e output). Per uso occasionale su n8n (qualche sessione a settimana per costruire workflow) il costo mensile è tipicamente sotto i 5 euro. Sessioni lunghe con molti file nel contesto costano di più.

Funziona su Windows? Sì, tramite PowerShell o Windows Terminal. Serve Node.js 18 o superiore installato, disponibile su nodejs.org. Su Mac e Linux il processo è identico.

In che lingua devo scrivere i prompt? In qualsiasi lingua. Claude Code capisce l'italiano: descrivere il workflow in italiano funziona esattamente come in inglese. Per i workflow n8n destinati a team italiani, scrivere i prompt in italiano facilita anche la manutenzione futura.

Posso usarlo senza avere un progetto di codice aperto? Sì. Puoi lanciarlo in una cartella vuota con solo un file CONTESTO.md che descrive la tua architettura. Claude legge quel file e usa quelle informazioni come riferimento per ogni risposta nella sessione.

---

Questo articolo fa parte del cluster su WhatsApp e Facebook Ads: Come integrare WhatsApp con Facebook Ads - guida pratica per aziende italiane