Cap 2: Commands

Qué son los Commands

Los commands controlan Claude Code desde una sesión. Tipeá / para ver todos los disponibles, o / seguido de letras para filtrar. Un command solo se reconoce al inicio del mensaje; el texto que sigue se pasa como argumentos.

Custom commands fusionados con Skills. Un archivo .claude/commands/deploy.md y un skill .claude/skills/deploy/SKILL.md ambos crean /deploy y funcionan igual. Los .claude/commands/ siguen funcionando, pero Skills es el approach recomendado porque suma directorio para archivos de soporte, frontmatter de invocación, y carga automática por Claude. Ver Skills para el formato completo.

Custom commands clásicos

Ubicaciones

Ruta	Alcance	Compartible
.claude/commands/	Proyecto (repo)	Sí, commiteable
~/.claude/commands/	Global (usuario)	No

El nombre del archivo (sin .md) se convierte en el nombre del slash command.

Command básico

<!-- .claude/commands/review-pr.md -->
Revisa el PR actual enfocándote en:
1. Seguridad (inyecciones, XSS, secretos expuestos)
2. Performance (N+1 queries, loops innecesarios)
3. Mantenibilidad (funciones > 50 líneas, código duplicado)

Usa git diff para ver los cambios y comenta cada hallazgo.

Invocar: /review-pr

Frontmatter

Los commands soportan el mismo frontmatter que Skills:

---
description: "Revisa PR enfocándose en seguridad y performance"
argument-hint: "número del PR"
allowed-tools: Read Bash Grep Glob
model: sonnet
---

Revisa el PR #$ARGUMENTS...

Campo	Tipo	Descripción
description	string	Description en autocomplete
argument-hint	string	Hint del argumento esperado
allowed-tools	string/list	Tools pre-aprobados
model	string	sonnet, opus, haiku, inherit
disable-model-invocation	boolean	Solo invocación manual
arguments	string/list	Argumentos posicionales nombrados

Substituciones de string

Variable	Descripción
$ARGUMENTS	Todos los argumentos pasados al command
$ARGUMENTS[N] / $N	Argumento por índice 0-based
$name	Argumento nombrado de arguments frontmatter
${CLAUDE_SESSION_ID}	ID de sesión
${CLAUDE_SKILL_DIR}	Directorio del command/skill (para scripts)

<!-- .claude/commands/explain.md -->
Explica el archivo o función: $ARGUMENTS

Incluye:
- Propósito general
- Parámetros y retorno
- Efectos secundarios
- Ejemplo de uso

Uso: /explain src/utils/auth.ts

Ejecutar shell con !

Inline:

---
argument-hint: "ruta del archivo"
allowed-tools: Bash(bun test *)
---

Ejecuta los tests del archivo y corrige los que fallen:

!`bun test $ARGUMENTS`

El comando se ejecuta antes de que Claude vea el contenido; la salida reemplaza el placeholder.

Multi-línea con fenced block:

## Environment
```!
node --version
npm --version
git status --short
```

Subcarpetas y namespacing

.claude/commands/
├── deploy/
│   ├── staging.md      → /deploy:staging
│   └── production.md   → /deploy:production
├── review/
│   ├── security.md     → /review:security
│   └── performance.md  → /review:performance
└── test-all.md         → /test-all

Subcarpetas usan : como separador.

MCP prompts como commands

Los MCP servers pueden exponer prompts que aparecen como commands con formato /mcp__<server>__<prompt>. Se descubren dinámicamente.

Builtin commands

Lista completa al día de hoy (algunos requieren account/subscription o features experimentales). Los marcados como Skill son bundled skills.

Sesión y contexto

Comando	Descripción
/help	Ayuda y comandos disponibles
/clear	Nueva conversación con contexto vacío. Aliases: /reset, /new
/compact [instrucciones]	Resume la conversación para liberar contexto
/context [all]	Visualiza uso de contexto como grid coloreado
/btw <pregunta>	Side question rápida sin agregar al historial
/recap	Resumen one-line de la sesión actual
/resume [session]	Resumir conversación por ID o nombre. Alias: /continue
/rewind	Volver a un checkpoint anterior. Aliases: /checkpoint, /undo
/branch [nombre]	Crear branch de la conversación. Alias: /fork (cambia con CLAUDE_CODE_FORK_SUBAGENT)
/rename [name]	Renombrar la sesión actual
/export [filename]	Exportar conversación como texto plano
/copy [N]	Copiar la N-ésima última respuesta al clipboard
/diff	Diff viewer interactivo de cambios uncommitted y per-turn

Modelo y effort

Comando	Descripción
/model [modelo]	Cambiar AI model
/effort [level|auto]	Setear effort level: low, medium, high, xhigh, max
/fast [on|off]	Toggle fast mode
/plan [descripción]	Entrar a plan mode directamente
/goal [condición|clear]	Setear meta que Claude persigue entre turnos

Configuración

