Uso de tokens de Claude Code y Codex: qué lee el Token Meter

Qué muestra el Token Meter

En cuanto un agente instalado o una clave de cuenta guardada le da algo que mostrar, el Token Meter aparece en el grupo de botones de la derecha de la barra de título y se queda ahí mientras la app está abierta, así que no tienes que abrir un panel para encontrarlo.

La barra muestra una sola cifra: la cuota más cercana a su límite entre todas las que sigues, coloreada según lo cerca que esté. Si nada de lo que has configurado publica una cuota, el chip muestra el total de tokens de 5 horas de Claude Code, o de Codex cuando Claude Code no está instalado. Sin ningún agente instalado y solo con saldos de cuenta, muestra el saldo en USD más bajo.

Haz clic para ver un resumen. Cada proveedor que has configurado tiene una fila de dos líneas: en la primera, su nombre y el tiempo que falta para el reinicio que importa, y en la segunda sus barras de 5 horas y semanal donde se conoce un límite, o el gasto y los tokens de hoy donde no. El proveedor que fijas en Configuración → Token Meter aparece primero (Claude Code a menos que lo cambies, o ninguno).

Abre una fila para ver el detalle completo de ese agente. Lista los tokens usados en las últimas 5 horas y los últimos 7 días, abreviados con K, M o B, más un sparkline de las últimas 24 horas con una barra por hora. Las tarjetas de costo muestran el costo aproximado de hoy y de los últimos 7 días a tarifas de API, con la fecha de la última actualización de la tabla de precios.

El desglose de 7 días cubre la entrada nueva, la salida, las escrituras en caché, las lecturas de caché y el número de turnos. Las cifras se actualizan en segundo plano cada minuto, más o menos.

Un agente solo aparece si está instalado, es decir, si existe su carpeta de transcripciones. Sin agente local y sin clave de cuenta guardada, el medidor no muestra nada en absoluto, en vez de un indicador vacío. Un indicador en cero afirma que no has usado nada, y eso no es lo mismo que no saberlo.

Qué agentes lee el Token Meter del disco

Para el conteo de tokens, el Token Meter tiene una sola fuente: la transcripción que cada agente guarda en tu disco. Claude Code, Codex, Gemini CLI y omp registran en la suya los tokens de cada turno. El medidor no llama a la API de ningún proveedor ni te pide iniciar sesión. No hay clave de API que pegar ni cuenta que conectar, y para el conteo de tokens no se envía nada a ninguna parte.

La lista tiene cuatro nombres porque el medidor lee las carpetas de transcripciones de Claude Code, Codex, Gemini CLI y omp. No lee OpenCode, así que no muestra nada para él en vez de una estimación.

1.0.22 añadió una segunda fuente, aparte de las transcripciones. Pega una clave de API en Configuración → Token Meter para cualquiera de los seis proveedores de cuenta y cada uno tiene su propia fila, que muestra lo que informa ese proveedor desde su propio endpoint: un saldo, una cuota del plan o un gasto. Es una medición distinta, con salvedades distintas. Lee la diferencia entre uso y saldo antes de tratar cualquiera de estas cifras como intercambiables.

Por qué las lecturas de caché tienen su propia línea

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 nuevo. Si se cuentan junto con todo lo demás, hacen que la sesión parezca mucho más grande de lo que es.

Con su propia línea, las lecturas de caché no estorban, y puedes ver a cuánto llegó realmente el resto de la sesión.

Lo que no muestra

Por defecto, el Token Meter informa el gasto: los tokens ya usados. No predice cuánto más puedes ejecutar. Las transcripciones de Claude Code no registran en qué punto está una suscripción, así que un porcentaje de Claude necesita otra fuente. Los archivos de sesión de Codex traen sus lecturas de límite de uso, pero solo tan recientes como tu último turno de Codex. Dos interruptores opcionales dan ahora una cifra en vivo para cada uno.

Para Claude, 1.0.21 añadió Límites del plan, que funcionan solo en macOS. Activa el interruptor en Configuración → Token Meter. La app lee entonces el inicio de sesión guardado de Claude Code desde tu macOS Keychain mediante la herramienta security del sistema, así que macOS no te pregunta cada vez. Obtiene el uso real de tu plan desde api.anthropic.com, como máximo una vez cada cinco minutos.

Para Codex, 1.0.22 añadió Límites en vivo de Codex. Lee el inicio de sesión de ChatGPT de Codex desde ~/.codex/auth.json y lo envía solo a chatgpt.com para obtener las ventanas actuales de 5 horas y semanal.

Está diseñado únicamente para leer ese archivo. Un token vencido no hace ninguna solicitud y te pide ejecutar codex. Un inicio de sesión guardado en el llavero del sistema no se lee en absoluto. Ambos interruptores están desactivados hasta que los activas.

Codex es el que tiene una cifra incluso con ese interruptor desactivado. Su propia CLI escribe las lecturas de límite de uso del plan en sus archivos de sesión, así que el medidor las lee de las mismas líneas que ya escanea. Esa lectura solo es tan reciente como tu último turno de Codex, y por eso existe el interruptor en vivo.

Las cifras de 5 horas y 7 días son ventanas que miran hacia atrás desde este momento. "Usado en las últimas 5 horas" es exactamente lo que significa el número. No dice nada sobre lo que permite tu plan.

Para quién es

El Token Meter está pensado para ejecutar Claude Code y Codex en paralelo, en paneles divididos o juntos en una Control Room (antes War Room). Muestra cuál está gastando más tokens sin que tengas que entrar en ninguna de las dos CLI para preguntarlo. Si usas un solo agente de vez en cuando, no aprenderás mucho de él. Mira también la página del Token Meter y la documentación del Token Meter.