👉 Nudgeist [Plugin para Claude Code - Hooks - Node.js - Benchmarking]

Ivan Luna 14 Oct, 2026 05 min de lectura
👉 Nudgeist [Plugin para Claude Code - Hooks - Node.js - Benchmarking]

Nudgeist pide una segunda opinión antes de que un mensaje llegue a un modelo caro. Le pregunta a Haiku si alcanza con un modelo más barato o un esfuerzo menor y, cuando ese cambio conviene una vez contada la caché de prompts, retiene el mensaje una vez con esa sugerencia. Un empujón, no un cambio: no es un router, ni un proxy, ni un selector automático de modelos, y nunca cambia nada por su cuenta. Tú decides. Sin servidor, sin telemetría, MIT.

En desarrollo activo: es el proyecto en el que estoy trabajando ahora.

Ver en GitHub Documentación

Un solo modelo para cada mensaje:


Una sesión de Claude Code corre cada mensaje con el modelo y el esfuerzo que tiene configurados, así que corregir un error de tipeo recibe el mismo modelo que un rediseño. Cambiar a mano es adivinar, y la apuesta puede salir al revés: un modelo que no usaste en esta sesión tiene que leer toda la conversación desde cero, mientras que tu modelo actual la lee desde la caché de prompts, a una fracción de su precio habitual. Así que un modelo más liviano no siempre es más barato para ese turno.

Nudgeist hace la pregunta por ti, hace la cuenta de la caché y solo habla cuando la respuesta vale la pena.

Cómo decide:


  • Qué estás usando. Lee el modelo, el esfuerzo y el tamaño del contexto de tu último turno desde la transcripción de la sesión, y Claude Code le avisa de cada /model en el momento.
  • Si se puede ahorrar algo. Si nada más barato puede convenir, se salta el chequeo: sin espera y sin costo.
  • Una segunda opinión. Haiku lee tu mensaje y un resumen breve: el título de la sesión, el nombre de la carpeta del proyecto, tus últimos pedidos, el final de la última respuesta de Claude, los archivos en juego con sus tamaños y el tamaño de la conversación. Nunca abre tus archivos.
  • Si cambiar conviene. Hace la cuenta de la caché con precios de lista y la duración de caché que tu sesión realmente usa, y sugiere un modelo solo cuando reduce al menos a la mitad el costo del turno. Cuando no, puede sugerir un esfuerzo menor.
  • Una pregunta, y después silencio. Retiene un mensaje una sola vez. Si mantienes tu modelo dos veces seguidas, se queda callado el resto de la sesión.

Tú decides:


El aviso te repite tu mensaje, así que no se pierde nada. Envíalo de nuevo sin cambios para mantener tu modelo, o antepón un comando para correr ese único mensaje más liviano. En cualquier caso, tu siguiente mensaje corre con el modelo y el esfuerzo que elegiste para la sesión. Después del primer turno con un modelo 5.5, un aviso que sugiere un modelo más liviano también muestra el costo estimado de las dos opciones.

  • /nudgeist:haiku <mensaje> corre este único mensaje en Haiku.
  • /nudgeist:sonnet <mensaje> lo corre en Sonnet.
  • /nudgeist:low <mensaje> y /nudgeist:medium <mensaje> lo corren en tu modelo con un esfuerzo menor.
  • /nudgeist:check <mensaje> le pregunta a Haiku cuál de estas opciones encaja, sin hacer el trabajo.

No se interpone en los comandos, en claude -p ni en las sesiones del SDK o en segundo plano: nunca se retienen. Cualquier error, timeout o veredicto poco claro deja pasar el mensaje, y NUDGEIST=off lo apaga.

Lo que cuesta:


Cada mensaje revisado cuesta una llamada a Haiku: unos 1.200 tokens y normalmente unos 2 segundos (mediana de 1,9 s; 27 de 36 llamadas tardaron entre 1,5 y 3 s, y 2 tardaron más de 8 s), medido en Claude Code 2.1.296. Los mensajes sin nada que ahorrar no se revisan, y una llamada que tarda más de 8 segundos deja pasar tu mensaje sin aviso.

