Claude Code nel 2026: Setup, Comandi Slash, MCP e Subagents

Aggiornato il: June 28, 2026

Ho utilizzato Claude Code ogni giorno lavorativo per l'ultimo mese su un vero monorepo Next.js. Questo post riguarda la configurazione, i comandi slash, CLAUDE.md, MCP, subagents, permessi e hook che effettivamente eseguo, oltre a dove incontra dei limiti.

Risposta rapida: cos'è Claude Code ed è utile?

Claude Code è l'CLI di codifica agentica di Anthropic. Legge il tuo repo, modifica i file, esegue comandi shell e collega strumenti finché un compito non è completato. Lo uso per rilasciare funzionalità, correggere bug e rivedere diff senza lasciare il terminale.

La configurazione che funziona per me: installare l'CLI, aggiungere un CLAUDE.md, collegare due o tre server MCP e mantenere i permessi stretti. Questa combinazione lo trasforma da un giocattolo di chat in un collega che conosce la tua codebase.

Non è magia. Su un repo con 200k file allucina API e rompe test. Il beneficio arriva quando si circoscrivono i compiti, si rivede ogni piano e si committa spesso. Di più sui limiti reali alla fine.

Come configurare Claude Code?

Ho installato l'installer nativo su macOS e Node su Linux. Entrambi sono percorsi ufficiali documentati nel repository all github.com/anthropics/claude-code.

## macOS / Linux native installer
curl -fsSL https://claude.ai/install.sh | bash

## o tramite npm
npm install -g @anthropic-ai/claude-code

## verificare
claude --version

Poi ho eseguito claude all'interno del mio repo e mi sono loggato con il mio account Anthropic. Al primo avvio ha scansionato l'albero e mi ha chiesto di confermare l'accesso alla directory. Ho detto sì solo per la root del progetto, non per l'intera cartella home.

Alcune decisioni di configurazione che ho preso all'inizio e che non ho rimpianto:

• Ho fissato la versione in CI in modo che i colleghi utilizzino la stessa.
• Ho aggiunto .claude/ a .gitignore tranne settings.json, che ho committato.
• Ho scritto il CLAUDE.md prima di qualsiasi prompt reale, perché la qualità del contesto decide la qualità dell'output.
• Ho mantenuto attiva la modalità predefinita "chiedere prima di azioni distruttive" per la prima settimana.

Il riferimento ufficiale per l'installazione e la configurazione si trova su docs.claude.com/en/docs/claude-code, che tengo aperto mentre configuro.

Quali comandi slash uso quotidianamente?

I comandi slash sono il modo più veloce per dirigere una sessione. Li ho imparati eseguendo /help e riducendo l'elenco a quelli che effettivamente utilizzo.

Eseguo /clear più di qualsiasi altro comando. Quando una sessione si confonde, un foglio pulito più un prompt più preciso risolve l'80% dei problemi. /compact è la versione più delicata che uso quando voglio mantenere lo slancio ma il contesto sta diventando pesante.

Come si scrive un CLAUDE.md che paga?

CLAUDE.md è un file markdown che Claude legge all'inizio di ogni sessione. Trattatelo come la documentazione di onboarding per un nuovo assunto che è veloce ma ha zero memoria delle vostre decisioni.

Eseguo /init per generare una prima bozza, poi lo riscrivo a mano. La versione generata è un punto di partenza, non il file finale. Il mio CLAUDE.md copre stack, convenzioni, layout, comandi e i tre bug che non voglio mai reintrodurre.

## Project

Next.js 14 App Router, TypeScript strict, Prisma + Postgres, pnpm workspaces.

## Layout
- App routes in app/
- Server actions in app/actions
- UI primitives in packages/ui

## Conventions
- Prefer async/await over .then chains
- Never use `any`; type unknown and narrow
- Keep components under 200 lines

## Commands
- Dev: pnpm dev
- Test: pnpm test
- Lint: pnpm lint

## Known traps
- Do not edit prisma/schema.prisma without running migrate
- rate-limit.ts is shared; changes affect all routes

Due errori che ho commesso e corretto nel CLAUDE.md. Primo, ho scritto paragrafi invece di liste, il che ha diluito il segnale. Secondo, ci ho messo la cronologia del progetto, che ha consumato token senza guadagno. Mantenetelo breve, imperativo e attuale.

Per i modelli più profondi, il mio articolo sulle competenze Claude Code analizza frammenti di prompt riutilizzabili che si abbinano bene con CLAUDE.md.

Come funzionano MCP e subagents in pratica?

MCP (Model Context Protocol) è il modo in cui Claude Code accede al di fuori del tuo repo: database, browser, GitHub, Linear. Eseguo tre server MCP e questo è più che sufficiente. Più server significano più token e più prompt di approvazione.

