Los comandos integrados de Claude Code

Tiempo: unos 20 min de lectura + 20 min de práctica

Lo esencial

Los comandos integrados de Claude Code son el tablero de mando del piloto. La mayoría de la gente vuela en piloto automático y nunca mira los instrumentos. Pero cuando sabes qué hace cada interruptor, eres el piloto y no un pasajero.

Conceptos clave

• Los comandos integrados controlan el comportamiento del agente; no modifican los archivos del proyecto
• Los modos de trabajo cambian el equilibrio entre autonomía y control
• El modo correcto para la tarea = menos preguntas de más y menos riesgo

Teoría

Comandos de diagnóstico

🎨 Imagínalo así: los comandos integrados son los pedales y las palancas de la cabina. Acelerador, freno, cambio de velocidades. La mayoría de los conductores solo pisa el acelerador. Pero el piloto conoce cada interruptor, y eso es justo lo que lo hace piloto.

/clear

Qué hace: borra el historial de la conversación actual con el agente.

Qué NO hace: no borra los archivos del proyecto, los workflows ni las herramientas: nada del sistema de archivos.

Cuándo usarlo:

• La conversación se alargó y el agente empieza a "olvidar" el contexto
• Cambias a una tarea completamente distinta
• /context mostró que el historial ocupa más del 70% de la ventana de contexto
• El agente empezó a dar respuestas raras: "empezar de cero" ayuda

Si te arrepientes: puedes recuperar la conversación anterior con el comando /resume. Al comando le puedes dar un nombre (/clear nombre), y así es más fácil encontrar la conversación anterior en la lista.

Ejemplo de uso:

/clear

Trabajaste 2 horas en el workflow del newsletter y ahora quieres crear un workflow nuevo para análisis SEO. Escribes /clear: el agente "olvida" el newsletter y empieza en blanco. Los archivos del newsletter siguen ahí.

/compact

🎨 Imagínalo así: /compact es como los apuntes de una clase. La clase duró 2 horas; los apuntes son 2 páginas. Todo lo clave está ahí, sin relleno. Sigues estudiando con los apuntes, no con la grabación.

Qué hace: comprime el historial de la conversación de forma inteligente. Conserva las decisiones clave y el contexto, y quita los detalles.

En qué se diferencia de /clear: /clear empieza una conversación nueva con el contexto vacío. /compact comprime: Claude recuerda en qué estaban trabajando, pero libera la mayor parte del contexto. Puedes indicarle a la compresión qué conservar: /compact conserva las decisiones sobre la base de datos.

Cuándo usarlo:

• /context muestra que está lleno en más del 60%
• Quieres seguir con la tarea actual, no empezar de nuevo
• El agente empieza a "trabarse" un poco: la primera señal de saturación

Ejemplo de uso:

/compact

Antes: la ventana de contexto está llena al 78%. Después: más o menos al 22%. Sigues trabajando con la cabeza fresca.

/context

Qué hace: muestra un mapa del uso de tokens en la sesión actual.

Qué ves: un mapa de colores de cómo se llena la ventana: qué ocupa espacio (el prompt del sistema, las herramientas MCP, los archivos de memoria, el historial de la conversación) y sugerencias de qué se puede aligerar.

Cuándo usarlo:

• La sesión va lenta y buscas qué está sobrecargando el contexto
• Planeas agregar un MCP y revisas si hay espacio
• Como diagnóstico regular en sesiones largas (más de 1 hora de trabajo)

Más sobre tokens y contexto en la lección Tokens y manejo del contexto.

/statusline

Qué hace: configura la barra de estado, que se queda fija abajo y muestra las métricas que te interesan. Describes con palabras lo que quieres ver, o lo ejecutas sin argumentos y Claude arma la barra según cómo se ve tu terminal.

Qué puedes mostrar: el modelo en uso, qué tan lleno está el contexto, la rama de git y otros datos de la sesión.

Cuándo sirve: cuando trabajas mucho tiempo en una misma sesión y quieres ver el llenado del contexto sin escribir comandos. Si necesitas el costo y los límites de tu plan, para eso está /usage (el comando /cost es su sinónimo).

Comandos para administrar componentes

/init

Qué hace: analiza automáticamente la estructura de un proyecto existente y crea un CLAUDE.md a partir de lo que ve.

Cuándo usarlo:

• Te sumas a un proyecto ajeno que no tiene CLAUDE.md
• Quieres generar un CLAUDE.md básico y luego afinarlo
• Empiezas un proyecto nuevo desde cero y quieres una plantilla inicial

Importante: /init crea un borrador, no el CLAUDE.md final. Hay que revisarlo y ajustarlo a tus necesidades (el rol del agente, instrucciones específicas).

/agents

Qué hace: te recuerda cómo administrar subagentes. Antes el comando abría un asistente de creación; ahora ese asistente ya no existe.

Cómo crear un subagente ahora:

• Pídeselo a Claude: "crea un subagente para revisar textos"
• O pon un archivo en la carpeta .claude/agents/ del proyecto (o en ~/.claude/agents/ para todos los proyectos)
• Para ver qué sesiones en segundo plano están corriendo, usa el comando claude agents en la terminal

