/. Questi comandi possono essere inviati attraverso l’SDK per eseguire azioni come compattare il contesto, elencare l’utilizzo del contesto o invocare comandi personalizzati. Solo i comandi che funzionano senza un terminale interattivo sono dispatchable attraverso l’SDK; il messaggio system/init elenca quelli disponibili nella vostra sessione.
Scoprire gli Slash Commands Disponibili
L’SDK Claude Agent fornisce informazioni sui slash commands disponibili nel messaggio di inizializzazione del sistema. Accedete a queste informazioni quando la vostra sessione inizia:Invio di Slash Commands
Inviate slash commands includendoli nella vostra stringa di prompt, proprio come testo normale. I comandi che agiscono sulla cronologia della conversazione, come/compact, necessitano di messaggi precedenti per funzionare, quindi gli esempi seguenti pongono prima una domanda e poi inviano il comando come follow-up alla stessa conversazione:
Una query può terminare con un risultato di errore, ad esempio quando il limite
maxTurns / max_turns viene raggiunto prima che il lavoro si completi. Il messaggio di risultato finale ha quindi is_error: true e un sottotipo di errore come error_max_turns invece di success.Dopo aver restituito quel messaggio di risultato finale, l’SDK genera un errore, perché il processo CLI esce con un codice non zero.Avvolgete il ciclo in un try/catch in TypeScript o try/except in Python se il vostro comando potrebbe raggiungere il limite, come mostrato in Single Message Input, oppure impostate maxTurns abbastanza alto affinché il lavoro si completi. In Python, catturate Exception: l’SDK presenta i risultati di errore come una semplice Exception.Slash Commands Comuni
/compact - Compatta la Cronologia della Conversazione
Il comando /compact riduce la dimensione della vostra cronologia di conversazione riassumendo i messaggi più vecchi preservando il contesto importante. La compattazione richiede una conversazione esistente con almeno due scambi precedenti da riassumere. Questo esempio ha una conversazione prima, poi la compatta e legge il messaggio di sistema compact_boundary che riporta il risultato:
Un messaggio
compact_boundary arriva solo quando la compattazione è stata eseguita. Se non c’è nulla da riassumere, /compact riporta il motivo invece di generare un errore: l’esecuzione termina comunque con un risultato success, nessun messaggio compact_boundary viene emesso, e il testo del risultato contiene il messaggio, ad esempio Not enough messages to compact. dopo un singolo breve scambio. Una nuova chiamata query() una tantum inizia con un contesto vuoto, quindi utilizzate questo modello in una sessione con turni precedenti, ad esempio nella modalità di input in streaming o quando riprendete una sessione./clear - Ripristina il Contesto della Conversazione
Il comando /clear ripristina la conversazione a un contesto vuoto, in modo che i prompt successivi inizino senza alcuna cronologia di conversazione precedente. La conversazione precedente rimane su disco e può essere ripresa passando il suo ID di sessione all’opzione resume.
Questo è utile nella modalità di input in streaming, dove inviate più prompt su una singola connessione. Per le chiamate query() una tantum, ogni chiamata inizia già con un contesto vuoto, quindi inviare /clear non ha alcun effetto pratico; avviate invece una nuova query().
/clear nell’SDK richiede Claude Code v2.1.117 o successivo. Nelle versioni precedenti è omesso da slash_commands.Creazione di Slash Commands Personalizzati
Oltre a utilizzare gli slash commands integrati, potete creare i vostri comandi personalizzati disponibili attraverso l’SDK. I comandi personalizzati sono definiti come file markdown in directory specifiche, simile a come sono configurati i subagenti.La directory
.claude/commands/ è il formato legacy. Il formato consigliato è .claude/skills/<name>/SKILL.md, che supporta la stessa invocazione slash-command (/name) più l’invocazione autonoma da parte di Claude. Vedere Skills per il formato attuale. La CLI continua a supportare entrambi i formati, e gli esempi seguenti rimangono accurati per .claude/commands/.Posizioni dei File
I comandi slash personalizzati sono archiviati in directory designate in base al loro ambito:- Comandi di progetto:
.claude/commands/- Disponibili solo nel progetto corrente (legacy; preferire.claude/skills/) - Comandi personali:
~/.claude/commands/- Disponibili in tutti i vostri progetti (legacy; preferire~/.claude/skills/)
Formato del File
Ogni comando personalizzato è un file markdown dove:- Il nome del file (senza estensione
.md) diventa il nome del comando - Il contenuto del file definisce cosa fa il comando
- Il frontmatter YAML opzionale fornisce la configurazione
Esempio di Base
Create la directory.claude/commands nel vostro progetto se non esiste, quindi create .claude/commands/refactor.md:
/refactor che potete utilizzare attraverso l’SDK.
Con Frontmatter
Create.claude/commands/security-check.md:
Utilizzo di Comandi Personalizzati nell’SDK
Una volta definiti nel filesystem, i comandi personalizzati sono automaticamente disponibili attraverso l’SDK:Funzionalità Avanzate
Argomenti e Segnaposti
I comandi personalizzati supportano argomenti dinamici utilizzando segnaposti: Create.claude/commands/fix-issue.md:
Esecuzione di Comandi Bash
I comandi personalizzati possono eseguire comandi bash e includere il loro output: Create.claude/commands/git-commit.md:
Riferimenti ai File
Includete i contenuti dei file utilizzando il prefisso@:
Create .claude/commands/review-config.md:
Organizzazione con Namespacing
Organizzate i comandi in sottodirectory per una struttura migliore:Esempi Pratici
Comando di Revisione del Pull Request
Create.claude/commands/review-pr.md:
Claude Code include skills bundled
code-review e verify. Se nominate un comando personalizzato dopo uno di essi, ad esempio .claude/commands/code-review.md, il vostro comando oscura lo skill bundled e slash_commands elenca il nome una sola volta.Comando Test Runner
Create.claude/commands/test.md:
Vedere Anche
- Slash Commands - Documentazione completa degli slash commands
- Subagenti nell’SDK - Configurazione basata su filesystem simile per i subagenti
- Riferimento SDK TypeScript - Documentazione API completa
- Panoramica SDK - Concetti generali dell’SDK
- Riferimento CLI - Interfaccia della riga di comando