Context-mode y TokenEconomizer reducen el contexto que gasta tu agente de código desde lados opuestos: context-mode recorta lo que devuelven las herramientas y TokenEconomizer, lo que se carga antes de empezar. En nuestra prueba de context-mode 2.2.1, un log de tests de 174 KB llegó al agente como 6,5 KB y los tres fallos seguían ahí.
yoDEV Tested · 19 de noviembre de 2026
Probamos context-mode 2.2.1 como plugin de Claude Code 2.1.328 en un contenedor Linux, con Node 22 y Node 24, sobre un log de tests, el historial de Git de Express y su changelog. Los resultados que reportamos como nuestros salen de esa prueba.
A TokenEconomizer lo probamos en octubre. Por eso la pregunta útil no es cuál gana, sino qué mitad del problema de contexto tienes tú.
¿Qué es context-mode, el servidor MCP que ahorra contexto?
Context-mode es un plugin y servidor MCP (un context mode MCP server, como lo buscan en inglés) creado por Mert Koseoglu que se sitúa entre las herramientas de tu agente y su ventana de contexto. Cuando un comando, la lectura de un archivo o una petición web va a producir una salida grande, esa salida no entra en la conversación: va a un índice SQLite FTS5 por proyecto, dentro de ~/.context-mode. El agente recibe un adelanto y busca en el índice solo la parte que necesita. Es context engineering aplicado a la salida de las herramientas.
Apareció como Show HN en febrero de 2026 (hilo 47148025) y ha crecido rápido: 34,3K estrellas y 2,4K forks en GitHub al momento de escribir esta nota. La línea 2.x es nueva (la 2.0.0 llegó a npm el 4 de noviembre de 2026 y la 2.2.1 el 17 de noviembre) y cambió lo suficiente como para que las guías de instalación anteriores ya no coincidan.
El plugin gratuito, que el proyecto llama Engine, se ejecuta en local, no envía telemetría según el proyecto y tiene licencia Elastic License 2.0. Eso es source-available, no open source en el sentido de la OSI: puedes usarlo, modificarlo y redistribuirlo, pero no ofrecerlo como servicio alojado.
¿Cómo ayuda context-mode a ahorrar tokens en Claude Code?
Trabaja sobre la salida, es decir, sobre lo que devuelven tus herramientas. Tres mecanismos hacen el trabajo:
- Ejecución en sandbox.
ctx_executeejecuta shell, Python, JavaScript, TypeScript o PowerShell en un subproceso. Las salidas pequeñas vuelven tal cual; las grandes vuelven como un adelanto del final más una llamada actx_searchlista para usar, con el texto completo indexado. - Hooks que redirigen. En Claude Code, el plugin registra hooks en PreToolUse, PostToolUse, SessionStart y UserPromptSubmit. En nuestra prueba, un
Readsobre un archivo de 174 KB fue denegado con una indicación para usarctx_execute, unWebFetchse redirigió actx_index+ctx_search, y uncatsimple del mismo archivo se dejó ejecutar, pero después sus 174 KB de stdout se reemplazaron por un resumen de 425 bytes. - Un diario de sesión. Las ediciones de archivos, los errores y las decisiones quedan registrados para que, después de la compactación (compaction),
ctx_resumepueda reconstruir un resumen de hasta 2 KB sin llamar al modelo.
La versión 2.2.1 expone nueve herramientas: ctx_execute, ctx_batch, ctx_index, ctx_search, ctx_resume, ctx_stats, ctx_doctor, ctx_upgrade y ctx_purge. Al momento de publicar esta nota, el README de la rama principal todavía enumera once, entre ellas ctx_fetch_and_index y ctx_insight, que no están en la 2.2.1. Fíate de lo que te muestren ctx_doctor y tu agente.
¿Qué resultados dio nuestra prueba de context-mode?
Instalamos la 2.2.1 como plugin de Claude Code (versión 2.1.328) y controlamos su servidor MCP y sus hooks directamente. Un límite, de entrada: no teníamos una sesión con modelo disponible, así que medimos la plomería (lo que vuelve de cada llamada), no si un modelo sigue las redirecciones por su cuenta, y no probamos la compactación.
| Carga de trabajo | Salida original | Llegó al agente | ¿Respuesta completa? |
|---|---|---|---|
| Log de tests, 3.000 tests, 3 fallos | 174.179 B | 6.513 B (ejecución + una búsqueda) | Sí: los 3 fallos con su mensaje de error |
Repositorio real: git log --stat -n 300 sobre Express |
168.193 B | 5.661 B | En parte: los archivos correctos, sin los hashes de commit |
History.md de Express indexado y consultado |
121.595 B | 2.451 B | Sí: los dos cambios incompatibles de res.redirect en Express 5 |
ls sobre una carpeta pequeña |
30 B | 44 B | Sí, con una pequeña sobrecarga |
Tres cosas destacaron:
El adelanto no es la respuesta. La primera respuesta sobre el log mostró el final de la salida y la línea de resumen (“3 failed, 2997 passed”), pero ninguno de los fallos. Los fallos llegaron con el ctx_search posterior, tanto con una consulta en lenguaje natural como con la palabra clave FAILED. El flujo son dos llamadas, y el ahorro solo se sostiene si el agente hace la segunda.
La fragmentación puede dejar contexto fuera de la respuesta. En el log de Git, la búsqueda devolvió las estadísticas de archivo correctas (lib/response.js, test/res.redirect.js) separadas de los commits a los que pertenecen. Sirve para “qué cambió”, no para “en qué commit”.
ctx_stats es generoso. Reportó un 96,6 por ciento fuera de la conversación en la sesión, unos 112K tokens. Esa cifra cuenta como ahorrado un archivo indexado completo, aunque un agente sin context-mode quizá lo habría filtrado con grep en lugar de leerlo entero. Tómala como un techo.
Las cifras del propio proyecto son más altas: un ahorro mediano del 99,4 por ciento en 36 filas de benchmark de 10 KB o más, publicado con la versión 2.0. Son datos reportados por el proyecto; los nuestros están en el mismo rango para salidas grandes y no muestran ningún ahorro en las pequeñas.
¿Funciona context-mode con Node 22?
No, y es el paso con más probabilidades de hacerte tropezar. La versión 2.x requiere Node 24.15.0 o superior ("engines": {"node": ">=24.15.0"}). Con Node 22, npm solo mostró un aviso EBADENGINE, Claude Code listó el plugin como activado y el servidor MCP expuso una única herramienta, ctx_doctor. Nada falló de forma visible: simplemente no ahorras nada. Ejecutar el doctor es lo que te dice por qué. Al pasar a Node 24, el doctor dio todo en verde y aparecieron las nueve herramientas.
¿Cómo instalar context-mode en Claude Code?
Revisa primero node --version. Después, desde una terminal:
claude plugin marketplace add mksglu/context-mode
claude plugin install context-mode@context-mode
Ejecutamos ambos comandos tal cual. Abre una sesión nueva y ejecuta /ctx-doctor, que el proyecto documenta como la comprobación para cualquier agente. Para actualizar más adelante: claude plugin update context-mode@context-mode.
¿Cómo instalar context-mode en Codex CLI?
La página de instalación del proyecto y el anuncio de la 2.0 dan los mismos pasos para Codex. Estos no los ejecutamos:
codex plugin marketplace add mksglu/context-mode
codex plugin add context-mode@context-mode
npm i -g context-mode
context-mode setup --agents codex
Los dos últimos comandos son necesarios para que Codex confíe en los hooks del plugin. Otros agentes (Gemini CLI, Qwen Code, Copilot CLI, Kiro, OpenCode, Pi y más) tienen cada uno su propio comando en el anuncio de la 2.0. Cursor, que aparecía en versiones anteriores del README, no figura entre los once agentes que nombra ese anuncio, al momento de publicar esta nota.
¿Context-mode es gratis?
El Engine, el plugin local que cubre este artículo, es gratis. El proyecto también vende un producto aparte, el Gateway: un servicio alojado que se convierte en la URL base de tu agente, enruta tus peticiones por sus servidores antes de que lleguen al modelo y añade memoria entre agentes, Recall y búsqueda de sesiones. Al momento de publicar esta nota, su sitio ofrece 1.000 peticiones gratis y planes de pago desde 20 dólares al mes. Es una decisión de confianza distinta a la de un plugin local, porque tus prompts y tu código pasan por un tercero, y es lo que instala el inicio rápido de su web (npx @context-mode/cli setup). Si solo quieres la herramienta local, usa los comandos del plugin de arriba.
¿Context-mode o TokenEconomizer?
Atacan mitades distintas de la factura de contexto, así que no compiten.
TokenEconomizer, de Microsoft Research y UC Berkeley, trabaja sobre la entrada y entre sesiones: poda las herramientas que siguen cargadas sin usarse y recuerda datos del entorno que tus sesiones vuelven a descubrir una y otra vez. En nuestra prueba de octubre, la poda redujo el contexto por petición un 31 por ciento, sobre todo al quitar herramientas de conectores: unos 8.000 tokens menos en cada petición.
Context-mode trabaja sobre la salida y dentro de una sesión: reduce lo que devuelve un comando, un archivo o una página. No hace nada en una sesión que nunca produce una salida grande, y hace mucho en una que se pasa el día leyendo logs, diffs, snapshots y documentación.
| Context-mode | TokenEconomizer | |
|---|---|---|
| Qué reduce | La salida de las herramientas | Definiciones de herramientas cargadas, descubrimientos repetidos |
| Cuándo ayuda | Salidas grandes dentro de una sesión | Muchos conectores, sesiones repetidas en un mismo repositorio |
| Nuestro resultado medido | ~96% en salidas de 120–175 KB; nada en las pequeñas | 31% menos contexto por petición |
| Requisitos | Node 24.15+ | Python 3.10+ |
| Licencia | Elastic License 2.0 (source-available) | Apache 2.0 |
Si tu agente carga decenas de herramientas MCP, empieza por TokenEconomizer. Si se pasa el día leyendo ejecuciones de tests, historial de Git y documentación, context-mode es el que mueve la cifra. Si te describen ambos, pueden convivir, aunque esa combinación no la hemos probado.
¿Y tú? ¿Qué es lo que más contexto le consume a tu agente en un día normal de trabajo?
- Dejo que compacte y sigo
- Abro una sesión nueva
- Uso un plugin o un servidor MCP para reducirlo
- Prefiero otra opción (cuéntanos cuál)
Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.
