Las analogías que lo explican todo

Analogía 1 — Comandos de Voz del Cirujano

En el quirófano, el cirujano no deja la operación para buscar herramientas. Dice "Bisturí" y el instrumental aparece. Palabras cortas, acción precisa, sin interrumpir el flujo. Eso son los slash commands: vocabulario especializado que ejecuta workflows complejos con una sola instrucción.

El cirujano (tú) mantiene la vista en la incisión (el código), no en buscar herramientas.

Analogía 2 — Macros de Excel para Equipos de Élite

Un analista de Goldman Sachs no recalcula el modelo de valoración manualmente cada vez. Tiene macros que en un clic ejecutan 200 pasos de análisis de forma idéntica. Los comandos slash son las macros de tu flujo de desarrollo: workflows capturados como código, reproducibles, auditables, versionados en git.

💡 El principio de los equipos de élite: "Los desarrolladores que obtienen 10x de productividad de Claude Code no son mejores en prompts individuales. Tienen mejores sistemas: CLAUDE.md en capas, comandos slash custom, workspaces organizados y hábitos que se componen." — Beam Dev, 2026

Taxonomía completa de lo que aparece al escribir /

OrigenEjemploNaturaleza
Built-in/clear, /model, /diffComportamiento hardcoded en el CLI
Skills bundled/batch, /simplify, /loopPrompts de Anthropic que Claude interpreta
Skills del usuario/mi-skill-customSKILL.md que tú creaste
Skills de plugins/plugin:skill-nameVienen con plugins instalados
MCP prompts/mcp__github__create-prPrompts expuestos por MCP servers
ℹ️ Distinción crítica: Los built-in tienen comportamiento hardcoded (abrir un picker, cambiar un setting). Las skills son prompts que Claude interpreta y ejecuta con herramientas. El usuario no nota la diferencia en el menú — ambos aparecen igual.

Las 6 fases del workflow y sus comandos

1️⃣ Setup del proyecto

  • /init — Genera CLAUDE.md
  • /memory — Edita contexto persistente
  • /mcp — Gestiona MCP servers
  • /permissions — Reglas allow/deny
  • /agents — Config subagentes

2️⃣ Durante la tarea

  • /plan [desc] — Solo lectura
  • /model — Cambia modelo
  • /compact — Libera contexto
  • /btw — Pregunta rápida
  • /goal — Objetivo hasta cumplir

3️⃣ Trabajo paralelo

  • /batch — Cambios masivos paralelos
  • /background — Sesión en background
  • /tasks — Gestiona tareas BG
  • /agents — Manager de subagentes

4️⃣ Antes de enviar

  • /diff — Viewer de diffs
  • /simplify — Quality review
  • /review [PR] — Review de PR
  • /security-review — Vulnerabilidades

5️⃣ Entre sesiones

  • /clear — Nueva sesión
  • /resume — Retoma sesión previa
  • /branch — Fork de conversación
  • /teleport — Web → terminal

6️⃣ Cuando algo va mal

  • /rewind — Rebobina código
  • /doctor — Diagnóstico instalación
  • /debug — Debug logging
  • /feedback — Reporta bug

Comandos built-in: referencia completa

Gestión de sesión y contexto

ComandoPropósitoAlias / Notas
/clear [nombre]Nueva conversación con contexto vacío. La anterior queda en /resume/reset, /new
/resume [sesión]Retoma conversación previa por ID o nombre. Picker si no se especifica/continue
/branch [nombre]Fork de conversación en este punto. El original se preserva/fork (sin fork mode)
/compact [instr]Libera contexto resumiendo. /compact focus on auth para enfocar
/rewindRebobina conversación y/o código a punto anterior con checkpointing/checkpoint, /undo
/teleportTrae sesión web al terminal. Requiere suscripción claude.ai/tp
/remote-controlHace la sesión disponible para control remoto desde claude.ai/code/rc

Configuración del modelo y rendimiento

ComandoPropósitoOpciones
/model [model]Cambia el modelo. Flechas ←→ para ajustar effort levelhaiku | sonnet | opus + effort level
/effort [level]Ajusta nivel de esfuerzo del modelolow · medium · high · xhigh · max · auto
/fast [on|off]Toggle fast mode — respuestas más rápidas, menos razonamiento
/context [all]Visualiza uso de contexto como grid coloreado con sugerenciasall para ver todo
/plan [desc]Entra en plan mode (solo lectura/exploración)/plan fix the auth bug
/goal [condición]Claude trabaja hasta cumplir el objetivoclear/stop/off para remover

Herramientas especiales

