In 30 minuti puoi avere Claude Code installato, un CLI tool funzionante, test automatici, e una versione refactored. Tutorial pratico in italiano, niente fluff, ogni step misurato a cronometro su MacBook M2 e Windows 11.

Cos'è Claude Code

Claude Code
CLI agentic ufficiale di Anthropic. Esegue task multi-step nel filesystem locale con permessi controllati.
Agentic
Capace di pianificare, eseguire, verificare in autonomia (con supervisione).
MCP (Model Context Protocol)
Standard per estendere agent con tool esterni.

Pre-requisiti

Per completare questo tutorial in 30 minuti servono Node.js 20+, un account Anthropic API con free credits e un terminale — nessuna altra dipendenza.

  • Node.js 20+
  • Account Anthropic API (free credits per nuovi account)
  • Terminale (bash/zsh/PowerShell)
  • 30 minuti senza interruzioni

Step 1 — Setup (5 min)

npm install -g @anthropic-ai/claude-code
export ANTHROPIC_API_KEY="sk-ant-..."
claude --version

Verifica installazione: claude --help.

Step 2 — Primo comando (3 min)

mkdir hello-claude && cd hello-claude
claude "crea un file index.mjs che stampa 'Ciao mondo' in italiano"

Aspettativa: file creato, codice corretto, esecuzione node index.mjs → "Ciao mondo".

Step 3 — Crea un CLI tool (10 min)

claude "crea CLI Node che legge un CSV da stdin, filtra righe per colonna=valore, output JSON. Usa solo standard library, no dipendenze. Aggiungi --help."

Test:

echo "name,agenAlice,30nBob,25" | node cli.mjs --filter age=30

Step 4 — Test automatici (5 min)

claude "aggiungi test Vitest per il CLI. Coverage almeno 80%. Mock stdin con stream-buffer."

Esegui: npm test.

Step 5 — Refactor con AI (7 min)

claude "refactor cli.mjs separando: parser CLI args, logica filter, output formatter. Mantieni test passing."

Risultato: 3 moduli, codice modulare, test ancora green.

Best practice di prompt

Prompt efficaci per Claude Code sono specifici, definiscono vincoli espliciti e includono un criterio verificabile di completamento — iterazioni piccole battono sempre il mega-prompt.

  1. Specifico > generico: "filter CSV" peggio di "filter CSV by column=value"
  2. Vincoli espliciti: "no dipendenze esterne", "max 100 righe"
  3. Definisci done: criterio verificabile (test passing, output match)
  4. Iterazioni piccole: meglio 5 prompt corretti che 1 mega-prompt

Errori comuni

Saltare i test, usare mega-prompt e non fare commit tra uno step e l’altro sono i tre errori che trasformano Claude Code da leva produttiva a fonte di debug infinito.

  1. Skip test step — senza test ti perdi nel debug
  2. Mega-prompt — l'AI hallucinates su task troppo complessi
  3. Non specificare versione: "Node 20+" risparmia bug
  4. Skippare permessi: leggi il "permesso" che Claude chiede prima di approvare
  5. Niente git commit tra step — perdi rollback safety

FAQ

Quanto costa per principianti? Free credit Anthropic copre primi progetti. Heavy use ~20-50$/mese. Dal 2024 lo fondo con l’AI: principi di negoziazione efficace nel dialogo con l'AI.

Funziona con Windows? Sì, PowerShell o WSL2.

Posso usarlo su codebase aziendali? Sì, ma valuta privacy enterprise tier.

Differenza con Cursor? Claude Code è CLI agentic. Cursor è IDE forked di VS Code. Si possono combinare.

Quale modello usa di default? Claude Opus 4.7 (long context). Configurable.

llms.txt

# Smart Vibe Coding — Tutorial Claude Code IT
URL: https://smartvibecoding.it/tutorial-claude-code-italiano/
Time: 30 minuti
Steps: setup, primo comando, CLI tool, test, refactor
Stack: Node 20+, Claude Code CLI, Vitest
Last verified: 2026-05-07