1.Come lo uso io
Il difetto che vedo più spesso in Claude Code è il codice in più. L'esempio classico: chiedi un campo per scegliere una data e arrivano una libreria nuova, un componente che la avvolge e un foglio di stili. Funziona, ma nessuno l'aveva chiesto.
Nel video mostro Ponytail, una repo gratuita su GitHub che fa fare all'agente qualche domanda prima di scrivere. La consiglio soprattutto a chi fa «vibe coding», cioè costruisce software descrivendolo all'AI senza saper programmare, e quel codice non lo sa rivedere. Qui lo installi, guardi cosa ti mette sul computer e misuri se sul tuo progetto cambia qualcosa.
2.Cosa ti serve
Claude Code
Installato e collegato al tuo account (Pro o Max). Come si fa è in fondo alla guida.
Node.js
Il plugin lo usa per i suoi piccoli programmi. Nel Terminale scrivi node --version: se non risponde, scaricalo da nodejs.org (versione LTS).
Un progetto vero
Una cartella dove hai già costruito qualcosa: in una vuota non c'è niente da riusare.
3.Come si consuma davvero
Claude Code misura il consumo in token, cioè pezzi di testo letti e scritti dal modello. A ogni richiesta rilegge la conversazione, i file che apre e i risultati dei comandi, poi scrive. Con un abbonamento Pro o Max la singola riga non la paghi: l'uso è compreso nel piano entro un limite di sessione e uno settimanale, e quando ne raggiungi uno Claude Code si ferma fino al ripristino. Con una chiave API paghi i token a consumo.
Il codice in più pesa due volte: viene scritto oggi e riletto ogni volta che una richiesta lo tocca. Ponytail è un prompt, cioè un testo di istruzioni, che entra in ogni sessione: dopo aver letto il codice coinvolto, l'agente sale una scala e si ferma al primo gradino che regge.
- 1
1 · DEVE ESISTERE?
se nessuno l'ha chiesto, non si scrive
- 2
2 · C'È GIÀ NEL PROGETTO?
si riusa
- 3
3 · LO FA IL LINGUAGGIO?
con le funzioni che ha già di suo (la libreria standard)
- 4
4 · LO FA LA PIATTAFORMA?
per esempio il campo data del browser
- 5
5 · C'È UNA LIBRERIA GIÀ INSTALLATA?
si usa quella
- 6
6 · SI FA IN UNA RIGA?
una riga
- 7
7 · SOLO ALLORA
il minimo che funziona
Controlli sui dati in ingresso, gestione degli errori, sicurezza e accessibilità restano fuori dai tagli.
I numeri del video li dichiarano gli autori: sessioni reali di Claude Code su un progetto open source, 12 richieste di funzioni nuove, modello Haiku 4.5, quattro prove ciascuna. Rispetto allo stesso agente senza Ponytail riportano circa il 54% di righe, il 22% di token, il 20% di costo e il 27% di tempo in meno. Il «100% safe» riguarda 20 prove su compiti di sicurezza e, precisano, non dimostra che il codice sia sicuro. Sul codice già essenziale misurano un effetto vicino a zero. Le righe si dimezzano e i token calano di circa un quinto, perché il modello consuma molto anche per leggere.
Qui comincia la parte pratica.
Dimmi chi sei e la guida si apre tutta: i passi, gli errori tipici e il file per la tua AI. Le risorse nuove te le mando per email; il telefono serve per sentirci a voce, se ha senso.
Gratis. Lo compili una volta: le altre guide restano aperte su questo dispositivo.
Cosa trovi dopo
- 4Passo 1 · Guarda cosa stai per installare
- 5Passo 2 · Installalo e controlla che sia attivo
- 6Passo 3 · Provalo prima e dopo
- 7Passo 4 · Aggiungi due o tre regole tue
- 8Passo 5 · Spegnilo quando non serve
- 9Se ti esce così
- 10Prima di usarlo davvero
- 11Ora tocca a te
- 12Il prossimo passo
Non leggerla soltanto: falla applicare.
Questa guida esiste anche come file Markdown, il formato che le AI leggono meglio. In testa ha già le istruzioni: lo dai a Claude Code (o lo alleghi a Claude, a ChatGPT) e l'AI la applica al tuo caso, chiedendoti i dati che le servono. Niente da riscrivere, niente da spiegare.
Cosa ottieni: Ponytail installato e controllato, due o tre regole «Prima di scrivere codice» nel tuo CLAUDE.md e una richiesta di prova con il conto delle righe toccate.
Gratis. Ti chiedo chi sei e come trovarti: le risorse nuove arrivano per email. Come si installa.
Installala nella tua AI
Il file che scarichi non è un riassunto: è la guida intera più le istruzioni per l'AI, scritte in testa. Tu lo consegni, lei lo legge, ti fa le domande e produce il risultato. Qui: Ponytail installato e controllato, due o tre regole «Prima di scrivere codice» nel tuo CLAUDE.md e una richiesta di prova con il conto delle righe toccate.
Con Claude Code
ConsigliatoClaude Code lavora dentro una cartella del tuo computer: legge il file, scrive i risultati lì e li ritrovi la prossima volta. Serve un account Claude con piano Pro o Max (non è nel piano gratuito).
- 1Installa Claude Code, una volta sola. Apri il Terminale (su Mac: cerca «Terminale» con Spotlight; su Windows: «PowerShell») e incolla il comando. Al primo avvio si apre il browser per entrare con il tuo account Claude.
ComandoMac curl -fsSL https://claude.ai/install.sh | bash
ComandoWindows (PowerShell) irm https://claude.ai/install.ps1 | iex
- 2Scarica il file dal riquadro «Per la tua AI» e mettilo in una cartella: quella del lavoro a cui vuoi applicarlo, o una nuova (per esempio
guide-ai). - 3Apri il Terminale in quella cartella. Il modo più semplice: scrivi
cd, uno spazio, trascina la cartella dentro la finestra del Terminale e premi Invio. - 4Avvia Claude Code scrivendo
claudee premendo Invio. Poi incolla il comando della guida e rispondi alle domande, una alla volta.Terminalecosì, per esempio $ claude > Leggi il file guida-ponytail-claude-code-meno-codice.md e segui le istruzioni scritte all'inizio. Ho letto la guida. Prima domanda, una alla volta: qual è la richiesta che rifai più spesso?
Su claude.ai, senza installare niente
Apri una chat nuova su claude.ai, allega il file con la graffetta e scrivi la frase qui sotto. Se usi i Progetti, aggiungi il file ai contenuti del progetto: resta a disposizione in ogni chat.
Leggi le istruzioni all'inizio del file allegato e seguile.Con ChatGPT o un'altra AI
Allega il file alla chat e scrivi la stessa frase. Le istruzioni sono pensate per Claude Code: dove parlano di cartelle e comandi, l'AI ti darà il testo da copiare al posto di scriverlo lei sul tuo computer.
Vale per qualunque assistente che legge i file allegati.
Continua con
Vuoi che un sistema così lo costruiamo insieme nella tua azienda? Prenota la call conoscitiva: 30 minuti, senza impegno.