Status Line en Claude Code: Personaliza tu Barra de Estado

Claude Code te permite personalizar la barra de estado inferior con un script de shell — como el PS1 de tu terminal, pero para tu sesión de IA.

Con ~50 líneas de bash tienes: modelo, directorio, rama git, diff stats, coste de sesión y una barra de uso de ventana de contexto — todo con colores ANSI.

Resultado:

Cómo funciona

Claude Code envía un JSON con metadatos de la sesión al stdin de tu script cada vez que la conversación se actualiza (máximo cada 300ms). Tu script lo lee, extrae lo que necesita, e imprime una línea por stdout. Esa línea se convierte en la barra de estado. Los códigos ANSI están soportados.

El esquema JSON completo está documentado en Status line configuration — incluye info del modelo, rutas del workspace, tracking de costes y uso de ventana de contexto.

Setup

1. Crea el script

#!/bin/bash
input=$(cat)

# --- Extraer datos ---
MODEL=$(echo "$input" | jq -r '.model.display_name')
DIR=$(echo "$input" | jq -r '.workspace.current_dir' | xargs basename)
ADDED=$(echo "$input" | jq -r '.cost.total_lines_added // 0')
REMOVED=$(echo "$input" | jq -r '.cost.total_lines_removed // 0')
COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
CTX_PCT=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

# Rama git
BRANCH=""
if git rev-parse --git-dir > /dev/null 2>&1; then
    B=$(git branch --show-current 2>/dev/null)
    [ -n "$B" ] && BRANCH="$B"
fi

# --- Colores ANSI ---
RST="\\033[0m"
DIM="\\033[2m"
BOLD="\\033[1m"
CYAN="\\033[36m"
GREEN="\\033[32m"
RED="\\033[31m"
YELLOW="\\033[33m"
MAGENTA="\\033[35m"
BLUE="\\033[34m"

# --- Barra de contexto (5 bloques) ---
filled=$((CTX_PCT / 20))
empty=$((5 - filled))
BAR=""
for ((i=0; i<filled; i++)); do BAR+="█"; done
for ((i=0; i<empty; i++)); do BAR+="░"; done

if [ "$CTX_PCT" -ge 80 ]; then
    BAR_COLOR="$RED"
elif [ "$CTX_PCT" -ge 50 ]; then
    BAR_COLOR="$YELLOW"
else
    BAR_COLOR="$GREEN"
fi

# --- Construir línea ---
OUT=""
OUT+="${DIM}╸${RST} "
OUT+="${BOLD}${CYAN}${DIR}${RST}"
[ -n "$BRANCH" ] && OUT+=" ${MAGENTA} ${BRANCH}${RST}"
OUT+=" ${DIM}│${RST} ${BLUE}${MODEL}${RST}"
OUT+=" ${DIM}│${RST} ${GREEN}+${ADDED}${RST} ${RED}-${REMOVED}${RST}"
OUT+=" ${DIM}│${RST} ${DIM}\\$${RST}${COST}"
OUT+=" ${DIM}│${RST} ${BAR_COLOR}${BAR}${RST} ${DIM}${CTX_PCT}%${RST}"

echo -e "$OUT"

Guárdalo como ~/.claude/statusline.sh y dale permisos:

chmod +x ~/.claude/statusline.sh

2. Actívalo en settings

Añade a .claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 0
  }
}

Reinicia Claude Code.

El comando /statusline

No hace falta montarla a mano: /statusline acepta instrucciones en lenguaje natural, genera el script en ~/.claude/ y actualiza tu settings.json por ti.

/statusline muestra el modelo, la rama git y una barra de contexto

Para eliminarla: /statusline delete. Si la barra no aparece, comprueba que el script tenga permiso de ejecución (chmod +x).

Qué muestra cada segmento

Requisitos

• jq instalado (brew install jq / apt install jq).
• Terminal con soporte ANSI (básicamente todas).