Il metodo: hook, skill, quality gate e agentic engineering applicati al codice vero.
**Claude Code** è un agente di coding che vive nel *terminale*: legge il progetto, modifica i file ed esegue comandi da solo. In questa guida metto in fila tutto quello che serve per passarci da ==curioso a produttivo== — installazione, il file di regole, i permessi, gli strumenti esterni, gli hook, i subagent e il conto dei token — e da ogni capitolo indico dove ho già scritto il tutorial di dettaglio.
Il **TDD** è il guinzaglio perfetto per un agente di coding: il test scritto *prima* definisce il comportamento, l'agente scrive ==solo il codice che lo fa passare==. In questo tutorial costruisco una **Minimal API .NET** con *Claude Code* in puro red-green-refactor, e monto due guardrail: uno **Stop hook** che rilancia dotnet test quando l'agente prova a dirsi "fatto" e un **subagent** che controlla che i test non vengano indeboliti.
Il ciclo di review che uso in locale con *Claude Code* — diff, critica, correzione — può girare da solo in CI. Con **claude-code-action** ogni pull request compatibile con i trigger e la policy sui fork riceve una ==review automatica==, mentre con un @claude nei commenti un collaboratore autorizzato può chiedere all'agente di rispondere o implementare una modifica. Parto dalla modalità **non interattiva** (claude -p), porto il prompt in GitHub Actions e imposto guardrail distinti per ==tool, turni, budget e permessi==.
Un **PreToolUse hook** di *Claude Code* è la barriera più semplice ed efficace per impedire all'agente di aprire, leggere o modificare file sensibili — .env, chiavi, credenziali, cartelle segrete. Racconto come lo configuro: un piccolo script che legge il JSON su stdin, controlla il path del tool Read/Edit/Write e ==esce con codice 2== per bloccare la chiamata prima che parta, restituendo un messaggio che Claude legge e capisce. Poche righe di bash, una voce in settings.json, e la tua repo è ==al riparo== anche dagli agenti più intraprendenti.
Una **skill** è una cartella con un file SKILL.md: istruzioni che *Claude Code* carica solo quando servono, non a ogni turno come CLAUDE.md. In questa guida ne costruisco una reale — changelog-entry, che genera una voce di changelog dai commit dall'ultimo tag — passando per ==contesto dinamico==, argomenti, tool pre-approvati, file di supporto e il test con skill-creator, fino alla scelta tra skill personale, di progetto o plugin.
Gli **hook** trasformano *Claude Code* da assistente persuadibile a sistema con garanzie: sono comandi shell che scattano a punti precisi del ciclo di vita e possono ==bloccare un'azione o correggerla in automatico==. In questa guida costruisco quattro *quality gate* reali — format e lint su PostToolUse, blocco dei comandi pericolosi su PreToolUse, test verdi obbligatori su Stop, contesto di progetto su SessionStart — con eventi, matcher, exit code e output JSON.
Il 1° giugno 2026 è entrato in vigore il **billing a consumo di GitHub Copilot** e Andrej Karpathy ha ufficialmente dichiarato il *vibe coding* un capitolo chiuso, sostituito dall'**agentic engineering**. ==Per le PMI italiane non è una sfumatura semantica==: cambia il modello di costo, cambia la governance, cambia chi può davvero portare l'AI in produzione. Vedo cosa fare nelle prossime 8 settimane.
Il **vibe coding** è la pratica di delegare parte della scrittura di codice a un *assistente AI conversazionale*, mantenendo lo ==sviluppatore in cabina di regia==. Non è hype: è un **cambio di processo** che richiede strumenti, policy e metriche. Vedo come introdurlo in modo serio.