I comandi slash 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 cancellare la cronologia delle conversazioni, compattare i messaggi o ottenere aiuto.

​
Scoprire i Comandi Slash Disponibili

L’SDK di Claude Agent fornisce informazioni sui comandi slash disponibili nel messaggio di inizializzazione del sistema. Accedi a queste informazioni quando la tua sessione inizia: 
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Ciao Claude",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Comandi slash disponibili:", message.slash_commands);
    // Output di esempio: ["/compact", "/clear", "/help"]
  }
}

​
Invio di Comandi Slash

Invia i comandi slash includendoli nella tua stringa di prompt, proprio come il testo normale: 
import { query } from "@anthropic-ai/claude-agent-sdk";

// Invia un comando slash
for await (const message of query({
  prompt: "/compact",
  options: { maxTurns: 1 }
})) {
  if (message.type === "result") {
    console.log("Comando eseguito:", message.result);
  }
}

​
Comandi Slash Comuni

​
/compact - Compatta la Cronologia delle Conversazioni

Il comando /compact riduce la dimensione della cronologia delle tue conversazioni 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("Compattazione completata");
    console.log("Token pre-compattazione:", message.compact_metadata.pre_tokens);
    console.log("Trigger:", message.compact_metadata.trigger);
  }
}

​
/clear - Cancella Conversazione

Il comando /clear inizia una conversazione fresca cancellando tutta la cronologia precedente: 
import { query } from "@anthropic-ai/claude-agent-sdk";

// Cancella conversazione e inizia da capo
for await (const message of query({
  prompt: "/clear",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Conversazione cancellata, nuova sessione iniziata");
    console.log("ID Sessione:", message.session_id);
  }
}

​
Creazione di Comandi Slash Personalizzati

Oltre a utilizzare i comandi slash integrati, puoi creare i tuoi comandi personalizzati che sono disponibili attraverso l’SDK. I comandi personalizzati sono definiti come file markdown in directory specifiche, simile a come sono configurati i subagenti.

​
Posizioni dei File

I comandi slash personalizzati sono memorizzati in directory designate basate sul loro ambito:
  • Comandi di progetto: .claude/commands/ - Disponibili solo nel progetto corrente
  • Comandi personali: ~/.claude/commands/ - Disponibili in tutti i tuoi progetti

​
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 Base

Crea .claude/commands/refactor.md: 
Refactorizza il codice selezionato per migliorare la leggibilità e la manutenibilità.
Concentrati sui principi del codice pulito e le migliori pratiche.
Questo crea il comando /refactor che puoi utilizzare attraverso l’SDK.

​
Con Frontmatter

Crea .claude/commands/security-check.md: 
---
allowed-tools: Read, Grep, Glob
description: Esegui scansione vulnerabilità di sicurezza
model: claude-3-5-sonnet-20241022
---

Analizza la base di codice per vulnerabilità di sicurezza incluse:
- Rischi di SQL injection
- Vulnerabilità XSS
- Credenziali esposte
- Configurazioni insicure

​
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";

// Usa un comando personalizzato
for await (const message of query({
  prompt: "/refactor src/auth/login.ts",
  options: { maxTurns: 3 }
})) {
  if (message.type === "assistant") {
    console.log("Suggerimenti di refactoring:", message.message);
  }
}

// I comandi personalizzati appaiono nella lista slash_commands
for await (const message of query({
  prompt: "Ciao",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    // Includerà sia comandi integrati che personalizzati
    console.log("Comandi disponibili:", message.slash_commands);
    // Esempio: ["/compact", "/clear", "/help", "/refactor", "/security-check"]
  }
}

​
Funzionalità Avanzate

​
Argomenti e Segnaposto

I comandi personalizzati supportano argomenti dinamici utilizzando segnaposto: Crea .claude/commands/fix-issue.md: 
---
argument-hint: [numero-issue] [priorità]
description: Risolvi un issue GitHub
---

Risolvi issue #$1 con priorità $2.
Controlla la descrizione dell'issue e implementa le modifiche necessarie.
Usa nell’SDK: 
import { query } from "@anthropic-ai/claude-agent-sdk";

// Passa argomenti al comando personalizzato
for await (const message of query({
  prompt: "/fix-issue 123 alta",
  options: { maxTurns: 5 }
})) {
  // Il comando processerà con $1="123" e $2="alta"
  if (message.type === "result") {
    console.log("Issue risolto:", message.result);
  }
}

​
Esecuzione di Comandi Bash

I comandi personalizzati possono eseguire comandi bash e includere il loro output: Crea .claude/commands/git-commit.md: 
---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Crea un commit git
---

## Contesto

- Stato corrente: !`git status`
- Diff corrente: !`git diff HEAD`

## Compito

Crea un commit git con messaggio appropriato basato sui cambiamenti.

​
Riferimenti ai File

Includi contenuti di file utilizzando il prefisso @: Crea .claude/commands/review-config.md: 
---
description: Rivedi file di configurazione
---

Rivedi i seguenti file di configurazione per problemi:
- Configurazione package: @package.json
- Configurazione TypeScript: @tsconfig.json
- Configurazione ambiente: @.env

Controlla per problemi di sicurezza, dipendenze obsolete e configurazioni errate.

​
Organizzazione con Namespace

Organizza i comandi in sottodirectory per una migliore struttura: 
.claude/commands/
├── frontend/
│   ├── component.md      # Crea /component (project:frontend)
│   └── style-check.md     # Crea /style-check (project:frontend)
├── backend/
│   ├── api-test.md        # Crea /api-test (project:backend)
│   └── db-migrate.md      # Crea /db-migrate (project:backend)
└── review.md              # Crea /review (project)
La sottodirectory appare nella descrizione del comando ma non influisce sul nome del comando stesso.

​
Esempi Pratici

​
Comando di Code Review

Crea .claude/commands/code-review.md: 
---
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
description: Code review completo
---

## File Modificati
!`git diff --name-only HEAD~1`

## Modifiche Dettagliate
!`git diff HEAD~1`

## Checklist di Review

Rivedi le modifiche sopra per:
1. Qualità del codice e leggibilità
2. Vulnerabilità di sicurezza
3. Implicazioni di performance
4. Copertura dei test
5. Completezza della documentazione

Fornisci feedback specifico e attuabile organizzato per priorità.

​
Comando Test Runner

Crea .claude/commands/test.md: 
---
allowed-tools: Bash, Read, Edit
argument-hint: [pattern-test]
description: Esegui test con pattern opzionale
---

Esegui test che corrispondono al pattern: $ARGUMENTS

1. Rileva il framework di test (Jest, pytest, ecc.)
2. Esegui test con il pattern fornito
3. Se i test falliscono, analizza e correggili
4. Ri-esegui per verificare le correzioni
Usa questi comandi attraverso l’SDK: 
import { query } from "@anthropic-ai/claude-agent-sdk";

// Esegui code review
for await (const message of query({
  prompt: "/code-review",
  options: { maxTurns: 3 }
})) {
  // Processa feedback di review
}

// Esegui test specifici
for await (const message of query({
  prompt: "/test auth",
  options: { maxTurns: 5 }
})) {
  // Gestisci risultati dei test
}

​
Vedi Anche