Introduzione a Claude Code e al suo ecosistema di comandi
Claude Code è l’assistente di programmazione sviluppato da Anthropic, progettato per operare direttamente nel terminale. Legge il codice del progetto, modifica i file e lancia comandi, tutto tramite una serie di slash command (comandi preceduti da “/”). L’elenco completo, con le versioni minime richieste, è disponibile nella pagina Commands della documentazione ufficiale, consultata il 13 novembre 2026. Poiché i comandi evolvono rapidamente, la data è fondamentale per capire quali funzionalità sono disponibili.
Claude Code si integra con il “loop engineering” di Boris Cherny, una metodologia che combina prompt, hook e auto‑memory per creare cicli di lavoro autonomi. Venerdì 13 novembre ha subito un problema di login su claude.ai e Claude Code, risolto dopo 67 minuti, dimostrando la necessità di monitorare lo stato dei servizi.
Installazione e primi passi
Claude Code si installa dal terminale su macOS, Linux e Windows, richiedendo un abbonamento Claude (Pro, Max, Ultra, Team o Enterprise) e un account Claude Console o l’accesso tramite provider cloud supportato. Una volta installato, basta digitare “/” nel prompt per visualizzare l’elenco dei comandi disponibili per la propria versione.
Il primo giorno in un progetto è cruciale: quattro comandi preparano il terreno e vengono usati raramente, ma sono fondamentali per impostare correttamente l’ambiente.
- /init legge il progetto e genera un file
CLAUDE.mdcontenente le istruzioni di base. Con la variabile d’ambienteCLAUDECODENEW_INIT=1il comando diventa interattivo, guidandoti nella creazione di skill, hook e file di memoria. - /import migra configurazioni di OpenAI Codex o Gemini CLI, se presenti.
- /memory apre e modifica i file
CLAUDE.md, gestendo l’auto‑memory e le note generate da Claude. UnCLAUDE.mdtroppo voluminoso consuma contesto; è consigliabile consultare la guida al “prompt‑audit” per pulirlo. - /permissions (alias
/allowed-tools) definisce le regole di accesso di Claude: allow, ask o deny. Include anche la gestione delle cartelle di lavoro e dei blocchi recenti dell’auto‑mode.
Gestione dei permessi avanzata
Per ridurre le richieste di conferma, il comando /fewer-permission-prompts scandaglia le trascrizioni, individua le chiamate di sola lettura più frequenti (Bash e MCP) e le aggiunge a .claude/settings.json. Prima di disattivare completamente i permessi, è consigliabile studiare i PreToolUse hook per bloccare comandi pericolosi.
Lavorare con i server MCP
Il protocollo Model Context Protocol (MCP) collega Claude Code a servizi esterni come GitHub o database. Il comando /mcp gestisce i server MCP e le credenziali OAuth:
- senza argomenti mostra lo stato dei server;
/mcp reconnect nome-serverricollega un singolo server;/mcp reconnect alltenta di riconnettere tutti i server caduti.
Per approfondire il funzionamento di MCP, consultare la spiegazione di MCP e la guida ai cinque migliori server.
Pianificazione e controllo del contesto durante lo sviluppo
/plan avvia la “plan mode” direttamente dal prompt. Inserendo una descrizione (/plan sposta la validazione dei form in un modulo condiviso) Claude si concentra sul compito specificato, ideale prima di modifiche che coinvolgono molti file o di analisi di progetti sconosciuti.
Il contesto è la quantità di informazioni che il modello ha a disposizione per ogni richiesta. Può riempirsi rapidamente, soprattutto quando si accumulano tool, memoria e output.
- /context visualizza il contesto in una griglia colorata, evidenziando le voci più pesanti.
- /compact riassume la conversazione, liberando spazio. È possibile specificare gli elementi da preservare, ad esempio
/compact tieni il piano e i comandi di test. - /autocompact imposta una soglia (es. 500 k token) oltre la quale avviene la compattazione automatica.
- /btw consente di porre domande al volo senza che la risposta entri nella conversazione, mantenendo intatto il contesto.
Gestione del modello, ragionamento e costi
Il comando /model permette di cambiare modello e di salvarlo come predefinito per le nuove sessioni. Nella selezione, il tasto s modifica il modello solo per la sessione corrente, utile per compiti particolarmente complessi.
/effort regola la profondità di ragionamento di Claude, da low a xhigh, con opzioni max (solo per la sessione) e auto. Alzare l’effort è consigliato per bug ostinati; abbassarlo per richieste rapide. /effort status mostra il livello attuale.
Per monitorare le spese, /usage (alias /cost e /stats) visualizza costi, limiti del piano e statistiche d’uso in tempo reale, anche a metà risposta. È fondamentale controllarlo prima di avviare lavori lunghi.
Lavori lunghi, parallelismo e automazione
Quando si affrontano compiti estesi o si desidera che Claude lavori in autonomia, i comandi evolvono da semplici scorciatoie a veri e propri meccanismi di automazione.
- /goal definisce una condizione di fine lavoro. Claude continua finché la condizione non è soddisfatta; un secondo modello verifica la condizione dopo ogni turno. Senza argomento mostra l’obiettivo corrente;
/goal clearo/goal stoplo rimuove. - /loop ripete un prompt a intervalli regolari, monitorando un evento o una variabile. È utile per test di regressione continui o per aggiornare automaticamente un file di log.
La chiave per /goal è una formulazione precisa: “i test passano e nessun test esistente è stato modificato” è verificabile, mentre frasi vaghe non lo sono. Per lavori senza supervisione, è necessario attivare l’auto‑mode, che delega a Claude la scelta degli strumenti.
Gestione delle attività simultanee
Claude Code supporta più attività parallele tramite alias e skill personalizzate:
- /review (alias
/code-review) avvia una revisione del codice, generando commenti inline. - /cost (alias
/usage) permette di controllare rapidamente il consumo corrente. - /new (alias
/clear) cancella la sessione e ricomincia da zero.
Alcuni comandi sono in realtà skill: anziché avere una logica fissa, inviano un testo di istruzioni al modello. Quando si scrive una skill personalizzata, l’ultimo passo è definire la risposta attesa, altrimenti Claude potrebbe interpretarla in modo imprevisto.
Interazione avanzata con la shell
Oltre alla barra (/), Claude Code riconosce due prefissi aggiuntivi:
- ! invia la riga direttamente alla shell e incorpora l’output nella sessione, consentendo a Claude di commentarlo.
- @ cita un percorso di file, facilitando riferimenti a risorse specifiche.
Con il prompt vuoto, premendo due volte Esc si apre il menu di rewind**, utile per tornare a uno stato precedente della sessione.
Consigli pratici e best practice
Per massimizzare l’efficacia di Claude Code, si consiglia di:
- Utilizzare
/initsolo una volta per progetto, poi mantenereCLAUDE.mdsnello. - Controllare regolarmente
/usagee/contextper evitare sorprese di token. - Definire obiettivi chiari con
/goalprima di avviare lavori lunghi. - Sfruttare gli alias (
/review,/cost,/new) per velocizzare il flusso di lavoro. - Configurare
/fewer-permission-promptsper ridurre le interruzioni dovute ai permessi.
Infine, ricordate che i comandi di Claude Code cambiano frequentemente; consultate sempre la documentazione ufficiale per verificare versioni e nuove funzionalità.