32blogby StudioMitsu

Guía de comandos de Claude Code — Referencia completa

Todos los comandos slash, flags CLI y atajos de teclado de Claude Code organizados por frecuencia de uso real. Más de 50 comandos cubiertos con la documentación oficial como única fuente.

22 min read
Contenido

Este artículo cubre cada comando, atajo y flag CLI de Claude Code — organizados por la frecuencia con la que realmente se usan. Todo aquí proviene de la documentación oficial de Anthropic y está verificado contra v2.1.72 (marzo 2026).

Top 10 de comandos que usarás cada día

Estos son los comandos que uso a diario. Aprende estos diez y podrás manejar la mayoría de los flujos de trabajo.

1. /compact — Comprimir contexto

bash
/compact
/compact Enfócate en las definiciones de tipos TypeScript

Comprime la conversación cuando la ventana de contexto se alarga. Opcionalmente puedes indicar en qué enfocarse. Es esencial para sesiones largas y reduce directamente el consumo de tokens.

¿Cuándo usarlo? Después de más de 30 minutos en una sesión, o en cuanto veas el aviso "context is getting large". Durante un refactor, prueba /compact Enfócate en el módulo de auth y los fallos de test actuales para conservar el contexto más relevante tras la compresión.

2. /model — Cambiar de modelo

bash
/model sonnet
/model opus

Cambia entre modelos según la tarea — Sonnet para investigación, Opus para escritura y razonamiento complejo. En la pantalla de selección, usa las flechas izquierda/derecha para ajustar el nivel de esfuerzo (profundidad de pensamiento). Los cambios surten efecto inmediatamente sin interrumpir la respuesta actual.

En la práctica: Usa Sonnet para exploración de archivos y búsquedas grep, luego cambia a Opus para decisiones arquitectónicas e implementación de código. El atajo Alt+P te permite cambiar de modelo sin borrar tu prompt actual — útil cuando empiezas a escribir y te das cuenta de que necesitas un modelo más capaz.

3. /cost — Consultar consumo de tokens

bash
/cost
/stats

/cost muestra el consumo de tokens API de la sesión actual. Sin embargo, los suscriptores Pro/Max no verán /cost — está diseñado para usuarios de API. Si tienes un plan Pro, usa /stats en su lugar para ver el uso diario, historial de sesiones y rachas.

Crea el hábito: Revisa tu consumo de tokens antes de terminar cada sesión. Los usuarios de API usan /cost, los de Pro usan /stats. Una vez que sabes "esta tarea usó X recursos", puedes tomar mejores decisiones la próxima vez — como "esta parte se podría haber hecho con Sonnet en vez de Opus".

4. /diff — Revisar cambios

bash
/diff

Abre un visor interactivo de diffs. Usa las flechas izquierda/derecha para alternar entre git diff y diffs por turno de Claude, y arriba/abajo para navegar entre archivos. Esencial antes de hacer commit.

Buena práctica: Después de pedirle a Claude que refactorice un módulo, ejecuta /diff antes de hacer commit. Cambia a "per-turn diffs" para ver qué cambió en cada paso — esto facilita detectar modificaciones no deseadas que pueden colarse en refactors grandes.

5. /clear — Reiniciar contexto

bash
/clear

Limpia el historial de conversación y libera contexto. También disponible como /reset o /new. Úsalo en las fronteras entre tareas para ahorrar tokens en la siguiente.

/compact vs /clear: /compact resume y mantiene el contexto (conserva el conocimiento). /clear es un reinicio total (empezar de cero). Usa /clear cuando cambias a una tarea completamente diferente en el mismo proyecto. Usa /compact cuando continúas la misma tarea pero el contexto se está haciendo pesado.

6. Shift+Tab — Alternar modos de permisos

Pulsa Shift+Tab para ciclar entre el modo Auto-Accept, Plan Mode y el modo normal.

  • Modo normal: Pide confirmación antes de cada ejecución de herramienta
  • Auto-Accept: Ejecuta todas las herramientas sin confirmación (para tareas de confianza)
  • Plan Mode: Acceso de solo lectura. Los cambios de código se proponen como planes y requieren aprobación antes de ejecutarse

Alt+M hace lo mismo.

