Qué es la línea de estado
La documentación la describe en una frase: "La línea de estado es una barra personalizable en la parte inferior de Claude Code que ejecuta cualquier script de shell que configures. Recibe datos de sesión en JSON a través de stdin y muestra lo que tu script imprima".
Enumera las razones por las que la gente la usa:
- Para "monitorear el uso de la ventana de contexto mientras trabajas".
- Para "rastrear los costos de la sesión".
- Para diferenciar sesiones cuando "trabajas en múltiples sesiones".
- Para mantener visibles la rama de git y su estado.
Vale la pena conocer dos detalles antes de construir una. Primero, no cuesta nada en uso del modelo: "La línea de estado se ejecuta localmente y no consume tokens de la API". Segundo, se sitúa junto al pie de página integrado en lugar de reemplazarlo, aunque la documentación señala que con una línea de estado personalizada, Claude Code deja de mostrar algunas sugerencias del pie de página.
Cómo configurar una
Hay dos rutas.
Deja que Claude la escriba. La documentación dice: "El comando /statusline acepta instrucciones en lenguaje natural que describen lo que quieres mostrar. Claude Code genera un archivo de script en ~/.claude/ y actualiza tus ajustes automáticamente". Describes lo que quieres, como el nombre del modelo y una barra de contexto, y apruebas las ediciones del archivo.
Escríbela tú mismo. Añade un campo statusLine a tus ajustes de usuario en ~/.claude/settings.json o a los ajustes del proyecto. Establece su tipo como comando y apunta el comando a un script o a un comando de shell en línea.
Tres campos opcionales dan forma a la salida:
- padding añade espaciado horizontal.
- refreshInterval vuelve a ejecutar el comando tras un temporizador, cubierto más adelante.
- hideVimModeIndicator oculta el texto del modo vim integrado cuando tu script lo muestra.
Para eliminar la línea de estado, la documentación dice que puedes ejecutar /statusline y pedirle que elimine o limpie la línea de estado, o borrar el campo de tus ajustes.
Qué campos de sesión recibe tu script
Cada vez que se ejecuta, tu script recibe un objeto JSON en stdin. La tabla de la documentación es larga y los campos se dividen en varios grupos.
Modelo y esfuerzo. model.id y model.display_name, además de effort.level y thinking.enabled.
Dónde estás. workspace.current_dir, workspace.project_dir (el directorio donde se lanzó Claude Code), directorios añadidos, la identidad del repositorio desde el remoto origin y detalles del worktree cuando estás en uno.
Identidad de la sesión. session_id, descrito como "Identificador único de sesión", y session_name, que usa el nombre personalizado que estableciste o el título de sesión generado por la IA. También está prompt_id para el prompt que se está procesando y transcript_path, la "Ruta al archivo de transcripción de la conversación".
Contexto. El objeto context_window, cubierto en la siguiente sección.
Costo y tiempo. cost.total_cost_usd, que la documentación describe como una estimación calculada en el cliente que "Puede diferir de tu factura real", además de la duración total y las líneas añadidas y eliminadas.
Límites. Campos para las ventanas de límite de tasa (rate-limit) y cuándo se reinician, y un objeto de caché de prompts con información sobre si la caché está activa (warm).
Pull requests. El número de PR abierta, la URL y el estado de revisión para la rama actual.
Algunos campos están ausentes hasta que se aplican. La sección de resolución de problemas de la documentación dice: "Los campos pueden ser null antes de que se complete la primera respuesta de la API, así que gestiona los valores nulos en tu script con alternativas (fallbacks)".
Cómo mostrar el uso de la ventana de contexto
Monitorear el contexto es el primer uso que enumera la documentación, y la página explica exactamente qué contiene.
Describe "la ventana de contexto en vivo de la respuesta más reciente de la API". Incluye el tamaño máximo de la ventana, los totales combinados de entrada y salida, un desglose por categoría y dos campos precalculados: used_percentage y remaining_percentage.
La regla clave es qué cuenta. La documentación dice: "El campo used_percentage se calcula solo a partir de los tokens de entrada: input_tokens + cache_creation_input_tokens + cache_read_input_tokens. No incluye output_tokens".
Si calculas la cifra tú mismo a partir del desglose, la documentación dice que debes "usar la misma fórmula de solo entrada para coincidir con used_percentage". Su recomendación para la mayoría de los scripts es más simple: "Usa used_percentage para obtener el estado de contexto preciso más sencillo".
Hay un campo que debe tratarse con cuidado: exceeds_200k_tokens. La documentación dice que refleja si el conteo combinado de la última respuesta supera los 200k y que "Este es un umbral fijo independientemente del tamaño real de la ventana de contexto". No es una advertencia de que tu ventana esté casi llena.
Por qué difiere de /context
La línea de estado y /context miden momentos ligeramente diferentes. La línea de estado usa la última respuesta de la API. /context añade una estimación de los mensajes añadidos desde entonces. Por lo tanto, justo después de pegar un archivo grande o de que Claude lea varios archivos, /context puede mostrar más que la línea de estado hasta que llegue la siguiente respuesta.
La compactación reinicia parte de los datos. La documentación dice que el objeto current_usage "es null antes de la primera llamada a la API en una sesión, y de nuevo inmediatamente después de /compact hasta que la siguiente llamada a la API lo vuelva a poblar". Un segmento de contexto en blanco o con guiones justo después de la compactación es normal, y un fallback en tu script lo mantiene legible.
Cuándo se actualiza la línea de estado
Las actualizaciones se basan en eventos, no en un reloj. La documentación dice que el script se ejecuta una vez cuando una sesión comienza o se reanuda, y de nuevo cuando:
- "Llega un nuevo mensaje del asistente".
- "Termina
/compact". - "Cambia el modo de permiso".
- "Se alterna el modo Vim".
- Cambias el comando en tus ajustes.
- Transcurre un intervalo de actualización, si configuraste uno.
- Una ventana de límite de tasa o una caché de prompts activa en los últimos datos alcanza su tiempo de reinicio o expiración.
Las actualizaciones se agrupan: "Claude Code aplica un debounce a las actualizaciones de 300ms, por lo que los cambios rápidos se agrupan y tu script se ejecuta una vez después de que los cambios se detengan". Y si se activa una nueva actualización mientras tu script aún se está ejecutando, Claude Code cancela el script en curso.
Por qué puede detenerse mientras se ejecutan agentes en segundo plano
Este es el comportamiento del ejemplo inicial. Debido a que las actualizaciones siguen a los eventos en la sesión principal, una espera larga en esa sesión significa pocas o ninguna actualización, incluso mientras se trabaja en otros lugares.
La documentación menciona el caso directamente: "Los disparadores basados en eventos pueden silenciarse cuando la sesión principal está inactiva, por ejemplo, mientras un coordinador espera a los subagentes en segundo plano". Su solución: establecer refreshInterval "para volver a ejecutar también el comando en un temporizador fijo". El mínimo es un segundo.
La documentación también menciona este ajuste para segmentos que cambian fuera de la sesión, como un reloj, o "cuando los subagentes en segundo plano cambian el estado de git mientras la sesión principal" está inactiva. Si tu línea de estado muestra el estado de git durante el trabajo multi-agente, un intervalo de actualización la mantiene al día.
Un intervalo de actualización vuelve a ejecutar tu script. No crea nuevos datos de contexto. Los campos de contexto siguen proviniendo de la respuesta de la API más reciente en la sesión principal.
Qué puede hacer que desaparezca
La sección de resolución de problemas enumera varias causas de una línea de estado en blanco:
- La carpeta no es de confianza. "Hasta que aceptes el diálogo de confianza del espacio de trabajo, la línea de estado permanecerá en blanco". La línea de estado ejecuta un comando de shell, por lo que sigue la misma regla de confianza que los hooks.
- El script falla. "Los scripts que salen con códigos distintos de cero o no producen salida hacen que la línea de estado se quede en blanco".
- Los hooks están desactivados. Si
disableAllHookses true fuera de los ajustes gestionados, solo se ejecutará una línea de estado gestionada. - Tu organización restringe los hooks. Con
allowManagedHooksOnlyestablecido en los ajustes gestionados, "tu línea de estado personalizada desaparece sin previo aviso".
Para ver qué está sucediendo, la documentación sugiere ejecutar claude --debug, que registra el stderr de tu script y su código de salida en la primera ejecución de una sesión.
La velocidad también importa. "Los scripts lentos bloquean la actualización de la línea de estado hasta que se completan". Para comandos como git status, la documentación sugiere cachear el resultado.
Cubrimos cómo Codex calcula su propia cifra de contexto restante, incluyendo por qué comienza en el máximo en un nuevo chat, en nuestra guía sobre contexto restante en Codex.
Lo que la gente intenta primero
Comparar la línea de estado con /context. Miden momentos diferentes. /context puede mostrar una cifra mayor hasta la siguiente respuesta.
Esperar actualizaciones durante trabajos largos en segundo plano. Los disparadores de eventos se silencian cuando la sesión principal está inactiva. Configura un intervalo de actualización.
Tratar exceeds_200k_tokens como una advertencia de ventana llena. Es un umbral fijo.
Añadir tokens de salida a la cifra de contexto. used_percentage cuenta solo los tokens de entrada.
Depurar una línea en blanco en una carpeta que no es de confianza. Acepta primero el diálogo de confianza.
La solución: Haz que la línea de estado te diga cuándo guardar el contexto
Paso 1: Mostrar used_percentage
Es el campo documentado para el estado de contexto preciso más sencillo.
Paso 2: Añadir fallbacks para valores nulos
Los campos pueden estar vacíos antes de la primera respuesta y después de /compact.
Paso 3: Configurar un intervalo de actualización para el trabajo con agentes
Mantén los segmentos actualizados mientras la sesión principal espera.
Paso 4: Guardar decisiones antes de que la ventana se llene
Cuando la cifra suba, anota las decisiones y hechos de la sesión que necesitarás de nuevo.
Configurando esto en MemoryLake
La línea de estado te dice qué tan llena está la ventana de contexto. No guarda nada. Cuando la sesión se compacta o termina, las decisiones tomadas en ella son tan duraderas como el resumen o la transcripción. El contexto que importa a través de las sesiones, como lo que decidiste, qué enfoque falló y qué restricciones se aplican, se mantiene mejor como notas que tú escribiste.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, restricciones y lecciones de sesiones pasadas, guardadas en un solo lugar que tú mantienes y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú escribes las entradas tú mismo, con tus propias palabras. No se lee nada de, ni se escribe en, ni se borra de tus sesiones de Claude Code, tus transcripciones, tus scripts de línea de estado, tus archivos de configuración o el almacenamiento de cualquier proveedor. La línea de estado funciona de la manera que Anthropic describe.
Paso 1: Crear una clave de API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: las decisiones y hechos que vale la pena conservar de una sesión larga. Un tema por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code, Codex y los otros asistentes que uses. Una nueva sesión puede comenzar desde las mismas notas.

