Crear comandos slash personalizados en Claude Code — Adapta tu flujo

¿Qué son los comandos slash personalizados?

Claude Code incluye comandos slash estándar como /help y /clear, pero ¿sabías que puedes añadir fácilmente tus propios comandos? Los comandos slash personalizados te permiten invocar prompts frecuentes o tareas rutinarias con una palabra clave corta, y dominarlos puede acelerar drásticamente tu desarrollo diario.

En lugar de escribir un prompt largo como “Revisa el código de la rama actual” cada vez, basta con escribir /review para ejecutar el mismo comportamiento. Si los compartes con tu equipo, puedes estandarizar los criterios de revisión o los procedimientos de lanzamiento.

Ubicación y formato de archivo

Los comandos slash personalizados son simples archivos Markdown. Hay dos ubicaciones de almacenamiento:

• Específicos del proyecto: .claude/commands/<nombre-comando>.md
• Globales del usuario: ~/.claude/commands/<nombre-comando>.md

Los comandos específicos del proyecto pueden confirmarse en el repositorio y compartirse con el equipo, mientras que los globales del usuario están disponibles en todos tus proyectos. El nombre del archivo se convierte en el nombre del comando, así que review.md se convierte en /review.

Creando tu primer comando

Empecemos con el comando más simple posible. Ejecuta esto desde la raíz de tu proyecto:

mkdir -p .claude/commands
cat > .claude/commands/review.md <<'EOF'
Lee todos los cambios actualmente en el área de staging de Git y
revísalos desde las siguientes perspectivas:

- Posibles errores
- Consistencia en los nombres
- Cobertura de pruebas faltante
- Preocupaciones de seguridad

Si encuentras problemas, repórtalos con nombres de archivo y números de línea.
EOF

Eso es todo. Cuando escribes /review en Claude Code, el contenido del archivo se envía como el prompt.

Aceptar argumentos

Para hacer los comandos más útiles, deja que acepten argumentos. Usa el marcador $ARGUMENTS dentro de tu Markdown y la cadena que pases en la invocación se insertará ahí.

# .claude/commands/explain.md

Por favor, explica el siguiente archivo o símbolo de forma cuidadosa
para que los principiantes puedan seguirlo.

Objetivo: $ARGUMENTS

Tu explicación debe incluir:
1. Un resumen de una o dos frases de lo que hace el código
2. Un recorrido paso a paso por las líneas importantes
3. Un ejemplo de uso realista
4. Errores comunes que evitar

Invócalo con /explain src/utils/parser.ts. El token $ARGUMENTS se sustituye por src/utils/parser.ts antes de la ejecución.

Comandos que referencian varios archivos

Además de pasar rutas de archivo como argumentos, puedes usar la sintaxis @ dentro de un comando para cargar explícitamente ciertos archivos.

# .claude/commands/check-types.md

Tras leer @tsconfig.json y @package.json, encuentra todos los errores
de tipo en todo el proyecto.

Pasos:
1. Ejecuta `npx tsc --noEmit`
2. Agrupa los errores por archivo
3. Sugiere un orden de prioridad para las correcciones
4. Ordena primero por el tamaño del área afectada

Por favor, muestra el resultado como una tabla.

Claude lee automáticamente tsconfig.json y package.json antes de empezar a trabajar en el comando.

En la práctica: un comando de preparación de release

Aquí tienes un ejemplo que envuelve un flujo típico de release en un solo comando.

# .claude/commands/release.md

Prepara el lanzamiento para la versión $ARGUMENTS.

Pasos:
1. Actualiza el campo `version` en package.json a $ARGUMENTS
2. Añade una nueva sección al inicio de CHANGELOG.md
   - Referencia el git log desde la etiqueta anterior
   - Clasifica en feat / fix / docs / chore
3. Ejecuta `npm run test` y confirma que pasan todas las pruebas
4. Ejecuta `npm run build` y confirma que no hay errores de compilación
5. Resume los cambios y propón un mensaje de commit

Importante: No ejecutes tú mismo `git push` ni `npm publish`.
Deja la confirmación final al usuario.

Escribir /release 1.4.0 se encarga de todo, desde el aumento de versión hasta ejecutar las pruebas. Por seguridad, evita operaciones destructivas y deja que un humano confirme el paso final.

Simular flags y opciones

Puedes describir lógica de ramificación en Markdown para simular flags.

# .claude/commands/test.md

Argumentos: $ARGUMENTS

Sigue estas reglas:

- Si los argumentos están vacíos: ejecuta todas las pruebas
- Si los argumentos contienen `--unit`: ejecuta solo pruebas unitarias
- Si los argumentos contienen `--e2e`: ejecuta solo pruebas E2E
- Si se incluye una ruta de archivo: ejecuta solo las pruebas relacionadas con ese archivo

Después de ejecutar, analiza la causa de cualquier prueba fallida.

Llamadas como /test --unit o /test src/auth.ts se vuelven posibles.

Buenas prácticas para compartir en equipo

Coloca los comandos específicos del proyecto bajo .claude/commands/ y gestiónalos con Git para que todo el equipo use los mismos comandos. Ten en cuenta lo siguiente:

• Usa una convención de nombres consistente: primero el verbo, nombres cortos (review, fix, explain)
• Documéntalos en el README: facilita encontrar los comandos
• Evita operaciones destructivas: prohíbe explícitamente cosas como git push --force o rm -rf
• Especifica el formato de salida: mantén los resultados de revisión consistentes con tablas o listas de verificación

Conclusión

Los comandos slash personalizados son el camino más corto para convertir Claude Code en “tu propio asistente de IA personal”. Empieza con uno o dos comandos simples y añade más cada vez que detectes una tarea repetitiva. En poco tiempo, se convertirán en una parte indispensable de tu flujo de trabajo.

Para lo básico de Claude Code, consulta la guía de inicio. Para automatización más avanzada, revisa Introducción al Agent SDK, y para consejos sobre contexto, mira Gestión de Contexto.

Para la documentación oficial, consulta la documentación de Anthropic.