Cómo verificar el uso de tokens de Claude Code: 4 formas de ver lo que gastan tus agentes

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: el comando /cost

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

/cost

Claude Code imprime el costo total y el conteo de tokens para la sesión actual, además de cuánto tiempo ha estado en ejecución. Es la respuesta más rápida a "¿cuánto ha gastado esta sesión hasta ahora?", y no necesita nada instalado.

La trampa: /cost está limitado a la sesión en la que te encuentras. No te dice cuánto gastaste ayer, cuánto costó un proyecto diferente, o cómo se compara un agente específico con otro. Para una verificación rápida es perfecto. Para cualquier cosa histórica, 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 /cost, 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? /cost.
• ¿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é.