Navegando por la REPL de Claude Code: Prompts y Comandos de Barra
Una vez que Claude Code está en ejecución, todo sucede dentro de una única sesión interactiva de REPL.
Esa sesión tiene dos tipos de entrada: solicitudes en lenguaje natural y comandos de barra integrados.
Conocer la diferencia, y saber cómo finalizar una sesión correctamente, es la última pieza de fluidez básica de la REPL antes de que comiences a confiar en ella para un trabajo real.
Resumen
El prompt de la REPL es donde escribes una solicitud en inglés simple y Claude Code la convierte en un plan de acción.
Una barra inicial marca un tipo diferente de entrada: un comando integrado que activa un comportamiento específico de la REPL en lugar de una tarea para que el agente planifique.
Los comandos de barra cubren cosas como construir el contexto inicial del proyecto, borrar la conversación o compactar el historial de una sesión larga.
La sesión persiste a través de muchas solicitudes, por lo que rara vez necesitas reiniciar claude en medio de una sesión de trabajo.
Salir limpiamente es importante porque señala que has terminado, en lugar de dejar la sesión colgada en un estado a medio terminar.
Receta
Tarjeta de receta de referencia rápida - lista para copiar y pegar.
# Una solicitud en lenguaje natural - inglés simple, sin sintaxis especial
> Añadir validación de entrada al formulario de registro
# Un comando de barra - comportamiento integrado de la REPL, no una tarea para el agente
> /init
# Limpiar el contexto de la conversación actual
> /clear
# Salir de la sesión limpiamente
> /exitCuándo usar esto:
- Cualquier vez que estés dentro de una sesión activa de Claude Code y necesites darle una nueva tarea.
- Iniciar una nueva sesión de proyecto, donde
/initle ayuda a construir el contexto por adelantado. - Una sesión se ha vuelto larga y lenta, donde
/compacto/clearpueden ayudar. - Finalizar el trabajo del día, donde
/exitcierra todo correctamente.
Ejemplo de Trabajo
cd ~/projects/my-app
claude
# Construir contexto inicial sobre el proyecto
> /init
# Una solicitud normal en lenguaje natural
> Explica cómo funciona actualmente la autenticación en esta base de código
# Una solicitud de seguimiento en la misma sesión, basándose en el mismo contexto
> Ahora añade limitación de tasa al endpoint de inicio de sesión
# Liberar contexto si la sesión se está volviendo larga
> /compact
# Terminar la sesión cuando hayas terminado
> /exitLo que esto demuestra:
/inity las solicitudes ordinarias se pueden mezclar libremente en la misma sesión.- Las solicitudes de seguimiento se basan en el contexto que Claude Code ya recopiló anteriormente en la sesión.
/compactestá disponible a mitad de sesión sin necesidad de salir y reiniciar./exites la forma deliberada y limpia de finalizar la sesión en lugar de cerrar la ventana de la terminal.
Profundización
Cómo Funciona
- Cada línea que escribes en el prompt
>se enruta al agente como una tarea, o es interceptada por la REPL como un comando de barra si comienza con/. - Las solicitudes en lenguaje natural se acumulan como parte del contexto de trabajo de la sesión, por eso las solicitudes de seguimiento pueden referirse a las anteriores.
- Los comandos de barra actúan sobre la sesión misma: construyendo contexto, limpiándolo, compactándolo o terminándolo, en lugar de actuar directamente sobre tus archivos de proyecto.
- Debido a que la sesión tiene estado, generalmente no necesitas repetir el contexto que ya le diste anteriormente en la misma sesión.
Comandos de Barra Comunes
| Comando | Qué hace |
|---|---|
/init | Hace que Claude Code construya el contexto inicial sobre el proyecto actual |
/clear | Limpia el contexto de la conversación actual, comenzando de nuevo dentro de la misma sesión |
/compact | Compacta el historial de una sesión larga para mantenerlo manejable mientras se conserva la esencia |
/exit | Finaliza la sesión limpiamente |
Notas sobre la Sintaxis del Prompt
# Lenguaje natural: describe el resultado, no los pasos exactos
> Arreglar la prueba fallida en checkout.test.ts
# Comando de barra: siempre comienza con una barra inicial, sin lenguaje natural mezclado
> /clearTrampas
- Escribir un comando de barra como parte de una oración - comenzar una solicitud en lenguaje natural con una palabra que casualmente comienza con
/puede ser malinterpretado como un intento de comando. Solución: mantén los comandos de barra como el primer carácter de la línea, sin nada más en esa línea. - Asumir que
/cleary/exithacen lo mismo -/clearrestablece el contexto pero mantiene la sesión abierta;/exitfinaliza la sesión por completo. Solución: usa/clearpara empezar de nuevo a mitad de sesión, y/exitsolo cuando hayas terminado realmente. - Cerrar la ventana de la terminal en lugar de salir - esto omite el apagado limpio que realiza la REPL en
/exit. Solución: escribe/exitantes de cerrar la terminal, especialmente si algún comando en segundo plano todavía se estaba ejecutando. - No usar
/initen un proyecto nuevo - omitirlo significa que la primera solicitud real tiene que construir el contexto desde cero, lo que puede ralentizar o debilitar el primer plan. Solución: ejecuta/initcomo tu primera acción en una sesión de proyecto completamente nueva. - Dejar que una sesión se ejecute demasiado tiempo sin compactar - un historial de conversación muy largo puede ralentizar las respuestas o diluir el contexto. Solución: ejecuta
/compactperiódicamente en sesiones largas, o/clearal cambiar a una tarea no relacionada.
Alternativas
| Alternativa | Usar cuando | No usar cuando |
|---|---|---|
| Solicitud en lenguaje natural | Quieres que el agente planifique y actúe sobre una tarea | Quieres controlar un comportamiento a nivel de REPL como borrar contexto |
| Comando de barra | Quieres un comportamiento integrado de la REPL (init, clear, compact, exit) | Quieres que Claude Code planifique una tarea de varios pasos |
Salir y reiniciar claude | Cambiaste a un proyecto completamente diferente | Simplemente estás cambiando de tarea dentro del mismo proyecto |
Preguntas Frecuentes
¿Cómo sé si debo escribir una solicitud en lenguaje natural o un comando de barra?
Si quieres que Claude Code planifique y actúe sobre una tarea, descríbela en inglés simple. Si quieres un comportamiento integrado de la REPL como borrar contexto o salir, usa un comando de barra inicial en su lugar.
¿Qué hace realmente `/init`?
- Hace que Claude Code construya el contexto inicial sobre el proyecto actual.
- Normalmente es el primer comando que se ejecuta en una sesión de proyecto completamente nueva.
- Hace que la primera solicitud real posterior sea más precisa, ya que el agente ya tiene orientación.
¿Cuál es la diferencia entre `/clear` y `/compact`?
/clear borra el contexto de la conversación actual y comienza de nuevo dentro de la misma sesión. /compact condensa un historial largo para mantenerlo manejable sin descartarlo por completo.
¿Necesito usar `/exit` y reiniciar para cada nueva tarea?
No. La sesión tiene estado y persiste a través de muchas solicitudes. Solo necesitas reiniciar cuando cambias a un directorio de proyecto diferente.
¿Qué sucede si simplemente cierro la terminal sin salir?
La sesión termina abruptamente en lugar de apagarse limpiamente. Es mejor escribir /exit primero, especialmente si un comando de shell todavía se estaba ejecutando.
¿Puedo mezclar comandos de barra y solicitudes en lenguaje natural en la misma sesión?
Sí. Se mezclan comúnmente, por ejemplo, ejecutando /init primero, luego una serie de solicitudes en lenguaje natural, luego /compact a mitad de una sesión larga.
¿Algún comando de barra modifica directamente mis archivos de proyecto?
No. Los comandos de barra cubiertos aquí actúan sobre la sesión misma, el contexto, el historial y el ciclo de vida de la sesión, no directamente sobre tus archivos. Las ediciones reales de archivos provienen de solicitudes en lenguaje natural dirigidas a través del agente.
¿Por qué usaría `/compact` en lugar de simplemente `/clear`?
/compact mantiene una versión condensada del historial de la sesión, por lo que el agente conserva algo de memoria del contexto anterior. /clear lo descarta por completo, lo que es mejor cuando te mueves a una tarea genuinamente no relacionada.
¿Hay alguna diferencia entre cómo la REPL trata una solicitud y cómo lo haría una interfaz de chat?
La solicitud de la REPL pasa por el bucle completo del agente: leer archivos, planificar, actuar y verificar, no solo producir una respuesta de texto. Esa distinción es la diferencia central con una interfaz de chat típica.
¿Cuál debería ser mi primer comando en un proyecto completamente nuevo?
/init es una opción sólida por defecto, ya que permite a Claude Code construir contexto sobre el proyecto antes de que le entregues una tarea real.
Relacionados
- Conceptos básicos de Claude Code 101 - un conjunto más amplio de ejemplos de primera sesión que incluyen instalación y lanzamiento.
- El Modelo Mental de Claude Code: Agente, No Autocompletado - lo que sucede detrás de escena cuando se envía una solicitud en lenguaje natural.
- Instalación de Claude Code y Conexión de Tu Primer Proyecto - cómo abrir una sesión en primer lugar.
- Modos de Permiso Explicados: Aceptación Automática vs. Preguntar Siempre - cómo se comporta la REPL de manera diferente según tu modo de permiso.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado), y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente: verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.