¿A dónde va realmente una factura de Claude Code?
Leer el gasto en APIs línea por línea: los tres números de cada petición, el mecanismo que domina en silencio las facturas de agentes y tres preguntas que convierten cualquier factura en algo auditable.
Una factura mensual de API es el peor lugar para descubrir una pregunta. Te dice qué gastaste, nunca a dónde fue — y con herramientas de código agénticas, a dónde va es genuinamente sorprendente la primera vez que lo miras. Este artículo es el modelo mental que desearía que todo desarrollador tuviera antes de abrir un panel de facturación.
Divulgación por adelantado: opero Teapot Router, un gateway de API para Claude Code y herramientas OpenAI SDK. Nada de esto depende de ello — la anatomía siguiente aplica a cualquier endpoint compatible con Anthropic.
Cada línea son tres números
Una petición de agente de código se factura por tres componentes. El reflejo a construir: cuando una factura te sorprenda, no preguntes qué modelo es caro — abre las líneas y pregunta cuál de los tres números se movió.
- Tokens de prompt — todo lo que el modelo lee: prompt del sistema, contexto del proyecto, la conversación hasta ahora, resultados de herramientas. En una sesión larga esto casi nunca es «tu pregunta»; es tu pregunta más todo lo que el agente tuvo que releer para responder.
- Tokens de completion — lo que el modelo escribe de vuelta: código, razonamiento, llamadas a herramientas. Normalmente la minoría de la factura.
- Lecturas/escrituras de caché — precios de prompt-cache. Las lecturas están muy descontadas; las escrituras pagan por poblar la caché. Que tu herramienta y endpoint cachéen bien mueve tu tarifa efectiva dramáticamente.
El dominante silencioso: el contexto se reenvía
Claude Code y agentes similares no tienen estado en el canal: en cada turno, el cliente reenvía la conversación completa — prompt del sistema, contexto de archivos, resultados previos incluidos. Tu mensaje 15 se factura como si hubieras preguntado los 15 a la vez. No es un defecto; es cómo funciona el protocolo. Pero explica dos hechos contraintuitivos:
Una sesión larga con un modelo barato puede costar más que una corta con uno caro. Y la solución con mejor ROI suele ser gestionar el contexto — limpiar salida de herramientas vieja, mantener sescciones acotadas, dejar que la caché trabaje — no cazar descuentos.
Tres palancas, en orden de honestidad
Antes de tocar una tabla de tarifas, las palancas ordenadas por cuánto ahorran honestamente:
- Dimensionar el modelo por tarea. Las ediciones rutinarias y los greps no necesitan el flagship; las peticiones arquitectónicas difíciles sí. Enrutar por tarea es el mayor ahorro honesto.
- Hacer que la caché funcione de verdad. Las lecturas de prompt-cache son un orden de magnitud más baratas que los tokens fríos. Prompts de sistema estables y estructura de sesión importan más que cualquier tabla de tarifas.
- Suscripción vs. uso — haz la aritmética para tu forma de uso. Los planes ganan si tu uso es intensivo en un modelo; el pago por uso gana en cuanto tu carga es diversa, ocasional o repartida entre herramientas. No hay respuesta universal, solo tu propia cuenta.
Tres preguntas para cualquier proveedor
Sea cual sea el endpoint, estas tres convierten una caja negra en un registro auditable:
- ¿Puedo ver coste, tokens y latencia por petición — no solo un total mensual? Y exportarlo.
- ¿Hay una lista de precios legible por máquinas, para calcular el coste antes de comprometerme? Un endpoint JSON público sin login es el listón que yo exigiría.
- ¿Qué pasa exactamente con mi saldo sin usar — caducidad, política de reembolso, comisiones? «Se queda ahí para siempre» debería ser una política escrita, no una vibración.
Privacidad, ya que enrutas código por un endpoint
Pregunta qué se conserva. Teapot Router guarda solo metadatos de facturación — sin archivar prompts ni respuestas — y deberías verificar en lugar de confiar en el marketing «zero log» de cualquier vendedor, incluido el nuestro.
No necesitas convertirte en optimizador de costes. Necesitas que tu factura sea respondible: abrir el panel, encontrar la línea, nombrar el número. Cuando tu endpoint te da eso, cada sorpresa se vuelve una explicación de una línea en lugar de un ticket de soporte.
FAQ
¿Por qué las sesiones largas de Claude Code cuestan más por mensaje?
Cada turno reenvía la conversación hasta ese punto, así que el mensaje 15 se factura contra un prompt mucho mayor que el 1. Con el mismo precio por token, el coste por mensaje crece con la longitud de la sesión.
¿La caché reduce la factura?
Sí, y mucho: las lecturas de prompt-cache son un orden de magnitud más baratas que los tokens fríos. Prompts estables y sesiones acotadas hacen que la caché acierte en lugar de repagar contexto repetido.
¿Cómo audito el coste de cada petición?
Usa un endpoint cuyo panel muestre coste, tokens y latencia por petición con exportación — y una lista de precios legible por máquinas para contrastar. Esa combinación convierte la factura en un registro auditable.