Flujo de trabajo práctico: Mantén Auto-Accept activado para escribir tests o generar boilerplate. Cambia a Plan Mode al tocar archivos críticos de producción (configs de despliegue, package.json, migraciones de BD). El flujo "mostrar plan → aprobar → ejecutar" previene accidentes.

7. ! — Modo Bash

bash
! npm test
! git status
! ls -la

Prefija la entrada con ! para ejecutar comandos bash directamente. Se ejecuta sin la interpretación de Claude, y la salida se añade al contexto de la conversación. Pulsa Tab para autocompletar comandos ! anteriores.

¿Por qué es útil?: Ejecutar git status a través de Claude significa que interpreta → ejecuta → explica — tres pasos. ! git status se ejecuta directamente y la salida simplemente entra al contexto. Úsalo cuando quieras que Claude vea la salida pero no necesites que interprete el comando en sí.

8. /resume — Reanudar sesiones

bash
/resume
/resume auth-refactor

Reanuda una sesión pasada por ID o nombre. Sin argumentos, abre un selector de sesiones. Alias: /continue. Desde la CLI, usa claude -c (más reciente) o claude -r "nombre".

Ejemplo de flujo de trabajo: Pausas el desarrollo de una feature para atender un hotfix. Después del fix, /resume para abrir el selector y volver a la sesión de desarrollo. Nombra tus sesiones con /rename auth-refactor para encontrarlas fácilmente después.

9. /memory — Gestionar CLAUDE.md

bash
/memory

Edita los archivos de memoria CLAUDE.md, activa o desactiva la auto-memoria. La función central para mantener reglas de proyecto y contexto entre sesiones.

¿Qué poner ahí? Reglas como "usar Vitest para tests", "CSS con Tailwind v4", "validar respuestas de API con Zod". Cualquier decisión de stack técnico o convenciones de código específicas del proyecto que de otra forma repetirías en cada sesión.

10. @ — Autocompletado de rutas de archivo

Escribe @ durante la entrada para activar el autocompletado de rutas de archivo. Útil al referenciar archivos específicos en tus preguntas.

Ejemplo: @src/components/Header.tsx Arregla el layout responsive — Claude sabe exactamente qué archivo revisar sin buscar. Ahorra tokens y obtiene resultados más rápidos.

Gestión de sesiones

Comandos para iniciar, terminar, reanudar y bifurcar sesiones. Se vuelven esenciales cuando manejas múltiples tareas en paralelo.

ComandoDescripción
/clearLimpia la conversación y libera contexto. Aliases: /reset, /new
/resume [sesión]Reanuda por ID o nombre. Alias: /continue
/fork [nombre]Crea un fork de la conversación en este punto
/rename [nombre]Renombra la sesión. Omite el nombre para auto-generación
/export [archivo]Exporta la conversación como texto plano
/exitSale de la CLI. Alias: /quit

Gestión de costes y rendimiento

Comandos para consumo de tokens y configuración de modelos. Dominar estos seis comandos es lo más importante para mantener tu factura de Claude Code bajo control.

ComandoDescripción
/costMuestra estadísticas de uso de tokens
/compact [instrucciones]Comprime la conversación con instrucciones de enfoque opcionales
/model [modelo]Selecciona o cambia de modelo. Flechas izq/der ajustan el nivel de esfuerzo
/fast [on|off]Alterna el modo rápido. Mismo modelo Opus 4.6 con salida más rápida
/usageMuestra límites de uso del plan y estado de rate limit
/extra-usageConfigura uso extra cuando se alcanzan los rate limits

Operaciones de código y revisión

Revisión de cambios, retroceso y comprobación de seguridad. Siempre revisa antes de hacer commit — especialmente después de pedirle a Claude que haga cambios a gran escala.

ComandoDescripción
/diffVisor interactivo de diffs (git diff + diffs por turno)
/rewindRetrocede la conversación y el código a un punto anterior. Alias: /checkpoint
/security-reviewAnaliza los cambios del branch actual en busca de vulnerabilidades
/copyCopia la última respuesta al portapapeles con selector de bloques de código
/planEntra en Plan Mode directamente desde el prompt

Configuración del proyecto

Inicialización del proyecto, configuración y gestión de permisos.

