Saltar al contenido principal

Personalización de la statusline

Intermedio

La statusline es la franja persistente que Claude Code muestra sobre tu sesión. Personalizarla mantiene siempre a la vista los datos que te importan — qué modelo, dónde estás, cuánto contexto queda, tu rama de git.

Qué puedes mostrar

  • Modelo en uso (para no ejecutar accidentalmente uno caro para una tarea trivial).
  • Directorio / proyecto actual.
  • Presupuesto de contexto — cuán llena está la ventana, una señal para hacer /compact.
  • Estado de git — rama, limpio/sucio y en qué worktree estás.

Cómo funciona

Apuntas la statusline a un script (configurado en settings) que recibe los datos de la sesión e imprime una línea. Como es solo un script, puedes mostrar cualquier cosa que puedas calcular.

#!/usr/bin/env bash
# reads session JSON on stdin; prints a status line
input=$(cat)
model=$(echo "$input" | jq -r '.model.display_name // "claude"')
branch=$(git branch --show-current 2>/dev/null)
printf "%s · %s · %s" "$model" "$(basename "$PWD")" "${branch:-no-git}"

(Los campos de entrada exactos están documentados — compruébalos antes de depender de una clave concreta.)

¿No quieres programarlo?

Herramientas de la comunidad (p. ej. ccstatusline) ofrecen statuslines listas para usar y configurables que puedes incorporar en lugar de escribir la tuya. Trata cualquier script de terceros como código que debes revisar antes de confiar en él.

:::tip El campo más útil Para la mayoría de la gente, presupuesto de contexto + modelo se ganan su sitio: previenen las dos sorpresas más comunes — quedarse sin contexto a mitad de tarea y quemar el modelo equivocado (más caro). :::

Siguiente