MemoryLake
Volver a todos los artículos
Tutorial19 de noviembre de 2026·10 min de lectura

¿Qué puede mostrar la línea de estado de Claude Code? Campos de sesión que recibe tu script, cómo mostrar el uso de la ventana de contexto y por qué puede detenerse con agentes en segundo plano (2026)

Añadiste una línea de estado a Claude Code para ver qué tan llena estaba la ventana de contexto sin tener que escribir /context cada pocos minutos. Funcionó bien durante una sesión normal. Luego iniciaste una tarea más larga donde Claude coordinaba varios subagentes en segundo plano, y el número en la parte inferior de la pantalla dejó de moverse durante un buen rato. Cuando finalmente ejecutaste /context, mostró una cifra más alta que la línea de estado.

Ambos comportamientos están documentados. La página de la línea de estado de Anthropic dice: "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". Y sobre la diferencia en los números: "La línea de estado informa los conteos de la última respuesta de la API, mientras que /context añade una estimación de los mensajes añadidos desde esa respuesta, por lo que /context puede mostrar una cifra mayor hasta la siguiente respuesta".

Esta guía cubre qué es la línea de estado, cómo configurar una, qué campos de sesión recibe tu script, cómo mostrar el uso de la ventana de contexto con precisión, cuándo se actualiza la línea de estado y por qué puede detenerse, qué puede hacer que desaparezca y cómo usar lo que muestra para decidir cuándo guardar el contexto fuera de la sesión.

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 disableAllHooks es true fuera de los ajustes gestionados, solo se ejecutará una línea de estado gestionada.
  • Tu organización restringe los hooks. Con allowManagedHooksOnly establecido 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.

La consola de MemoryLake mostrando la pantalla de claves de API, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de claves de API, donde se crea y copia una nueva clave para usar en un agente

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.

El espacio de trabajo de MemoryLake con los primeros documentos subidos, listando cada archivo a medida que se convierte en memoria buscable
El espacio de trabajo de MemoryLake con los primeros documentos subidos, listando cada archivo a medida que se convierte en memoria buscable

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.

La pantalla de integraciones de MemoryLake listando los clientes de IA y frameworks de agentes que pueden conectarse a la capa de memoria
La pantalla de integraciones de MemoryLake listando los clientes de IA y frameworks de agentes que pueden conectarse a la capa de memoria

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.

Preguntas frecuentes

¿Qué es la línea de estado de Claude Code?

Una barra personalizable en la parte inferior de Claude Code que ejecuta un script de shell y muestra su salida.

¿Cómo configuro una línea de estado en Claude Code?

Ejecuta /statusline con una descripción, o añade un campo statusLine a tus ajustes.

¿Cómo muestro el uso de la ventana de contexto en la línea de estado?

Usa el campo context_window.used_percentage del JSON que recibe tu script.

¿Por qué mi línea de estado es diferente de /context?

La línea de estado usa la última respuesta de la API, y /context añade una estimación para los mensajes más nuevos.

¿Por qué mi línea de estado deja de actualizarse?

Los disparadores de eventos pueden silenciarse cuando la sesión principal está inactiva. Configura un refreshInterval.

¿La línea de estado consume tokens?

No. Se ejecuta localmente y no consume tokens de la API.

¿Por qué mi línea de estado está en blanco?

Las causas comunes son una carpeta que no es de confianza, un script que falla o restricciones de hooks en tus ajustes.