ComandoDescripción
/initInicializa el proyecto con una guía CLAUDE.md
/memoryEdita archivos de memoria CLAUDE.md y configuración de auto-memoria
/configAbre la UI de configuración (pestaña Config). Alias: /settings
/permissionsVer o actualizar permisos. Alias: /allowed-tools
/hooksGestiona configuraciones de hooks para eventos de herramientas
/agentsGestiona configuraciones de subagentes
/pluginGestiona plugins de Claude Code
/reload-pluginsRecarga todos los plugins activos sin reiniciar
/skillsLista las skills disponibles
/keybindingsAbre o crea el archivo de configuración de keybindings

Integraciones externas

Integraciones con IDE, navegador, GitHub y sesiones remotas. La función /remote-control es especialmente interesante — te permite controlar tu Claude Code local desde claude.ai, lo que significa que puedes dirigir el trabajo desde tu móvil cuando no estás en tu escritorio.

ComandoDescripción
/mcpGestiona conexiones de servidores MCP y autenticación OAuth
/ideGestiona integraciones con IDE y muestra el estado
/chromeConfigura la integración con Chrome (automatización web y testing)
/remote-controlHabilita control remoto desde claude.ai. Alias: /rc
/remote-envConfigura el entorno remoto por defecto para sesiones teleport
/pr-comments [PR]Obtiene y muestra comentarios de PR de GitHub. Requiere gh CLI
/install-github-appConfigura la app Claude GitHub Actions para un repositorio
/install-slack-appInstala la app Claude Slack

Atajos de teclado

Algunas teclas difieren según el SO y el terminal. Cambia de pestaña para ver tu plataforma.

Controles generales (Windows / WSL)

AtajoDescripción
Ctrl+CCancelar entrada o generación actual
Ctrl+DSalir de la sesión de Claude Code
Ctrl+LLimpiar pantalla del terminal (conserva historial de conversación)
Ctrl+GAbrir en editor de texto predeterminado
Ctrl+OAlternar salida verbose
Ctrl+RBúsqueda inversa en historial de comandos
Ctrl+BPoner tareas en segundo plano (usuarios de tmux: pulsar dos veces)
Ctrl+TAlternar visibilidad de lista de tareas
Ctrl+FTerminar todos los agentes en segundo plano (pulsar dos veces en 3 segundos)
Alt+VPegar imagen del portapapeles
Shift+Tab / Alt+MAlternar modos de permisos
Alt+PCambiar de modelo
Alt+TAlternar pensamiento extendido (ejecuta /terminal-setup primero)
Esc + EscRetroceder o resumir
/ Navegar historial de comandos
/ Ciclar entre pestañas de diálogo

Usuarios de WSL: En Windows Terminal, Shift+Enter puede no funcionar de fábrica. Ejecuta /terminal-setup para instalar el keybinding. Al usar @ para rutas de archivos, usa rutas WSL como /mnt/c/....

Edición de texto (Windows / WSL)

AtajoDescripción
Ctrl+KEliminar hasta el final de la línea
Ctrl+UEliminar línea completa
Ctrl+YPegar texto eliminado
Alt+Y (después de Ctrl+Y)Ciclar historial de pegado
Alt+BMover cursor una palabra atrás
Alt+FMover cursor una palabra adelante

Entrada multilínea (Windows / WSL)

MétodoAtajoNotas
Escape rápido\ + EnterFunciona en todos los terminales
Shift+EnterShift+EnterFunciona en WezTerm, Ghostty, Kitty
Secuencia de controlCtrl+JCarácter de salto de línea
Modo pegadoPegar directamentePara bloques de código y logs

Para Windows Terminal, VS Code y otros, ejecuta /terminal-setup para instalar el binding de Shift+Enter.

Flags CLI

Flags que puedes especificar al lanzar Claude Code. Especialmente importantes para scripting y automatización.

Casos de uso comunes:

bash
# Obtener un resumen del repo en un comando y guardarlo en archivo
claude -p "Explica la estructura de este repositorio" > repo-overview.txt

# Trabajar en un git worktree aislado sin afectar tu branch principal
claude -w experimental-feature

# Automatizar revisión de código en CI/CD
claude -p --output-format json --max-turns 5 "Revisa este PR"

