Guía

Cómo crear comandos slash personalizados en Claude Code

Si escribes en Claude Code el mismo prompt largo cada semana, como una lista de revisión o los pasos de una publicación, puedes convertirlo en tu propio comando slash. Esta guía explica los comandos integrados que conviene conocer, cómo escribir uno personalizado y cómo compartirlo en un proyecto.

Actualizado 30 de octubre de 2026

Respuesta rápida: crea un archivo Markdown en .claude/skills/<name>/SKILL.md (o en el formato antiguo .claude/commands/<name>.md) dentro de tu proyecto y escribe en él el prompt; se convierte en /<name>. Ponlo en ~/.claude/ para usarlo en todos tus proyectos, y haz commit de la carpeta del proyecto para compartirlo con tu equipo.

Las rutas y los campos de abajo se comprobaron con la documentación de Claude Code de Anthropic en octubre de 2026.

Comandos integrados que conviene conocer

Escribe / en una sesión para ver todos los comandos que tienes disponibles, o / y unas letras para filtrar. Un comando solo cuenta al principio del mensaje; lo que escribas después se convierte en sus argumentos. Algunos comandos dependen de tu plataforma y tu plan.

Comando	Qué hace
`/init`	Redacta un CLAUDE.md para el proyecto
`/memory`	Abre tus archivos CLAUDE.md y de memoria
`/plan`	Pasa al modo plan antes de un cambio grande
`/context`	Muestra qué está llenando la ventana de contexto
`/compact`	Resume la conversación para liberar espacio
`/clear`	Empieza una conversación nueva
`/resume`	Vuelve a abrir una conversación anterior
`/status`	Muestra tu versión, modelo, cuenta y conexión
`/config`	Abre ajustes como el tema y el modelo

La lista completa está en la página Commands de Anthropic.

Crea tu propio comando

Los comandos personalizados y los skills ahora funcionan igual: .claude/commands/review.md y .claude/skills/review/SKILL.md te dan el mismo comando /review. La carpeta de skill es la forma recomendada porque puede contener archivos adicionales.

En tu proyecto, crea la carpeta .claude/skills/review/. El nombre de la carpeta se convierte en el nombre del comando, salvo que definas otro con un campo name:.
Dentro, crea SKILL.md.
Empieza el archivo con el frontmatter. La línea --- tiene que ser la primera de todas:
- description: qué hace el comando y cuándo usarlo. Pon primero el uso principal.
- argument-hint: opcional, una pista que aparece en el autocompletado, como [file].
Cierra el frontmatter con otra línea --- y escribe el prompt debajo, igual que se lo escribirías a Claude: qué revisar, en qué orden y cómo informar.
Escribe /review en una sesión. Los cambios en el archivo se aplican al momento; si creaste una carpeta .claude/skills/ de primer nivel nueva en plena sesión, ejecuta /reload-skills.

Pasa argumentos

$ARGUMENTS se sustituye por todo lo que se escribe después del comando.
$0, $1, $2 (contando desde 0) toman palabras sueltas, así que /migrate SearchBar JavaScript TypeScript rellena tres marcadores. Pon entre comillas los valores con espacios.
Si el archivo no tiene ningún marcador, Claude Code añade los argumentos al final como ARGUMENTS: ….
Para escribir un signo de dólar literal delante de un dígito, escápalo, como en \$1.00.

Opciones útiles del frontmatter

disable-model-invocation: true: solo tú puedes iniciarlo con la barra. Úsalo para cualquier cosa con efectos secundarios, como un despliegue.
user-invocable: false: lo oculta del menú /, de modo que solo Claude lo carga como conocimiento de fondo.
allowed-tools: herramientas que Claude puede usar sin preguntar durante el turno en que ejecutas el comando, por ejemplo Bash(npm run build *). Concede acceso; no restringe otras herramientas.

Los nombres de los campos deben coincidir exactamente; los campos desconocidos se ignoran sin ningún aviso.

Comparte comandos en un proyecto

Dónde	Quién lo recibe
`.claude/skills/` o `.claude/commands/` en el repositorio	Todos los que descargan el repositorio
`~/.claude/skills/` o `~/.claude/commands/`	Solo tú, en todos tus proyectos
Un plugin	Quien lo instale; se usa como `/plugin-name:command`
Configuración gestionada	Toda una organización, definida por los administradores

Las subcarpetas de .claude/commands/ añaden un espacio de nombres: .claude/commands/frontend/component.md se convierte en /frontend:component. Las sesiones en la nube y de Cowork no leen ~/.claude/skills/, así que haz commit del comando en el repositorio o activa el skill en tu cuenta de claude.ai si lo necesitas allí. Para los skills en las apps de Claude, consulta cómo usar Claude Skills.

Si no funciona

El comando no aparece en el menú /. Comprueba que el nombre de la carpeta o del archivo no tenga <, >, espacios dobles ni caracteres invisibles; un nombre así se rechaza. Inicia claude --debug y busca [names] en el registro de depuración para ver qué nombres se rechazaron. Ejecuta /reload-skills después de añadir una carpeta de skills nueva.
Se ignoran los ajustes del frontmatter. El YAML tiene que ser válido y empezar en la primera línea; un error de análisis carga el comando sin ningún campo definido.
Claude nunca lo usa por su cuenta. Haz que la descripción diga cuándo usarlo y comprueba que disable-model-invocation no esté definido.
El comando del proyecto ejecuta tu versión personal. Cuando el mismo nombre existe en ~/.claude/ y en el proyecto, gana el personal; cambia el nombre de uno de los dos.

Un comando ya hecho para guardar sesiones

El plugin de Workbranch para Claude Code añade /workbranch:save, que archiva por temas las tareas, decisiones, preguntas abiertas e ideas de la sesión en un proyecto de Workbranch, para que no tengas que escribir ese comando tú. Workbranch tiene una prueba gratuita de 3 días en app.workbranch.ai.

Fuentes

Extend Claude with skills (Claude Code Docs, consultado el 30 de octubre de 2026)
Commands (Claude Code Docs, consultado el 30 de octubre de 2026)
Use Claude Code with your Pro or Max plan (Centro de ayuda de Claude, consultado el 30 de octubre de 2026)

Preguntas frecuentes

¿Uso .claude/commands o .claude/skills?

Los dos crean el mismo tipo de comando slash, y los archivos de comando antiguos siguen funcionando. Anthropic recomienda los skills para lo nuevo, porque una carpeta de skill puede contener archivos de apoyo y Claude puede cargarla automáticamente cuando viene al caso.

¿Claude puede ejecutar mi comando por su cuenta?

Claude puede cargar un skill con descripción cuando encaja con tu petición. Añade disable-model-invocation: true al frontmatter si solo debes iniciarlo tú, por ejemplo para un despliegue.

¿Qué pasa si mi comando se llama igual que otro?

Los comandos de empresa ganan a los personales, y los personales a los del proyecto. Un skill gana a un archivo de comando con el mismo nombre. Los comandos de plugins llevan espacio de nombres, como /plugin-name:command, así que no chocan.