Claude Kit
En vivo usableLa configuración de Claude Code con la que construí este portafolio: reglas, agentes, hooks y una barra de estado que no miente, igual en cada máquina.
Mi configuración de Claude Code, publicada y saneada: reglas de enrutamiento por carril, seis subagentes, diez skills, cinco hooks y una barra de estado que dice la verdad sobre el contexto, la caché y el HANDOFF. Unos scripts de espejo la dejan idéntica en cada máquina sin borrar nada.
Tecnología
- IA & agentes
- Automatización
Sector
- Herramientas dev
Problema
Usaba Claude Code todo el día en tres frentes y los mismos problemas aparecían en todos: el modelo más caro haciendo trabajo de uno chico, sesiones que perdían el hilo y descubrir demasiado tarde que el contexto estaba enorme, la caché fría o el traspaso desactualizado.
Enfoque
Un repo es la fuente de verdad de lo que Claude Code lee en cada máquina: CLAUDE.md, reglas,
agentes, skills, hooks, la barra de estado y rules/thresholds.json, el único lugar con números.
sync-to-home.sh lo copia a ~/.claude con respaldo, fusiona solo las claves portables de
settings.json y nunca borra; verify.sh comprueba que aterrizó y corre las tres suites.
La barra lee el JSON que Claude Code le pasa en cada turno y lo pinta en dos líneas: contexto en
tokens absolutos, estado de la caché en una palabra (caliente, enfriando, fría) y sus
minutos, cuota del plan, git y la frescura del HANDOFF. Un dato que falta se pinta ⚠, nunca 0.
La lección 01 de la ruta Code like me la explica sector por sector. El simulador de la barra (el enlace de demo) la
muestra reaccionando a controles: cada estado es la salida real del script, pre-renderizada.
Para quien tiene más de una máquina, el módulo opcional enjambre (--with enjambre) añade un
hook que bloquea el ssh directo a los nodos y obliga a delegar por la cola de enjambre.
Límites: la barra tarda unos 476 ms en Windows, por encima de la meta de 200 ms; el CLAUDE.md
del kit son las reglas de su autor y está pensado para editarse. Código bajo Apache-2.0.
Resultado
- pruebas automáticas en verde
- 140
- statusline 67 + hooks 38 + módulo enjambre 23 + /route 12, Windows, 2026-10-15
- render completo de la barra en Windows + Git Bash
- 476ms
- docs/statusline-internals.md, 2026-09-22
- hooks del ciclo de sesión
- 5
- home/.claude/hooks, 2026-10-15
- skills
- 10
- home/.claude/skills, 2026-10-15
- subagentes por carril
- 6
- home/.claude/agents, 2026-10-15
Qué haría después
- Bajar el render de la barra o aceptar el presupuesto: 476 ms medidos contra 200 ms de meta; falta medir en la Mac.
- Portar las ideas a Codex CLI y Gemini CLI.
- Una línea UNATTENDED: para que una sesión acepte un alcance aprobado sin detenerse a preguntar.
Arquitectura
Kit de configuración de Claude Code: reglas, agentes, hooks y barra de estado que se espejan a cada máquina sin borrar nada.
- PC Windows
- Mac mini
- GitHub
Flujos que se pueden reproducir
- Instalar o actualizar el kit
- Una sesión lee las reglas y un hook actúa
- La barra de estado se repinta
- Módulo enjambre: la guardia de ssh
- Publicar la versión pública filtrada
Cómo se hizo
- 01 — Lee tu barra: qué te está diciendo Claude Code en cada turno — Mirar las dos líneas de la barra de estado y saber, en un vistazo, cuatro cosas: cuánto contexto te queda antes de que la sesión se degrade, si la caché sigue caliente, si tu trabajo está a salvo (commit, push, HANDOFF)…
- Hooks — Cinco scripts en home/.claude/hooks/, conectados en home/.claude/settings.json. Todo hook sale siempre con código 0 — un hook nunca debe ser la razón de que fallen la sesión, una compactación o la herramienta que…
Proyectos hermanos
- enjambre Programación con agentes repartida en hardware propio: una PC con Windows orquesta y una Mac mini ejecuta trabajos de Claude Code sin interfaz, cada uno en su worktree de git. Cada trabajo vuelve como una rama revisable y una línea en un registro de solo añadir, y un visor local muestra nodos, trabajos y telemetría.
- Cert Studio Un simulador estático para preparar las certificaciones CCAR-F y CCDV-F: simulacros que reparten las preguntas según el peso oficial de cada dominio, cronómetro, puntaje escalado de 100 a 1000 y cada opción incorrecta etiquetada con el tipo de trampa que representa. El progreso vive solo en el navegador. Ayuda de estudio no oficial: las 240 preguntas son originales y ninguna reproduce un ítem real del examen.