# Permitir solo herramientas de lectura para análisis automatizado seguro
claude -p --allowedTools "Read" "Grep" "Glob" "Encuentra problemas en este código"

Flags de uso frecuente

FlagDescripciónEjemplo
--modelEstablecer modelo (sonnet, opus, o nombre completo)claude --model opus
--print, -pImprimir respuesta sin modo interactivoclaude -p "explica esto"
--continue, -cContinuar la conversación más recienteclaude -c
--resume, -rReanudar sesión por ID o nombreclaude -r "auth-refactor"
--worktree, -wIniciar en git worktree aisladoclaude -w feature-auth
--allowedToolsHerramientas que se ejecutan sin pedir permiso--allowedTools "Bash(git log *)" "Read"
--append-system-promptAñadir instrucciones al prompt por defecto--append-system-prompt "Usa TypeScript"

Flags de automatización y SDK

FlagDescripción
--output-formatFormato de salida (text, json, stream-json). Esencial para scripting
--input-formatFormato de entrada (text, stream-json)
--json-schemaObtener JSON validado contra un esquema (solo modo print)
--max-turnsLimitar turnos del agente (solo modo print)
--max-budget-usdGasto máximo de API (solo modo print)
--fallback-modelAuto-fallback cuando el modelo por defecto está sobrecargado (solo modo print)
--no-session-persistenceDesactivar guardado de sesiones (solo modo print)
--include-partial-messagesIncluir eventos parciales de streaming en la salida

Flags de seguridad y permisos

FlagDescripción
--permission-modeIniciar en modo de permisos especificado
--dangerously-skip-permissionsSaltar todos los prompts de permisos (usar con precaución)
--allow-dangerously-skip-permissionsHabilitar la opción de bypass de permisos
--permission-prompt-toolHerramienta MCP para manejar prompts de permisos en modo no interactivo
--sandboxAlternar modo sandbox
--toolsRestringir herramientas disponibles ("" para desactivar todas, "default" para todas)
--disallowedToolsEliminar herramientas del contexto del modelo

Flags de prompt y configuración

FlagDescripción
--system-promptReemplazar todo el system prompt
--system-prompt-fileCargar system prompt desde archivo (reemplaza el por defecto)
--append-system-promptAñadir al prompt por defecto (recomendado)
--append-system-prompt-fileAñadir contenido de archivo al prompt por defecto
--agentEspecificar agente para la sesión actual
--agentsDefinir subagentes personalizados dinámicamente vía JSON
--settingsCargar configuración desde archivo JSON o string
--setting-sourcesFuentes de configuración separadas por comas (user, project, local)
--mcp-configCargar servidores MCP desde archivos JSON
--strict-mcp-configUsar solo servidores MCP de --mcp-config

Otros flags

FlagDescripción
--add-dirAñadir directorios de trabajo adicionales
--chrome / --no-chromeActivar o desactivar integración con Chrome
--debugModo debug (filtro por categoría: "api,hooks")
--disable-slash-commandsDesactivar todas las skills y comandos
--fork-sessionCrear nuevo ID de sesión al reanudar
--from-prReanudar sesiones vinculadas a un PR de GitHub
--ideAuto-conectar al IDE si hay exactamente uno disponible
--init / --init-onlyEjecutar hooks de inicialización (--init-only sale sin sesión)
--maintenanceEjecutar hooks de mantenimiento y salir
--plugin-dirCargar plugins desde directorios para esta sesión
--remoteCrear sesión web en claude.ai
--session-idUsar ID de sesión específico (formato UUID)
--teammate-modeModo de visualización de equipo de agentes (auto, in-process, tmux)
--teleportReanudar sesión web en terminal local
--betasIncluir headers beta en peticiones API
--verboseActivar logging verbose
--version, -vMostrar número de versión

Referencia completa de comandos

Lista alfabética de cada comando slash disponible en Claude Code. Algunos comandos pueden no ser visibles dependiendo de tu plan, plataforma o entorno.

