Comandos de barra en el SDK

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

Descubriendo comandos de barra disponibles

El SDK del Agente Claude proporciona información sobre los comandos de barra disponibles en el mensaje de inicialización del sistema. Accede a esta información cuando tu sesión comienza:

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: ["/compact", "/clear", "/help"]
  }
}

Enviando comandos de barra

Envía comandos de barra incluyéndolos en tu cadena de solicitud, como texto normal:

Comandos de barra 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 el contexto importante:

`/clear` - Limpiar conversación

El comando /clear inicia una conversación nueva limpiando todo el historial anterior:

Creando comandos de barra personalizados

Además de usar comandos de barra 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 de barra personalizados se almacenan en directorios designados según 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

Crea .claude/commands/refactor.md:

Refactor the selected code to improve readability and maintainability.
Focus on clean code principles and best practices.

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

Con frontmatter

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

---
allowed-tools: Read, Grep, Glob
description: Run security vulnerability scan
model: claude-opus-4-6
---

Analyze the codebase for security vulnerabilities including:
- SQL injection risks
- XSS vulnerabilities
- Exposed credentials
- Insecure configurations

Usando comandos personalizados en el SDK

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

Características avanzadas

Argumentos y marcadores de posición

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

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

---
argument-hint: [issue-number] [priority]
description: Fix a GitHub issue
---

Fix issue #$1 with priority $2.
Check the issue description and implement the necessary changes.

Usar en SDK:

Ejecución de comandos Bash

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

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

Referencias de archivos

Incluye contenidos de archivos usando el prefijo @:

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

Organización con espacios de nombres

Organiza comandos en subdirectorios para una mejor estructura:

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

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

Crea .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 ejecutor de pruebas

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

Usa estos comandos a través del SDK:

Ver también

Slash Commands - Documentación completa de comandos de barra
Subagentes en el SDK - Configuración basada en sistema de archivos similar para subagentes
Referencia del SDK de TypeScript - Documentación completa de la API
Descripción general del SDK - Conceptos generales del SDK
Referencia de CLI - Interfaz de línea de comandos

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") {
    console.log("Command executed:", 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("Compaction completed");
    console.log("Pre-compaction tokens:", message.compact_metadata.pre_tokens);
    console.log("Trigger:", message.compact_metadata.trigger);
  }
}

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

// Clear conversation and start fresh
for await (const message of query({
  prompt: "/clear",
  options: { maxTurns: 1 }
})) {
  if (message.type === "system" && message.subtype === "init") {
    console.log("Conversation cleared, new session started");
    console.log("Session ID:", message.session_id);
  }
}

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: ["/compact", "/clear", "/help", "/refactor", "/security-check"]
  }
}

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 $1="123" and $2="high"
  if (message.type === "result") {
    console.log("Issue fixed:", message.result);
  }
}

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
}