Claude Code come funziona: guida per chi non programma

Claude Code come funziona: è l’agente di coding di Anthropic che legge i file sul disco, li modifica e lancia comandi. Non è ChatGPT: non copi codice, gli chiedi il risultato e resti committente.

Se ti serve una landing in due serate e non hai uno sviluppatore in organico, questo è lo strumento concreto del vibe coding: parli in italiano, l’agente scrive sui file. Il terminale, qui, è una chat. Non un esame.

Come funziona Claude Code (e perché non è ChatGPT)

Anthropic lo definisce un agente di coding: legge il codebase, modifica file, esegue comandi e si collega agli strumenti di sviluppo. Lo trovi nel terminale, nell’app desktop, nel browser e come estensione per VS Code. Il 17 agosto 2026 il repository pubblico segnava 141.713 stelle e 22.751 fork.

Il motore è un loop agentico in tre fasi. Prima raccoglie contesto. Poi agisce. Poi verifica i risultati. Puoi interrompere in qualsiasi momento. Senza strumenti risponde solo a testo, come una chat. Con gli strumenti legge, modifica, lancia comandi e cerca sul web. Le categorie ufficiali sono cinque: file, search, execution, web, code intelligence.

Questa è la differenza che conta rispetto a ChatGPT. Lì copi un blocco e speri di incollarlo nel posto giusto. Qui l’agente sta già dentro la cartella. È lo stesso scarto che separa un chatbot da un agente AI: uno parla, l’altro lavora sui file.

All’avvio in una cartella vede i file del progetto, il terminale, lo stato git, il file CLAUDE.md e la memoria automatica (le prime 200 righe o 25 KB di MEMORY.md, il primo dei due limiti che scatta). In modalità predefinita chiede approvazione prima di ogni modifica. Shift+Tab cicla le modalità: acceptEdits approva da solo le edit, plan propone senza scrivere.

Prima di toccare i file fa uno snapshot. Se qualcosa non va, torni indietro. Le sessioni restano in ~/.claude/projects/.

In produzione, su siti e repo, a TheDrobot Claude Code si usa come agente sulla cartella del progetto, non come chat da cui copiare pezzi.

Cosa serve prima di installare: Mac, Windows, abbonamento

Requisiti di sistema, dalla documentazione Advanced setup consultata il 17 agosto 2026: macOS 13.0 o successivo; Windows 10 versione 1809 o successiva, oppure Windows Server 2019 o successivo; Ubuntu 20.04+, Debian 10+, Alpine 3.19+. Hardware: almeno 4 GB di RAM, processore x64 o ARM64. Serve una rete. Shell ammesse: Bash, Zsh, PowerShell o CMD. Serve un Paese supportato da Anthropic.

Serve anche un account a pagamento. Il piano Free dà la chat su web, iOS, Android e desktop. Claude Code compare da Pro in su, nella riga «Includes Claude Code». Alternative: account Console API a credito, oppure Bedrock, Google Cloud Agent Platform, Microsoft Foundry. Per cambiare account, in sessione usi /login.

Due scelte di superficie, prima ancora del comando.

L’app desktop è il percorso più vicino a un programma normale. Download ufficiale per macOS (Intel e Apple Silicon), Windows x64 e Windows ARM64. Dopo il login si apre il tab Code. Serve l’abbonamento. Se il terminale ti fa paura, parti da qui.

Sul web, senza installare nulla, c’è https://claude.ai/code (anche da app iOS e Android). Meno «sul disco» dell’app o della CLI, utile per provare.

Su Windows nativo Anthropic consiglia Git for Windows. Altrimenti Claude Code usa PowerShell al posto di Bash. Se lavori in WSL, Git for Windows non ti serve.

Quello che non ti serve: npm. L’installazione via @anthropic-ai/claude-code è deprecata come metodo consigliato nel README del repository. Il pacchetto resta documentato; da v2.1.198 chiede Node.js 22 o successivo. Vietato sudo npm install -g. Se non programmi, non passare da lì.

Installazione passo passo su Mac e Windows

Percorso ufficiale consigliato: installazione nativa. Si aggiorna da sola in background.

Su Mac, Linux o WSL, nel Terminale:

curl -fsSL https://claude.ai/install.sh | bash