ComandoAliasesDescripción
/add-dir <ruta>Añadir directorio de trabajo a la sesión actual
/agentsGestionar configuraciones de subagentes
/btw <pregunta>Pregunta lateral sin añadir a la conversación. Funciona mientras Claude está ocupado
/chromeConfigurar integración con Chrome
/clear/reset, /newLimpiar historial de conversación y liberar contexto
/compact [instrucciones]Comprimir conversación con enfoque opcional
/config/settingsAbrir UI de configuración (pestaña Config)
/contextVisualizar uso de contexto como cuadrícula de colores
/copyCopiar última respuesta al portapapeles
/costMostrar estadísticas de uso de tokens
/desktop/appContinuar sesión en la app de escritorio (solo macOS/Windows)
/diffAbrir visor interactivo de diffs
/doctorDiagnosticar instalación y configuración
/exit/quitSalir de la CLI
/export [archivo]Exportar conversación como texto plano
/extra-usageConfigurar uso extra para rate limits
/fast [on|off]Alternar modo rápido
/feedback [reporte]/bugEnviar feedback
/fork [nombre]Bifurcar conversación en el punto actual
/helpMostrar ayuda y comandos disponibles
/hooksGestionar configuraciones de hooks para eventos de herramientas
/ideGestionar integraciones con IDE y estado
/initInicializar proyecto con CLAUDE.md
/insightsGenerar informe de análisis de sesión
/install-github-appConfigurar app Claude GitHub Actions
/install-slack-appInstalar app Claude Slack
/keybindingsAbrir o crear archivo de configuración de keybindings
/loginIniciar sesión en cuenta Anthropic
/logoutCerrar sesión
/mcpGestionar conexiones de servidores MCP y OAuth
/memoryEditar archivos CLAUDE.md y configuración de auto-memoria
/mobile/ios, /androidMostrar código QR para descargar la app móvil
/model [modelo]Seleccionar o cambiar modelo. Flechas ajustan nivel de esfuerzo
/output-style [estilo]Cambiar estilo de salida (Default/Explanatory/Learning)
/passesCompartir semana gratis con amigos (solo cuentas elegibles)
/permissions/allowed-toolsVer o actualizar permisos
/planEntrar en Plan Mode directamente
/pluginGestionar plugins
/pr-comments [PR]Obtener y mostrar comentarios de PR de GitHub
/privacy-settingsVer/actualizar configuración de privacidad (solo Pro/Max)
/release-notesVer changelog completo
/reload-pluginsRecargar todos los plugins activos sin reiniciar
/remote-control/rcHabilitar control remoto desde claude.ai
/remote-envConfigurar entorno remoto por defecto para teleport
/rename [nombre]Renombrar sesión (omitir para auto-generación)
/resume [sesión]/continueReanudar sesión por ID o nombre
/reviewDeprecado. Usar plugin code-review
/rewind/checkpointRetroceder conversación y código a punto anterior
/sandboxAlternar modo sandbox (solo plataformas compatibles)
/security-reviewAnalizar cambios del branch en busca de vulnerabilidades
/skillsListar skills disponibles
/statsVisualizar uso diario, sesiones y rachas
/statusMostrar versión, modelo, cuenta y conectividad
/statuslineConfigurar línea de estado
/stickersPedir stickers de Claude Code
/tasksListar y gestionar tareas en segundo plano
/terminal-setupConfigurar keybindings del terminal (Shift+Enter etc.)
/themeCambiar tema de colores
/upgradeAbrir página de upgrade (solo Pro/Max)
/usageMostrar uso del plan y rate limits
/vimAlternar entre modos de edición Vim y Normal

Los servidores MCP pueden exponer prompts como comandos en el formato /mcp__<servidor>__<prompt>, descubiertos dinámicamente desde los servidores conectados.

Las skills incluidas como /simplify, /batch y /debug también aparecen junto a los comandos integrados cuando escribes /. También puedes crear tus propias skills.

Conclusión

Claude Code tiene más de 50 comandos, pero usarás unos 10 a diario. Empieza con /compact, /model y /cost para crear el hábito de ser consciente de los tokens y costes.

A medida que te sientas cómodo, expande a /diff para revisiones pre-commit, /fork para ramas experimentales y /btw para preguntas rápidas laterales sin romper tu flujo.

Para los flags CLI, conocer --print y --output-format json abre posibilidades de scripting en shell e integración con CI/CD.

Documentación oficial: CLI Reference | Interactive Mode