Codex no tiene un único número que responda a todas las preguntas sobre token usage. Lo primero es decidir qué quieres medir: la sesión actual de CLI, una línea de estado visible mientras trabajas, la quota o credits de ChatGPT/Codex, la facturación de OpenAI API, el usage de una sola respuesta o el historial local de esta máquina.
Si estás dentro de Codex CLI, el primer comando es /status. Si quieres mantener contadores visibles mientras trabajas, configura /statusline. Si preguntas por quota o credits del plan, ve a los ajustes de uso de Codex o ChatGPT. Si preguntas por API key spend, usa OpenAI Platform Usage. Si preguntas por una llamada concreta, revisa el objeto usage de la respuesta completada.
No empieces por scripts de JSONL local ni por snippets de private endpoints. Pueden servir para una estimación personal, pero no son un registro oficial de billing y pueden exponer prompts, rutas de archivos, código o datos de clientes.
- Sesión actual de CLI:
/status - Footer visible en CLI:
/statusline - Quota o credits de ChatGPT/Codex: ajustes de uso de Codex o ChatGPT
- Gasto con API key: OpenAI Platform Usage
- Una llamada API:
usageen la respuesta completada - Historial local: logs locales de Codex, solo como estimación
Respuesta rápida: elige el medidor correcto
La pregunta útil no es “cuántos tokens ha usado Codex en total”. La pregunta útil es “qué registro debe demostrar este número”. Una sesión de CLI, una quota de suscripción, API organization usage, usage de una respuesta y logs locales son registros distintos. Compararlos como si fueran un solo ledger produce falsas alarmas.
| Pregunta | Primer lugar que mirar | Qué prueba | Qué no prueba |
|---|---|---|---|
| Cuánto usa esta sesión de Codex CLI | /status dentro de CLI | Configuración y token state de la sesión actual | Historial de cuenta o API bill |
| Cómo dejar contadores visibles | /statusline | Footer counters y contexto en el TUI | Uso histórico en otros dispositivos |
| Cuánta quota o credits quedan | Ajustes de uso de Codex o ChatGPT | Subscription-side usage y credits | API-key spend |
| Cuánto gastó mi API key | OpenAI Platform Usage | API usage por organization o project | Quota de ChatGPT/Codex |
| Cuántos tokens usó una llamada | Completed response usage | Input, cached input, output, reasoning y total fields donde existan | La factura mensual completa |
| Qué pasó localmente | Local Codex logs | Actividad aproximada en esta máquina | Official billing, cloud usage u otros equipos |
A fecha de 23 de mayo de 2026, los límites de plan, credits, disponibilidad de modelos y etiquetas de UI de Codex siguen siendo datos volátiles. Los comandos de CLI y el concepto de response usage son más estables que la etiqueta exacta de una pestaña.
En CLI empieza por /status
En Codex CLI, /status responde a una pregunta concreta: qué ocurre en la sesión de terminal activa. Puede mostrar model, configuration, context pressure y token usage de la superficie actual. No es un historial global de la cuenta.
text/status
Lee la salida como evidencia de sesión. Sirve para saber si la tarea actual se volvió pesada, si el modelo activo es el esperado o si el route coincide con lo que creías. No sirve para demostrar cuánto queda de tu plan ChatGPT, cuánto gastó una API key ayer ni qué hizo otro ordenador.
Lo que ves en /status | Lectura correcta | Lectura incorrecta |
|---|---|---|
| Model o session configuration | Configuración actual de CLI | Política permanente de cuenta |
| Context o token usage | Estado de la sesión activa | Monthly invoice |
| Limit hints | Señal del Codex route actual | Prueba de quota entre productos |
El flujo práctico es guardar la salida de /status y decidir si el problema sigue en CLI o ya pertenece a subscription usage o API billing.
/statusline muestra estado, no facturación
/statusline sirve para ver estado mientras trabajas. Puede poner model, context, limits, token counters, git, session, current directory y Codex version en el footer del TUI.
La diferencia importa. /status es una consulta puntual. /statusline es una superficie de visualización. Ayuda a detectar presión de contexto durante una edición larga, pero no se convierte en un dashboard histórico.
Buenos usos:
- observar context pressure durante un refactor largo
- confirmar model y session al cambiar de proyecto
- decidir si conviene compactar o dividir una tarea
- evitar llamadas repetidas a
/status
Malos usos:
- probar historical spend
- reconciliar ChatGPT quota con API billing
- estimar actividad de otro ordenador
- sustituir OpenAI Platform Usage
Si la pregunta es “qué ocurre en este terminal ahora”, sigue en CLI. Si la pregunta es “qué ha usado mi cuenta o mi API key”, cambia a la superficie oficial correspondiente.
Quota y credits de ChatGPT/Codex
La parte de suscripción es donde más se mezclan términos. Codex plan quota, credits, CLI session y API organization bill no son el mismo número. Si usas ChatGPT sign-in, Codex app, cloud tasks o workspace Codex, empieza por los ajustes de uso de Codex o ChatGPT.
Esta superficie responde preguntas como:
- Cuánto included Codex usage queda en mi plan
- Si alcancé un plan limit o credit limit
- Si credits aplica a este route
- Si la sesión está usando ChatGPT sign-in o API key
No conviene convertir esta comprobación en una tabla completa de planes. Las ventanas, credits y opciones al llegar al límite pertenecen a la guía OpenAI Codex usage limits. Aquí el objetivo es más estrecho: escoger el medidor antes de confiar en la cifra.
Para soporte, guarda account, workspace o plan, Codex route, usage surface revisada y timestamp. Un número sin esos datos casi nunca permite diagnosticar.
API billing y response usage son otra vía
Si aparece API key, project, organization, service account, SDK o backend integration, estás en la vía API. OpenAI Platform Usage responde por organization o project usage. El usage de una completed response responde por el token accounting de una llamada.
| Pregunta API | Superficie | Mejor evidencia |
|---|---|---|
| Cuánto usó una organization o project | OpenAI Platform Usage | Time range, project/org scope, billing period |
| Cuántos tokens usó una llamada | Completed response usage | response id, model, usage fields |
| Por qué API cost difiere de Codex CLI | Route comparison | API key billing está separado del plan ChatGPT/Codex |
Una forma mínima de registrar una llamada:
json{ "response_id": "resp_...", "model": "gpt-...", "usage": { "input_tokens": 1200, "cached_input_tokens": 800, "output_tokens": 350, "total_tokens": 1550 } }
Esto ayuda para request-level accounting, debugging y cost attribution. Aun así, no dice cuánto Codex quota queda en ChatGPT subscription. Si el workflow pasó de ChatGPT sign-in a API key, también cambió el medidor de uso.
Si la decisión de route sigue confusa, lee Codex API key vs subscription. Primero separa route; después compara usage.
Historial local: útil, pero no oficial
Los local Codex logs pueden ayudar a entender qué pasó en esta máquina: qué proyecto tuvo sesiones largas, si ayer hubo una tarea grande o qué directorio generó más actividad. Son débiles como prueba de billing o quota.
Antes de parsear archivos locales, usa esta frontera:
| Pregunta local | Interpretación segura | Riesgo |
|---|---|---|
| Sessions en esta máquina | Actividad local aproximada | Faltan otros dispositivos y cloud surfaces |
| Token-like fields en session files | Personal estimate | El significado del campo puede cambiar |
| Prompt o transcript text | Debug context | Puede exponer code, paths, secrets o customer data |
| Private backend endpoints | No usar como normal path | Fragile, unsupported, account risk |
Si ejecutas un parser, mantenlo read-only, privado y con alcance limitado. No pegues transcripts completos en herramientas públicas. No llames official ledger a un total local JSONL. La frase honesta es: el historial local estima lo que esta máquina registró.
Por qué las cifras no coinciden
Los usage numbers de Codex y OpenAI suelen no coincidir porque contestan preguntas distintas.
| Desajuste | Causa probable | Siguiente paso |
|---|---|---|
/status alto, Platform Usage bajo | CLI session tokens no son API organization spend | Separar CLI y API |
| Platform Usage sube, Codex quota no cambia | El trabajo usó API key | Revisar project key y billing owner |
| ChatGPT/Codex quota cambia, API logs no | El trabajo usó subscription Codex | Revisar signed-in account y workspace |
| Local logs no coinciden con dashboard | Logs incompletos y local-only | Usar official dashboard para account evidence |
Per-call usage no suma exactamente la invoice | Pricing, cached tokens, time range, scope y rounding | Comparar dentro de la misma vía API |
No fuerces una reconciliación entre superficies. Clasifica el número y compáralo solo con evidencia del mismo tipo.
Qué guardar antes de pedir soporte
Para un problema de CLI:
- salida de
/statusen la sesión activa - Codex version, model y project directory
- si usaste ChatGPT sign-in o API key
- approximate time window
Para un problema de subscription quota:
- captura de la usage surface de Codex o ChatGPT
- plan o workspace type
- si credits está involucrado
- timezone y time window
- cloud tasks, local messages o code reviews
Para un problema de API billing:
- organization y project scope
- API key owner o service account, sin mostrar la key
- Platform Usage time range
- representative completed response
usage - model names y request ids
Así support o un admin puede mirar el medidor correcto. “Codex token usage está mal” es demasiado amplio. “Estoy comparando /status, ChatGPT quota y Platform Usage de routes distintos” sí se puede diagnosticar.
Preguntas frecuentes
¿Cómo veo token usage en Codex CLI?
Ejecuta /status dentro de la sesión activa de Codex CLI. Sirve para current session state, no para account-wide history.
¿Qué hace /statusline?
/statusline configura el footer del Codex TUI. Puede mostrar counters y context mientras trabajas, pero no es un billing dashboard.
¿Dónde veo Codex plan quota o credits?
En los ajustes de uso de Codex o ChatGPT para la cuenta iniciada. UI labels, credits y plan rules deben revisarse con la cuenta actual.
¿Dónde veo OpenAI API token usage?
Organization o project usage se ve en OpenAI Platform Usage. El token count de una llamada se ve en el usage de la completed response.
¿Por qué Codex CLI usage no coincide con Platform Usage?
Porque son medidores distintos. CLI usage describe la active session; Platform Usage describe API organization o project.
¿Los local Codex logs muestran tokens históricos?
Pueden estimar actividad local en esta máquina. No prueban official account-wide usage y pueden contener sensitive context.
¿Debo usar private endpoint scripts?
No como normal path. Usa primero supported CLI commands, account usage settings, Platform Usage y completed response usage.