Comandos Slash en el SDK

Los comandos slash proporcionan una forma de controlar sesiones de Claude Code con comandos especiales que comienzan con /. Estos comandos pueden enviarse a través del SDK para realizar acciones como limpiar el historial de conversación, compactar mensajes u obtener ayuda.

Descubriendo Comandos Slash Disponibles

El Claude Agent SDK proporciona información sobre comandos slash disponibles en el mensaje de inicialización del sistema. Accede a esta información cuando tu sesión comience:

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Hola Claude",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Comandos slash disponibles:", message.slash_commands);
    // Ejemplo de salida: ["/compact", "/clear", "/help"]
  }
}

import asyncio
from claude_agent_sdk import query

async def main():
    async for message in query(
        prompt="Hola Claude",
        options={"max_turns": 1}
    ):
        if message.type == "system" and message.subtype == "init":
            print("Comandos slash disponibles:", message.slash_commands)
            # Ejemplo de salida: ["/compact", "/clear", "/help"]

asyncio.run(main())

Enviando Comandos Slash

Envía comandos slash incluyéndolos en tu cadena de prompt, igual que texto regular:

import { query } from "@anthropic-ai/claude-agent-sdk";

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

Comandos Slash Comunes

/compact - Compactar Historial de Conversación

El comando /compact reduce el tamaño de tu historial de conversación resumiendo mensajes más antiguos mientras preserva contexto 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("Compactación completada");
    console.log("Tokens pre-compactación:", message.compact_metadata.pre_tokens);
    console.log("Disparador:", message.compact_metadata.trigger);
  }
}

/clear - Limpiar Conversación

El comando /clear inicia una conversación fresca limpiando todo el historial previo:

import { query } from "@anthropic-ai/claude-agent-sdk";

