Saltar al contenido
Proyectos

Claude Kit

En vivo usable

La 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
publica filtradogit pull --ff-onlylista del espejosync-to-homesync-from-homecompara derivacorre suitescarga al arrancarJSON por stdinpayload por stdinlee umbraleslogs y borradoressnapshot de sesión--drifthooks, HOME falsoumbrales de derivatexto de la barraejecuta verify.shrepo fuente · fuera de este repoFuente privada y filtrotools/build-kit.sh (el script noestá en este repo)externo · gitGitHubrepo público, rama mainrepo · clon localRepo Claude Kithome/.claude · templates · docs ·testsscripts · bashScripts de espejosync-to-home.sh · sync-from-home.sh· mirror-lib.sh · kit-update.shscript · bashverify.shcomprobaciones con eval · jq · gitpruebas · bashPruebasdirectorio de usuario · cada máquinaConfiguración instalada~/.claudeexterno · sesión de trabajoSesión de Claude Codeproceso de Claude Codehooks · bash + jqCinco hookslog-event · session-drift-warn ·precompact-draft · compact-reinject· log-tool-failuredatos · JSONUmbralesrules/thresholds.jsonscript · bash >= 4.2Barra de estadostatusline.sh · jq · gitarchivos localesRegistros y estadoevents.jsonl · tool-failures.jsonl ·snapshots · docs/handoffsC4 · nivel 2 (contenedores) · tráfico ambiente = llamadas reales · clic en una caja para el detallelínea continua = HTTP/SQL · punteada = adaptador elegido por configuración · caja punteada = existe fuera del proyecto
abrir en pestaña ↗

Flujos que se pueden reproducir

  1. Instalar o actualizar el kit
  2. Una sesión lee las reglas y un hook actúa
  3. La barra de estado se repinta
  4. Módulo enjambre: la guardia de ssh
  5. 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…
Parte del Ecosistema Claude Code →

Proyectos hermanos

Aprende cómo se hizo → Code Like Me