¿Qué es TokenEconomizer?
TokenEconomizer es un plugin que abarata los agentes de código en los repositorios a los que vuelves, sin cambiar el agente ni el modelo. Tras cada sesión terminada actualiza tres cosas: micro-skills (datos del repositorio que las sesiones redescubren una y otra vez, como ejecutar python -m pytest porque falta pytest), una lista de herramientas que el repositorio nunca usa, que retira mediante la propia configuración del agente, y un loop guard que pregunta a un modelo juez si un turno que falla una y otra vez está atascado y, si es así, envía una sola redirección.
Admite Claude Code, Codex, GitHub Copilot CLI y Pi, con soporte experimental para Cursor, opencode y Hermes. La poda de herramientas y el loop guard vienen activados por defecto; las micro-skills, desactivadas. El plugin no necesita clave de API propia: sus llamadas a modelos pasan por la CLI de tu agente con tu plan actual, y lo que aprende se guarda en ~/.tokeneconomizer.
Lo acompaña el artículo TokenEconomizer: Experience-Driven Black-Box Cost Control for Coding Agents (arXiv 2610.22732), de investigadores de Microsoft Research, Microsoft Security y UC Berkeley. Está escrito en Python solo con la biblioteca estándar, requiere Python 3.10 o posterior y tiene licencia Apache-2.0. La versión 0.1.0 salió el 26 de octubre de 2026.
¿Merece la pena TokenEconomizer?
TokenEconomizer es un complemento de costes para agentes de código con un estudio controlado detrás, y ese estudio respalda una afirmación modesta y creíble: en un repositorio al que vuelves una y otra vez, el agente puede dejar de pagar por los mismos errores y por herramientas que nunca llama. El artículo ejecutó en orden 277 tareas de SWE-Bench de 6 repositorios, con tres semillas cada una, en cinco combinaciones de agente y modelo. Informa de un coste medio, teniendo en cuenta la caché, entre un 18,4 y un 30,9 % inferior al del agente sin modificar, menor en las 30 celdas de repositorio y combinación (entre un 5,2 y un 40,1 %), con las propias llamadas a modelos del plugin cargadas a la tarea que las provocó. Con el mismo montaje, RTK por sí solo subió el coste en 12 de esas celdas y RepoMap de Aider en 15.
Las salvedades están en el propio artículo. Pass@1 subió en 4 de 5 combinaciones y bajó 1,0 puntos en Claude Code con Opus 4.8; el artículo da desviaciones típicas sobre tres semillas pero ninguna prueba de significación, y la mayoría de las diferencias son de uno o dos puntos. Sus hiperparámetros se fijaron en ejecuciones de desarrollo sobre los mismos seis repositorios, las secuencias de tareas son correcciones independientes y no sesiones reales de usuarios, y los autores dicen que el uso interactivo no se ha probado. El ahorro también tarda: todos los repositorios salvo xarray costaron más al principio, y todos eran más baratos a partir de la sexta tarea.
La configuración por defecto no es la que hay detrás de la cifra estrella. El 18,4 a 30,9 % usa los tres mecanismos, pero el plugin desactiva las micro-skills por defecto. En Claude Code, la ablación del artículo atribuye a la poda de herramientas sola un 13,2 % (Sonnet 5) y un 17,7 % (Opus 4.8), a las micro-skills solas un 11,8 y un 14,3 %, y al loop guard solo un 7,1 y un 5,4 %. La única prueba independiente que hemos encontrado, de yoDEV en DEV Community antes de la etiqueta v0.1.0, encaja con eso: en 8 correcciones de errores en un repositorio Python pequeño, ejecutadas dos veces por lado, la poda retiró 284 herramientas y redujo el contexto por petición un 31 %, el coste por sesión bajó un 15 % ($0.72 a $0.61) en solo 4 sesiones, las micro-skills nunca se activaron y el loop guard nunca intervino.
El tratamiento de los datos es más limpio que en la mayoría. No hay clave de API adicional; las llamadas del juez, la redirección y el proponedor de datos pasan por la CLI de tu propio agente (claude -p, codex exec, copilot -p), con Haiku por defecto en Claude Code, y la documentación dice que ninguna llamada recibe el contenido de los archivos ni tus prompts. El juez ve las últimas 24 acciones, con los comandos cortados a 90 caracteres, como mucho unos 1.500 tokens. El estado aprendido se queda en ~/.tokeneconomizer y la documentación no menciona telemetría. Eso sí, la poda escribe listas de denegación en archivos del proyecto como .claude/settings.local.json, ocultos a git mediante .git/info/exclude.
Es una versión de investigación temprana. El repositorio se creó el 13 de octubre de 2026 y tiene unas 4.800 estrellas y 16 issues y pull requests abiertos, entre ellos una fuga de memoria en Windows en el lanzador de hooks (#144) y una condición de carrera en el loop guard cuando las herramientas se ejecutan en paralelo (#142). Está probado con rangos estrechos de versiones de los agentes, como Claude Code 2.1.300 a 2.1.310, y las versiones más nuevas no están probadas. Mientras RTK comprime la salida de los comandos, TokenEconomizer cambia lo que el agente carga y repite, así que ambos se suman: el mejor resultado del artículo con Opus 4.8, un coste un 33,2 % menor, los combinaba.
Dónde se gana su sitio
Una desarrolladora backend con plan de API que usa Claude Code a diario en un monorepo de Django
Dejar de pagar por herramientas MCP y conectores que el repositorio nunca usa
Instala el plugin y deja la configuración por defecto; tras varias sesiones, la poda escribe una lista de denegación en .claude/settings.local.json, después de una hora sin actividad para no romper una caché de prompts caliente. En la pequeña prueba de yoDEV esto retiró 284 herramientas y redujo el contexto por petición un 31 %; toolprune restore las devuelve.
Un responsable de ingeniería que vigila el gasto en agentes de un equipo de diez personas con Codex
Ver si el coste de los agentes en los repositorios principales del equipo baja de verdad
Cada desarrollador lo instala; status y el ledger.jsonl de cada repositorio informan del coste de las sesiones, incluidas las llamadas del propio plugin. Cuenta con que las primeras sesiones cuesten más y juzga el resultado tras una semana de trabajo normal, no por el 18,4 a 30,9 % del artículo.
Un desarrollador cuyo agente repite una y otra vez el mismo comando de pruebas fallido
Cortar bucles largos de fallos sin detener el agente a mano
Tras 5 turnos con éxito en el repositorio, el loop guard envía un turno que parece atascado a un juez de tu plan (Haiku por defecto en Claude Code) y redirige una vez si el juez tiene al menos 0,7 de confianza. Nunca detiene un turno por sí mismo; en ejecuciones headless, un turno marcado sigue hasta los propios límites del agente.
Antes de decidirte
- Puesta en marcha
- Requiere Python 3.10 o posterior. Clona el repositorio y deja el clon donde está, añádelo como marketplace de plugins e instala tokeneconomizer@tokeneconomizer (comandos de plugin de claude, codex o copilot); Pi lo instala directamente desde git. En Claude Code y Copilot CLI, ejecuta toolprune refresh-catalog una vez por máquina y tras actualizar el agente.
- Integraciones
- Probado con Claude Code 2.1.300 a 2.1.310, Codex 0.153.1 a 0.164.0, Copilot CLI 1.0.83 a 1.0.102 y Pi 1.2.0 a 1.3.0; Cursor, opencode y Hermes son experimentales. La poda retira herramientas sueltas en Claude Code, paquetes de capacidades en Codex y servidores MCP enteros en Copilot CLI, y nada en los demás.
- Datos y privacidad
- Datos aprendidos, pruebas de uso de herramientas, historial de bucles, un registro de costes y un registro de errores se quedan en ~/.tokeneconomizer; borrar esa carpeta elimina lo aprendido. Las llamadas a modelos pasan por la CLI de tu agente y, según la documentación, nunca incluyen contenido de archivos ni tus prompts. No hay telemetría documentada. Apache-2.0.
- Coste a escala
- El plugin es gratis; sus llamadas del juez y del proponedor se cobran en tu plan, y con la configuración por defecto solo llama a un modelo cuando un turno parece atascado. No hay edición alojada ni de pago publicada.
- Límites
- El ahorro necesita sesiones repetidas en un mismo repositorio y empieza en negativo. Con Copilot BYOK, las llamadas a modelos del plugin quedan en pausa. Ejecutar un comando del plugin dentro del agente cuesta un turno del modelo. 16 issues y pull requests abiertos, entre ellos una fuga de memoria en Windows y una condición de carrera con herramientas en paralelo en el loop guard.
Lo bueno
- Ahorro medido en un artículo con tres semillas y sus propias llamadas incluidas
- Sin clave de API adicional; las llamadas a modelos pasan por la CLI de tu agente
- El estado aprendido se queda en local, en ~/.tokeneconomizer
- Toda acción es reversible, y si el plugin falla la sesión sigue funcionando
Lo malo
- Las micro-skills, parte del resultado estrella, vienen desactivadas
- Cuesta más en las primeras tareas de un repositorio nuevo
- Hiperparámetros ajustados en los mismos repositorios en que se probó
- v0.1.0 con errores abiertos en Windows y de concurrencia, y pocas versiones de agentes probadas
Ideal para
Desarrolladores y equipos que pagan por token Claude Code, Codex o Copilot CLI y usan el agente en los mismos pocos repositorios día tras día.
Alternativas a TokenEconomizer
TokenEconomizer: preguntas frecuentes
- ¿Merece la pena TokenEconomizer?
- Un recortador de costes con un estudio real detrás, que merece la pena en los repositorios donde trabajas a diario, siempre que esperes de la configuración por defecto menos que la cifra estrella del artículo. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta TokenEconomizer?
- Gratis con licencia Apache-2.0; sus propias llamadas a modelos se cobran en tu plan o clave actual del agente.
- ¿Qué inconvenientes tiene TokenEconomizer?
- Las micro-skills, parte del resultado estrella, vienen desactivadas; cuesta más en las primeras tareas de un repositorio nuevo; hiperparámetros ajustados en los mismos repositorios en que se probó; v0.1.0 con errores abiertos en Windows y de concurrencia, y pocas versiones de agentes probadas.
- ¿Para quién es TokenEconomizer?
- Desarrolladores y equipos que pagan por token Claude Code, Codex o Copilot CLI y usan el agente en los mismos pocos repositorios día tras día.
- ¿Cuánto cuesta TokenEconomizer para un equipo o en producción?
- El plugin es gratis; sus llamadas del juez y del proponedor se cobran en tu plan, y con la configuración por defecto solo llama a un modelo cuando un turno parece atascado. No hay edición alojada ni de pago publicada.
- ¿Es TokenEconomizer seguro para los datos de la empresa?
- Datos aprendidos, pruebas de uso de herramientas, historial de bucles, un registro de costes y un registro de errores se quedan en ~/.tokeneconomizer; borrar esa carpeta elimina lo aprendido. Las llamadas a modelos pasan por la CLI de tu agente y, según la documentación, nunca incluyen contenido de archivos ni tus prompts. No hay telemetría documentada. Apache-2.0.
- ¿Cuáles son las mejores alternativas a TokenEconomizer?
- Las alternativas más cercanas que hemos analizado son rtk (Rust Token Killer), context-mode y ccusage.
Respuestas comprobadas el 5 nov 2026.