Claude Code: 36 lezioni dopo 6 mesi di uso quotidiano

Perché questo video conta per chi costruisce

Avthar Sewrathan racconta sei mesi vissuti dentro Claude Code da power user, organizzando 36 tecniche in tre livelli: foundations, workflow intermedi, tecniche avanzate. Il punto di partenza è una confessione utile: per i primi mesi usava Claude Code come "ChatGPT con il tasto save", prompt vaghi e zero struttura. La svolta è arrivata trattandolo come uno strumento di engineering, non come un autocomplete potenziato. Per chi sta costruendo un MVP da solo o in team piccolo, le lezioni che seguono valgono settimane di tentativi a vuoto.

Foundations: il file Claude.md fa la differenza

L'installazione standard è sul laptop con un comando dal sito Anthropic, ma Avthar segnala anche due opzioni meno banali: installazione su server remoto (AWS, DigitalOcean, Hetzner) per progetti backend, e uso dentro IDE come VS Code, Cursor o Windsurf se non sei a tuo agio nel terminale. Da iOS si può controllare il tutto con Termius. Tra i comandi base, la to-do list automatica, il bash mode dentro la sessione, l'auto accept con shift+tab, lo switch modello con /model, l'escape per interrompere quando vedi che sta sbagliando direzione.

Ma il vero acceleratore è il file Claude.md. Pensalo come la memoria del progetto: viene aggiunto al contesto a ogni task. Dentro ci stanno le convenzioni git (creare branch, mai push diretto su main, commit regolari), l'overview architetturale, i comandi di build, le preferenze su test, debugging, analytics e documentazione. Una volta scritto, Claude Code segue queste regole in automatico. Pro tip di Avthar: non scriverlo a mano, chiedi a Claude stesso di generarlo e poi di aggiornarlo man mano che il progetto evolve. Stessa logica per il debugging: screenshot in input quando ci sono bug di UI, generazione automatica dei test (puntando a end-to-end, non a test specifici dell'implementazione), e test driven development chiedendo a Claude prima i test e poi l'implementazione.

Workflow intermedi: planning mode e mentalità da product manager

Il salto di qualità arriva con il planning mode. Premi tab+shift fino al "plan only mode" e Claude restituisce un piano scritto prima di toccare il codice. Avthar lo usa per decisioni architetturali e bug complessi. Combinato con l'opus plan mode, il modello più potente ragiona sul piano e Sonnet, più economico, esegue. I "think keyword" controllano quanto budget di ragionamento allocare: think, think hard, ultra think. Inseriti nel prompt, dicono al modello di fermarsi a riflettere prima di agire.

Claude Code non è solo per scrivere codice. Il web search e il web fetch lo rendono utile per ricerche tecniche (come usare l'API di Stripe) o report di scouting (qual è il miglior auth provider con componenti di login pronti). Legge anche PDF: Avthar gli passa report di Deep Research di ChatGPT come input alla fase di research interna. Stessa logica per generare PRD, guide di UX, documentazione API e decision doc, sfruttando il contesto reale del codebase invece di partire da zero come farebbe ChatGPT. L'integrazione con GitHub Actions (/install gh actions) chiude il cerchio: tagghi Claude Code in issue e pull request e lui lavora su GitHub senza passare dalla tua macchina, recensendo anche le PR in entrata.

La parte più difficile da accettare è la mentalità giusta. Avthar la formula così: pensa come un product manager. Significa due cose. La prima è dare a Claude tutto il contesto rilevante e i constraint giusti. La seconda, più scomoda per chi viene dall'engineering tradizionale, è lasciar andare la rilettura riga per riga. Verifichi a un livello di astrazione più alto: l'esperienza utente è quella che volevi, i test passano, l'app si comporta come previsto. Non devi capire ogni riga generata. È un cambio di postura simile al passaggio da ingegnere senior a manager di un team tecnico.

Tecniche avanzate: parallelismo, custom command, sub-agent, MCP

Il livello master si apre con il parallelismo. I sub-agent paralleli esplorano più soluzioni a uno stesso problema in parallelo, e tu (o Claude stesso) scegli la migliore: utile per architettura di feature complesse o bug ostici. Ma il vero unlock sono i git work tree. Crei una cartella .trees nel repo, lanci git worktree add per ogni feature da sviluppare, apri una sessione terminale per ogni work tree e dentro fai partire un'istanza separata di Claude Code. Risultato: più feature sviluppate in parallelo sullo stesso codebase senza conflitti, history git pulita, alla fine chiedi a Claude di fare il merge e risolvere i conflitti rimasti. Una settimana di lavoro in poche ore.

I custom slash command sono scorciatoie per i prompt che ripeti spesso. Crei una cartella commands/ dentro .claude/ nel working directory, aggiungi un file markdown con il nome del comando (es. changelog.md), specifichi descrizione, tool permessi (di solito bash, read, write) e il prompt vero e proprio. Possono essere project-specific o personal (validi per tutti i progetti). I sub-agent custom sono assistenti specializzati con prompt e permessi dedicati: UX design, API design, security review, esecuzione test, database administration. Si creano con /agents, una procedura guidata che genera il file markdown con tipo, descrizione d'uso, tool e system prompt. Una volta esistenti, Claude Code li delega in automatico ai task pertinenti, oppure li invochi tu nel prompt ("usa il database admin agent per validare queste query").

L'ultimo tassello è MCP, Model Context Protocol. Estende Claude Code verso tool esterni: i server MCP per database (MongoDB, Postgres, Supabase) per lavoro diretto sui dati, Playwright MCP per far "vedere" a Claude la UI dell'app durante test e debugging, Figma MCP per andare da design a codice. È un ecosistema in crescita, che vale la pena monitorare se stai costruendo prodotti dove Claude Code deve interagire con sistemi terzi.

Costi: quale piano ha senso per chi costruisce

Non c'è una versione gratuita. Il piano Pro a 20 dollari al mese serve per familiarizzare. Quando sei serio sul build, il Max 5x a 100 dollari o il Max 20x a 200 dollari diventano sostenibili: rate limit cinque o 20 volte superiori al Pro. Avthar usa il Max 20x e lo consiglia a chi vive nel tool. L'API Anthropic diretta resta opzione percorribile solo se l'azienda paga il consumo. Da fine agosto sono entrati in vigore rate limit settimanali aggiuntivi sul piano Max: vale la pena tenere d'occhio l'impatto reale, ma per ora il rapporto valore/prezzo regge.