¿Adónde fue mi uso de Claude? Uso por proyecto

Última actualización: 30 de septiembre de 2026

Claude Code escribe cada sesión en un archivo de tu equipo, bajo ~/.claude/projects, con una carpeta por proyecto. Cada respuesta lleva sus recuentos de tokens. Súmalos por carpeta y tendrás tu uso por proyecto, siempre que cuentes cada mensaje una sola vez y solo los últimos 30 días, porque es el tiempo que Claude Code conserva los archivos por defecto. Lo que hiciste en claude.ai o en las apps de Claude no está ahí.

Esta página muestra dónde están los números, las dos trampas al sumarlos y lo que ningún archivo local puede decirte. Los datos sobre Claude Code proceden de la documentación de Anthropic, enumerada al final.

Dónde lo anota Claude Code

En las transcripciones de sesión bajo ~/.claude/projects, una carpeta por proyecto y un archivo JSONL por sesión. Cada respuesta del modelo lleva un bloque usage con tokens de entrada, de salida y de caché.

Ruta: ~/.claude/projects/<project>/<session>.jsonl. El nombre de la carpeta es la ruta del proyecto con las barras convertidas en guiones, por ejemplo -Users-you-work-my-repo. Los subagentes escriben en una carpeta subagents/ junto a la sesión.
Formato: un objeto JSON por línea. Las líneas del modelo contienen un message con su id, el model y un bloque usage: input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens.
Texto sin cifrar: los archivos no están cifrados. Todo lo que pasó por una herramienta está ahí: contenido de archivos, salida de comandos, texto pegado.

Anthropic documenta dónde están los archivos y qué contienen, no la estructura de cada línea. Puede cambiar con cualquier versión, así que un script que los lea debe saltarse las líneas que no conozca en lugar de fallar.

Por qué una suma simple sale demasiado alta

Claude Code puede escribir la misma respuesta en la transcripción más de una vez, por ejemplo mientras la transmite o cuando una sesión se bifurca. Cuenta cada ID de mensaje una sola vez, o el total saldrá muy por encima.

Entonces el mismo ID de mensaje aparece en varias líneas, cada una con un bloque usage. Conserva una línea por ID (la de mayor salida) y descarta el resto. En mi propio equipo, una suma simple salió unas 2,7 veces demasiado alta. Entre archivos pasa lo mismo: una sesión reanudada o bifurcada puede copiar respuestas anteriores a un archivo nuevo.

30 días, y luego desaparece

Solo hasta donde lleguen las transcripciones. Claude Code las borra cuando superan cleanupPeriodDays, que por defecto son 30 días. Sube ese valor o guarda tus propios totales si quieres más.

El ajuste: cleanupPeriodDays en ~/.claude/settings.json, por ejemplo {"cleanupPeriodDays": 90}. El valor mínimo es 1; el 0 se rechaza.
Una excepción: las sesiones que iniciaste o continuaste por última vez en Claude Desktop o Cowork se conservan sea cual sea su antigüedad, salvo que fijes desktopSessionCleanupPeriodDays (Claude Code 2.1.248 o posterior).
El precio: un periodo más largo guarda más texto sin cifrar en el disco. Si solo quieres los números, es más seguro guardar los totales en otro sitio y dejar el periodo corto.

Tokens por proyecto, a grandes rasgos

Tras eliminar los duplicados, suma el uso por carpeta de proyecto. Tres cosas hacen el resultado más justo:

Worktrees: cada worktree tiene su propia carpeta. Súmalas al repositorio al que pertenecen.
Peso, no solo recuento: un millón de lecturas de caché cuesta mucho menos que un millón de tokens de salida. Valorar cada tipo a precios de lista de la API da un peso más justo. Es una vara de medir, no una factura: en Pro o Max no pagas ningún precio por token.
Parte de la ventana, como estimación: Anthropic no dice cómo se convierten los tokens en el porcentaje de tu ventana de cinco horas o semanal. Cualquier parte por proyecto es una estimación y conviene rotularla como tal.

Lo que queda invisible

Los chats en claude.ai y en las apps de Claude no dejan ninguna transcripción en tu equipo. Aun así gastan de los mismos límites de sesión y semanales, de modo que parte de la ventana no se puede atribuir a un proyecto.

Lo mismo vale para Claude Code en otro equipo, para transcripciones ya borradas y para una segunda cuenta en la misma máquina. Si tu ventana subió más de lo que explican tus tokens locales, normalmente ahí fue el resto.

En AI Cockpit

Desde Mac 6.8, la ventana Uso hace este trabajo por ti. Muestra adónde fue tu cuota de Claude y Codex: por proyecto, modelo, esfuerzo y hora, hasta 365 días atrás.

Dos medidas lado a lado: tokens en bruto y el equivalente a precios de lista de la API, rotulado como no factura.
Parte estimada de las ventanas de cinco horas y de siete días, más un mapa de calor de día de la semana × hora.
Contado una vez: las respuestas se deduplican por ID de mensaje. Los worktrees cuentan para su repositorio principal.
Más allá de los 30 días: la app lee lo que Claude Code aún conserva y desde entonces guarda ella misma los totales: solo números, almacenados en local, nunca el texto de tus sesiones.
Crear análisis guarda un informe HTML autónomo; también hay exportación a CSV. Los nombres de proyecto se pueden anonimizar.

La ventana existe solo en el Mac; lee archivos del equipo. Los límites en sí (lo llena que está cada ventana y cuándo se restablece) se explican en Cómo vigilar los límites de uso de Claude.

Respuestas breves

¿Dónde guarda Claude Code mi uso de tokens?

¿Por qué me sale un total de tokens demasiado alto?

¿Hasta cuándo atrás puedo ver mi uso de Claude Code?