Más sobre subagentes en la lección Subagentes.

/plugin y /skills

Qué hacen: /skills muestra la lista de skills disponibles (puedes filtrarlas por nombre). /plugin administra los plugins: paquetes que contienen skills, hooks, subagentes y MCP.

Acciones principales:

• /skills: mostrar todas las skills disponibles
• /plugin: abrir el menú de plugins
• /plugin list: mostrar los plugins instalados
• /plugin install <nombre>: instalar un plugin del marketplace
• /plugin enable <nombre> y /plugin disable <nombre>: activar y desactivar

Más sobre skills en las lecciones Qué son las Skills, Creamos una skill desde cero y Arquitectura de skills.

/loop

Qué hace: ejecuta una tarea de forma repetida con un intervalo definido.

Sintaxis: /loop <intervalo> <comando>

Ejemplos:

/loop 5m /check-server-health
/loop 1h /daily-digest
/loop 10m revisa si ya terminó el despliegue

Cuándo usarlo:

• Monitorear un proceso que toma tiempo (un despliegue, un procesamiento por lotes)
• Revisiones periódicas mientras tú haces otra cosa
• Probar un horario antes de pasarlo a la nube

Importante: /loop funciona mientras la sesión de Claude Code esté abierta. Si no indicas el intervalo, Claude elige la pausa entre repeticiones. Para un horario permanente que siga corriendo con la computadora apagada están las rutinas (routines) en la nube, con el comando /schedule, o servicios externos como Trigger.dev. Más detalles en la lección Loop vs. Scheduled Tasks.

Los modos de trabajo del agente

Esta es quizá la parte más importante de la lección en la práctica. Los modos de permisos cambian cómo toma decisiones el agente y qué hace sin tu intervención. Se cambian con Shift+Tab (en círculo) o con una opción al arrancar: claude --permission-mode <modo>. Los nombres en la interfaz y en la configuración son un poco distintos; abajo van los dos. La lista vigente de modos está en la documentación de Claude Code: cambia de una versión a otra.

Plan Mode (modo de planeación)

🎨 Imagínalo así: Plan Mode es el arquitecto que dibuja el plano antes de la obra. Los albañiles (los demás modos) trabajarán después siguiéndolo. Sin plano, los albañiles hacen lo que se les ocurre. Con plano, hacen lo que tú necesitas.

Cómo activarlo: Shift+Tab (hasta llegar al modo plan), el comando /plan (puedes darle la tarea de una vez: /plan arregla el inicio de sesión) o arrancar con claude --permission-mode plan

Qué pasa: el agente analiza la tarea y arma un plan detallado, sin ejecutarlo. Ves la lista de pasos, los archivos que se van a modificar y los posibles riesgos.

Cuándo usarlo:

• Una tarea compleja que quieres entender antes de ejecutarla
• Operaciones riesgosas (migración de datos, una refactorización grande)
• Para aprender: quieres entender cómo va a actuar el agente
• Tienes que explicarle al cliente qué se va a hacer exactamente

Ejemplo: "Crea un sistema de análisis de ventas conectado a Google Sheets con reportes diarios automáticos" → el agente arma un plan de 12 pasos con la descripción de cada uno. Lo revisas, lo ajustas y luego dices "adelante".

Manual (modo de confirmación; en la configuración, default)

Cómo activarlo: Shift+Tab o claude --permission-mode default

Qué pasa: el agente lee archivos libremente, pero antes de modificar un archivo o ejecutar un comando te muestra qué va a hacer exactamente y te pide confirmación.

Cuándo usarlo:

• Trabajas en un proyecto en producción donde un error sale caro
• Estás aprendiendo y quieres entender cada paso
• Una refactorización importante en la que necesitas control
• Es la primera vez que trabajas con un código que no conoces

Cuándo sobra: en trabajo rutinario con tareas claras, el modo frena el proceso sin aportar nada.

acceptEdits (aceptar cambios automáticamente)

Cómo activarlo: Shift+Tab

Qué pasa: el agente edita archivos y ejecuta comandos de archivos sencillos (crear una carpeta, mover, copiar) sin preguntar. Los demás comandos siguen pidiendo confirmación. Tú ves el resultado.

Cuándo usarlo:

• Una tarea clara con un agente en el que confías
• Iteraciones cuando ya entendiste lo que hace el agente
• Tareas de contenido (escribir textos, crear archivos)
• Un proceso rutinario que ya se hizo muchas veces

auto (modo automático con revisión)

Cómo activarlo: Shift+Tab; en las versiones nuevas de Claude Code (desde la 2.1.283, a octubre de 2026) es el modo inicial en la terminal y en VS Code, así que muchas veces ya está activado

Qué pasa: el agente trabaja sin preguntar y, en tu lugar, un segundo modelo clasificador revisa cada acción. Las acciones peligrosas las detiene.

Cuándo usarlo:

• Tareas largas en las que te cansarías de confirmar cada paso
• Cuando quieres avanzar, pero la libertad total te da miedo

