Mira lo que Claude Code te cuesta de verdad con ccusage — y luego decide cómo pagar
«Me ha parecido caro este mes» no es un dato. ccusage lee tus registros locales de sesión y los valora a tarifa oficial: un comando para empezar, qué significa la cifra, y la forma de uso que responde suscripción vs. pago por uso.
Todo usuario de Claude Code tiene el mismo momento de duda: ¿me pasé este mes? La duda suele detenerse en la sensación, porque el siguiente paso es incómodo — el suscriptor no ve factura, solo una barra de progreso; el usuario de API sí la ve, pero solo se acuerda de mirarla a fin de mes. La respuesta estuvo todo el tiempo en tu máquina: Claude Code escribe el uso de cada sesión en registros locales, y ccusage es la herramienta más simple para leer ese libro en voz alta. Esto no es otro manual de ccusage — el comando es de una línea y no necesita manual. Va de lo que viene después de medir: qué precio usa la cifra, qué números importan, y cómo una semana de medición responde a «¿cómo debería estar pagando esto?»
Transparencia desde el principio: opero Teapot Router, un gateway de API por uso. Escribir «cómo decidir entre suscripción y por uso» me interesa obviamente — por eso las primeras cuatro secciones no dependen de ningún proveedor y tratan solo de tus números; la parte interesada aparece en la última sección, y cada criterio allí es público y recalculable.
«Me parece caro» no es un dato; los registros locales sí
Cada sesión de Claude Code queda escrita en archivos JSONL bajo ~/.claude: qué peticiones, qué modelos, cuántos tokens de entrada y salida, cuánta caché acertada. El registro empieza el día que instalas — salvo accidente, tus últimas semanas de uso están enteras ahí.
Lo que hace ccusage es de una sencillez desarmante: lee ese registro, multiplica por una tabla de precios y ordena el resultado por día, semana y sesión. No sube nada, no pide clave de API, no cambia configuración — no lo necesita: el libro y la aritmética se quedan en tu máquina.
Un comando para empezar, tres vistas que conviene conocer
Nada que instalar — npx ccusage daily corre tal cual. Tres vistas que conviene conocer a diario, cada una responde una pregunta:
- daily: cuánto costó cada día — responde «qué día quemó»;
- blocks: troceado en bloques de facturación de 5 horas — la vista alineada con las ventanas de límite de la suscripción; muestra dónde cae tu trabajo pesado;
- monthly: el mes resumido — míralo antes de preguntar «debería cambiar de forma de pago».
Calcula a tarifa oficial — el paso que todo el mundo se salta
ccusage multiplica por la tabla oficial de tarifas. De ahí una distinción crucial: si eres suscriptor, la cifra no es lo que pagaste (pagas una cuota fija) — es «cuánto costaría este uso a tarifa de API oficial», una regla para medir uso, no una factura. Si eres usuario de API, es una aproximación de tu factura — aproximación, porque la tarificación de lecturas/escrituras de caché puede diferir del detalle exacto de tu proveedor; el detalle por petición sigue siendo la fuente de verdad.
La distinción no es pedantería; es la puerta al siguiente paso: lee la salida de ccusage como una forma de uso, no como una factura, y los números empiezan a decidir por ti.
Ejecútalo una semana y obtienes más que un total
El total dice si es caro; la forma dice por qué, y si otro modelo de facturación saldría más barato. Corre una semana y saca cuatro parámetros: horas de concentración al día (la extensión de tus bloques), intensidad de las tareas (modelo insignia o equilibrado al mando), tasa de acierto de caché (mismo contexto, acierto contra frío difiere un orden de magnitud) y el perfil de picos (constante a diario, o dos días de explosión). Estos cuatro sirven mucho más que el total mensual, porque las diferencias de todos los modelos de facturación se despliegan a lo largo de estos cuatro ejes.
De la forma a la decisión: el aspecto de esa aritmética
Con una forma en la mano, suscripción contra por uso deja de ser una disputa de bandos y se vuelve una multiplicación asignable: horas al día × intensidad en una calculadora de costes, sale el mensual por uso, colócalo junto al precio de la suscripción. Por debajo, el por uso ahorra; por encima, estás pagando precio de uso por un caudal sin tope — lo cual puede tener sentido, pero ahora es una elección informada.
La parte interesada, dicha sin rodeos: nuestra calculadora y nuestro detalle por petición hacen exactamente esto — tarifas leídas en vivo del endpoint público de precios, coste de cada petición consultable y exportable después. Pero no tienes que usarlos con nosotros: cualquier proveedor que ofrezca tabla legible por máquina y detalle por petición hace la misma aritmética; quien no ofrezca ninguna de las dos, por barata que parezca su tabla, debería anotarse «no verificable» como un coste.
El valor de ccusage no es el comando; es cambiar una sensación por una forma. Mide una semana, memoriza cuatro números: horas, intensidad, aciertos, picos. Con esos cuatro, cualquier discurso de facturación — incluido el nuestro — pierde el poder de asustarte, porque la respuesta la multiplicaste tú.
Preguntas frecuentes
¿ccusage es gratis? ¿Necesita internet o clave de API?
Es libre y gratuito. Solo lee los registros de sesión bajo ~/.claude y calcula localmente — nada se sube, no pide clave, corre directo con npx sin instalar nada.
Soy suscriptor — ¿la cifra es mi factura?
No. El suscriptor ve «este uso a tarifa oficial de API» — una regla para medir su forma de uso. Lo que pagas es la cuota fija. El usuario de API ve una aproximación de su factura; el detalle por petición del proveedor es la fuente exacta.
¿En qué se diferencia del /usage integrado en Claude Code?
/usage muestra lo restante y consumido de la ventana de límite actual — un indicador del «ahora». ccusage agrega el histórico en vistas de día/mes/bloque. Uno gestiona el presente, el otro el pasado — decidir cómo pagar exige el segundo.