Gli slash commands forniscono un modo per controllare le sessioni di Claude Code con comandi speciali che iniziano con /. 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:
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Hello Claude",
options: { maxTurns: 1 }
})) {
if (message.type === "system" && message.subtype === "init") {
console.log("Available slash commands:", message.slash_commands);
// Example output: ["clear", "compact", "context", "usage"]
}
}
Invio di Slash Commands
Inviate slash commands includendoli nella vostra stringa di prompt, proprio come testo normale:
import { query } from "@anthropic-ai/claude-agent-sdk";
// Send a slash command
for await (const message of query({
prompt: "/compact",
options: { maxTurns: 1 }
})) {
if (message.type === "result" && message.subtype === "success") {
console.log("Command executed:", message.result);
}
}
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:
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "/compact",
options: { maxTurns: 1 }
})) {
if (message.type === "system" && message.subtype === "compact_boundary") {
console.log("Compaction completed");
console.log("Pre-compaction tokens:", message.compact_metadata.pre_tokens);
console.log("Trigger:", message.compact_metadata.trigger);
}
}
/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/)
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 .claude/commands/refactor.md:
Refactor the selected code to improve readability and maintainability.
Focus on clean code principles and best practices.
/refactor che potete utilizzare attraverso l’SDK.
Con Frontmatter
Create .claude/commands/security-check.md:
---
allowed-tools: Read, Grep, Glob
description: Run security vulnerability scan
model: claude-opus-4-7
---
Analyze the codebase for security vulnerabilities including:
- SQL injection risks
- XSS vulnerabilities
- Exposed credentials
- Insecure configurations
Utilizzo di Comandi Personalizzati nell’SDK
Una volta definiti nel filesystem, i comandi personalizzati sono automaticamente disponibili attraverso l’SDK:
import { query } from "@anthropic-ai/claude-agent-sdk";
// Use a custom command
for await (const message of query({
prompt: "/refactor src/auth/login.ts",
options: { maxTurns: 3 }
})) {
if (message.type === "assistant") {
console.log("Refactoring suggestions:", message.message);
}
}
// Custom commands appear in the slash_commands list
for await (const message of query({
prompt: "Hello",
options: { maxTurns: 1 }
})) {
if (message.type === "system" && message.subtype === "init") {
// Will include both built-in and custom commands
console.log("Available commands:", message.slash_commands);
// Example: ["clear", "compact", "context", "usage", "refactor", "security-check"]
}
}
Funzionalità Avanzate
Argomenti e Segnaposti
I comandi personalizzati supportano argomenti dinamici utilizzando segnaposti:
Create .claude/commands/fix-issue.md:
---
argument-hint: [issue-number] [priority]
description: Fix a GitHub issue
---
Fix issue #$0 with priority $1.
Check the issue description and implement the necessary changes.
import { query } from "@anthropic-ai/claude-agent-sdk";
// Pass arguments to custom command
for await (const message of query({
prompt: "/fix-issue 123 high",
options: { maxTurns: 5 }
})) {
// Command will process with $0="123" and $1="high"
if (message.type === "result" && message.subtype === "success") {
console.log("Issue fixed:", message.result);
}
}
Esecuzione di Comandi Bash
I comandi personalizzati possono eseguire comandi bash e includere il loro output:
Create .claude/commands/git-commit.md:
---
allowed-tools: Bash(git add *), Bash(git status *), Bash(git commit *)
description: Create a git commit
---
## Context
- Current status: !`git status`
- Current diff: !`git diff HEAD`
## Task
Create a git commit with appropriate message based on the changes.
Riferimenti ai File
Includete i contenuti dei file utilizzando il prefisso @:
Create .claude/commands/review-config.md:
---
description: Review configuration files
---
Review the following configuration files for issues:
- Package config: @package.json
- TypeScript config: @tsconfig.json
- Environment config: @.env
Check for security issues, outdated dependencies, and misconfigurations.
Organizzazione con Namespacing
Organizzate i comandi in sottodirectory per una struttura migliore:
.claude/commands/
├── frontend/
│ ├── component.md # Creates /component (project:frontend)
│ └── style-check.md # Creates /style-check (project:frontend)
├── backend/
│ ├── api-test.md # Creates /api-test (project:backend)
│ └── db-migrate.md # Creates /db-migrate (project:backend)
└── review.md # Creates /review (project)
Esempi Pratici
Comando di Revisione del Codice
Create .claude/commands/code-review.md:
---
allowed-tools: Read, Grep, Glob, Bash(git diff *)
description: Comprehensive code review
---
## Changed Files
!`git diff --name-only HEAD~1`
## Detailed Changes
!`git diff HEAD~1`
## Review Checklist
Review the above changes for:
1. Code quality and readability
2. Security vulnerabilities
3. Performance implications
4. Test coverage
5. Documentation completeness
Provide specific, actionable feedback organized by priority.
Comando Test Runner
Create .claude/commands/test.md:
---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
description: Run tests with optional pattern
---
Run tests matching pattern: $ARGUMENTS
1. Detect the test framework (Jest, pytest, etc.)
2. Run tests with the provided pattern
3. If tests fail, analyze and fix them
4. Re-run to verify fixes
import { query } from "@anthropic-ai/claude-agent-sdk";
// Run code review
for await (const message of query({
prompt: "/code-review",
options: { maxTurns: 3 }
})) {
// Process review feedback
}
// Run specific tests
for await (const message of query({
prompt: "/test auth",
options: { maxTurns: 5 }
})) {
// Handle test results
}
Vedere Anche
