Claude Code Guide | Salvatore Scaramuzzi

01 L'Anatomia Perfetta di un Prompt

Analizzando sessioni reali, emerge una struttura definita per massimizzare l'efficacia ed evitare che l'IA parta alla cieca consumando token inutili. La struttura è divisa in macro-blocchi logici:

TASK

Dichiarazione immediata dell'obiettivo.

"Voglio [COMPITO] così che [CRITERI DI SUCCESSO]."

CONTEXT FILES

Prima di rispondere, elenca esplicitamente i file da leggere.

"Prima di rispondere, leggi completamente questi file: [nome_file.md] — [cosa contiene]."

REFERENCE

Fornisci un esempio di come vuoi il risultato finale, descrivendone le regole estratte (Reverse-Engineering).

"Usa questo come riferimento... Ecco le regole estratte (inizia ogni regola con 'Sempre' o 'Mai')."

SUCCESS BRIEF

Specifica output, lunghezza ed effetto desiderato. Cosa EVITARE (es. "Non deve sembrare IA generica").

RULES

Blocca l'esecuzione se sta per violare le linee guida.

"Se stai per violare una delle mie regole, fermati e dimmelo."

CONVERSATION & PLAN

Il vero segreto salva-token. Impedisce all'IA di scrivere codice errato a raffica.

"NON iniziare ancora l'esecuzione. Invece, fammi domande di chiarimento per perfezionare l'approccio passo dopo passo. Prima di scrivere, elenca le 3 regole del file di contesto che contano di più. Poi dammi il tuo piano di esecuzione (massimo 5 passaggi). Inizia a lavorare solo dopo che ci saremo allineati."

02 Guida all'utilizzo di `/loop`

Il comando /loop esegue prompt in modo ricorrente e automatizzato all'interno della sessione attiva, sfruttando i tool nativi dell'agente (CronCreate, CronList, CronDelete).

Sintassi ed Esempi Pratici

                # 1. Intervallo + Prompt fisso

                /loop 5m "controlla se il deploy è terminato e mostrami l'esito"

                # 2. Solo Prompt (Claude sceglie l'intervallo ottimale tra 1m e 1h)

                /loop "verifica se la CI passa e risolvi i commenti della review"

                # 3. Combinato con comandi o skill personalizzate

                /loop 20m /review-pr 1234

⚠️ Limiti e Vincoli:

Il loop vive finché il terminale è aperto. Usa tmux o screen per lasciarlo attivo in background.
Scadenza Automatica: Qualsiasi task ricorrente scade dopo 7 giorni per evitare sprechi infiniti di budget.
Puoi registrare un massimo di 50 task concorrenti per sessione.

03 Strategie d'Oro per Risparmiare Token

Claude Code ragiona come un agente: ogni interazione e strumento usato aggiunge contesto e consuma token. Ecco come ottimizzare la spesa.

1. Sfrutta l'Allineamento Preventivo

Imponendo a Claude di NON iniziare a eseguire, ma di fare domande e proporre un piano di max 5 passi, eviti che l'IA scriva centinaia di righe di codice errato. Correggere un piano di 5 righe costa pochissimi token; correggere un intero refactoring sbagliato distrugge il tuo budget.

2. Padroneggia i Comandi di Pulizia

Usa attivamente i comandi slash integrati per monitorare e tagliare il contesto accumulato:

/context Visualizza esattamente quanti token stai occupando al momento nel tuo context window.
/compact Fondamentale. Quando la chat supera l'80% di utilizzo, riassumi la cronologia mantenendo solo i dettagli cruciali.
/compact mantieni intatta la struttura del database
/clear Cancella completamente la cronologia. Usalo ogni volta che cambi task per evitare di ricaricare token inutili.
/cost Controlla le statistiche di utilizzo finanziario e i token spesi nella sessione corrente.

3. Struttura un file `CLAUDE.md` con `/init`

Esegui /init all'inizio del progetto per generare un file di memoria centralizzato (CLAUDE.md). Inserisci lì le convenzioni di stile e i comandi di build. In questo modo, eviti di dover reinviare a Claude le stesse istruzioni di formattazione o di ambiente in ogni singolo prompt.

💡 Tip DevOps: Nel mio progetto fremox.it, il file CLAUDE.md funge da "Source of Truth" per l'IA, contenendo il Design System, le regole di sicurezza (CSP) e lo stack tecnologico. Questo garantisce che ogni modifica al codice sia coerente al 100% con l'architettura esistente.

> claude.code.guide