Cómo tener siempre visible el porcentaje de contexto en Claude Code

Written on December 26, 2025

“You can’t manage what you can’t measure” - Peter Drucker

Claude Code permite personalizar una “status line” para que se actualice después de cada comando. Status line configuration

Yo estoy continuamente ejecutando el comando /context. Si no sabes por qué tienes que vigilar tu contexto te recomiendo mi artículo Tu CLAUDE.md no funciona (sin Context Engineering)

El comando /context es lento y rompe mi flujo de trabajo, así que he creado una status line para ver el estado del contexto en tiempo real.

Verde (<40%)

Status bar verde - contexto bajo 40%

Amarillo (40-60%)

Status bar amarillo - contexto entre 40% y 60%

Rojo (>60%). Con warning ⚠️ al llegar al 70% porque te acercas al auto-compactado, si lo tienes activado.

Status bar rojo - contexto sobre 60% con warning

Instalación

1. Instala jq (procesador JSON)

# macOS
brew install jq

# Linux (Ubuntu/Debian)
sudo apt-get install jq

2. Descarga el script

mkdir -p ~/.claude
curl -o ~/.claude/statusline.sh https://raw.githubusercontent.com/nikeyes/claude-code-config/main/statusline.sh
chmod +x ~/.claude/statusline.sh

3. Configura Claude Code

Añade esta configuración en el archivo ~/.claude/settings.json

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

Ejemplo: https://github.com/nikeyes/claude-code-config/blob/main/settings-personal.json#L14

4. Reinicia Claude Code

Listo. Ahora ves tu porcentaje de contexto en todo momento.

Claude Code with context status line

Nota sobre auto-compactado

Yo tengo desactivado el auto-compactado de contexto. Si lo tienes activado, Claude Code se reserva un 22,5% del contexto para poder hacer el compactado. Así que cuando llegues al 77% del contexto, se compactará automáticamente.

Yo uso el plugin stepwise-dev y no compacto nunca. Controlo el contexto en cada paso y limpio el contexto entero en cada fase: Research → Plan → Implement Phase X → Validate.

Written on December 26, 2025