La barra de estado de Claude Code es increíble: CC statusline hace que la terminal sea instantáneamente hermosa y eficiente

Una barra de estado de Claude Code que muestra en tiempo real el modelo, Git, contexto y costos, guía de inicio rápido de TUI sin configuración.

Olvida la barra de estado predeterminada de Claude Code, CCstatusline es la herramienta que hace que la terminal sea hermosa y funcional. Puede incluir información del modelo, ramas de Git, uso de tokens, costos de sesión, temporizadores y flechas de Powerline en una barra de estado personalizada, todo con configuración gráfica, sin necesidad de modificar archivos.

¿Qué es CCstatusline?

Es un paquete npm de código abierto para Claude Code que proporciona una barra de estado configurable con métricas en tiempo real, soporta Powerline, configuración TUI integrada y múltiples temas.

Una vez iniciado, puedes ver una vista previa en vivo: Ctx: 18.6k | ⎇ main | (+42,-10). Después de la configuración, puede ser aún más llamativa.

¿Qué puede mostrar?

Los componentes (Widgets) se pueden combinar libremente: nombre del modelo, longitud del contexto, rama de Git/cambios, duración de la sesión, temporizador de bloque de 5 horas, costo de la sesión, directorio de trabajo, texto o salida de comando personalizados... También se pueden configurar múltiples barras de estado con diferentes disposiciones.

Configuración completamente a través de TUI, sin necesidad de modificar archivos de configuración

Ejecuta npx ccstatusline@latest para acceder a la interfaz interactiva, con siete menús: editar líneas, cambiar colores, configuración de Powerline, opciones de terminal, estilo global, instalar en Claude Code, guardar y salir. La parte superior se actualiza en tiempo real.

Activa Powerline, la estética se eleva al máximo

Primero, en el menú de Powerline, presiona i para instalar Nerd Font, luego presiona t para activar las flechas de separación. Si eres usuario de Windows y ves cuadros, instala Nerd Font y configúralo como la fuente de la terminal.

Pasos rápidos de instalación

• Ejecuta en la terminal:

npx ccstatusline@latest

o bunx ccstatusline@latest

• Entra en TUI, primero activa Powerline, luego ajusta los componentes, colores y estilo global según sea necesario.
• Selecciona "Install to Claude Code" para guardar la configuración y salir.

Consejos para configurar componentes

• Entra en "Edit Lines → Line 1" y usa ↑↓ para seleccionar componentes, a para agregar, d para eliminar, ←→ para cambiar tipos, r para mostrar valores originales, m para fusionar.
• Puedes crear 3 barras de estado independientes y ver la vista previa en tiempo real.

Recomendado incluir: modelo, Block Timer, Session Cost, Git Branch, Context Length.

Colores y opciones de terminal

En "Edit Colors" usa ←→ para seleccionar colores, f para primer plano/fondo, b para negrita, a para alternar 256 colores, r para restablecer. En "Terminal Options" puedes elegir entre 16 colores/256 colores/Truecolor.

Instalar en Claude Code y ejemplos de ejecución

Después de guardar, abre Claude Code y la barra de estado se activará de inmediato, el tema se puede cambiar en los temas de Powerline.

Regresa a TUI para realizar más cambios

Puedes ejecutar npx ccstatusline@latest en cualquier momento para continuar ajustando.

Mis combinaciones de componentes favoritas

Rama de Git + cambios, Block Timer, Session Cost, Context Length, directorio de trabajo, modelo actual.

Block Timer

Claude Code crea un bloque de sesión cada 5 horas, este temporizador te ayuda a saber cuánto tiempo queda; presiona p para alternar al modo de barra de progreso.

Session Cost

Muestra en tiempo real el costo, r cierra la etiqueta para mostrar solo el número. Necesita Claude Code 1.0.85+.

Ramas de Git y cambios

Las ramas son permanentes, el número de líneas cambiadas es claro, y hay un pequeño componente git worktree disponible.

Longitud del contexto

Cuenta de tokens en tiempo real, evita exceder el límite en sesiones largas.

Comandos personalizados

Puedes ejecutar cualquier comando de shell y colocar la salida en la barra de estado, recuerda configurar un tiempo de espera de 5000ms+ para comandos de red. Ejemplo:

date +%H:%M node -v git rev-parse --short HEAD curl -s wttr.in?format="%t" npx -y ccusage@latest statusline

Resumen y consideraciones

• Las flechas de Powerline requieren Nerd Font.
• Session Cost necesita Claude Code 1.0.85+, puede no actualizarse al usar /resume.
• Si deseas cambiar la configuración, ejecuta npx ccstatusline@latest en cualquier momento.