Cuánto gastás en IA con ccusage.

Qué es ccusage

ccusage es un comando gratis y de código abierto (licencia MIT) que lee los registros que Claude Code, Codex y otras herramientas de IA ya guardan en tu compu. Con esos registros te arma una tabla con los tokens que usaste y cuánto costarían a precio de API.

• Todo el análisis se hace en tu compu: los registros no salen de ahí y no te pide cuenta.
• Al correr, baja la lista de precios de los modelos. Con --offline usa la que ya tiene guardada.
• Si pagás una suscripción, el número no es lo que te cobran: es lo que valdría si pagaras por uso.
• Los costos son estimados, con precios de LiteLLM y models.dev.

Qué necesitás

No hace falta instalarlo: npx lo baja y lo corre en el momento.

Dónde lee los registros

En total soporta hasta 18 herramientas y te separa el uso de cada una.

Pasos

1. Mirá el gasto por día. Corré npx ccusage@latest. Sin nada más, te muestra la tabla diaria.
2. Elegí desde qué fecha. Para ver solo este mes, corré npx -y ccusage@latest daily --since 20261001 (la fecha va como año, mes y día pegados).
3. Mirá el gasto por mes. Corré npx ccusage@latest monthly para tener un total por mes y el acumulado.
4. Revisá cada herramienta. En la tabla vas a ver por separado Claude, Codex y las demás que detecte.
5. Probá otras vistas si las necesitás. Están las de la tabla de abajo.

Otras vistas

Si algo falla

• Si te dice que no encuentra npx, instalá Node o usá Bun con bunx ccusage@latest.
• Si faltan días viejos: Claude Code guarda los registros 30 días por defecto (cleanupPeriodDays), así que lo anterior ya no está para leer.
• Si aparece un aviso «Missing pricing for» un modelo, ese modelo no suma al costo: el total es un mínimo.
• Si no tenés internet o no querés que baje los precios, agregá --offline para usar la lista guardada.
• Si la tabla no entra en la pantalla, agregá --compact.