Tus agentes dejan de empezar de cero: el plugin de Hilbana para Claude Code

El plugin de Hilbana para Claude Code ya está publicado en un repositorio público. Son dos líneas:

/plugin marketplace add hilbana/claude-plugin
/plugin install hilbana@hilbana

Reinicias, pegas tu clave de API y a partir de ahí tus agentes tienen memoria del proyecto, tiran de una cola de trabajo y el gasto de tokens queda imputado a la tarea concreta que estaban haciendo.

El problema no era conectar el MCP

Conectar Claude Code con Hilbana ya se podía hacer con una clave de API y un comando. Lo que no se resolvía con eso son las tres cosas que se rompen cuando de verdad trabajas así todos los días.

Cada sesión nueva empieza en blanco. Cierras Claude Code y con él se va todo: por qué esa rejilla lleva un min(), cuál fue la causa raíz del bug de la semana pasada, que en este repo los comentarios de plantilla van entre llaves. Mañana lo vuelves a explicar. Y pasado.

Nadie sabe cuánto cuesta una tarea. Ves la factura del mes y no ves qué se llevó el dinero. La pregunta útil no es «cuánto gasté», es «cuánto costó cerrar esta issue», y esa nadie te la contestaba.

Dos agentes chocan. Si lanzas varios en paralelo sin nada que reparta el trabajo, acaban los dos en la misma tarea.

Qué instala

Memoria por proyecto. Un hook al abrir el repositorio le recuerda al agente que cargue lo que ya se sabe, y otro al cerrar guarda un resumen de la sesión. El ámbito es el nombre de la carpeta, así que funciona en cualquier repositorio, no solo en los que tienes como proyecto en Hilbana. Es el sustituto de engram, y el plugin trae un comando para migrar lo que ya tuvieras.

Contabilidad de tokens por tarea. El plugin lee la transcripción, calcula el gasto real y lo manda solo. El servidor decide a qué issue imputarlo mirando cuál tiene reclamada el agente en ese momento.

Aquí hay una decisión de diseño que merece explicarse, porque es contraintuitiva: lo mide el hook, no el agente. Podríamos haberle pedido al modelo que reportara su propio consumo al terminar. No lo hacemos porque un modelo no sabe lo que consume, y si se le pregunta, contesta un número plausible que se ha inventado. Un dato inventado es peor que ninguno: parece una métrica.

Un detalle del mismo estilo: el cálculo deduplica por identificador de mensaje. El mismo mensaje aparece en varias líneas de la transcripción, y sumar por línea infla la cifra alrededor de un 80%.

Los comandos del ciclo. Son el framework de trabajo humano + agente hecho comandos:

• /hilbana-plan convierte un objetivo en un grafo de sub-issues y encola las que ya se pueden hacer.
• /hilbana-claim-next coge la siguiente issue lista y la arranca. La cola es atómica, así que dos agentes pidiendo a la vez nunca reciben la misma.
• /hilbana-finish verifica la definición de «hecho», comenta, registra la ejecución y suelta el bloqueo.
• /hilbana-review cierra o devuelve.

La regla que sostiene esto: un trabajador nunca cierra su propio trabajo. Se para en In Review. No es burocracia, es que un agente que se aprueba a sí mismo no está aportando ninguna garantía; solo está moviendo una tarjeta.

Cuándo usar el plugin y cuándo no

Hay tres vías para conectar Hilbana con Claude y no compiten:

• El plugin, si trabajas en Claude Code dentro de tu repositorio. Es la única que trae memoria, comandos y medición de gasto.
• El conector, si lo que quieres es consultar y operar tú mismo desde claude.ai, en web o escritorio, sin gestionar ninguna clave.
• La clave de API, si vas a conectar tus propios agentes o un entorno de CI.

Por dónde empezar

La guía completa, con requisitos, configuración, verificación y los fallos típicos, está en Plugin para Claude Code.

Lo esencial: te hace falta Claude Code, Node 18 o superior en el PATH (los hooks corren con node) y una clave de API del workspace en el que trabajas, que se crea en Ajustes → API keys. Si aún no tienes espacio, créalo gratis: el plan Free no caduca ni pide tarjeta.

El código del plugin es público y va con licencia MIT, en github.com/hilbana/claude-plugin. Si algo no encaja con tu forma de trabajar, ábrenos una issue allí: los comandos son ficheros de texto y se pueden discutir.