Source: https://aiprimetech.io/it/claude-code/tutorial/ [Home](/it/) › [Claude Code](/it/claude-code/) › Tutorial [Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/) Ultimo aggiornamento: 11 ottobre 2026 # Tutorial di Claude Code: la tua prima sessione reale Questa è la sessione da svolgere una volta, con attenzione, per rendere rapide tutte quelle successive. Trenta minuti, un repository reale e acquisirai le abitudini che distinguono chi ama Claude Code da chi lo trova costoso e imprevedibile. ## TLDR - Inizia con /init — un buon CLAUDE.md è il file con il maggiore impatto nel repository. - Pianifica prima di modificare: chiedi un piano, approvalo, poi lascia che venga eseguito. - Mantieni le autorizzazioni restrittive, compatta spesso il contesto e usa il modello più economico in grado di svolgere il lavoro. ## 1. Apri il progetto e scrivi il file di memoria ``` cd your-project claude /init ``` /init esamina il repository e prepara una bozza di CLAUDE.md: come compilare, come eseguire i test, convenzioni e cosa non toccare. Modificala. Ogni sessione futura la leggerà per prima, ed è per questo che ripaga il tempo investito in un giorno: l'agente smette di riscoprire il progetto ogni volta. ## 2. Modalità piano (modalità pianificazione): chiedi un piano, non una modifica Claude Code include una modalità pianificazione: premi Shift+Tab per scorrere le modalità di autorizzazione finché non compare plan, oppure avvia con claude --permission-mode plan, e l'agente potrà leggere e ragionare, ma non modificare o eseguire nulla finché non tornerai alla modalità precedente. È il modo più sicuro per esplorare una codebase sconosciuta e quello più economico per avviare una modifica importante. ``` > Plan how to add rate limiting to the /api/upload route. Don't edit anything yet. ``` Leggi il piano. Correggilo con parole semplici. Poi: go ahead. Pianificare e poi eseguire produce modifiche migliori e sessioni più economiche rispetto a lasciare che l'agente esplori apportando modifiche. ## 3. Lascia che esegua i test Spiegagli come eseguire i test (oppure lascia che lo indichi CLAUDE.md) e chiedigli di eseguirli dopo la modifica. Il ciclo — modificare, testare, leggere l'errore, correggere — è il punto di forza dell'agente. Presta attenzione alle richieste di autorizzazione: ciascuna è un'occasione per delimitare ciò che può fare. ## 4. Autorizzazioni ``` /permissions ``` Consenti liberamente la lettura e la modifica, autorizza specifici comandi sicuri (Bash(npm test), Bash(git diff *)) e mantieni l'obbligo di conferma per qualsiasi operazione distruttiva. Negli script, imposta lo stesso insieme con --allowedTools. ## 5. Compatta il contesto quando cambia l'argomento ``` /compact focus on the rate limiter; drop the earlier exploration ``` Il contesto ha un costo. Ogni turno reinvia tutto ciò che è stato scambiato fino a quel momento. Compatta il contesto a ogni cambio di direzione e /clear tra attività non correlate: questa sola abitudine dimezza la spesa della maggior parte degli utenti. ## 6. Scegli il modello per ogni passaggio Usa il livello Sonnet come impostazione predefinita. Per quella singola decisione davvero difficile, /model a Opus, prendi la decisione e torna al modello precedente. La guida ai modelli descrive i livelli e come fissarne la scelta. ## 7. Crea un commit e revisiona ``` > Commit this as a single change with a message that explains the rate limit values. ``` Chiedigli di creare un commit, poi leggi personalmente il diff. L'agente è uno sviluppatore junior veloce e instancabile, con un'ottima memoria del tuo CLAUDE.md: sottoponi il suo lavoro alla stessa revisione che faresti per uno sviluppatore junior. ## Come proseguire - Competenze — insegnagli una volta le procedure del tuo team. - Sottoagenti (/agents) — suddividi le attività più grandi tra agenti specializzati. - Server MCP (/mcp) — dagli accesso al tuo database, al browser e al sistema di gestione dei ticket. - La GitHub Action — lo stesso ciclo su ogni pull request. - Prezzi — e come smettere di tenere d'occhio i consumi con un piano a tariffa fissa. ## Provalo prima gratuitamente I nuovi account ricevono $5 di credito API gratuito con il codice CLAUDECODE — abbastanza per una serata con Claude Code su Sonnet — poi crediti pari a 7.69231× il valore nominale. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crea un account con il codice CLAUDECODE](/register?promo=CLAUDECODE) ## Domande frequenti Che cos'è CLAUDE.md? Il file di memoria del progetto che Claude Code legge all'inizio di ogni sessione: comandi di compilazione e test, convenzioni e limiti. /init ne prepara una bozza; tu lo mantieni aggiornato.Che cos'è la modalità pianificazione in Claude Code? Chiedere un piano senza apportare modifiche, approvarlo e poi eseguirlo. Produce modifiche migliori e sessioni più brevi ed economiche rispetto alle modifiche esplorative.Come faccio a evitare che Claude Code chieda l'autorizzazione ogni volta? Usa /permissions per autorizzare in anticipo strumenti e comandi sicuri, oppure --allowedTools negli script. Mantieni l'obbligo di conferma per i comandi distruttivi. ## Esegui Claude Code sul gateway Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice CLAUDECODE.[Ottieni una chiave API](/register?promo=CLAUDECODE) [Scopri i piani illimitati](/it/plans/) AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway. ## Altre guide su Claude Code [Claude Code: la guida completa](/it/claude-code/)[Come installare Claude Code](/it/claude-code/install/)[Documentazione della CLI di Claude Code: comandi e flag](/it/claude-code/cli/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[L'SDK di Claude Code, ora Claude Agent SDK](/it/claude-code/sdk/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Errori di Claude Code e come risolverli](/it/claude-code/errors/)[Claude Code è open source?](/it/claude-code/open-source/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Subagenti di Claude Code: come funzionano, come definirli e team di agenti](/it/claude-code/subagents/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)