CodeBurn: cómo saber exactamente dónde se van tus tokens de Claude, Codex y Cursor

Tienes tres suscripciones activas — Claude Max, Cursor Pro, y la API de OpenAI para algunos scripts con Codex. Cada una te manda su factura. Las sumas a fin de mes, te da un mini infarto, y sigues. ¿Qué proyecto se comió la mitad del presupuesto? No sabes. ¿Qué tipo de tarea quema más tokens en ciclos de edit/test/fix? Tampoco. ¿Si cambiaras de Opus a Sonnet en debugging ganarías margen? Ni idea.

Esta es la foto de casi todos los que estamos usando agentes en 2026. Gastamos como empresa y medimos como consumidor.

CodeBurn arregla eso.

Qué es CodeBurn

Un dashboard TUI (interfaz en terminal, al estilo htop) que lee directamente los archivos de sesión que cada herramienta de coding asistido deja en disco y te dice cuánto costó cada cosa.

No es un wrapper. No es un proxy. No pide API keys. Solo lee:

• Claude Code: ~/.claude/projects/
• Claude Desktop: ~/Library/Application Support/Claude/local-agent-mode-sessions/
• Codex (OpenAI): ~/.codex/sessions/
• Cursor: la SQLite de globalStorage/state.vscdb
• cursor-agent CLI
• OpenCode: SQLite en ~/.local/share/opencode/
• Pi: ~/.pi/agent/sessions/
• GitHub Copilot: ~/.copilot/session-state/ (solo output tokens, ver nota más abajo)

Los parsea, clasifica cada mensaje en una de 13 categorías de tarea con pattern matching determinista (sin llamadas a LLM), y calcula costo con precios sacados de LiteLLM, auto-cacheados, con todos los modelos soportados.

Es open source. Lo mantiene el equipo de Agentseal. Más de 3,000 stars en GitHub cuando escribo esto.

Instalar

npm install -g codeburn

O sin instalar:

npx codeburn

Requiere Node 20+. Para Cursor y OpenCode, better-sqlite3 se instala automáticamente como dependencia opcional.

Lo primero que ves

Escribes codeburn en la terminal y entras al dashboard interactivo. Por defecto arranca en 7 días.

Arrow keys para switchear entre Today / 7 Days / 30 Days / Month / All Time (o 1 2 3 4 5 como shortcuts). Auto-refresh cada 30 segundos. q para salir. c abre comparación de modelos. p alterna entre providers si tienes varios.

El overview te da cost, calls, sessions, cache hit %. Debajo, breakdowns por:

• Proyecto — con avg cost por sesión. Aquí ves cuál cliente o repo se está comiendo la factura.
• Modelo — con token counts desagregados.
• Actividad — 13 categorías con one-shot success rate: te dice en qué tipo de tarea el modelo acierta a la primera vs. en cuáles quema tokens iterando.
• Core tools — qué tools usaste más (Read, Edit, Bash, Grep…).
• MCP servers — gasto por servidor MCP.
• Shell commands — qué comandos de shell corrieron más.

También te muestra las cinco sesiones más caras que corriste en todos los proyectos. Muy útil para detectar el outlier que te arruinó la semana.

Lo que cambia cuando tienes estos datos

1. Dejas de decidir por instinto

Yo creía que mis proyectos de frontend consumían más porque son más visuales. CodeBurn me dijo que no: el proyecto que más me cobra es uno de backend con tests complicados, porque los ciclos de fix-test-fix disparan el costo en silencio.

2. Ves el one-shot rate real

Esto es lo que más me voló la cabeza. CodeBurn te dice, por tipo de actividad, qué % de las veces el modelo resolvió la tarea a la primera vs. requirió retries. Si tu one-shot rate en "testing" es 30%, sabes dónde meter un prompt más estricto o un hook de PreToolUse. Si en "refactoring" es 85%, déjalo así y optimiza en otro lado.

3. Puedes comparar modelos con data propia

Con c en el dashboard abres comparación de modelos. Ves costo por sesión promedio, tokens por llamada, one-shot rate. Si llevas dos semanas probando Sonnet vs. Opus, aquí sale quién te da mejor margen en tu trabajo real, no en benchmarks de marketing.

4. Sabes si tu plan de suscripción vale la pena

codeburn plan set claude-max    # $200/mes
codeburn plan set cursor-pro    # $20/mes

El dashboard te muestra cost API-equivalent vs. precio de la suscripción. Es decir: cuánto te saldría la misma sesión si la pagaras por API. Si tu ratio es 3x o más, el plan vale oro. Si es 0.8x, estás subsidiando a otros.

