--- title: "Tutorial Claude Code per principianti" description: "Impara a usare Claude Code da zero: installazione, prima sessione, il ciclo plan-edit-run-review, scrivere un CLAUDE.md e andare oltre." type: "guide" locale: "it" category: "Claude Code" canonical: "https://agenticschool.dev/it/guide/how-to-use-claude-code" datePublished: "2026-06-13" dateModified: "2026-06-13" --- # Tutorial Claude Code per principianti - Category: Claude Code - Keywords: how to use claude code, claude code tutorial, claude code beginner guide, claude code getting started, claude code commands - Canonical URL: https://agenticschool.dev/it/guide/how-to-use-claude-code - Locale: it > Impara a usare Claude Code da zero: installazione, prima sessione, il ciclo plan-edit-run-review, scrivere un CLAUDE.md e andare oltre. Claude Code e l'agente di coding IA di Anthropic basato su terminale: lanci un comando nel tuo progetto, descrivi in linguaggio naturale cosa vuoi, e l'agente legge i tuoi file, pianifica, modifica il codice, esegue comandi e verifica il proprio lavoro in un ciclo. Questo tutorial completo per principianti ti porta da "niente installato" a una prima sessione produttiva: come installare Claude Code, avviarlo, usare il workflow plan-edit-run-review che lo rende affidabile, scrivere il CLAUDE.md che gli insegna le tue regole, e dove andare dopo con subagent, hook, skill e MCP. Tutto qui e aggiornato a giugno 2026 e verificato contro la documentazione ufficiale. ## Cos'e Claude Code (e cosa non e) Claude Code e un agent harness: un software che mette un modello Claude in un ciclo con dei tool (leggere file, modificare file, eseguire comandi shell, cercare sul web) e il giudizio per usarli verso un obiettivo che tu fissi. Gira nel terminale, in VS Code e JetBrains, in un'app desktop e sul web. Non e solo autocomplete ne una finestra di chat che ti da snippet da incollare: lavora direttamente nel tuo repository, fa modifiche multi-file, esegue i tuoi test e itera finche il compito non e fatto. Mantieni il controllo verificando cosa propone e approvando le azioni importanti. - Vive dove vive il tuo codice: nel terminale, nel tuo editor o in una scheda del browser. - Agisce, non si limita a proporre: modifica file ed esegue comandi, poi legge i risultati. - Tu supervisioni: chiede il permesso per le azioni sensibili, e verifichi i suoi piani e i suoi diff. - Serve un account: Claude Pro, Max, Team, Enterprise o Console (a token). Il piano gratuito Claude.ai non include Claude Code. ## Installare Claude Code Il modo consigliato di installare Claude Code nel 2026 e l'installer nativo, che non ha dipendenza da Node.js e si aggiorna da solo in background. Esegui la riga unica per la tua piattaforma, poi conferma che ha funzionato. Se preferisci npm, il pacchetto funziona ancora e installa lo stesso binario, ma serve Node.js 18 o piu recente e non si aggiorna in modo altrettanto pulito. Non installare mai con sudo: una directory npm di proprieta di root causa errori di permessi a ogni installazione futura. ```bash # macOS, Linux, WSL (recommended native installer) curl -fsSL https://claude.ai/install.sh | bash # Windows PowerShell irm https://claude.ai/install.ps1 | iex # npm fallback (needs Node.js 18+, do NOT use sudo) npm install -g @anthropic-ai/claude-code # Confirm it installed claude --version ``` Installa Claude Code con l'installer nativo o via npm come fallback, poi verifica la versione. Se qualcosa sembra strano, esegui "claude doctor" per un bilancio di salute della tua installazione e configurazione. Su Windows nativo, Git for Windows e opzionale ma lascia Claude Code usare Git Bash per i comandi shell. ## La tua prima sessione Apri un terminale nel progetto su cui vuoi lavorare, ed esegui "claude". La prima volta ti guida nel login via browser. Una volta entrato, sei a un prompt interattivo: digita una richiesta in italiano o in inglese e premi Invio. Comincia in piccolo per costruire fiducia, per esempio "spiega cosa fa questo progetto" oppure "trova dove viene renderizzato l'hero della home page". Claude Code legge da solo i file pertinenti, quindi non devi incollare codice. Per terminare la sessione, digita /exit, e per riprendere piu tardi, esegui "claude -c" per continuare la tua ultima sessione in quella cartella. ```bash # Start Claude Code in the current project claude # Continue your most recent session in this folder claude -c # Resume a specific past session from a list claude --resume ``` Avviare, continuare e riprendere una sessione Claude Code. ## Il workflow centrale: plan, edit, run, review L'unica abitudine che rende Claude Code affidabile e: pianificare prima di lasciarlo modificare. Premi Shift+Tab per passare in modalita plan: Claude esplora la tua codebase e propone cosa intende fare senza cambiare un solo file, cosi puoi correggere la rotta a costo minimo prima che venga scritto codice. Approva il piano, lascialo fare le modifiche, lascialo eseguire i tuoi test o il dev server, poi verifica il diff prima di fare commit. Questo ciclo esplora-pianifica-implementa-commit tiene l'agente onesto e cattura una direzione sbagliata finche e ancora gratuita da correggere. - Plan: premi Shift+Tab per la modalita plan, cosi Claude propone i cambiamenti prima di modificare. Usalo per tutto cio che tocca piu file, lo schema o la sicurezza. - Edit: approva il piano e lascia che Claude faccia le modifiche multi-file. - Run: lascialo eseguire i tuoi test, il type-checker o il dev server, cosi vede veri risultati, non supposizioni. - Review: leggi il diff e fai commit. Sei il quality gate prima che il codice diventi permanente. ## CLAUDE.md: insegnare le tue regole all'agente CLAUDE.md e un semplice file Markdown alla radice del tuo repo che Claude Code legge automaticamente all'inizio di ogni sessione e tratta come istruzioni permanenti. E il miglioramento piu potente che puoi fare: scrivi il tuo stack, le tue convenzioni, il tuo quality gate e il tuo tono una sola volta, e l'agente smette di rideciderli a ogni compito. Genera un file di partenza con /init, che scansiona il tuo progetto e redige un CLAUDE.md, poi riducilo alle regole che correggi davvero di continuo. Tienilo corto, perche viene ricaricato a ogni turno e consuma lo stesso context window di cui il tuo compito ha bisogno. ```markdown # Project Rules ## Stack - TypeScript only. Package manager is bun, never npm. ## Conventions - Use rounded-sm for border-radius. Never use em dashes; use "-". ## Quality - Before saying a task is done, run: bun run lint && bun run typecheck && bun run test. ## Tone - Direct and concise. No filler. ``` Un CLAUDE.md compatto da adattare. Esegui /init per generare un punto di partenza. ## Andare oltre: le quattro skill che ti rendono un power-user Una volta acquisite le basi, quattro funzionalita trasformano Claude Code da assistente utile a compagno di squadra affidabile. Ognuna ha la sua guida approfondita in questo cluster. I subagent ti lasciano delegare il lavoro accessorio rumoroso a un contesto fresco, cosi la tua sessione principale resta pulita. Gli hook fanno girare i tuoi quality gate automaticamente, cosi nessuna modifica rotta passa. Le skill e gli slash command impacchettano i tuoi migliori workflow in trigger di una parola. E l'MCP connette l'agente ai tuoi database, browser e servizi. Leggili in qualsiasi ordine; insieme fanno la differenza tra usare Claude Code e padroneggiare Claude Code. - Subagent: delega ricerca, review o test a un agente specializzato nella propria context window. Vedi la guida Claude Code Subagents. - Hook: scatena comandi shell automaticamente sugli eventi del ciclo di vita per imporre formattazione, test e sicurezza. Vedi la guida Claude Code Hooks. - Skill e slash command: fissa un workflow ripetuto in un /command o skill riutilizzabile. Vedi la guida Skills e Commands. - MCP: connetti tool e dati esterni tramite un protocollo standard. Vedi la guida di setup MCP. ## Steps ### 1. Installare Claude Code Esegui l'installer nativo per la tua piattaforma (curl su macOS/Linux/WSL, irm in Windows PowerShell) oppure usa npm con Node.js 18+. Conferma con "claude --version". ### 2. Avviare la tua prima sessione Apri un terminale nel tuo progetto, esegui "claude" e accedi via browser quando richiesto. Comincia con una richiesta a basso rischio come "spiega cosa fa questo progetto". ### 3. Pianificare prima di modificare Premi Shift+Tab per passare in modalita plan. Lascia che Claude proponga il suo approccio senza toccare i file, e correggilo a costo minimo prima che venga scritto codice. ### 4. Implementare ed eseguire Approva il piano, lascia che Claude faccia le modifiche, e lascialo eseguire i tuoi test o il dev server, cosi parte da veri risultati piuttosto che da supposizioni. ### 5. Verificare e fare commit Leggi il diff, correggi cio che non va, e fai commit. Sei il quality gate che decide cosa diventa permanente. ### 6. Aggiungere un CLAUDE.md Esegui /init per generare un CLAUDE.md di partenza, poi riducilo al tuo stack, alle tue convenzioni e al tuo comando di quality gate, cosi l'agente segue le tue regole a ogni sessione. ## FAQ ### Come installo Claude Code? Usa l'installer nativo: esegui "curl -fsSL https://claude.ai/install.sh | bash" su macOS, Linux o WSL, oppure "irm https://claude.ai/install.ps1 | iex" in Windows PowerShell. Un'installazione npm ("npm install -g @anthropic-ai/claude-code") funziona ancora e richiede Node.js 18 o piu recente. Conferma con "claude --version". ### Claude Code e gratuito? No. Claude Code richiede un piano a pagamento Claude Pro, Max, Team o Enterprise, oppure un account Anthropic Console fatturato a token ai prezzi dell'API. Il piano gratuito Claude.ai non include l'accesso a Claude Code. ### Come comincio a usare Claude Code dopo l'installazione? Apri un terminale nel tuo progetto ed esegui "claude". Accedi via browser quando richiesto, poi digita una richiesta in linguaggio naturale. Comincia con un piccolo compito a basso rischio per costruire fiducia, e usa la modalita plan (Shift+Tab) prima di lasciarlo modificare qualcosa di piu grande. ### Cos'e il file CLAUDE.md? CLAUDE.md e un file Markdown alla radice del tuo repository che Claude Code legge automaticamente a ogni sessione e tratta come regole permanenti. Contiene il tuo stack, le tue convenzioni, il tuo quality gate e il tuo tono. Genera un file di partenza con /init e tienilo corto, perche viene ricaricato a ogni turno. ### Serve saper programmare per usare Claude Code? Aiuta, ma non e necessario per iniziare. Claude Code puo costruire e spiegare software funzionante a partire da richieste in linguaggio naturale. Una certa comprensione del codice ti aiuta a verificare i suoi cambiamenti, individuare errori e decidere cosa e sicuro da rilasciare, quindi ripaga in fretta. ### In cosa Claude Code differisce da Cursor o Copilot? Claude Code e un agente basato su terminale che pilota tutto il tuo repo ed esegue comandi. Cursor e una AI IDE dove verifichi i cambiamenti visivamente, e Copilot e cominciato come autocomplete nell'editor. Sono tutti tool di coding IA, ma differiscono per interfaccia e grado di autonomia del workflow. Vedi il nostro confronto Claude Code vs Codex CLI per un'analisi di agenti terminale affini.