Workbranch › Guide
GuidaCome creare comandi slash personalizzati in Claude Code
Se ogni settimana scrivi in Claude Code lo stesso lungo prompt, come una checklist di revisione o i passaggi di un rilascio, puoi trasformarlo in un comando slash tutto tuo. Questa guida presenta i comandi integrati da conoscere, spiega come scriverne uno personalizzato e come condividerlo in un progetto.
In breve: crea nel progetto un file Markdown in .claude/skills/<name>/SKILL.md (o nel vecchio formato .claude/commands/<name>.md) e scrivici dentro il prompt; diventa /<name>. Mettilo invece in ~/.claude/ per usarlo in tutti i tuoi progetti, e fai il commit della cartella del progetto per condividerlo con il team.
Percorsi e campi qui sotto sono stati verificati sulla documentazione di Claude Code di Anthropic a ottobre 2026.
Comandi integrati da conoscere
Digita / in una sessione per vedere tutti i comandi a tua disposizione, oppure / più qualche lettera per filtrarli. Un comando conta solo all'inizio esatto di un messaggio; tutto quello che scrivi dopo gli viene passato come argomenti. Alcuni comandi dipendono dalla piattaforma e dal piano.
| Comando | Cosa fa |
|---|---|
/init | Scrive una bozza di CLAUDE.md per il progetto |
/memory | Apre i tuoi file CLAUDE.md e di memoria |
/plan | Passa alla plan mode prima di una modifica importante |
/context | Mostra cosa sta occupando la finestra di contesto |
/compact | Riassume la conversazione per liberare spazio |
/clear | Inizia una nuova conversazione |
/resume | Riapre una conversazione precedente |
/status | Mostra versione, modello, account e connessione |
/config | Apre le impostazioni, come tema e modello |
L'elenco completo è nella pagina Commands di Anthropic.
Crea il tuo comando
Comandi personalizzati e skill ora funzionano allo stesso modo: .claude/commands/review.md e .claude/skills/review/SKILL.md ti danno entrambi /review. La cartella skill è la forma consigliata perché può contenere file aggiuntivi.
- Nel tuo progetto, crea la cartella
.claude/skills/review/. Il nome della cartella diventa il nome del comando, a meno che tu non ne imposti uno diverso con un camponame:. - Al suo interno, crea
SKILL.md. - Inizia il file con il frontmatter. La riga
---deve essere la primissima riga:description:cosa fa il comando e quando usarlo. Metti per primo l'uso principale.argument-hint:facoltativo, un suggerimento mostrato nel completamento automatico, come[file].
- Chiudi il frontmatter con un'altra riga
---e scrivi sotto il prompt, come lo scriveresti a Claude: cosa controllare, in che ordine e come riferire. - Digita
/reviewin una sessione. Le modifiche al file vengono recepite subito; se hai creato una nuova cartella.claude/skills/di primo livello a sessione avviata, esegui/reload-skills.
Passare argomenti
$ARGUMENTSviene sostituito con tutto ciò che scrivi dopo il comando.$0,$1,$2(contando da 0) prendono singole parole, quindi/migrate SearchBar JavaScript TypeScriptriempie tre segnaposto. Metti tra virgolette i valori con spazi.- Se il file non ha segnaposto, Claude Code aggiunge gli argomenti alla fine come
ARGUMENTS: …. - Per scrivere un simbolo del dollaro letterale prima di una cifra, usa il carattere di escape, come in
\$1.00.
Opzioni utili del frontmatter
disable-model-invocation: true: puoi avviarlo solo tu con lo slash. Usalo per tutto ciò che ha effetti collaterali, come un deploy.user-invocable: false: lo nasconde dal menu/, così lo carica solo Claude come conoscenza di sfondo.allowed-tools:gli strumenti che Claude può usare senza chiedere durante il turno in cui esegui il comando, per esempioBash(npm run build *). Concede accesso; non limita gli altri strumenti.
I nomi dei campi devono corrispondere esattamente; i campi sconosciuti vengono ignorati senza alcun avviso.
Condividere i comandi in un progetto
| Dove | Chi lo riceve |
|---|---|
.claude/skills/ o .claude/commands/ nel repository | Chiunque faccia pull del repository |
~/.claude/skills/ o ~/.claude/commands/ | Solo tu, in tutti i tuoi progetti |
| Un plugin | Chiunque lo installi; si usa come /plugin-name:command |
| Impostazioni gestite | Tutti in un'organizzazione, tramite gli amministratori |
Le sottocartelle in .claude/commands/ aggiungono un namespace: .claude/commands/frontend/component.md diventa /frontend:component. Le sessioni cloud e Cowork non leggono ~/.claude/skills/, quindi se ti serve lì fai il commit del comando nel repository oppure attiva la skill sul tuo account claude.ai. Per le skill nelle app di Claude, vedi come usare le Claude Skills.
Se non funziona
- Il comando non compare nel menu
/. Controlla che il nome della cartella o del file non contenga<,>, spazi doppi o caratteri invisibili; un nome così viene rifiutato. Avviaclaude --debuge cerca[names]nel log di debug per vedere quali nomi sono stati rifiutati. Esegui/reload-skillsdopo aver aggiunto una nuova cartella di skill. - Le impostazioni nel frontmatter vengono ignorate. Lo YAML deve essere valido e iniziare alla riga uno; un errore di parsing carica il comando senza alcun campo impostato.
- Claude non lo usa mai da solo. Fai in modo che la descrizione dica quando usarlo e verifica che
disable-model-invocationnon sia impostato. - Il comando del progetto esegue invece la tua versione personale. Quando lo stesso nome esiste in
~/.claude/e nel progetto, vince quella personale; rinomina uno dei due.
Un comando già pronto per salvare le sessioni
Il plugin Workbranch per Claude Code aggiunge /workbranch:save, che archivia i compiti, le decisioni, le domande aperte e le idee della sessione in un progetto Workbranch, divisi per argomento, così non devi scriverti quel comando da solo. Workbranch offre una prova gratuita di 3 giorni su app.workbranch.ai.
Fonti
- Extend Claude with skills (Claude Code Docs, verificato il 2026-10-30)
- Commands (Claude Code Docs, verificato il 2026-10-30)
- Use Claude Code with your Pro or Max plan (Claude Help Center, verificato il 2026-10-30)
Domande frequenti
Meglio usare .claude/commands o .claude/skills?
Entrambi creano lo stesso tipo di comando slash e i vecchi file di comando continuano a funzionare. Per i nuovi lavori Anthropic consiglia le skill, perché una cartella skill può contenere file di supporto e Claude può caricarla da solo quando è pertinente.
Claude può eseguire il mio comando di sua iniziativa?
Una skill con una descrizione può essere caricata da Claude quando si adatta alla tua richiesta. Aggiungi disable-model-invocation: true al frontmatter se deve avviarla solo tu, per esempio per un deploy.
Cosa succede se il mio comando ha lo stesso nome di un altro?
I comandi enterprise hanno la precedenza su quelli personali, e quelli personali su quelli del progetto. Una skill prevale su un file di comando con lo stesso nome. I comandi dei plugin hanno un namespace, come /plugin-name:command, quindi non entrano in conflitto.