Uso, límite del plan y saldo: tres números que se confunden
Comparar el límite de uso de Claude Code con tu consumo es comparar tres respuestas a "¿cuánto he usado?", de tres lugares sin relación. Los tokens gastados salen de las transcripciones en tu disco. El porcentaje de tu plan lo da el proveedor, por la red, y solo si se lo pides. El saldo prepago viene de la API de una cuenta y no tiene que ver con ninguno de los dos. Discrepan todo el tiempo. Cada discrepancia es información, no un error.
Número uno: tokens gastados, desde tu propio disco
El primer número son los tokens gastados. Claude Code y Codex escriben una transcripción por cada sesión y en ella guardan el conteo de tokens de cada turno. Suma esos conteos en una ventana y obtienes lo que un agente consumió en las últimas 5 horas o en los últimos 7 días. Sin clave de API, sin cuenta, sin red. Los conteos de tokens se leen en local y no se envían a ningún lado.
Este número te dice si Claude Code o Codex es el más caro cuando los ejecutas lado a lado, algo que no puedes saber de otra forma mientras ambos están a mitad de una tarea. Además es el único de los tres que se separa por herramienta de agente en vez de sumarse por cuenta, aunque no por panel: dos paneles de Claude Code comparten un mismo total.
Léelo con cuidado, porque la mayoría de los tokens de una sesión larga con un agente son lecturas de caché: contexto que el agente ya envió y que la caché del proveedor devuelve en cada turno. Como total único, eso parece catastrófico.
Desglosado, la entrada nueva, la salida y las escrituras de caché juntas son una porción pequeña. Una herramienta que muestra un total enorme sin separar las lecturas de caché te enseña un número que te asustará sin motivo.
La versión en dinero del número uno, y por qué con reservas
El Token Meter de MXterm Pro pone precio a cada modelo a partir de una tabla y muestra la fecha en que se revisaron esos precios por última vez. Una tabla de precios sin fecha termina convirtiéndose en ficción sin que nadie lo note.
Un modelo sin precio publicado se deja sin precio en vez de mostrarse como US$0,00, porque "US$0,00" se lee como gratis y la verdad es "no lo sabemos". Entonces el total se etiqueta como un mínimo y no como un total, y nombra los modelos que no tenían precio.
La reserva más importante es qué significa la cifra. En una suscripción Max o Pro, la cifra en dólares es lo que habrían costado esos tokens a tarifas de pago por uso. No es tu factura. Nada en una transcripción dice qué plan pagó cada turno, así que una herramienta que solo lee transcripciones no puede saber cuánto te cobraron en realidad.
Número dos: porcentaje de tu plan
Tu disco no puede responder "¿cuánto me queda?", y esa es la pregunta que la gente hace de verdad. Nada en una transcripción de Claude Code registra en qué punto está tu suscripción: cuando el desarrollador de MXterm Pro buscó en sus propias transcripciones campos de límite de uso o de cuota, cada coincidencia era prosa dentro de un mensaje, nunca un campo de datos. El porcentaje de tu plan tiene que venir del proveedor.
En macOS, MXterm Pro obtiene el porcentaje de Claude del endpoint de uso de la propia Anthropic, con el inicio de sesión que Claude Code ya tiene guardado. Eso implica leer la credencial de otra aplicación. MXterm Pro lo hace con la herramienta security del sistema, así que macOS no pregunta cada vez. No está disponible en Windows.
El interruptor está apagado hasta que lo enciendes, y dice exactamente qué va a hacer antes de que lo actives. Si lo deniegas, la app deja de pedirlo, en vez de abrir un diálogo en cada actualización.
Codex es la excepción. Su CLI escribe los encabezados de límite de uso del plan en sus archivos de sesión, así que esos porcentajes ya están en tu disco y no necesitan credencial. El problema es la frescura: una lectura escrita durante tu último turno de Codex tiene justo la antigüedad de ese turno.
Un interruptor añadido en 1.0.22 lee el archivo de inicio de sesión de Codex y le pregunta directamente a OpenAI por las ventanas actuales de 5 horas y semanal. Usa el porcentaje del plan como el número que guía tu decisión antes de empezar algo largo.
Guía relacionadaUso de tokens de Claude Code y Codex: qué lee el Token MeterNúmero tres: lo que queda en la cuenta
El tercer número pertenece a quien le pagas de verdad, y su forma depende del proveedor. Un proveedor prepago como DeepSeek o Moonshot te da un saldo prepago: dinero que solo baja hasta que lo recargas. Un plan de programación como el de Kimi, MiniMax o Z.ai te da capacidad restante en una ventana que se renueva.
Una clave de OpenRouter muestra la parte usada de su límite de gasto si la clave tiene uno, y solo lo que ha gastado la clave si no lo tiene. MXterm Pro no lee el saldo de una cuenta de OpenRouter. Cada lectura viene del endpoint de cuenta del propio proveedor, con una clave de API que tú pegas. Esa fuente es distinta de los otros dos números, y solo ella sabe del dinero que ya pagaste.
Antes de conectar cualquiera de ellos, lee completo qué expone cada proveedor y dónde viven esas claves. Los lectores de cuenta siguen el formato de respuesta publicado por cada proveedor; aún no se han comprobado todos contra una cuenta real.
Un saldo además se resiste a convertirse en un medidor, porque no tiene denominador. US$37,40 de crédito de DeepSeek no son un porcentaje de nada a menos que inventes qué significa "lleno". MXterm Pro lo muestra como dinero y nunca lo convierte en porcentaje. Un saldo nunca compite con las ventanas de cuota por un lugar en el chip de la barra de título, y el chip muestra el saldo más bajo en USD solo cuando no hay cuota ni uso de Claude Code o Codex que mostrar.
Cuándo importa cada uno de verdad
Antes de una ejecución larga, mira el porcentaje del plan. Los tokens gastados no te dicen si vas a chocar con un muro en veinte minutos, y un saldo prepago sano no ayuda si la restricción es una ventana de suscripción de 5 horas.
Cuando ejecutas Claude Code y Codex a la vez, vigila los tokens que gastan.
Cuando algo deja de funcionar, que los tres no coincidan es el diagnóstico. Un plan al 100% con un buen saldo significa que llegaste al límite de uso, no que te quedaste sin dinero. Un porcentaje de plan sano con el saldo prepago vacío significa lo contrario. Si los tokens gastados se ven normales y los otros dos también, el problema no es la cuota.
A fin de mes, ninguno de los tres es tu factura. El costo derivado de las transcripciones usa tarifas de API, los porcentajes del plan no son dinero y un saldo es una instantánea. La página de facturación del proveedor es la autoridad, y lo único que debería zanjar una discusión sobre lo que te cobraron.
Cómo leerlos juntos sin engañarte
Leer juntos el límite de uso de Claude Code y tu consumo exige tres reglas, y valen en cualquier herramienta donde leas los números.
Primera, revisa la antigüedad de todo lo que no se calcula en vivo. Una lectura del proveedor que falló sigue mostrando su último valor bueno. Es el comportamiento correcto, pero solo si la pantalla lo dice.
Segunda, nunca conviertas uno en otro. Los tokens gastados no pueden volverse un porcentaje de un plan, porque no conoces el denominador. Un porcentaje no puede volverse dinero. Un saldo no puede volverse turnos restantes. Cada conversión necesita un número que nadie publicó.
Tercera, asocia cada porcentaje a una ventana concreta y a su hora de reinicio. "90% usado" no significa nada hasta que sabes si es una ventana de 5 horas que se reinicia en veinte minutos o una semanal que se reinicia el domingo.
En MXterm Pro cada fila nombra la ventana a la que pertenece su barra y cuándo se reinicia. Una ventana que ya se reinició muestra un guion, porque una cifra vieja pasaría por la actual. Mira también la página del Token Meter y la documentación del Token Meter.
SSH con varios paneles, Command Recipes (Cmd+J) y una Control Room (antes War Room) multiagente: gratis para empezar.
¿Ya tienes MXterm Pro? Lee la guía de configuración →
¿Nuevo en MXterm Pro? Mira los precios →
Preguntas frecuentes
Porque miden cosas distintas. Un conteo de tokens de las transcripciones locales es lo que consumió el agente de esta máquina. El panel de control de un proveedor informa lo que se facturó a tu cuenta o cuánto llevas de una ventana del plan, en todas las máquinas y herramientas de esa cuenta. Rara vez coincidirán, y ninguno está equivocado.
No. Nada en las transcripciones de sesión de Claude Code registra en qué punto está tu suscripción, así que el porcentaje tiene que venir del proveedor. Una herramienta que lo muestra sin una llamada de red y sin una credencial te da una estimación. Codex es la excepción: su CLI escribe los encabezados de límite de uso del plan en sus archivos de sesión, aunque una lectura ahí solo es tan fresca como tu último turno de Codex.
No, y así lo indica: "A tarifas de API, no lo que se facturó en una suscripción". Las transcripciones no registran qué plan pagó cada turno, así que la cifra es lo que costarían esos tokens a las tarifas de API publicadas por modelo, con la fecha en que se revisaron esas tarifas al lado. Un modelo sin precio publicado no se cuenta como US$0, y el total se marca como un mínimo.
Casi seguro por las lecturas de caché. En una sesión larga el agente reenvía contexto que ya envió, y la caché del proveedor lo devuelve en cada turno, lo que eclipsa todo lo demás. Por eso el desglose lista las lecturas de caché aparte de la entrada nueva, la salida y las escrituras de caché.
El porcentaje del plan del agente con el que vas a ejecutar algo largo, porque es el que tiene un muro detrás. Los tokens gastados sirven para comparar Claude Code con Codex. Un saldo prepago sirve para proveedores a los que pagas por solicitud y no por mes.
No para los conteos de tokens: salen de transcripciones que ya están en tu máquina, sin clave ni cuenta. Solo hace falta una clave para los saldos de cuenta de los proveedores, y cada una se usa únicamente contra su propio proveedor. Los interruptores del porcentaje del plan no usan claves de API. Reutilizan el inicio de sesión que la CLI del agente ya tiene, y siguen apagados hasta que los enciendes.