ComandoPropósitoNotas
/btw <pregunta>Pregunta efímera — overlay descartable, no entra al historialDisponible incluso mientras Claude procesa
/diffViewer interactivo de diffs (←→ entre git diff y diffs por turno)
/permissionsGestiona reglas allow/ask/deny para herramientasAlias: /allowed-tools
/background [prompt]Detach sesión como background agentAlias: /bg. Monitorear con claude agents
/tasksLista y gestiona tareas en backgroundAlias: /bashes
/doctorDiagnóstico de instalación. Presionar f para que Claude arregle issues
/feedback [reporte]Envía feedback a Anthropic con contexto de sesiónAlias: /bug
/initGenera CLAUDE.md inicial. Con CLAUDE_CODE_NEW_INIT=1: flujo interactivo
/memoryEdita archivos CLAUDE.md, habilita auto-memory
/terminal-setupConfigura keybindings para VS Code, Cursor, Windsurf, Alacritty, Zed

El comando /btw en detalle

Analogía — El susurro al copiloto

El capitán puede susurrar al copiloto sin interrumpir la comunicación con la torre. /btw es ese canal lateral: pregunta y respuesta no entran al historial de la sesión principal.

Aspecto/btwSubagente
Ve tu contexto completo✅ Sí❌ No (contexto fresco)
Tiene herramientas❌ No✅ Sí (todas)
Entra al historial❌ No — efímero✅ Sí (resultado)
CostoBajo — reutiliza prompt cacheNormal — contexto nuevo
PropósitoPreguntar sobre lo que Claude ya sabeIr a buscar algo nuevo

Skills bundled por Anthropic

ℹ️ Son prompts, no código: Las skills bundled son prompts que Claude interpreta y ejecuta con herramientas. Claude también puede invocarlas automáticamente cuando las detecta relevantes en la conversación.
/batch Cambios masivos en paralelo (5–30 unidades)
Analogía

El comandante que divide una misión en pelotones. Múltiples equipos atacan distintos objetivos simultáneamente en vez de uno en secuencia.

Orquesta cambios a gran escala: investiga codebase → descompone en 5–30 unidades → presenta plan → spawna subagente por unidad en worktree aislado → cada uno implementa, corre tests y abre PR.

/batch migrate src/ from Solid to React /batch add error handling to all API endpoints /batch update all tests to use the new assertion library /batch add TypeScript types to all JavaScript files in src/

Cuándo SÍ: Cambios repetitivos que aplican el mismo patrón a muchos archivos independientes.

Cuándo NO: Cambios en los mismos archivos (conflictos garantizados) o que requieren decisiones secuenciales.

/simplify [foco] 3 agentes de review en paralelo sobre archivos recientes

Revisa archivos recientemente modificados: code reuse, calidad y eficiencia. 3 agentes de review en paralelo, agrega findings y aplica fixes.

/simplify /simplify focus on memory efficiency /simplify focus on error handling patterns /simplify focus on TypeScript type safety

Cuándo SÍ: Después de implementar una feature, antes de commit/PR.

Cuándo NO: En código no modificado recientemente — falta contexto de los cambios.

/loop [intervalo] [prompt] Ejecución repetida periódica

Ejecuta un prompt repetidamente. Sin intervalo, Claude se auto-regula. Sin prompt, ejecuta check de mantenimiento o el prompt en .claude/loop.md.

/loop 5m check if the deploy finished /loop 10m run tests and report failures /loop # Mantenimiento autónomo

Alias: /proactive

/debug [descripción] Habilita debug logging y troubleshooting

Habilita debug logging (off por defecto) y lee el log de la sesión para troubleshootear.

/debug /debug the MCP server keeps disconnecting /debug high memory usage after compaction

Diferencia con /doctor: /debug es para errores en tiempo de ejecución. /doctor es para problemas de instalación.

/claude-api [migrate|managed-agents-onboard] Referencia completa de la API de Claude