// Limpiar conversación y comenzar de nuevo
for await (const message of query({
  prompt: "/clear",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Conversación limpiada, nueva sesión iniciada");
    console.log("ID de sesión:", message.session_id);
  }
}

Creando Comandos Slash Personalizados

Además de usar comandos slash integrados, puedes crear tus propios comandos personalizados que están disponibles a través del SDK. Los comandos personalizados se definen como archivos markdown en directorios específicos, similar a cómo se configuran los subagentes.

Ubicaciones de Archivos

Los comandos slash personalizados se almacenan en directorios designados basados en su alcance:

• Comandos de proyecto: .claude/commands/ - Disponibles solo en el proyecto actual
• Comandos personales: ~/.claude/commands/ - Disponibles en todos tus proyectos

Formato de Archivo

Cada comando personalizado es un archivo markdown donde:

• El nombre del archivo (sin extensión .md) se convierte en el nombre del comando
• El contenido del archivo define qué hace el comando
• El frontmatter YAML opcional proporciona configuración

Ejemplo Básico

Crear .claude/commands/refactor.md:

Refactoriza el código seleccionado para mejorar la legibilidad y mantenibilidad.
Enfócate en principios de código limpio y mejores prácticas.

Esto crea el comando /refactor que puedes usar a través del SDK.

Con Frontmatter

Crear .claude/commands/security-check.md:

---
allowed-tools: Read, Grep, Glob
description: Ejecutar escaneo de vulnerabilidades de seguridad
model: claude-3-5-sonnet-20241022
---

Analiza la base de código para vulnerabilidades de seguridad incluyendo:
- Riesgos de inyección SQL
- Vulnerabilidades XSS
- Credenciales expuestas
- Configuraciones inseguras

Usando Comandos Personalizados en el SDK

Una vez definidos en el sistema de archivos, los comandos personalizados están automáticamente disponibles a través del SDK:

import { query } from "@anthropic-ai/claude-agent-sdk";

// Usar un comando personalizado
for await (const message of query({
  prompt: "/refactor src/auth/login.ts",
  options: { maxTurns: 3 }
})) {
  if (message.type === "assistant") {
    console.log("Sugerencias de refactorización:", message.message);
  }
}

// Los comandos personalizados aparecen en la lista slash_commands
for await (const message of query({
  prompt: "Hola",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    // Incluirá tanto comandos integrados como personalizados
    console.log("Comandos disponibles:", message.slash_commands);
    // Ejemplo: ["/compact", "/clear", "/help", "/refactor", "/security-check"]
  }
}

Características Avanzadas

Argumentos y Marcadores de Posición

Los comandos personalizados soportan argumentos dinámicos usando marcadores de posición:

Crear .claude/commands/fix-issue.md:

---
argument-hint: [issue-number] [priority]
description: Arreglar un issue de GitHub
---

Arregla el issue #$1 con prioridad $2.
Revisa la descripción del issue e implementa los cambios necesarios.

Usar en SDK:

import { query } from "@anthropic-ai/claude-agent-sdk";

// Pasar argumentos al comando personalizado
for await (const message of query({
  prompt: "/fix-issue 123 high",
  options: { maxTurns: 5 }
})) {
  // El comando procesará con $1="123" y $2="high"
  if (message.type === "result") {
    console.log("Issue arreglado:", message.result);
  }
}

Ejecución de Comandos Bash

Los comandos personalizados pueden ejecutar comandos bash e incluir su salida:

Crear .claude/commands/git-commit.md:

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
description: Crear un commit de git
---

## Contexto

- Estado actual: !`git status`
- Diff actual: !`git diff HEAD`

## Tarea

Crear un commit de git con mensaje apropiado basado en los cambios.

Referencias de Archivos

Incluye contenidos de archivos usando el prefijo @:

Crear .claude/commands/review-config.md:

---
description: Revisar archivos de configuración
---

Revisa los siguientes archivos de configuración para problemas:
- Configuración de paquete: @package.json
- Configuración de TypeScript: @tsconfig.json
- Configuración de entorno: @.env

Busca problemas de seguridad, dependencias desactualizadas y configuraciones incorrectas.

Organización con Espacios de Nombres

Organiza comandos en subdirectorios para mejor estructura:

.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)

El subdirectorio aparece en la descripción del comando pero no afecta el nombre del comando en sí.

Ejemplos Prácticos

Comando de Revisión de Código

Crear .claude/commands/code-review.md:

---
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
description: Revisión de código integral
---

## Archivos Cambiados
!`git diff --name-only HEAD~1`

## Cambios Detallados
!`git diff HEAD~1`

## Lista de Verificación de Revisión

Revisa los cambios anteriores para:
1. Calidad y legibilidad del código
2. Vulnerabilidades de seguridad
3. Implicaciones de rendimiento
4. Cobertura de pruebas
5. Completitud de documentación

Proporciona retroalimentación específica y accionable organizada por prioridad.

Comando Ejecutor de Pruebas

Crear .claude/commands/test.md:

---
allowed-tools: Bash, Read, Edit
argument-hint: [test-pattern]
description: Ejecutar pruebas con patrón opcional
---

Ejecutar pruebas que coincidan con el patrón: $ARGUMENTS

1. Detectar el framework de pruebas (Jest, pytest, etc.)
2. Ejecutar pruebas con el patrón proporcionado
3. Si las pruebas fallan, analizarlas y arreglarlas
4. Re-ejecutar para verificar las correcciones

Usa estos comandos a través del SDK:

import { query } from "@anthropic-ai/claude-agent-sdk";

// Ejecutar revisión de código
for await (const message of query({
  prompt: "/code-review",
  options: { maxTurns: 3 }
})) {
  // Procesar retroalimentación de revisión
}

// Ejecutar pruebas específicas
for await (const message of query({
  prompt: "/test auth",
  options: { maxTurns: 5 }
})) {
  // Manejar resultados de pruebas
}

Ver También

• Comandos Slash - Documentación completa de comandos slash
• Subagentes en el SDK - Configuración similar basada en sistema de archivos para subagentes
• Referencia del SDK de TypeScript - Documentación completa de la API
• Resumen del SDK - Conceptos generales del SDK
• Referencia de CLI - Interfaz de línea de comandos