Comando	Descripción
/init	Inicializa proyecto con CLAUDE.md. Set CLAUDE_CODE_NEW_INIT=1 para flujo interactivo extendido
/memory	Editar CLAUDE.md, enable/disable auto-memory, ver entries
/config	Settings UI (theme, modelo, output style). Alias: /settings
/status	Settings UI tab Status (versión, modelo, cuenta, conectividad)
/permissions	Manejar allow/ask/deny rules. Alias: /allowed-tools
/hooks	Ver configuración de hooks
/mcp	Manejar conexiones MCP y OAuth
/agents	Manejar configuraciones de subagents
/skills	Listar skills. Space para hide a Claude o al / menu
/plugin	Manejar Claude Code plugins
/reload-plugins	Recargar plugins activos sin reiniciar
/output-style	(vía /config) configurar output style
/statusline	Configurar status line
/theme	Cambiar tema (auto, light/dark, daltonized, ANSI, custom)
/color [color|default]	Color del prompt bar
/tui [default|fullscreen]	Setear renderer del TUI
/focus	Toggle focus view (solo en fullscreen)
/scroll-speed	Ajustar velocidad del scroll (fullscreen)
/keybindings	Abrir/crear archivo de keybindings
/terminal-setup	Keybindings de terminal (Shift+Enter, etc.)
/add-dir <path>	Agregar working directory para acceso a archivos

Costos y diagnóstico

Comando	Descripción
/usage	Costo de sesión, plan limits, stats. Aliases: /cost, /stats
/extra-usage	Configurar extra usage para superar rate limits
/doctor	Diagnosticar instalación y settings. f para auto-fix
/insights	Reporte analizando sesiones (áreas, patrones, fricción)
/heapdump	Heap snapshot para diagnosticar memoria alta
/release-notes	Ver changelog con picker de versiones

Background y paralelo

Comando	Descripción
/background [prompt]	Detach sesión a background agent. Alias: /bg
/tasks	Listar background tasks. Alias: /bashes
/stop	Stop background session (solo cuando attached)
/exit	Salir del CLI. Alias: /quit

Review y QA (algunos son Skills)

Comando	Descripción
/review [PR]	Review local de un PR
/security-review	Analiza cambios pendientes por vulnerabilidades
/simplify [focus]	Skill. Revisa archivos recientes por reuso/calidad/eficiencia y aplica fixes
/batch <instrucción>	Skill. Cambios masivos en el codebase paralelizados via worktrees
/debug [descripción]	Skill. Enable debug logging y troubleshoot
/loop [interval] [prompt]	Skill. Correr prompt repetidamente. Alias: /proactive
/claude-api [migrate|managed-agents-onboard]	Skill. Referencia API/SDK; /claude-api migrate upgradea código a modelo nuevo
/fewer-permission-prompts	Skill. Genera allowlist desde transcripts para reducir prompts
/ultraplan <prompt>	Draft plan en sesión ultraplan, review en browser
/ultrareview [PR]	Review profundo multi-agente en cloud sandbox (3 free runs en Pro/Max)

Sesiones remotas y multiplataforma

Comando	Descripción
/desktop	Continuar sesión en Desktop app (macOS/Windows). Alias: /app
/teleport	Traer sesión web al terminal. Alias: /tp
/remote-control	Habilitar control remoto desde claude.ai. Alias: /rc
/remote-env	Configurar environment default para web sessions con --remote
/web-setup	Conectar GitHub a Claude Code on the web
/voice [hold|tap|off]	Toggle voice dictation. Requiere Claude.ai
/mobile	QR code para descargar app móvil. Aliases: /ios, /android
/chrome	Configurar Claude in Chrome
/ide	Manejar integraciones IDE y status

GitHub y scheduling

Comando	Descripción
/install-github-app	Setup Claude GitHub Actions app
/install-slack-app	Instalar Slack app
/autofix-pr [prompt]	Spawn sesión web que vigila el PR y empuja fixes cuando CI falla
/schedule [descripción]	Crear routines en cron. Alias: /routines

Onboarding y misc

Comando	Descripción
/team-onboarding	Generar guía de onboarding desde tu historial de uso
/powerup	Lecciones interactivas con demos animados
/sandbox	Toggle sandbox mode
/passes	Compartir semana free de Claude Code (cuentas eligibles)
/upgrade	Página para upgrade de plan
/login	Sign in
/logout	Sign out
/privacy-settings	Settings de privacidad (Pro/Max)
/feedback [report]	Reportar feedback. Alias: /bug
/radio	Claude FM lo-fi radio en el browser
/stickers	Pedir stickers
/setup-bedrock	Wizard de Amazon Bedrock (con CLAUDE_CODE_USE_BEDROCK=1)
/setup-vertex	Wizard de Google Vertex AI (con CLAUDE_CODE_USE_VERTEX=1)

Algunos comandos removidos en versiones recientes: /vim (removed en 2.1.92 — usar /config → Editor mode), /pr-comments (removed en 2.1.91 — pedirle a Claude directamente que vea los PR comments).

Built-in commands disponibles via Skill tool

Algunos builtin se exponen via el Skill tool y Claude puede invocarlos:

• /init
• /review
• /security-review

Otros como /compact NO están disponibles via Skill tool.

Ejemplo: Command de deploy

<!-- .claude/commands/deploy/staging.md -->
---
description: "Deploy a staging con verificación"
allowed-tools: Bash Read
disable-model-invocation: true
---

Ejecuta el deploy a staging:

1. Verificar que no hay cambios sin commitear
2. Ejecutar los tests
3. Construir el proyecto
4. Desplegar

!`git status --porcelain`
!`bun test`
!`bun build`

---

Siguiente: Sub-Agents