7. La interfaz interactiva: sesiones, temas y atajos

Objetivo del tema

Moverte con soltura por la interfaz interactiva de Claude Code: iniciar y retomar sesiones, escribir prompts eficientes con las sintaxis especiales, usar los comandos slash, dominar los atajos de teclado, gestionar el contexto de conversaciones largas y personalizar la apariencia.

7.1 Arrancar y conversar

La experiencia principal de Claude Code es su modo interactivo (un REPL de terminal). Se abre sobre el directorio actual o indicando el trabajo desde la línea de comandos:

claude                        # sesión interactiva en el proyecto actual
claude "Resume la arquitectura del código"   # arranca con un prompt
claude -c                     # continúa la última conversación
claude -r                     # abre el selector de sesiones anteriores

La pantalla se organiza en tres zonas: el área de conversación, el campo de entrada inferior y una línea de estado donde verás el modelo activo, el modo de permisos vigente y el consumo de contexto. La línea de estado es personalizable con /statusline: el propio Claude genera el script que la muestra con la información que quieras (rama de Git, nombre del proyecto, etc.).

Una vez dentro, simplemente escribe tu pedido en lenguaje natural. No hay menús que memorizar: los comandos existen para acelerar, no como requisito.

7.2 Sintaxis especial del campo de entrada

Cuatro prefijos convierten al campo de entrada en algo mucho más potente que un chat:

Sintaxis especial de entrada
Prefijo Función Ejemplo
@ Referencia archivos o directorios con búsqueda difusa; su contenido entra al contexto. ¿Cómo se maneja la autenticación en @src/api/auth.ts?
! Modo bash: ejecuta un comando real y su salida queda registrada en la conversación. !git status
# Guarda el texto como memoria en CLAUDE.md (tema 6). # los tests del CI corren con make test-ci
/ Comandos slash del propio Claude Code. /compact

A esto se suman dos apoyos visuales: puedes arrastrar imágenes a la terminal o pegarlas con Ctrl+V (capturas de error, maquetas, diagramas) y componer mensajes multilínea con barra invertida antes de Enter o con Option+Enter en macOS (configurable en otras terminales con /terminal-setup).

Combina prefijos: revisa el estado del repo con !git diff, pide cambios citando los archivos exactos con @ y guarda las conclusiones con #. Cuanto más preciso el contexto, mejores respuestas.

7.3 Los comandos slash esenciales

Escribiendo / se despliega la lista de acciones disponibles, con autocompletado al presionar Tab. Estos son los comandos fundamentales agrupados por función:

Comandos slash principales
Comando Función
/help Ayuda integrada y lista de comandos.
/init Genera o mejora el CLAUDE.md del proyecto (tema 6).
/model Ver y cambiar el modelo activo (tema 5).
/clear Limpia el historial y empieza una conversación fresca.
/compact Resume la conversación liberando contexto (acepta instrucciones).
/rewind Abre los checkpoints para retroceder código y/o conversación.
/resume Retoma una sesión anterior del proyecto.
/status Versión, cuenta, modelo y estado de conexión.
/usage y /cost Consumo del plan y gasto en modo API.
/config Preferencias: tema visual y otras opciones.
/memory Abre los archivos de memoria para editarlos.
/agents Gestión de subagentes (tema 14).
/mcp Servidores MCP conectados (tema 16).
/ide Conecta la sesión con VS Code o JetBrains (tema 12).
/add-dir Agrega directorios de trabajo adicionales (monorepos).
/doctor Diagnóstico de la instalación.
/export Exporta la conversación a archivo o portapapeles.
/exit Cierra la sesión.

Los comandos personalizables (por ejemplo /feature o /bug creados por tu equipo) se estudiarán en el tema 14.

7.4 Control del flujo: interrumpir, encolar y retroceder

Tres mecánicas definen la comodidad de una sesión larga:

  • Interrumpir: Esc detiene a Claude en cualquier momento (mientras ejecuta un comando o escribe código); el trabajo ya hecho no se pierde y puedes redirigirlo de inmediato.
  • Encolar mensajes: mientras el agente trabaja puedes seguir escribiendo; los mensajes quedan en cola y se procesan al terminar el turno actual. Ideal para dar instrucciones adicionales sin esperar.
  • Retroceder con checkpoints: antes de cada modificación Claude Code guarda automáticamente un punto de control. Con doble Esc (o /rewind) navegas hacia atrás en la conversación y eliges restaurar el código, la conversación o ambos. Es la red de seguridad que anima a experimentar sin miedo.

