Home › Claude Code › Tutorial
PanoramicaInstallazioneriferimento della CLIPrezzi e limitiAgent SDKSkill e pluginGitHubWeb, desktop e IDEModelliErroriÈ open source?TutorialPer studentiAutomazione QAConfronto con CursorConfronto con Codex e OpenCodeSubagentiHookMCPEcosistemaVS CodeOpenRouterLimiti di frequenzaGuida in cinese
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

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 Scopri i piani illimitati

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 completaCome installare Claude CodeDocumentazione della CLI di Claude Code: comandi e flagPrezzi e limiti di Claude Code, spiegatiL'SDK di Claude Code, ora Claude Agent SDKSkill e plugin di Claude CodeClaude Code in GitHub: App, Action e @claudeClaude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegateQuale modello usa Claude Code e come cambiarloErrori di Claude Code e come risolverliClaude Code è open source?Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore educationCome usare Claude Code per l'automazione QAClaude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambiClaude Code vs Codex vs OpenCode: confronto tra gli agenti da terminaleSubagenti di Claude Code: come funzionano, come definirli e team di agentiHook di Claude Code: controllo deterministico su ciò che fa l'agenteMCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concretiL'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgonoClaude Code in VS Code: l'estensione, l'uso dal terminale e gli erroriCome usare OpenRouter in Claude Code (e quando evitarlo)Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverloCome usare Claude Code: dall'installazione all'uso quotidiano