Su Windows, prima guarda il prompt. Se vedi PS C:\ sei in PowerShell. Se vedi C:\ senza PS, sei in CMD. I due comandi non sono intercambiabili.

PowerShell:

irm https://claude.ai/install.ps1 | iex

CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Se compare «The token ’&&’ is not a valid statement separator», sei in PowerShell e hai incollato il comando CMD. Se irm non è riconosciuto, sei in CMD e hai incollato il comando PowerShell. Non è un errore di Claude Code. È la shell sbagliata.

Alternative ufficiali, senza auto-update: su Mac, Homebrew con brew install --cask claude-code (canale stable circa una settimana indietro; claude-code@latest per le release subito; si aggiorna con brew upgrade). Su Windows, WinGet: winget install Anthropic.ClaudeCode, aggiornamento con winget upgrade Anthropic.ClaudeCode.

Verifica:

claude --version

Deve stampare un numero di versione seguito da (Claude Code). La documentazione di setup porta come esempio 2.1.211 (Claude Code): è l’esempio della pagina, non «l’ultima versione del giorno». Poi cd nella cartella del progetto e claude. Al primo avvio il login si apre nel browser.

C’è anche l’estensione editor: cerca «Claude Code» in VS Code o in Cursor (ID anthropic.claude-code). Per chi non ha mai aperto un editor, può aspettare.

Primo progetto: sito vetrina per una PMI in due serate

Scenario didattico, non un case con orologi o conteggi di iterazioni. Una pagina unica per uno studio, un’agenzia, un ristorante o un’officina. Sezioni minime: chi siamo, servizi, recensioni o lavori, contatti con bottone WhatsApp, footer.

Due serate sono la cornice di questa guida, non una misura di laboratorio. Serata 1: installazione e prima versione. Serata 2: testi veri, prova sul telefono, pubblicazione.

Crea una cartella vuota, entra, lancia claude (o apri quella cartella dall’app desktop). Poi parli da committente, non da developer.

Un prompt che funziona assomiglia a questo: città, nome dell’attività, tono (diretto, formale, caldo), tre servizi veri, una frase su chi siete, un numero WhatsApp vero, tre recensioni o tre lavori reali. Un prompt che non funziona è «fammi un sito bello».

Una modifica è un messaggio. Se il titolo è debole, chiedi solo il titolo. Se il bottone WhatsApp non si vede sul telefono, chiedi solo quello. Dieci correzioni in un colpo solo producono un sito che non riconosci più.

Quando i testi sono i tuoi, puoi chiedere di pubblicarlo su un host statico gratuito. Non mettiamo qui un canone: dominio, IVA e piano a pagamento dell’host non stanno in questa guida. Il passo è «pubblica su un host statico gratuito», non «compra un pacchetto».

Il titolare non deve diventare programmatore per una sera. Deve restare committente e tester: dire il risultato, aprire il sito sul telefono, rifiutare la prima bozza se i testi non sono i suoi. Il codice lo scrive l’agente. Il giudizio sul lavoro resta umano.

Valerii Yerokhin, esperto di Antigraviti e CEO di TheDrobot

Comandi base del primo giorno

Non ti servono tutti i comandi. Ti servono questi, dal quickstart ufficiale.

Dove	Comando	Cosa fa
Shell	claude	Avvio interattivo nella cartella
Shell	claude "task"	Un compito singolo
Shell	claude -p "query"	Una domanda, poi esce
Shell	claude -c	Continua l’ultima conversazione in quella cartella
Shell	claude -r	Riprende una conversazione precedente
In sessione	/help	Elenco comandi
In sessione	/clear	Azzera la cronologia
In sessione	/exit o Ctrl+D due volte	Esce
In sessione	/login	Cambia account
In sessione	/usage	Barre di consumo del piano
In sessione	/	Mostra comandi e skill
Tastiera	Shift+Tab	Cambia modalità di permesso

Su Pro e Max il dollaro che vedi nel blocco Session di /usage è un calcolo a listino API. Non è la fattura. L’uso di Claude Code sta dentro l’abbonamento, con i limiti del piano. Se sfori, puoi aggiungere usage credit a pagamento.

Quanto costa Claude Code