El modo de permisos se alterna con Shift+Tab y se anuncia en la línea de estado: modo normal (aprueba acciones), modo de edición automática aceptada y modo Plan de solo lectura. Lo analizamos a fondo en el próximo tema.

7.5 Atajos de teclado esenciales

A diferencia de otras interfaces, Claude Code no depende de una tecla líder: cada atajo es directo y está pensado para el flujo de trabajo:

Atajos de teclado más utilizados
Atajo Acción
Esc Interrumpir al agente o limpiar el campo de entrada.
Esc doble Abrir el historial de checkpoints (/rewind).
Shift+Tab Ciclar modos de permisos: normal, ediciones automáticas, Plan.
Ctrl+C Limpiar la entrada actual; dos veces para salir.
Ctrl+D Salir de la sesión.
Ctrl+L Limpiar la pantalla de la terminal.
Ctrl+R Transcripción extendida: historial completo desplazable.
Ctrl+V Pegar una imagen en la conversación.
Tab Autocompletar comandos y rutas en el campo de entrada.
\ + Enter Salto de línea dentro del mismo mensaje (multilínea).

7.6 Sesiones: historial y continuidad

Cada conversación es una sesión independiente, guardada automáticamente por proyecto:

  • Nueva tarea, nueva sesión: /clear limpia el contexto sin cerrar el agente; cambiar de tema con memoria llena produce respuestas confundidas y consumos innecesarios.
  • Retomar trabajo: claude -c continúa la última conversación y claude -r (o /resume) abre el historial completo para elegir dónde continuar, con todo su contexto.
  • Documentar decisiones: /export vuelca la conversación a Markdown: útil para adjuntar el razonamiento a un pull request o documentar por qué se descartó una alternativa.
  • Trabajo paralelo: puedes abrir varias terminales con sesiones independientes sobre el mismo proyecto (con Git como red de seguridad para ediciones concurrentes).

7.7 Gestionar el contexto: /clear y /compact

El contexto es el recurso más valioso de una sesión: cada turno reenvía el historial completo al modelo, y cuando se agota, Claude Code compacta automáticamente resumiendo lo anterior. No esperes al auto-compact para gestionar:

  • /clear entre tareas: la regla más rentable. Tarea terminada, contexto limpio; el próximo pedido parte de cero y con respuestas más nítidas.
  • /compact dentro de una tarea larga: resume el hilo conservando las decisiones y el estado del código. Acepta instrucciones para dirigir el resumen: /compact conserva los nombres de archivo modificados y los tests pendientes.
  • Señales de contexto saturado: respuestas que olvidan lo conversado, referencias a archivos inexistentes o lentitud creciente: hora de compactar o limpiar.

7.8 Temas y apariencia

Con /config eliges el tema visual entre las variantes oscuras, claras, sus versiones daltonizadas (pensadas para distintos tipos de daltonismo) y las variantes ANSI, que respetan la paleta de colores de tu propia terminal. La selección persiste entre sesiones.

Para ir un paso más allá, /statusline personaliza la línea inferior: le describes qué quieres ver ("rama de git, modelo y porcentaje de contexto usado") y Claude escribe el script que la alimenta. Es un buen ejemplo de la filosofía del producto: la herramienta se personaliza conversando con ella.

Nuevas líneas cómodas

/terminal-setup configura Shift+Enter para saltos de línea en iTerm2 y la terminal de VS Code: indispensable para prompts largos.

Edición al estilo Vim

/vim activa los modos de inserción y normal de Vim en el campo de entrada. Si vives en Vim, no querrás volver atrás.

Diagnóstico rápido

Ante comportamientos extraños: /doctor revisa la instalación y /status confirma modelo, cuenta y conexión sin salir de la sesión.

Conclusión: dominar la interfaz interactiva multiplica tu productividad: contexto exacto con @ e imágenes, acciones rápidas con comandos slash, red de seguridad con checkpoints y un contexto sano gracias a /clear y /compact. En el próximo tema profundizaremos en el modo Plan y el modo de edición directa, las dos formas de trabajar que Shift+Tab alterna.