Disclaimer del repo: los presets usan precios públicos conocidos (abril 2026) y no modelan los token allowances exactos, porque los vendors no publican los límites consumer. Pero la referencia relativa es honesta.

Comandos útiles más allá del dashboard

codeburn today                  # hoy
codeburn month                  # este mes
codeburn report -p 30days       # rolling 30 días
codeburn report -p all          # todo lo registrado
codeburn report --from 2026-04-01 --to 2026-04-10
codeburn status                 # one-liner compacto: hoy + mes
codeburn export                 # CSV con hoy, 7 días, 30 días
codeburn export -f json
codeburn optimize               # encuentra waste y te da fixes copy-paste
codeburn optimize -p week

report --format json saca la data completa del dashboard como JSON estructurado. Pipe a jq:

codeburn report --format json | jq '.projects'
codeburn today --format json | jq '.overview.cost'

Filtros por provider y proyecto

codeburn report --provider claude
codeburn report --project myapp
codeburn report --exclude tests --exclude scratch
codeburn month --project api --project web

Ambas flags son repetibles y combinables.

Menubar en macOS

npx codeburn menubar

Un solo comando: baja el .app nativo (Swift + SwiftUI, código fuente en mac/), lo instala en ~/Applications y lo lanza. El icono es una flamita con el costo del día. Al hacer click, popover con tabs por agente, switcher de período, paneles de Trend / Forecast / Pulse / Stats / Plan, breakdowns de actividad y modelo, hallazgos del optimize y export CSV/JSON.

Refresca en vivo con FSEvents más poll de 15 segundos. Si trabajas varias horas al día con agentes, tener el número en la barra superior te ahorra sustos de fin de mes.

Moneda local

Por default en USD. Cambiar es un comando:

codeburn currency MXN
codeburn currency EUR
codeburn currency         # ver actual
codeburn currency --reset # volver a USD

Acepta cualquier código ISO 4217 (162 monedas). Exchange rates de Frankfurter (ECB, gratis, sin API key), cacheados 24 horas en ~/.cache/codeburn/. Config en ~/.config/codeburn/config.json. La moneda aplica en todos lados: dashboard, status, menubar, exports, JSON.

Detalles que importan

Cursor estima costos con precio de Sonnet. Cursor "Auto" oculta el modelo real que usó, entonces CodeBurn lo etiqueta como "Auto (Sonnet est.)". No es perfecto, pero es lo único honesto que puede hacer sin data del vendor. La vista de Cursor además muestra un panel de Languages (extraído de bloques de código) en vez de Core Tools/Shell/MCP, porque Cursor no loguea tools individuales.

La primera corrida en una DB grande de Cursor puede tardar hasta un minuto. Después queda cacheada y las siguientes son instantáneas.

Copilot solo expone output tokens. Así que las cifras de Copilot quedan por debajo del costo real de API. El modelo se trackea vía eventos session.model_change; los mensajes antes del primer cambio de modelo se saltan para no atribuir mal. Es una limitación de la fuente, no de CodeBurn.

Codex tool names están normalizados a Claude. exec_command se ve como Bash, read_file como Read. Eso hace que el classifier de actividades y el breakdown de tools funcionen parejo entre providers.

El sistema es extensible. Agregar un provider nuevo es un solo archivo. Ver src/providers/codex.ts como ejemplo si quieres soportar uno que te interese.

Por qué esto importa si facturas con agentes

Si eres freelance, consultor o agencia y tus deliverables involucran agentes de IA, estás en una posición nueva: tu costo variable dejó de ser predecible. Antes, el costo de producir código era tu tiempo. Ahora es tu tiempo + tokens, y los tokens no se portan como las horas.

Dos proyectos que aparentemente te toman las mismas horas pueden tener 3x de diferencia en costo de IA. Si no estás midiendo, estás subsidiando al cliente caro con el margen del cliente barato.

El siguiente paso lógico después de CodeBurn es cruzarlo con tu tracker de horas (Harvest, Toggl, lo que uses). Si tienes horas por proyecto ahí y costos de IA por proyecto aquí, sacas costo real por hora de desarrollo asistido y margen por cliente. Ese número es el que le falta a la mayoría de los que están cobrando en 2026.

Y ese número solo se obtiene si primero tienes la otra mitad — la que CodeBurn te da gratis.

Links

• Repo: github.com/getagentseal/codeburn
• NPM: npmjs.com/package/codeburn
• License: MIT