Chi ha capito Claude Code come funziona chiede subito il prezzo. Sul piano Pro paghi l’abbonamento, non una fattura a token per ogni landing. Listino ufficiale, tasse escluse, «usage limits apply», prezzi soggetti a modifica. Conversioni in euro al riferimento BCE del 14 agosto 2026: 1 EUR = 1,1567 USD, arrotondate a due decimali.

Piano	Prezzo listino	In euro (14 ago 2026)	Claude Code
Free	0 USD	0 EUR	Non incluso
Pro mensile	20 USD/mese	17,29 EUR/mese	Incluso
Pro annuale	17 USD/mese (200 USD anticipati)	14,70 EUR/mese	Incluso
Max 5x	100 USD/mese	86,45 EUR/mese	Incluso
Max 20x	200 USD/mese	172,91 EUR/mese	Incluso
Team Standard	20 USD/postazione/mese se annuale, 25 se mensile	17,29 / 21,61 EUR	Incluso, più Claude Cowork
Team Premium (5x)	100 USD/postazione/mese se annuale, 125 se mensile	86,45 / 108,07 EUR	Incluso, più Claude Cowork
Enterprise self-serve	20 USD/postazione/mese più consumo API, fatturazione annuale	17,29 EUR più consumo	Incluso, con i controlli admin del Team

In pagina prodotto Anthropic descrive Pro come adatto a sprint brevi su codebase piccoli, Max 5x all’uso quotidiano su codebase più grandi, Max 20x a chi vuole il massimo accesso ai modelli.

I numeri «circa 13 USD per sviluppatore per giorno attivo» e «150-250 USD al mese» (sotto i 30 USD/giorno per il 90% degli utenti) li dichiara Anthropic sui rollout enterprise a consumo API. Non sono il costo di una landing. Non usarli per preventivare il sito vetrina di una PMI su Pro. Sistemi interni, portali e web app costruiti sul processo dell’azienda sono il lavoro descritto nella pagina di sviluppo software di TheDrobot.

Fonte prezzi: claude.com/pricing.

Claude Code vs Cursor: quale scegliere se non programmi

Cursor è un editor. Claude Code è un agente che vive nella cartella del progetto. Non sono lo stesso oggetto con due loghi.

Il piano Individual Pro di Cursor, consultato il 17 agosto 2026, costa 20 USD al mese. Il piano Teams costa 40 USD a utente al mese. Esiste un Hobby gratuito con Agent requests limitate. Prezzi al netto delle tasse.

Dentro Cursor puoi anche installare l’estensione ufficiale Claude Code. Utile se un giorno vorrai vedere i file. Non è il punto di partenza se non hai mai aperto un editor.

Se non hai mai visto il codice, parti da Claude Code: app desktop o CLI. Parli, approvi, controlli sul telefono. Se dopo due progetti ti manca il pannello con i file aperti, allora ha senso aggiungere Cursor. Non il contrario.

Errori tipici del principiante e come evitarli

Prompt vago. «Fammi un sito moderno» produce un sito di nessuno. Città, servizi, testi, numero WhatsApp, tono. Come brieferesti un grafico che non conosce l’azienda.

Dieci modifiche in un colpo. L’agente le mescola. Tu non sai più cosa hai approvato. Una richiesta, un controllo, la successiva.

Accettare la prima versione. La prima bozza è uno scheletro. I testi sono spesso inventati, i margini sul telefono stretti, il footer vuoto. Il lavoro vero è rifiutare. Hai lo snapshot: tornare indietro non è un disonore.

Paura di rompere il computer. In default non scrive senza il tuo sì. Lo snapshot è il tasto indietro. La cartella del progetto non è il disco di sistema. Se hai paura, lavora in una cartella nuova, non sopra il gestionale.

Installare con npm o con sudo. È il metodo che Anthropic non consiglia più. Per il non tecnico è anche il modo più facile di inciampare in Node, permessi e versioni. Resta sull’installer nativo o sull’app.

Confondere PowerShell e CMD. È l’errore Windows più frequente del primo giorno. Guarda se c’è PS nel prompt, poi incolla il comando giusto.

Il primo passo concreto è di stasera, non di «quando avrò tempo»: scarica l’app desktop oppure lancia l’installer nativo, crea una cartella con il nome dell’attività e scrivi un solo messaggio con città, servizi veri e numero WhatsApp.