¿Cuántos tokens me quedan en Claude? 4 formas de verlo en Claude Code

Si ejecutas Claude Code durante más de unos minutos al día, los tokens son tu verdadera moneda. Deciden cuándo alcanzas un límite de tasa, qué tan rápido consumes una suscripción y si una larga ejecución de agente valió la pena. El problema es que Claude Code no te grita el número. Tienes que ir a buscarlo.

Aquí hay cuatro formas de verificar el uso de tokens de Claude Code, desde el comando incorporado más rápido hasta un medidor en vivo que muestra cada agente en tiempo real. Elige el que se ajuste a cuán profundo necesitas llegar.

1. La forma más rápida: /usage, /context y la línea de estado

Dentro de cualquier sesión de Claude Code, escribe:

/usage

Claude Code muestra el uso de tokens de la sesión actual y, en un plan de Claude.ai, lo que queda de tu cuota: los límites de 5 horas y de 7 días, más la parte de la ventana de contexto que ya estás usando. /cost y /stats siguen funcionando, son alias del mismo comando. Puedes lanzarlo mientras Claude responde, las cifras aparecen sin interrumpir la respuesta (antes de la v2.1.234, el comando esperaba al final del turno).

¿Quieres el detalle de la ventana de contexto en vez de un solo porcentaje? Escribe /context: la ventana se dibuja como una cuadrícula de colores y se señala lo que la está llenando, una herramienta con una salida demasiado pesada, un archivo de memoria que ha engordado, una sesión cerca de su capacidad.

Los dos comandos tienen la misma pega: hay que escribirlos, y solo ven la sesión en la que estás. Nada te dice cuánto gastaste ayer ni cuánto costó otro proyecto. Si quieres una cifra que se quede en pantalla, usa la línea de estado. Pídele a Claude Code que la escriba por ti:

/statusline show model name and context percentage with a progress bar

Genera un script en ~/.claude/ y lo conecta a tu configuración. Si prefieres escribirlo tú mismo, añade una entrada statusLine en ~/.claude/settings.json. El script recibe por stdin un objeto JSON con context_window.used_percentage, cost.total_cost_usd y, para los suscriptores Pro y Max, rate_limits.five_hour.used_percentage. Con una línea basta:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

La línea de estado se refresca después de cada respuesta de la API, así que el porcentaje se mueve mientras la sesión avanza. Sigue siendo una sesión por terminal: para cualquier cosa histórica, o para varios agentes a la vez, sigue leyendo.

2. Lee la fuente: las transcripciones de sesión

Claude Code escribe cada sesión en el disco como una transcripción JSONL. En macOS y Linux las encontrarás aquí:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Cada línea es un mensaje, y los mensajes del asistente llevan un objeto usage con los conteos exactos: input_tokens, output_tokens, y los campos de caché (cache_creation_input_tokens, cache_read_input_tokens). Las lecturas de caché son la parte interesante: son mucho más baratas que la entrada fresca, así que una sesión con una alta tasa de aciertos de caché cuesta mucho menos de lo que sugiere el conteo bruto de tokens.

Esta es la verdad fundamental. Cada otra herramienta, incluidas las dos a continuación, lee estos mismos archivos. Si quieres crear tu propio informe, jq sobre el JSONL te llevará allí.

3. Una CLI dedicada: ccusage

Si prefieres no escribir tu propio analizador, la herramienta comunitaria ccusage lee esas transcripciones y las resume en totales diarios, mensuales y por sesión:

npx ccusage@latest

Es un buen término medio: más historia que /usage, menos trabajo que hacer jq a mano. Sin embargo, se queda en la terminal, así que responde "¿qué gasté?" pero no "¿qué agente, en este momento, lo está gastando?".

4. Un medidor en vivo: uso por sesión en AgentsRoom

Los tres métodos anteriores comparten un punto ciego: son posteriores a los hechos y de un solo flujo. En el momento en que ejecutas varios agentes en paralelo, quieres ver el uso por agente, en vivo, sin tener que escribir un comando en cada terminal.

Eso es lo que hace el medidor de uso de tokens de Claude Code en AgentsRoom. Lee las mismas transcripciones JSONL, por sesión, y muestra:

• tokens de entrada, salida y caché por agente, actualizándose a medida que la sesión avanza
• la tasa de aciertos de caché, para que puedas ver cuándo se está reutilizando el contexto en lugar de reenviarse
• una advertencia antes de que una sesión se acerque a un límite de tasa

Debido a que atribuye el uso por sesión, se mantiene correcto incluso cuando ejecutas múltiples cuentas de Claude Code una al lado de la otra: cada cuenta mantiene sus propios totales, lo que hace que la facturación por cliente sea sencilla.

¿Cuál deberías usar?

• ¿Solo necesitas el número de esta sesión, o lo que queda de tu cuota? /usage, y la línea de estado si la quieres siempre visible.
• ¿Quieres crear un informe personalizado? Lee las transcripciones JSONL directamente.
• ¿Quieres totales diarios y mensuales en la terminal? ccusage.
• ¿Ejecutando varios agentes y quieres ver el uso en vivo, por agente y por cuenta? Usa el medidor en AgentsRoom.

Verificar el uso es el primer paso. Si los números te hacen fruncir el ceño, el siguiente movimiento es reducirlos: consulta cómo reducir los costos de tokens de Claude Code para los factores que realmente importan, comenzando con la reutilización de caché.