Claude Code Serie Tutorial 3: Perché solo il terminale?

1.3 Perché scrivere codice nel terminale?

Facciamo un esempio: stai scrivendo una nuova funzionalità e all'improvviso scopri di dover modificare una funzione di utility di basso livello sparsa in tre file, con alcune chiamate che attraversano i moduli. Apri l'editor, fai una ricerca globale, sfogli file uno per uno, modifichi con cura, poi esegui di nuovo i test — rosso. Guardi l'errore, controlli lo stack, correggi e ripeti.

In questo processo, il tempo veramente speso a "capire come modificare" è forse meno della metà. Il resto è lavoro meccanico: trovare file, modificare riferimenti, aspettare la compilazione, cliccare col mouse.

Mettere l'AI nel terminale ha come obiettivo principale comprimere questo lavoro meccanico.

Il terminale è il posto più vicino al codice

Potresti usare VS Code, JetBrains o Vim. Qualunque strumento tu usi, durante la scrittura del codice non puoi evitare il terminale. Eseguire npm test, git log, grep, make build — queste operazioni avvengono naturalmente nella riga di comando.

Allora, se il tuo compagno AI si trova anche lui nello stesso terminale, le cose si semplificano. Non devi copiare e incollare il contenuto dei file in una finestra di chat, non devi descrivere "nel mio progetto c'è una classe chiamata UserService che si trova alla riga 42 di src/services/user.ts...". Claude Code si trova nella directory radice del progetto e vede tutto da solo.

Questa è una semplificazione drastica del contesto. Quando dici a Claude Code "aiutami a rifattorizzare la gestione degli errori del modulo di login", legge davvero il tuo auth/login.ts, legge errors.ts, trova tutti i punti in cui viene chiamato e modifica direttamente. Non c'è bisogno che tu faccia da tramite.

Ti libera dal ruolo di "operatore"

Quando usi una chat AI nel browser, spesso interpreti inconsapevolmente il ruolo di "intermediario": l'AI produce codice, tu lo leggi, lo verifichi, lo copi, poi torni nell'editor per incollarlo. Se il codice funziona, tutto bene; se no, copi l'errore, chiedi di nuovo, copi ancora. Questo processo interrompe molto il flusso.

Il design di Claude Code è pensato per riportarti al ruolo di "pensatore". Tu dici l'idea, lui agisce. Dopo la modifica vedi direttamente il diff nel terminale e decidi se accettarlo. Può anche eseguire test e lint per te. Tu rimani lì, per lo più a leggere codice e prendere decisioni, senza passare continuamente da una finestra all'altra.

Perché non un plugin per l'editor?

Potresti chiederti: perché non creare direttamente un plugin AI nell'editor?

I plugin per editor sono certamente utili e molti team li usano già. Ma Claude Code nel terminale ha alcuni vantaggi difficili da sostituire con un plugin:

1. Nessun vincolo dall'editor. Oggi usi VS Code, domani passi a Neovim, o anche su un server remoto senza GUI, Claude Code funziona. È indipendente dallo strumento che scegli.
2. Può fare cose più "audaci". Nel terminale può eseguire qualsiasi comando Shell. Questo significa che può fare cose molto più ampie — può avviare un container Docker per verificare una migrazione del database, fare pull di un ramo remoto e controllare i conflitti, eseguire automaticamente test e2e dopo le modifiche. Queste cose, di solito i plugin per editor non osano farle o semplicemente non possono.
3. Elaborazione batch e automazione. Puoi inserire Claude Code in uno script e fargli elaborare decine di repository, generare documentazione in batch, gestire automaticamente le Issues. In questo caso non è più un "assistente", ma un ingranaggio della pipeline.

Un mio piccolo esempio

Tempo fa dovevo migrare un progetto JavaScript a TypeScript, circa ventimila righe di codice. Non l'ho fatto manualmente file per file aggiungendo tipi, né contavo su un plugin dell'editor per fare tutto.

Ho semplicemente avviato Claude Code nella directory del progetto e gli ho detto: "Migra gradualmente questo progetto a TypeScript strict mode, modificando alcuni file alla volta. Dopo ogni batch, esegui tsc --noEmit e se ci sono errori, correggili da solo, finché tutto non passa."

Nella mezz'ora successiva, ho fatto fondamentalmente una cosa sola: guardare i diff delle modifiche, annuire o scuotere la testa. Ogni tanto gli dicevo "qui non usare any, definisci una interface", e lui continuava. Alla fine il progetto compilava correttamente, molto più velocemente di quanto avevo stimato.

Questo non significa che Claude Code sia più intelligente di un plugin. Ma è in grado di completare da solo il ciclo "modifica-verifica-riparazione", ed è questa la differenza fondamentale rispetto a un'AI basata su chat.

In fondo, il terminale dà mani e piedi all'AI

Mettere l'AI nel terminale significa essenzialmente darle la capacità di eseguire, non solo di consigliare.

Fa sì che il tuo repository di codice non sia più solo un insieme di testi da leggere, ma diventi un ambiente reale che l'AI può "toccare", modificare e verificare. Questo è un enorme passo avanti.

Tu mantieni ancora la direzione del progetto e tutte le decisioni chiave, ma il lavoro noioso, poco creativo e che richiede continui salti ha un esecutore più adatto.