Por qué esta guía existe
Acabas de instalar Claude Code. Abres la terminal. Aparece un cursor parpadeando. Ya está.
Funciona. Pero no te dice nada. No sabes en qué modelo estás, en qué carpeta, en qué branch. No sabes cuánto va costando la sesión. No sabes si la ventana de contexto se está llenando. Trabajas a ciegas.
Esta guía cierra esa brecha. Cuatro cambios en orden. Veinte minutos. Pensada para gente que acaba de llegar y todavía no quiere meterse con cosas más finas como skills, MCPs o subagentes.
Al final tienes una terminal que sí te informa.
1 · El statusline (la barra que sí te informa)
Qué vas a ver al final de esta sección
El statusline es una barra de dos líneas que aparece en la parte de abajo de tu terminal. Vive ahí, todo el rato, mientras trabajas con Claude. Te muestra:
Línea 1
- Modelo activo (Opus, Sonnet, Haiku)
- Carpeta donde estás
- Branch de git
- Líneas añadidas y borradas en la sesión
- Costo en USD acumulado
- Duración de la sesión
Línea 2
- Barra de progreso del contexto (verde abajo de 60%, amarilla entre 60 y 85, roja arriba de 85)
- Tokens usados sobre el límite
- Hora actual en Bogotá, Santiago y Madrid
- Tasa USD a COP del día
Por qué importa
- Evitas commitear en la branch equivocada.
- Te das cuenta cuando estás gastando Opus en una tarea que merecía Haiku.
- Ves la ventana de contexto llenándose antes de que el agente empiece a olvidar.
- Tienes a la vista cuánto va costando la sesión, sin abrir el dashboard de Anthropic.
Cómo lo instalas
Le pasas este prompt a Claude Code. Tal cual. Él te crea el script.
Quiero un statusline custom para Claude Code en mi Mac. Que sea un script bash en `~/.claude/statusline.sh` y se registre en `~/.claude/settings.json` en `statusLine.command`.
Que muestre 2 líneas:
Línea 1: modelo actual, nombre de la carpeta donde estoy, branch git, líneas añadidas y borradas en la sesión, costo USD acumulado, duración de la sesión. Separados por `|` en gris.
Línea 2: barra de progreso del contexto (verde <60%, amarillo 60-85%, rojo >85%), tokens usados sobre límite, hora actual en Bogotá, Santiago y Madrid, tasa USD→COP del día (cacheada 1 hora desde open.er-api.com).
Colores ANSI 24-bit. Iconos emoji para cada campo (🤖 modelo, 🌿 branch, 💰 costo, etc.). Detecta automáticamente si el modelo es de 1M de contexto y ajusta el límite a 1.000.000, si no, 200.000.
Léeme el script entero y déjamelo listo para probar.
Pasos después de pegar el prompt:
Claude te crea el script
Te lo escribe en ~/.claude/statusline.sh. Te muestra el contenido entero antes de guardarlo. Léelo. Si entiendes 70% de lo que hace, está bien.
Registras la ruta en settings.json
Claude lo hace en el mismo paso, pero verifica. Abre ~/.claude/settings.json y asegúrate de que aparece algo así:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}
Reinicias Claude Code
Cierras y abres. La barra aparece abajo. Si no aparece, le dices a Claude "el statusline no se ve, qué falló" y él revisa permisos del script (chmod +x) y rutas.
Lo que viene de fábrica
- Una sola línea minimalista
- Modelo y poco más
- No ves contexto, costo ni branch
- Trabajas sin tablero
Lo que tienes después
2 · Los 3 modos de operación
El atajo más infrautilizado de Claude Code es Shift+Tab. Cicla entre tres modos. Cada uno cambia cómo se comporta el agente con tus archivos.
Cuándo usar cuál
Default mode · te pregunta antes de actuar
Es el de fábrica. Antes de tocar un archivo o ejecutar un comando, te pide permiso. Lento, pero seguro.
Lo uso para: repos delicados, código de cliente, cuando estoy aprendiendo una herramienta nueva y quiero ver cada paso. También cuando Claude está trabajando con git en algo que no quiero perder.
Auto mode · ejecuta directo
Mi modo del día a día. Claude crea archivos, los modifica, corre comandos sin pedirte permiso cada vez.
Lo uso para: refactors pequeños, escribir componentes, generar contenido, mover archivos. Cualquier cosa donde el daño máximo posible es un git reset --hard.
Plan mode · te muestra el plan antes de tocar nada
Claude escribe el plan en bloques. Lo lees. Lo apruebas o lo ajustas. Recién ahí ejecuta.
Lo uso para: refactors grandes, migraciones, cuando voy a tocar varios archivos a la vez, cuando estoy explorando un repo nuevo y quiero entender antes de mover. Hace lento el arranque, pero te salva de tareas mal escopadas.
3 · Comandos que uso todos los días
Tecleas / dentro de Claude Code y se despliega un menú. Estos son los 7 que más uso. Los otros casi no los toco.
/ y se despliega el catálogo. Estos 7 los uso casi todos los días. /model · cambiar de modelo sin cerrar la sesión
Opus para tareas pesadas (plan grande, decisión arquitectónica). Sonnet para el día a día (escribir código con un buen plan). Haiku para tareas mecánicas (búsquedas, renames, leer muchos archivos rápido).
Lo lanzo cuando arranco una tarea distinta. Empezar Opus, terminar Haiku.
/rewind · devolverte a un punto anterior
Claude se metió en un camino malo. Borró algo que no debía, o reescribió mal un archivo. /rewind te deja volver tres turnos atrás sin perder la sesión.
Es como Ctrl+Z pero para tu chat entero. El que más me ha salvado de pánicos.
/effort · ajustar profundidad de pensamiento
Sube el effort cuando el problema requiere pensar (deuda técnica, debugging raro, decisión de arquitectura). Bájalo cuando la tarea es trivial (rename, mover archivos, escribir un README).
Effort alto gasta más tokens pero piensa más. Effort bajo va al grano.
/clear · limpiar el contexto sin cerrar
La conversación se enredó. Cambiaste de tarea. Quieres arrancar fresco pero sin reabrir Claude.
/clear borra el historial de la sesión actual y te deja con el contexto vacío. Es el comando que más uso después de /model.
/compact · comprimir el contexto
La barra del statusline está en rojo. Llevas una hora en la misma sesión y no quieres perder el hilo. /compact resume todo lo que llevas y arranca con el resumen.
Pierdes detalle. Mantienes la dirección. Útil cuando vas a la mitad de un refactor largo y todavía falta.
/permissions · qué tools corren sin pedir permiso
Acá decides qué comandos puede ejecutar Claude en automático y cuáles te tiene que preguntar.
Lo abro la primera vez que instalo Claude Code en una máquina nueva, configuro los Bash permitidos que uso a diario (git status, git diff, npm install, ls), y lo dejo así.
/agents · ver agentes disponibles
Lista los agentes que tienes definidos en .claude/agents/. Si estás arrancando, esto va a salir vacío. Es ok. Más adelante, cuando empieces a crear agentes pre-definidos, los ves todos acá.
4 · Background agents (/bg)
A veces necesitas que Claude haga tres cosas a la vez. Investigar una librería, refactorizar un componente y generar copy para un post. Si las haces en serie, te bloqueas. Si las mandas en paralelo, sigues conversando en el chat principal mientras los otros trabajan.
Eso es /bg. Lanza la tarea a un agente nuevo, en background, y tu sesión principal queda libre.
Cuándo lo uso
- Investigación larga. "Lee la documentación de Nuxt 4 y resume los breaking changes vs Nuxt 3." Tres minutos de lectura mía esperando, vs cinco segundos de pasarlo al background.
- Refactor pesado. "Migra estos 8 componentes a la nueva API." Lo mando al background y sigo escribiendo la guía mientras tanto.
- Generación que tarda. "Genera 5 versiones de copy para este hero." Lo dejo trabajando y reviso cuando vuelve.
- Búsquedas en bibliotecas grandes. "Encuentra todas las referencias a
oldFunctiony lista archivos." Background. Sigo en lo mío.
Cómo se invoca
Dentro de una sesión de Claude Code, escribes /bg y le pides la tarea:
> /bg investiga las 3 librerías más usadas para validación de formularios en Vue 3 y resume pros/contras
Claude lo dispara a un agente nuevo. Tú sigues chateando.
Para ver el estado de los agentes que tienes corriendo, abres el panel de agentes (Agent View). Desde una terminal normal:
claude agents
Te muestra todos los agentes activos, cuánto llevan corriendo, y cuáles ya entregaron resultado.
Cierre
Si llegaste hasta acá, tu Claude Code ya no te deja a ciegas. Checklist final:
Statusline visible al final de tu terminal
Dos líneas, todo el rato. Modelo, branch, costo, contexto, husos horarios, tasa COP.
Sabes ciclar entre los 3 modos con Shift+Tab
Default, Auto, Plan. Cada uno con su caso.
Conoces los 7 comandos slash que más se usan
/model, /rewind, /effort, /clear, /compact, /permissions, /agents.
Sabes lanzar tareas en background con /bg
Y abrir Agent View con claude agents desde una terminal normal.
Sigue leyendo
Esta es la base. Si te sirvió, en la biblioteca hay tres guías que continúan justo desde acá:
¿Algo no te funcionó? ¿Tu setup quedó distinto y quieres contarme? Escríbeme por DM en @santaia.lab.