Tokens de Codex CLI: leerlos y luego reducirlos
Codex te dice lo que gastó después. Aquí está cómo verlo antes, y qué mueve la cifra.
Las sesiones de Codex CLI tienen la misma forma que cualquier sesión de agente: una pregunta pequeña envuelta en mucho contexto. La diferencia es que una parte apreciable de ese contexto es ambiental. Está ahí antes de que escribas nada.
Entrada ambiental: la parte que no pediste
Antes de cada petición, Codex tiene sus instrucciones e información sobre las herramientas disponibles. Desde septiembre de 2026, Codex puede aplazar herramientas MCP localizables tras la búsqueda de herramientas, así que no todos los esquemas detallados tienen que cargarse al principio. Un servidor que no uses aún puede aportar metadatos de búsqueda; el volumen depende de las herramientas activadas y de la versión de la CLI.
Esto se puede medir sin gastar cuota, lo cual es inusual y conviene saberlo:
codex debug prompt-inputImprime lo que se enviaría. Determinista, repetible y no cuesta nada.
Ejecútalo en tu máquina y lee el total. El resultado depende de los plugins, las skills, los servidores MCP activados y la versión de la CLI: mide tu configuración en vez de fiarte de una cifra ambiental genérica.
Entrada de sesión: la parte que controlas
Sobre la entrada ambiental se apila lo que todo agente acumula: archivos leídos, comandos ejecutados y el hilo hasta ahora. Las palancas son las que funcionan en todas partes.
- Nombrar el archivo en vez de dejar que el agente lo encuentre.
- Una sesión por tarea, cerrada cuando la tarea termina.
- Filtrar las salidas ruidosas antes de que lleguen al hilo.
- Poner un techo al contexto y mantenerlo.
Ejecutar Codex con presupuesto
capsul conduce la CLI de Codex en la que ya has iniciado sesión, así que responde tu plan de ChatGPT existente. La continuación, el uso y el esfuerzo de razonamiento se te devuelven donde puedes verlos.
npm i -g @penra/capsulcapsul ask 'añade paginación al endpoint de búsqueda' --budget 3000Leer las cifras con honestidad
Dos advertencias válidas para cualquier banco de tokens, el nuestro incluido. Primera: entrada ponderada y entrada en bruto son mediciones distintas, porque la entrada en caché se factura a una fracción de la entrada nueva, así que una comparación que ignore la caché favorece al brazo que mejor cachea. Segunda: un ahorro en una tarea no es un ahorro en la siguiente. Nuestra propia tabla tiene una fila donde capsul usa más entrada ponderada, y se publica en lugar de retirarse.
Preguntas
¿Cómo veo el consumo de tokens de Codex sin gastar cuota?
codex debug prompt-input imprime lo que se enviaría para una entrada dada sin llamar a ningún modelo. Es determinista, así que puedes medir un cambio ejecutándolo dos veces.
¿capsul necesita una clave de API de OpenAI?
No. Conduce la CLI de Codex en la que ya has iniciado sesión, así que responde tu plan de ChatGPT. Una clave de API es una opción por sesión en cualquier plan.
¿Reducir la entrada cambia el esfuerzo de razonamiento?
Son independientes. El esfuerzo es un ajuste aparte, devuelto a capsul junto al uso, y puedes fijarlo por petición.
¿Los servidores MCP cuestan tokens aunque no se usen?
Algunos metadatos aún pueden ocupar contexto, pero el esquema completo de una herramienta no se carga necesariamente en cada petición. Desde septiembre de 2026, Codex puede aplazar las herramientas MCP localizables tras la búsqueda de herramientas y cargar las definiciones pertinentes cuando las necesita; el volumen depende de las herramientas activadas y de la versión de la CLI.
$ npm i -g @penra/capsul