Carga material de referencia de la API para tu lenguaje (Python, TypeScript, Java, Go, Ruby, C#, PHP, cURL). Se activa automáticamente cuando tu código importa anthropic.

/claude-api # Referencia completa /claude-api migrate # Upgrade de model IDs /claude-api managed-agents-onboard # Setup de Managed Agents
/fewer-permission-prompts Reduce interrupciones de permisos

Escanea transcripts por tool calls de solo lectura comunes (Bash, MCP), luego agrega un allowlist priorizado a .claude/settings.json.

Útil después de varias sesiones cuando ya sabes qué herramientas usas habitualmente.

Comandos custom: el diferenciador de equipos élite

Analogía — El Playbook de la NFL

Todos los equipos tienen las mismas jugadas básicas disponibles. Los equipos élite tienen playbooks propios que explotan las fortalezas específicas de su roster. Los comandos custom son tu playbook: capturas los workflows que SÍ funcionan para tu equipo y los haces reproducibles.

Estructura de archivos

.claude/ # Proyecto (commit a git) └── commands/ ├── review-pr.md # → /review-pr ├── security-audit.md # → /security-audit ├── deploy-staging.md # → /deploy-staging └── db/ └── migration.md # → /db/migration (namespaced) ~/.claude/ # Personal (no en git del proyecto) └── commands/ └── my-standup.md # → /my-standup (solo para ti)
✅ Regla de versioning: Siempre commit .claude/commands/ a git. Los comandos del proyecto son documentación ejecutable accesible a todo el equipo al clonar.

Frontmatter y la variable $ARGUMENTS

--- description: "Review de PR: calidad, tests, convenciones del equipo" allowed-tools: # Evita prompts de permiso en cada ejecución - Bash - Read - Grep --- Abre un PR con título claro y solicita review de @$ARGUMENTS # Invocación: # /review-pr alice → $ARGUMENTS = "alice" # /review-pr alice bob charlie → $ARGUMENTS = "alice bob charlie" # Sin parsing posicional — $ARGUMENTS es el string completo

4 ejemplos de comandos custom de producción

/review-pr [reviewer] Abre PR y solicita review al reviewer especificado
--- description: "Abre PR y solicita review al reviewer especificado" allowed-tools: [Bash, Read] --- Abre un PR para el branch actual con: - Título claro y descriptivo - Resumen de 3 bullets de los cambios - Lista de archivos afectados - Solicitar review de @$ARGUMENTS Usa `gh pr create` con el template del proyecto si existe. Si $ARGUMENTS está vacío, asigna al reviewer del CODEOWNERS.
/db/migration [nombre] Crea una nueva migración de BD con validaciones
--- description: "Crea migración de BD con nombre dado y la valida" allowed-tools: [Bash, Write, Read] --- Crea una nueva migración llamada "$ARGUMENTS": 1. Genera: `alembic revision --autogenerate -m "$ARGUMENTS"` 2. Lee el archivo y verifica que upgrade/downgrade sea correcto 3. Si hay columnas NOT NULL nuevas → añade valor por defecto 4. Corre: `alembic check` para verificar consistencia 5. Reporta: nombre del archivo + resumen de cambios
/deploy-staging Deploy con checklist de seguridad pre-deploy
--- description: "Deploy a staging con checks de seguridad" allowed-tools: [Bash, Read, Grep] --- Antes de deployar a staging, verificar: 1. Tests pasan: `npm test` 2. Sin secrets hardcodeados: `grep -r "api_key\|password" src/` 3. Build compila: `npm run build` Si TODO pasa → ejecutar: `npm run deploy:staging` Luego monitorear logs por 2 minutos. Si ALGÚN check falla → DETENER. No ejecutar el deploy.
/security-audit Auditoría OWASP de archivos modificados
--- description: "Auditoría de seguridad OWASP de cambios pendientes" allowed-tools: [Read, Grep, Bash] --- Audita archivos modificados desde el último commit buscando: - SQL sin sanitizar o queries con interpolación de strings - Contraseñas, tokens, API keys en texto plano - Validación de inputs insuficiente en endpoints - Criptografía débil (MD5, SHA1 para passwords) - XSS: output de usuario sin escapar Por cada hallazgo → archivo, línea, severidad (CRITICAL/HIGH/MEDIUM/LOW), fix sugerido. Si no hay hallazgos → confirmar que se revisaron todos los archivos.

Naming conventions para equipos

PatrónEjemploCuándo usar
Verbo + objeto/review-pr, /run-testsAcciones simples
Namespace/acción/db/migration, /refactor/renameGrupos de comandos
Workflow completo/release-checklist, /incident-responseWorkflows largos multistep
Personal/my-standup, /my-review-styleComandos en ~/.claude/commands/

Anti-patrones en comandos custom

Anti-patrónProblemaSolución
Sin allowed-toolsPrompts de permiso en cada ejecuciónSiempre especificar en frontmatter
Comando >500 palabrasConsume demasiado contextoUn comando, un propósito. Partir en varios
Sin descriptionEl picker es ilegible para el equipoDescription obligatoria en comandos de proyecto
No versionados en gitSe pierden, no se comparten.claude/commands/ siempre en git
Sin condición de "done"Claude no sabe cuándo pararDefinir output esperado y condición de éxito

Atajos de teclado y modos de input

Controles generales

AtajoDescripción
Ctrl+CCancelar input o generación actual
Ctrl+DSalir de Claude Code
Ctrl+G / Ctrl+X Ctrl+EAbrir en editor de texto externo
Ctrl+LRedibujar pantalla
Ctrl+OToggle transcript viewer
Ctrl+RBúsqueda reversa en historial
Ctrl+V / Cmd+VPegar imagen desde clipboard
Ctrl+BEnviar tarea a background
Ctrl+TToggle task list
EscInterrumpir respuesta de Claude
Esc + EscRewind o summarize
Shift+Tab / Alt+MCiclar modos de permisos
Alt+P / Option+PCambiar modelo
Alt+T / Option+TToggle extended thinking
Alt+O / Option+OToggle fast mode

Edición de texto

AtajoDescripción
Ctrl+AInicio de línea
Ctrl+EFin de línea
Ctrl+KBorrar hasta fin de línea
Ctrl+UBorrar desde cursor hasta inicio
Ctrl+WBorrar palabra anterior
Ctrl+YPegar texto borrado
Alt+BRetroceder una palabra
Alt+FAvanzar una palabra

Input multilínea

MétodoAtajoTerminales
Quick escape\ + EnterTodos
Option keyOption+EntermacOS (con Option as Meta)
Shift+EnterShift+EnteriTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal
Control sequenceCtrl+JTodos sin configuración

Vim mode — referencia

Activar: /config → Editor mode → Vim

AspectoComandos
Cambio de modoEsc → NORMAL · i/a/o → INSERT · v/V → VISUAL
Movimientoh/j/k/l · w/e/b · 0/$ · gg/G · f/F+char
Ediciónx · dd · D · cc/C · yy · p/P · u · .
Text objectsiw/aw · i"/a" · i(/a( · i{/a{

Prefijos especiales de input

PrefijoDescripción
/ al inicioComando o skill
! al inicioShell mode — ejecuta y agrega output al contexto
@Autocompletado de rutas de archivos

Casos reales: comandos slash que transforman equipos

Equipo de 3 personas → escala enterprise con spec-driven development B — Joshua McDonald, Medium 2026

Joshua McDonald, fundador con equipo pequeño, usó comandos slash custom para implementar spec-driven development:

.claude/commands/ ├── spec-create.md # /spec-create [feature] → genera especificación técnica ├── spec-implement.md # /spec-implement → implementa basado en spec aprobada ├── spec-review.md # /spec-review → valida implementación vs spec └── release-notes.md # /release-notes → genera notas de release del sprint

Resultado: Equipo de 3 personas gestiona codebase de 150K líneas con calidad comparable a equipo de 15. Los comandos capturan el "cómo" una sola vez — no en la cabeza de cada desarrollador.

/batch para migración de testing library: Jest → Vitest (200 archivos) B — Claude Directory 2026
/batch migrate all test files in src/__tests__/ from Jest to Vitest

Claude descompone en 200 unidades, spawna subagentes en paralelo, cada uno migra ~5 archivos, ejecuta tests, verifica y abre PRs individuales.

Resultado: Migración que tomaba semanas se completa en horas. El comando captura el "cómo migrar" una sola vez — no lo tiene que saber cada dev.

/security-review como gate de CI en empresas fintech C — Comunidad
# .git/hooks/pre-commit /security-review $(git diff --name-only HEAD) # CRITICAL → bloquea commit # HIGH/MEDIUM → warning, permite commit

Resultado: Reducción de vulnerabilidades en producción sin security review manual en cada PR. El comando custom define exactamente qué buscar según las convenciones del equipo.

Toolradar — 20 comandos slash top en producción (2026) B — Toolradar 2026

Los 5 comandos más productivos según uso real de equipos en 2026:

#ComandoImpacto
1/review-prReview completo antes de merge — estándar de equipo
2/test-coverageAnálisis + sugerencias de tests faltantes
3/refactor-moduleRefactorización con preservación de API pública
4/incident-responseChecklist guiado para respuesta a incidentes
5/onboard-codebaseWalkthrough de arquitectura para nuevos devs

Árbol de decisión y honestidad epistémica

¿Qué necesitas hacer? │ ├─── Configurar sesión (modelo, permisos, contexto) │ └─── Built-in: /model · /effort · /compact · /permissions │ ├─── Workflow repetitivo que ya hacías manualmente │ └─── Comando custom en .claude/commands/ │ ¿Aplica a todo el equipo? │ ├─── SÍ → Proyecto (.claude/commands/) + commit a git │ └─── NO → Personal (~/.claude/commands/) │ ├─── Workflow con MCP server específico │ └─── MCP prompt: /mcp__servidor__workflow │ ├─── Cambio masivo (N archivos, misma transformación) │ └─── /batch <instrucción> │ ├─── Pregunta rápida sin contaminar historial │ └─── /btw <pregunta> │ ├─── Shell command rápido con contexto │ └─── !comando │ └─── Review de calidad antes de PR └─── /simplify + /review + /security-review

Honestidad epistémica

[A] Verificado — Docs oficiales Anthropic [B] Ampliamente reportado — Múltiples fuentes técnicas 2026 [C] Heurística comunitaria — Sin estudio controlado