La mia attuale configurazione MCP fa un lavoro reale ogni settimana:

• Il server GitHub apre PR e legge i commenti di revisione.
• Il server Postgres risponde a "quanti record corrispondono" senza che io scriva SQL.
• Il server Playwright verifica le modifiche dell'interfaccia utente rispetto a un URL di staging.

Li ho configurati in .claude/settings.json e li ho verificati ciascuno con un prompt di una riga prima fidarmi di loro in un compito reale. La configurazione e la selezione dei server sono coperte nel dettaglio nella guida all'integrazione MCP per Claude Code e nel più ampio primo sul contesto del modello MCP.

I subagents sono il moltiplicatore successivo. Per una funzionalità con parti indipendenti, chiedo a Claude di inviare subagents paralleli, ciascuno circoscritto a un file o modulo, e lascio che un agente principale fonda i risultati. Riduce il tempo effettivo su grandi modifiche.

I subagents eccellono quando il lavoro è genuinamente parallelo. Falliscono quando i compiti condividono lo stato, perché la fase di fusione diventa disordinata. Per i modelli di parallelizzazione in cui mi fido, vedere Claude Code subagents e automazione del team.

Come funzionano permessi e hook?

I permessi decidono cosa può fare Claude senza chiedere. Manteniamo i valori predefiniti conservativi ed espandiamo per progetto. Il prompt di approvazione appare prima di qualsiasi azione distruttiva, che è l'unica rete di sicurezza che non disattivo mai.

Gli hook sono script definiti dall'utente che vengono eseguiti su eventi di Claude: prima di un comando, dopo una modifica, all'inizio di una sessione. Uso uno hook post-edit per eseguire automaticamente il linter e il type-checker, così Claude riceve feedback rapido senza che io debba eseguire nulla.

Un hook mi ha salvato la settimana scorsa. Il mio hook pre-command ha bloccato un rm -rf su un percorso esterno al progetto, e Claude si è adattato a una cancellazione circoscritta. È esattamente il tipo di guardrail che vale i dieci minuti per configurare.

Claude Code è utile nel 2026?

Sì, per gli sviluppatori che vivono già nel terminale. Il costo è reale, misurato in token, e ripaga quando i tuoi compiti sono circoscritti e il tuo repo è ben descritto da CLAUDE.md.

Mi ha sostituito tre strumenti: una chat AI separata, un assistente di ricerca CLI e la maggior parte della mia esplorazione manuale con grep-and-read. Il ciclo nativo del terminale è più veloce che passare tra le schede verso un browser.

Dove perde ancora: refactoring ambigui su larga scala, framework nuovissimi con poca documentazione e qualsiasi cosa richieda gusto su una codebase intera. Per queste cose pianifico prima in testo semplice, poi do a Claude una specifica precisa.

Dovresti fidarti di farlo lavorare su codice di produzione?

Non senza supervisione. Tratto l'output di Claude Code come tratterei la PR di un junior competente: leggo ogni diff, eseguo i test e non faccio mai merge per fiducia. L'autonomia è un quadrante, non un interruttore.

L'onesta avvertenza: Claude Code produrrà con sicurezza codice che sembra giusto ed è sottilmente sbagliato, specialmente nell'ambito della gestione degli errori e della pulizia asincrona. Controlla tu stesso i percorsi di fallimento, mantieni un rollback veloce e ottieni un serio aumento di produttività senza disastri. I documenti Anthropic coprono le impostazioni che non ho ripetuto qui.

Punti chiave

• Installa l'CLI, poi investi in CLAUDE.md prima del primo prompt reale.
• Padroneggia /clear, /compact e /permissions; il resto è opzionale.
• Inizia con due o tre server MCP e aggiungi solo quando un workflow lo richiede.
• Usa subagents per lavori paralleli e indipendenti; mantieni i compiti a stato condiviso seriali.
• Mantieni i permessi stretti e aggiungi hook per lint, type-check e guardrail di comandi distruttivi.
• Rivedi ogni diff come una PR. L'autonomia senza revisione è dove i progetti subiscono danni.

Crediti delle immagini

• Codice sorgente colorato che brilla su un monitor sviluppatore — foto di Mikhail Nilov su Pexels
• Primo piano sfocato di codice di programmazione colorato visualizzato su uno schermo — foto di Pixabay su Pexels
• Un programmatore con cuffie che scrive codice su una scrivania con due monitor — foto di Christina Morillo su Pexels
• Un ingegnere del software che scrive e rivede codice in un ufficio moderno — foto di ThisIsEngineering su Pexels