Las cifras de costo de un aviso usan precios de lista de los modelos 5.5. Con una suscripción pagas un plan, no por token, así que son una guía aproximada.

Comprobado, no supuesto:


El repositorio incluye un benchmark de doce tareas de código evaluadas con tests ocultos, resueltas en Haiku y en Opus, con cada corrida cruda, cada diff y cada llamada al asesor publicados y con su hash. El 13 de octubre de 2026, Haiku 5.5 aprobó las doce. De 36 llamadas al asesor, 16 sugirieron Haiku y 20 se abstuvieron; ninguna sugirió Haiku donde fallaba.

Los límites se publican junto con los resultados. Como Haiku nunca falló, el error caro (sugerir Haiku donde falla) sigue sin probarse, y para eso hacen falta tareas más difíciles. Las tareas son mías y las muestras son pequeñas, así que los números son una señal, no una prueba. Esas corridas usaron una versión anterior del resumen de la sesión, y las sugerencias de esfuerzo no se evalúan.

Dos ediciones:


  • Edición completa (el repositorio): los hooks que miran cada mensaje antes de enviarlo, más los cinco comandos.
  • Edición de comandos: el directorio de plugins de Anthropic acepta hooks en segundo plano solo de organizaciones verificadas, así que la edición enviada ahí tiene solo los cinco comandos, sin hooks y sin código.

Instalación:


# Claude Code, edición completa
/plugin marketplace add nudgeist/nudgeist
/plugin install nudgeist@nudgeist

# Uso
/nudgeist:check renombra el cargador de config        # qué modelo o esfuerzo encaja, sin hacer el trabajo
/nudgeist:haiku corrige el error de tipeo del README  # corre este único mensaje en Haiku

Necesita Node.js 18 o posterior: los hooks corren con node.

Stack técnico:


  • Runtime: Node.js 18+, ESM, sin dependencias. Los hooks son scripts locales que leen la transcripción de la sesión y devuelven una decisión.
  • Integración con Claude Code:
    • tres eventos de hooks: SessionStart y PostModelSwitch para seguir el modelo de la sesión, y UserPromptSubmit para mirar cada mensaje antes de enviarlo;
    • lecturas acotadas de la transcripción de la sesión;
    • cinco comandos que invoca el usuario.
  • Modelo de costo: precios de lista, lecturas de caché frente a una lectura nueva de toda la conversación, y la duración de caché que usa la sesión.
  • Tests: npm test cubre el lector de la sesión, la cuenta de costos, el parser de la respuesta del asesor y la lógica de retener una sola vez.
  • Benchmark: tests ocultos; corridas crudas, diffs y llamadas al asesor publicados, con su hash.
  • Privacidad:
    • sin servidor y sin telemetría;
    • la segunda opinión corre a través de tu propio Claude Code y va adonde Claude Code envía normalmente tus mensajes: Anthropic, o tu gateway o proveedor de nube;
    • el archivo de estado guarda un hash del mensaje retenido, nunca su texto. Detalles en la política de privacidad.

Conclusión:


Nudgeist se construyó en octubre de 2026 alrededor de una pregunta: ¿puede un modelo rápido darse cuenta, antes de empezar el trabajo, de cuándo no hace falta uno caro? El proyecto demuestra:

  • Construir sobre el modelo de costo real de una sesión de agente: un cambio de modelo solo vale la pena una vez contada la caché de prompts.
  • Dejar a la persona al mando: pregunta una vez, después se hace a un lado, y nunca cambia nada por su cuenta.
  • Usar la API de hooks de Claude Code con un diseño que falla abierto: cualquier error, timeout o veredicto poco claro deja pasar el mensaje.
  • Medir con disciplina: un benchmark evaluado con tests ocultos, cada corrida cruda publicada con su hash y los límites expuestos junto a los resultados.
  • Respetar la privacidad desde el diseño: sin servidor, sin telemetría, y nada guardado del mensaje salvo un hash.


Etiquetas

Compartir


Proyectos relacionados

Todos los proyectos