Comandi Slash nell'SDK

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:

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:

`/clear` - Cancella Conversazione

Il comando /clear inizia una conversazione fresca cancellando tutta la cronologia precedente:

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:

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:

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:

Vedi Anche

Comandi Slash - Documentazione completa dei comandi slash
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 a riga di comando

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);
  }
}

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);
  }
}

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);
  }
}

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"]
  }
}

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);
  }
}

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
}