Cuánto cuesta realmente Codex CLI
Inicio con plan vs clave API, caché automático y la matemática de tokens de sesiones agénticas — el panorama de costes del agente de código de OpenAI.
Los usuarios de Codex CLI se dividen en dos bandos: los del plan ChatGPT que nunca ven un contador de tokens y los de clave API que no ven más que contadores de tokens. Ambos adivinan — el bando del plan no ve el medidor, el bando de la API no ve el comportamiento del modelo. Este es el panorama de costes de Codex CLI: qué modo factura qué, a dónde van los tokens y por qué las sesiones agénticas se comportan distinto de un chat.
Transparencia desde el principio: opero Teapot Router, un gateway que sirve a Codex CLI y Claude Code en protocolos OpenAI-compatible y Anthropic. La mecánica de abajo vale para cualquier endpoint OpenAI-compatible.
Dos modos, dos realidades de medición
Codex CLI corre en dos modos con facturación fundamentalmente distinta. Inicio con plan: el uso viene incluido en una suscripción ChatGPT hasta límites, y ves un indicador de cuota, no una factura — barato hasta chocar con el muro, luego limitado. Modo clave API: cada token se mide y se tarifica por modelo — ahí viven de verdad las preguntas de coste. Los equipos que necesitan ver cuánto cuesta el trabajo usan clave API; los que solo necesitan el trabajo usan planes hasta que los límites muerdan.
A dónde van los tokens en una sesión agéntica
Una sesión de Codex no es un chat; es un bucle de llamadas a herramientas, lecturas de ficheros y ediciones, y cada vuelta reenvía el contexto de trabajo. La factura la mueven las mismas tres variables de cualquier agente de código:
- Vueltas por tarea — los agentes iteran; un refactor son decenas de idas y vueltas facturadas, no un prompt.
- Crecimiento de contexto — cada fichero leído y resultado de herramienta viaja en las vueltas siguientes; el mensaje 20 paga otra vez por los mensajes 1-19.
- Comportamiento de caché — OpenAI descuenta prefijos repetidos automáticamente; no lo configuras, pero la forma de tu sesión decide cuánta factura recibe el descuento.
El intercambio que hace la caché automática
El caché de prompt de OpenAI no requiere configuración: los prefijos estables repetidos se descuentan al acertar. La contrapartida es el control — recibes el descuento cuando la forma de tu sesión resulta ser cache-friendly, y no puedes etiquetar ni dirigir como permite el caché estilo Anthropic. Consecuencia práctica: la disciplina de sesión (tareas con ámbito, sesiones nuevas, prefijos estables y aburridos) mueve tu tasa efectiva más que la elección de modelo, y no existe knob que compense un contexto caótico.
Codex a través de un gateway
El modo clave API también es el modo enrutables: cambia un base_url y Codex habla con cualquier endpoint OpenAI-compatible. Ahí es donde los equipos ponen un gateway — un pool compartido en vez de claves por desarrollador, medición por petición (modelo, tokens, aciertos de caché, coste exacto) en vez de un misterio mensual, y consolidado de gasto a nivel organización. La medición es el punto: el modo plan esconde cuánto cuesta el trabajo; un gateway medido lo muestra, por tarea, por clave, por proyecto.
Elige el modo a propósito: planes para incluido-y-opaco, clave API para medido-y-auditable. Luego gestiona las tres variables que deciden la factura de la API — vueltas, crecimiento de contexto, forma de sesión cache-friendly — porque en coding agéntico dominan todo lo demás.
Preguntas frecuentes
¿Codex CLI es gratis con un plan ChatGPT?
El uso viene incluido hasta los límites del plan — pagas la suscripción, no por token, y al pasarte llega limitación, no factura. Las cargas pesadas suelen acabar en modo clave API.
¿El caché de prompt aplica a sesiones Codex?
Sí — los prefijos estables repetidos reciben descuento automático en los endpoints OpenAI. No lo configuras; la forma de la sesión (tareas con ámbito, contexto estable) determina cuánta factura se descuenta.
¿Puedo apuntar Codex CLI a mi endpoint?
Sí — define la base URL a cualquier endpoint OpenAI-compatible. Los gateways añaden medición por petición y pools de equipo encima; el protocolo es el mismo.