Importante: el modo automático requiere un modelo compatible, y una organización puede desactivarlo. Si tu plan no lo tiene, te quedan Manual y acceptEdits.

dontAsk (solo lo permitido de antemano)

Qué pasa: el agente hace solo lo que permitiste de antemano en la configuración; todo lo demás lo rechaza en silencio, sin hacer preguntas.

Cuándo usarlo: scripts y CI, donde no hay una persona y la lista de acciones permitidas se conoce con precisión.

Bypass Permissions (confianza total)

🎨 Imagínalo así: Bypass Permissions es como darle las llaves del departamento a una cuadrilla de albañiles e irte de vacaciones. Si la cuadrilla es de confianza y la tarea es clara, está bien. Si la cuadrilla es desconocida y la tarea es vaga, regresas a un caos.

Cómo activarlo: la opción de arranque --dangerously-skip-permissions (lo mismo que --permission-mode bypassPermissions)

Qué pasa: el agente obtiene permisos completos para todas las operaciones sin confirmaciones. Incluidas las operaciones potencialmente destructivas.

Cuándo usarlo:

• Solo dentro de un entorno aislado: un contenedor o una máquina virtual donde no hay nada que romper
• Pipelines automatizados donde no hay una persona (para ellos también existe el modo dontAsk, más estricto)
• Cuando entiendes por completo lo que hace el agente

Advertencia: no uses este modo para experimentos ni para tareas desconocidas en tu propia computadora. El agente puede borrar archivos, sobrescribir datos y hacer operaciones irreversibles.

Tabla resumen de los modos

Práctica

Tarea: un recorrido por los modos

Toma una tarea sencilla: "Crea el archivo README.md del proyecto newsletter-automation con una descripción breve de lo que hace el proyecto y cómo ejecutarlo".

1. Ejecútala en Plan Mode: estudia el plan, mira qué piensa hacer el agente
2. Aprueba el plan: Claude saldrá del modo de planeación y empezará a trabajar
3. Mira el resultado. Ahora di "ahora agrega una sección de preguntas frecuentes con 3 preguntas"
4. Cambia a Manual (Shift+Tab) y pide que agregue otra sección. Observa cómo el agente pide permiso
5. Ejecuta /context: mira cuántos tokens se usaron
6. Ejecuta /clear: empieza una sesión limpia

Objetivo: sentir en la práctica, y no en teoría, la diferencia entre los modos.

Tabla completa de comandos integrados

Herramientas y recursos

• Lista de comandos de Claude Code: la documentación completa de los comandos
• Modos de permisos: qué permite cada modo
• Configuración de Claude Code: ajustes de comportamiento y permisos
• /clear: una conversación nueva con el contexto vacío
• /compact: compresión inteligente (mejor que /clear cuando quieres seguir)
• /context: auditoría de tokens
• /statusline: barra de estado
• /init: generar CLAUDE.md
• /agents: indicaciones sobre subagentes
• /plugin y /skills: plugins y skills
• /loop: tareas repetidas
• Plan Mode: planear antes de ejecutar

Precios y versiones vigentes: Lo vigente.

Errores comunes

Error 1: No conocer /compact Usas solo /clear y empiezas de cero cada vez. /compact comprime el historial y conserva las decisiones clave. Usa /compact al 60% de llenado; /clear, solo al cambiar a otra tarea.

Error 2: Bypass Permissions para experimentar --dangerously-skip-permissions en un proyecto de trabajo, y el agente borró por accidente archivos importantes. Este modo es solo para un entorno aislado (un contenedor, una máquina virtual), donde no hay una persona y no hay nada que perder.

Error 3: Ignorar Plan Mode en tareas complejas De entrada "hazlo" en lugar de "primero muéstrame el plan". El agente se fue por otro lado, gastó 15 minutos y el resultado no es el que querías. Plan Mode no cuesta nada: 2 minutos de plan te ahorran 30 minutos de rehacer.

🎨 Imagínalo así: saltarte Plan Mode en una tarea compleja es como pedirles a los albañiles "hagan algo bonito" sin un boceto. Van a hacer algo bonito. Pero no lo que tú querías.

Lecciones relacionadas

• Modos de trabajo: más sobre Plan Mode y los otros modos de permisos
• Tokens y manejo del contexto: cómo /context te ayuda a controlar el costo y el rendimiento
• Context Rot y 28 técnicas contra la degradación: 28 técnicas basadas en /compact, /clear y /context
• Manejo del contexto: técnicas avanzadas: manejo avanzado del contexto para proyectos complejos

Ideas clave

Los modos de trabajo no son solo ajustes: son una herramienta para controlar el riesgo. Plan Mode antes de las tareas complejas = un seguro que no cuesta nada.

/clear no da miedo. Los archivos se quedan donde están; el historial es solo el contexto de la conversación. Limpiar el historial es útil y necesario.

Saltarse los permisos es para máquinas, no para personas. Úsalo solo cuando entiendas por completo lo que estás automatizando.

Siguiente lección

→ RAG: Retrieval Augmented Generation: cómo enseñarle a Claude Code a trabajar con tus datos internos