Los slash commands 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 compactar contexto, listar el uso del contexto o invocar comandos personalizados. Solo los comandos que funcionan sin una terminal interactiva se pueden enviar a través del SDK; el mensaje system/init enumera los disponibles en su sesión.
Descubrimiento de Slash Commands Disponibles
El Claude Agent SDK proporciona información sobre los slash commands disponibles en el mensaje de inicialización del sistema. Acceda a esta información cuando su sesión comience:
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"]
}
}
Envío de Slash Commands
Envíe slash commands incluyéndolos en su cadena de prompt, como texto normal:
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);
}
}
Comandos Slash Comunes
/compact - Compactar historial de conversación
El comando /compact reduce el tamaño de su historial de conversación resumiendo mensajes antiguos mientras preserva el 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("Compaction completed");
console.log("Pre-compaction tokens:", message.compact_metadata.pre_tokens);
console.log("Trigger:", message.compact_metadata.trigger);
}
}
/clear - Restablecer contexto de conversación
El comando /clear restablece la conversación a un contexto vacío, de modo que los prompts posteriores comienzan sin historial de conversación previo. La conversación anterior permanece en disco y se puede recuperar pasando su ID de sesión a la opción resume.
Esto es útil en modo de entrada en streaming, donde envía múltiples prompts sobre una única conexión. Para llamadas query() de una sola vez, cada llamada ya comienza con contexto vacío, por lo que enviar /clear no tiene efecto práctico; inicie una nueva query() en su lugar.
/clear en el SDK requiere Claude Code v2.1.117 o posterior. En versiones anteriores se omite de slash_commands.
Creación de Slash Commands Personalizados
Además de usar slash commands integrados, puede crear sus 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.
El directorio .claude/commands/ es el formato heredado. El formato recomendado es .claude/skills/<name>/SKILL.md, que admite la misma invocación de slash command (/name) más invocación autónoma por Claude. Consulte Skills para el formato actual. La CLI continúa admitiendo ambos formatos, y los ejemplos a continuación siguen siendo precisos para .claude/commands/. Ubicaciones de Archivos
Los slash commands personalizados se almacenan en directorios designados según su alcance:
- Comandos de proyecto:
.claude/commands/ - Disponibles solo en el proyecto actual (heredado; prefiera .claude/skills/)
- Comandos personales:
~/.claude/commands/ - Disponibles en todos sus proyectos (heredado; prefiera ~/.claude/skills/)
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
Cree .claude/commands/refactor.md:
Refactor the selected code to improve readability and maintainability.
Focus on clean code principles and best practices.
/refactor que puede usar a través del SDK.
Con Frontmatter
Cree .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
Uso de 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";
// 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"]
}
}
Características Avanzadas
Argumentos y Placeholders
Los comandos personalizados admiten argumentos dinámicos usando placeholders:
Cree .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);
}
}
Ejecución de Comandos Bash
Los comandos personalizados pueden ejecutar comandos bash e incluir su salida:
Cree .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
Incluya contenidos de archivos usando el prefijo @:
Cree .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
Organice 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)
Ejemplos Prácticos
Comando de Revisión de Código
Cree .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 de Ejecutor de Pruebas
Cree .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
}
Véase También
