Perché il tuo flusso di lavoro non è cambiato nonostante usi Claude Code ogni giorno
"Ricordo di aver eseguito /init. Ma non ho idea di quando l'ho aggiornato l'ultima volta."
Ti suona familiare? Hai installato Claude Code, passato i primi giorni a configurarlo e ci chatti ogni giorno. Eppure, rispetto a tre mesi fa, la struttura del tuo lavoro è rimasta sostanzialmente invariata.
Questo non è un problema di utilizzo; è un problema di posizionamento.
Se continui a usare Claude Code come un "strumento che risponde quando interpellato", finirai per digitare le stesse istruzioni ogni mattina, ottenere risposte simili e copiarle nel tuo lavoro. Potresti essere più efficiente, ma il modo in cui il tuo lavoro procede non è cambiato radicalmente.
Il cambiamento avviene quando inizi a trattare Claude Code come un "obiettivo di progettazione". Chi sa cosa in quale contesto? Quali compiti vengono delegati a chi? Cosa si muove anche quando nessun umano è presente? Quando inizi a pensare a questo come a un progetto, Claude Code inizia a comportarsi in modo completamente diverso.
Le 27 funzionalità pubblicate da @sairahul1 (https://x.com/sairahul1/status/2070428662080618607) elencano sistematicamente le funzioni che dovrebbero essere utilizzate da questa prospettiva di progettazione. Swarm le ha interpretate attraverso la lente del design degli agenti e le ha organizzate in un formato applicabile a contesti aziendali reali.
Ventisette potrebbero sembrare tante, ma ci sono solo tre principi fondamentali. Spiegheremo questa struttura in ordine a partire dal prossimo capitolo.
Le tre discipline che collegano le 27 funzionalità
Osservando le 27 funzionalità, potrebbero sembrare sparse. Ci sono scorciatoie, impostazioni dei file, input vocale ed esecuzione di test. Tuttavia, una volta decodificate, possono essere organizzate in gruppi che rispondono a tre domande.
Disciplina 1: Progettazione del contesto (Funzionalità 1–5)
Creare uno stato in cui Claude sappia "di chi è il progetto, per quale scopo e quanto ne capisce attualmente". Se questo si rompe, devi spiegare tutto da capo ogni volta.
Disciplina 2: Progettazione della delega (Funzionalità 6–14)
Affidare strutturalmente compiti e autorità a Claude. Invece di dire "correggi il bug", organizzi e consegni "cosa è rotto e quali sono i vincoli", il che cambia la probabilità di una risoluzione al primo tentativo.
Disciplina 3: Progettazione dell'autonomia (Funzionalità 15–27)
Progettare un meccanismo in cui Claude possa continuare a muoversi senza costanti istruzioni umane.
Queste tre fasi sono anche l'ordine in cui dovresti usarle. Se il contesto non è impostato, la delega diventa approssimativa. Se la delega non è progettata, l'autonomia sfugge di mano.
Ciò di cui devi essere consapevole qui è come cambiare la struttura di "io che istruisco Claude ogni mattina". Se lanci gli stessi compiti nella chat ogni mattina, l'umano è ancora il soggetto. Quando il design passa a una struttura che muove Claude, ciò che fai la mattina cambia.
Per prima cosa, diamo un'occhiata alle cinque funzionalità della Progettazione del contesto.
Fondamenti della progettazione del contesto
L'obiettivo della progettazione del contesto è fornire a Claude il "contesto di questo progetto". Senza contesto, ogni conversazione parte da zero.
La prima cosa da eseguire è `/init`.
Quando apri un progetto per la prima volta, esegui questo comando per primo. Claude analizza la struttura del codebase, le dipendenze e i comandi di build per generare automaticamente CLAUDE.md. Questo file diventa il "progetto" del progetto.
Qui è dove molti si fermano. Ricordano di aver eseguito /init, ma non sanno quando è stato aggiornato l'ultima volta. Se lasciato come generato, il contenuto di CLAUDE.md si allontanerà dalla realtà man mano che il progetto cambia. Operando con la premessa di aggiornamenti settimanali, Claude può sempre muoversi nel contesto più recente.
Successivamente, è utile impostare `/statusline`.
Una barra di stato apparirà nella parte inferiore dello schermo. Puoi visualizzare cosa è in esecuzione e quali processi sono attivi. Può anche essere integrata con barre di stato personalizzate in Vim o Neovim, permettendoti di configurarla in base al tuo ambiente editor esistente.
Il terzo è l'input vocale.
Puoi trasmettere requisiti complessi parlando usando ⌃⌘Space su Mac o l'input vocale nativo su iOS e Android. Puoi passare lunghe istruzioni come "Voglio che questo componente si muova in questo modo per questo motivo, ma non cambiare gli stili esistenti" senza digitare. Poiché puoi trasmettere i pensieri mentre fluiscono, risparmi tempo speso a organizzare mentre scrivi.
Usa `/context` per controllare lo stato del contesto.
Puoi vedere cosa c'è attualmente nella conversazione e l'utilizzo della finestra di contesto in tempo reale. Nelle sessioni lunghe, il contenuto del progetto iniziale tende a sbiadire. Questo comando ti permette di monitorarlo.
Le operazioni di reset per questo sono `/compact` e `/clear`.
/compact comprime l'intero contesto in un riepilogo. /clear è un reset completo. Se continui una sessione lunga, le risposte di Claude potrebbero diventare vaghe. Questo è un segno che il contesto è intasato. Usando periodicamente /compact, puoi mantenere la qualità dell'output.
Prima: Nella seconda metà di una sessione lunga, Claude dà una risposta non allineata anche quando dice "seguendo la politica di progettazione discussa in precedenza".
Dopo: Comprimere con /compact prima di continuare mantiene l'output accurato rispetto alla politica.
Le cinque funzionalità fanno una cosa: mantenere lo stato di Claude che "sa" come progetto. Questo diventa la base per il passo successivo, la Progettazione della delega.
L'arte di passare i problemi
Una volta impostato il contesto, il passo successivo è come passare il problema. L'accuratezza della risposta cambia completamente a seconda che tu dica "correggi il bug" o lo passi in modo strutturato.
Per prima cosa, usa la modalità piano (`Shift+Tab`).
Prima di modifiche importanti, questa modalità restituisce "solo il piano" invece di eseguire. Puoi controllare cosa Claude intende cambiare e in quale ordine in anticipo.
Invece di correggere gli errori dopo che si sono verificati, puoi segnalare "è sbagliato" in fase di pianificazione. Incorporare questo passaggio nel tuo design cambia significativamente la frequenza delle modifiche impreviste. Mentre continui a usarlo, ti renderai conto che riduce lo sforzo di controllare "perché questo file è stato riscritto?" dopo il fatto.
Il secondo è la strutturazione di problemi, vincoli e contesto.
Se dici solo "correggi il bug", Claude cerca di riempire le ipotesi da solo. Se quelle ipotesi sono sbagliate, la soluzione sarà sbagliata.
Il formato ufficialmente raccomandato è scrivere "cosa è rotto" sulla prima riga e "cosa è stato provato, vincoli e formato di output previsto" dalla seconda riga in poi. Solo passarlo in questo formato cambia il tasso di risoluzioni al primo tentativo. Il modo in cui passi il problema diventa esso stesso un'abilità.
Il terzo è `AskUserQuestion`.
Questa è una funzionalità in cui Claude chiede chiarimenti prima di procedere quando incontra requisiti ambigui. Il lavoro aggiuntivo causato dall'implementazione che procede con requisiti vaghi spesso accade quando questa funzionalità non viene utilizzata. È un progetto che paga il costo della conferma prima dell'implementazione.
Il quarto è il passo di auto-verifica.
Alla fine di un'attività, dì a Claude di "eseguire i test e confermare che la build passi prima di finire". Invece di aggiungere questo manualmente ogni volta, scriverlo in CLAUDE.md garantisce che venga eseguito automaticamente alla fine di ogni attività. Invece di Claude che si ferma in uno stato in cui le cose non funzionano dopo una modifica, il ciclo che include la verifica viene completato come un'unica attività.
Adottare misure proattive con la modalità piano e automatizzare i passaggi reattivi con l'auto-verifica. La struttura del flusso di sviluppo cambia nel momento in cui questi due vengono incorporati nel design.
Nel prossimo capitolo, esamineremo la progettazione della delega di attività continue a Claude.
Progettare la delega
Nei capitoli precedenti, abbiamo organizzato come comunicare con Claude e come fargli mantenere la memoria. Il prossimo passo è cambiare "chi diventa il soggetto".
10. Sottoagenti
Se un umano gestisce le procedure durante attività lunghe, inevitabilmente si blocca. Dire costantemente "fai questo dopo, poi fai quello quando hai finito" significa che l'umano, non Claude, sta gestendo il coordinamento.
Usando gli strumenti TodoWrite o Task, Claude scompone le attività in sottoattività e le esegue in parallelo. In termini ufficiali, questa è "esecuzione simultanea di sottoagenti" — una struttura in cui più Claude figli si muovono contemporaneamente. Diversi Claude eseguono ricerca, implementazione e test allo stesso tempo. Gli umani non hanno bisogno di tenere la procedura.
11. Competenze personalizzate (file modello del flusso di lavoro)
Posizionando file Markdown nella directory .claude/commands/, puoi chiamare set di istruzioni con /nome-comando. Nel contesto di Swarm, è più facile pensarli come "SKILL.md (file modello del flusso di lavoro)".
Prima: Scrivere "Per favore, conduci un'indagine sulla concorrenza. I passaggi sono 1, 2, 3..." ogni volta.
Dopo: Basta digitare /competitive-research in una riga.
Il tempo speso a scrivere le stesse istruzioni ripetutamente scompare. Se condiviso con un team, diventa un modello in cui chiunque può ottenere la stessa qualità di output.
12. Selezione del modello
Puoi cambiare modello all'interno di una sessione premendo Alt+P. Un utilizzo realistico in tre fasi è: modelli di alto ragionamento per le fasi di progettazione e concettuali, modelli leggeri per l'implementazione semplice e modelli di fascia media per il debug.
Abbinare la potenza del modello al peso del processo migliora sia l'efficienza dei costi che la velocità di risposta contemporaneamente.
13. Aggiornamenti automatici di CLAUDE.md
Se dici a Claude di "aggiungere ciò che hai imparato in questo progetto a CLAUDE.md", Claude aggiornerà CLAUDE.md da solo. È una struttura in cui il progetto cresce da solo.
Aggiungendo questo comando una volta a settimana, CLAUDE.md diventa un "documento vivente". Anche se gli umani non scrivono riflessioni, Claude accumula ciò che ha imparato.
14. Collegamento a file esterni
Puoi passare file, URL o Issue come contesto usando @{percorso_file}. È un meccanismo per completare "leggi questo file prima di lavorare" in una riga.
Prima: Copiare e incollare i contenuti del file nel prompt.
Dopo: Basta scrivere "Controlla le impostazioni facendo riferimento a @src/config.yaml."
Progettare la delega significa creare un sistema che passa il soggetto a Claude. Quando procedure, modelli, riferimenti e memoria sono tutti a posto, gli umani devono solo pensare a "cosa creare".
Tuttavia, all'aumentare della delega, aumenta anche il rischio che "Claude si muova in una direzione diversa dall'intento". Nel prossimo capitolo, vedremo come fermare presto quella deriva.
Fermare la deriva presto
Man mano che la delega a Claude aumenta, un problema diventa più probabile: rendersi conto che è andato in una direzione completamente diversa da quella prevista. Chiamiamo questo deriva.
La deriva non è qualcosa da sistemare dopo; può essere prevenuta adottando misure di progettazione proattive.
15. Arresto immediato
Se senti che l'output sta andando in una direzione ovviamente sbagliata, puoi fermarlo immediatamente con il tasto Escape. "Lo sistemerò dopo che è finito" è un errore. Più la generazione procede, più alto è il costo di correzione. Fermarsi a metà e correggere il prompt fa risparmiare tempo e token.
Se pensi intuitivamente che qualcosa non va, fermalo senza esitazione. La velocità di questo giudizio ha un impatto diretto sull'accuratezza.
16. Richiedere il primo output come prova
Un design proattivo è dire "mostrami solo il primo output prima, e deciderò se continuare" prima di iniziare il lavoro.
Invece di lasciarlo passare 10 minuti nella direzione sbagliata, conferma con il primo output prima di lasciarlo eseguire. Questa è l'idea di stroncare la deriva sul nascere. È essenziale per attività di lunga durata o lavoro che inizia con direzioni ambigue.
Prima di dire "lascio il resto a te", inserisci "fammi controllare l'inizio". È solo un passo, ma questa mossa proattiva cambia il risultato.
17. Hook di notifica
Fissare lo schermo in attesa che un'attività lunga finisca è una perdita di tempo. Posizionando uno script in ~/.claude/hooks/, puoi ricevere notifiche desktop quando un'attività è completata.
Impostalo una volta. Da allora in poi, anche se stai facendo altro lavoro, Claude ti avviserà quando ha finito. È un design che elimina l'atto di aspettare.
18. Passaggio di screenshot
Spiegare i bug dell'interfaccia utente a parole è sorprendentemente difficile. Invece di dire verbalmente "è apparso un errore rosso in alto a sinistra e il pulsante non può essere premuto", passare uno screenshot è più veloce.
Claude riceve l'immagine e restituisce il contenuto dell'errore, la causa e i suggerimenti per la correzione così come sono. Si completa con "guarda questo schermo".
Le 18 funzionalità introdotte finora si basano tutte sulla premessa di una singola persona che opera. Nel prossimo capitolo, entriamo nella struttura di "utilizzo come team", dove più Claude vengono eseguiti in parallelo e integrati.
Operazione parallela e integrazione
Mentre usi Claude Code come strumento di chat, non puoi iniziare l'attività successiva finché una non è finita. Ma cambiando il design, puoi creare una struttura in cui più Claude si muovono simultaneamente.
Inizia con l'integrazione di Chrome DevTools. Poiché puoi passare i log degli errori del browser e i log di rete direttamente a Claude Code, non hai più bisogno di spiegare verbalmente situazioni come "c'è un errore rosso nella console ma non so cosa stia succedendo". La documentazione ufficiale ha una pagina dedicata per questo, posizionandola come gateway per il debug.
Anche la gestione delle sessioni cambia. Puoi riprendere l'ultima sessione così com'è con claude --continue, o scegliere da un elenco di sessioni con claude --resume. Inoltre, nominando le sessioni con /rename, puoi gestire più attività in parallelo con la stessa sensazione dei rami Git. Usando sessioni denominate "Auth", "Payment" e "Dashboard", il costo del cambio di contesto diventa quasi zero.
E il cuore dell'operazione parallela è la combinazione con git worktrees. Digitare claude --worktree feature-auth avvia una sessione in cui il ramo è completamente isolato dal worktree. Se esegui Auth, Payment e Dashboard in worktree separati, tre Claude procederanno con lo sviluppo in parallelo. Poiché ciascuno è in uno spazio di lavoro indipendente, non si verificano conflitti. La struttura per finire una settimana di sviluppo in un giorno è stabilita qui come design.
È anche necessario organizzare i pensieri su MCP. Un server MCP non è sempre la soluzione ottimale. La documentazione ufficiale afferma che "gli strumenti CLI sono il modo più efficiente in termini di contesto per interagire con i servizi esterni", e si dice che strumenti CLI come gh o aws abbiano un'elevata efficienza di contesto e siano meno soggetti a limiti di velocità. Con solo il comando gh, Claude Code può creare, aggiornare e chiudere autonomamente le Issue di GitHub. Avere un asse di giudizio per verificare se uno strumento CLI può essere utilizzato prima di aggiungere un MCP mantiene il design semplice.
Quando il design parallelo è possibile, gli umani non hanno più bisogno di gestire la sequenza. Questo perché il design passa a passare più soggetti a Claude simultaneamente. Successivamente, evolveremo questa elaborazione parallela progettata in un sistema che continua a muoversi anche quando sei lontano dalla scrivania.
Operazione autonoma
La domanda successiva dopo il design parallelo è: "Dove devo essere durante quel periodo?" Quando l'operazione autonoma è progettata, viene creato uno stato in cui il lavoro procede anche senza un umano presente.
/loop è una funzionalità che esegue il polling automatico all'interno di una sessione. La spiegazione ufficiale è "Polling rapido mentre una sessione è aperta", e ripete le operazioni specificate mentre la sessione è aperta. Usando --resume o --continue ti permette di riprendere sessioni che non sono scadute, e secondo i rapporti di esperienza nell'articolo originale, sono stati segnalati casi di funzionamento senza equipaggio fino a tre giorni. Anche se non abbiamo confermato quel numero di giorni direttamente con fonti ufficiali, funziona certamente come punto di ingresso per l'operazione autonoma di lunga durata.
Il Controllo Remoto, aggiunto nel Q1 2026, è una funzionalità per operare sessioni Claude Code in esecuzione localmente da uno smartphone o dal browser di un PC. Mentre il codice rimane locale, solo i messaggi vengono scambiati attraverso un canale crittografato. È stato rilasciato come anteprima di ricerca nel febbraio 2026. Viene stabilito uno scenario in cui il Claude Code locale continua a muoversi semplicemente inviando "controlla se i test sono passati" da uno smartphone mentre sei fuori.
Anche le query in linguaggio naturale ai database possono essere incorporate nel design. Connettendoti a SQLite, PostgreSQL o MySQL tramite MCP, puoi recuperare dati usando l'italiano (o l'inglese) come "dimmi gli utenti registrati la settimana scorsa". La guida ufficiale suggerisce di eseguire claude mcp add per connettere strumenti esterni come il tuo database, permettendoti di delegare le routine di conferma dei dati a Claude senza scrivere SQL.
Ci sono anche quattro funzionalità per controllare la profondità del pensiero. ultrathink attiva il pensiero esteso fino a 31.999 token semplicemente includendo quella parola chiave nel prompt. C'è una gerarchia: think è 4.000 token, megathink è 10.000 token e ultrathink è 31.999 token. Il modo corretto di usarlo è solo per il 10% veramente difficile dei problemi, come decisioni architetturali complesse, implementazioni di sicurezza, ottimizzazione delle prestazioni e refactoring su larga scala. Usarlo per ogni query gonfierà i costi inutilmente.
/effort ultracode è un'impostazione per abilitare il ragionamento xhigh e i flussi di lavoro dinamici per l'intera sessione. Mentre ultrathink è una parola chiave a turno singolo, ultracode rimane attivo per tutta la sessione. È adatto per "lavoro pesante a livello di sessione" come il controllo di un intero codebase, la migrazione di centinaia di file o attività ad alto rischio. Tuttavia, poiché i costi dei token aumentano significativamente, discernere la situazione determina l'efficacia.
Claude Code, iniziato con la digitazione in una chat per muoverlo, ha raggiunto il gateway di un sistema che rileva eventi e si muove autonomamente. Invece degli umani che lo muovono, il design muove Claude. Successivamente, confermeremo dove sorge essenzialmente la differenza di produttività attraverso tutte queste funzionalità.
Perché i risultati differiscono con lo stesso Claude Code
Le persone che sviluppano velocemente non hanno necessariamente abilità speciali. Stanno semplicemente progettando in modo più sistematico.
Ad esempio, considera la situazione di eseguire /init. Anche se viene digitato lo stesso comando, la qualità dell'output diversi mesi dopo sarà completamente diversa tra un CLAUDE.md che viene aggiornato settimanalmente e uno che è stato lasciato dall'impostazione. Questo perché la freschezza e l'accuratezza del contesto che Claude legge hanno un impatto diretto sulla qualità dell'output.
Usando un'analogia con la cucina, il livello di cucina è determinato più da come è organizzata la cucina stessa che da quali ingredienti vengono usati. Le prestazioni del modello di Claude sono fornite equamente a tutti gli utenti. La differenza sta nell'accuratezza di questi tre punti: come è stato organizzato il contesto, come sono state sistematizzate le istruzioni e come è stata progettata l'operazione autonoma.
Prima di discutere "quale modello usare", prova a controllare quando è stato aggiornato l'ultima volta il tuo attuale CLAUDE.md. Questo ti dirà lo stato attuale del tuo design.
Quindi, da dove dovresti effettivamente iniziare? Nel prossimo capitolo, organizzeremo una sequenza di introduzione passo dopo passo.
Da dove iniziare: una guida all'introduzione passo dopo passo
Non devi provare a ricordare tutti e 27 in una volta.
Nella prima settimana, restringi il campo a solo quattro.
- Crea una mappa del progetto con
/init. - Comprimi periodicamente il contesto con
/compact. - Separa esplorazione ed esecuzione con la modalità piano (
Shift+Tab). - Passa i passaggi di auto-verifica (test, build) a Claude.
Con solo questi quattro, la qualità della sessione cambierà radicalmente. Poiché Claude inizia a muoversi con una comprensione accurata di "cosa dovrebbe essere fatto", la quantità di rilavorazione diminuirà visibilmente.
Dalla seconda settimana in poi, aggiungi la Progettazione della delega su questa base. Riassumi le istruzioni in un formato riutilizzabile con le Competenze personalizzate, regola il peso e la velocità dell'elaborazione con la selezione del modello (Alt+P) e stabilisci l'abitudine di aggiornare CLAUDE.md settimanalmente. Questa è la fase in cui passi le istruzioni da "qualcosa scritto ogni volta" a "qualcosa che si accumula".
Dopo un mese, procedi con i sottoagenti, git worktrees e sessioni parallele. Avrai un sistema in cui puoi concentrarti su progettazione e conferma mentre sviluppi più funzionalità contemporaneamente.
ultrathink e ultracode sono strumenti da usare per la prima volta in questo flusso quando incontri "problemi veramente difficili". Non sono strumenti da tirare fuori per ogni problema.
Seguendo questi passaggi, capirai attraverso l'esperienza "perché ogni funzionalità è necessaria". Per favore, inizia con i quattro elementi per la prima settimana.
Tutto cambia nel momento in cui lo tratti come un obiettivo di progettazione
Nel momento in cui inizi a trattare Claude Code come un obiettivo di progettazione, la qualità della sessione cambia radicalmente.
Riassumerò il contenuto introdotto in questo articolo in una forma che puoi salvare e a cui puoi fare riferimento.
- I quattro elementi —
/init+/compact+ modalità piano + auto-verifica — sono i progetti di base più fondamentali. - Sistematizza il riutilizzo delle istruzioni con le Competenze personalizzate e fai crescere
CLAUDE.mdcome un "progetto vivente" aggiornato settimanalmente. - Quando inizi a usare i sottoagenti, la produttività passa dall'addizione alla moltiplicazione.
- La regola ferrea è rilevare la deriva presto e fermarsi immediatamente. Richiedi sempre prove nel primo output.
- Puoi sviluppare più funzionalità contemporaneamente con
git worktrees+ sessioni parallele. - Imposta l'operazione autonoma con
/loope conferma o impartisci istruzioni da uno smartphone con il Controllo Remoto. ultrathinkè uno strumento dedicato per il "10% veramente difficile". Non è per ogni problema.
Se provi anche solo una delle funzionalità menzionate in questo articolo, il tuo rapporto con Claude Code inizierà gradualmente a cambiare.
Per chi è interessato agli Agenti AI
Swarm (@swarm_japan) condivide filosofie di progettazione essenziali e casi d'uso aziendali per gli agenti.
Seguici per acquisire le conoscenze aziendali necessarie per l'era degli agenti AI 👇
★ Spiegare le ultime informazioni sugli agenti AI da una prospettiva unica
★ Introdurre casi d'uso aziendali per gli agenti
★ Pubblicare know-how originale
Se sei interessato, seguici e dai un'occhiata! 👀