Qué cambia esto en la práctica
La primera diferencia es el tiempo. La línea de estado se convierte en una señal para guardar el contexto, no solo en un medidor.
La segunda es una compactación más fluida. Lo que necesitas ya está anotado antes de que el resumen reemplace al detalle.
La tercera es la consistencia entre herramientas. Las mismas notas están disponibles en Claude Code y en otros asistentes.
Mejores prácticas para la línea de estado de Claude Code
Empieza con /statusline. Describe lo que quieres y deja que Claude Code escriba el script.
Usa used_percentage. Cuenta solo los tokens de entrada, por diseño.
Gestiona los nulos. Espera valores vacíos antes de la primera respuesta y después de la compactación.
Añade refreshInterval para trabajos largos con agentes. Los disparadores de eventos pueden silenciarse.
Mantén los scripts rápidos. Cachea comandos lentos como git status.
Muestra el nombre de la sesión. Ayuda cuando ejecutas varias sesiones.
Revisa la configuración de confianza y hooks si está en blanco. Ambos pueden ocultarla.
Conclusión
La línea de estado de Claude Code ejecuta un script de shell que tú configuras, le pasa datos de sesión en JSON por stdin y muestra lo que el script imprime, sin usar tokens de la API. Los datos incluyen el modelo, el espacio de trabajo, el ID y nombre de la sesión, la ruta de la transcripción, estimaciones de costo, límites de tasa y un objeto context_window cuyo used_percentage cuenta solo los tokens de entrada.
Se actualiza ante eventos como nuevos mensajes del asistente y /compact, con un debounce de 300ms. Esos disparadores pueden silenciarse mientras la sesión principal espera a subagentes en segundo plano, por lo que un refreshInterval la mantiene al día. Informa sobre la última respuesta de la API, razón por la cual /context puede mostrar una cifra mayor. Úsala como una señal para guardar lo que importa antes de que la ventana se llene.