Cuánto cuesta una tarea de Claude Code
Un bugfix, un scaffold y un refactor son tres cuentas distintas: anatomía de coste por tarea — vueltas, crecimiento de contexto, lo que de verdad cuesta una tarea.
Los números mensuales esconden el número que cambia tu comportamiento: cuánto cuesta una tarea. Un bugfix rápido y una tarde de refactor no son el mismo producto, pero la factura los muestra como una mancha. Este post rompe el gasto de agente en la unidad en la que de verdad decides — la tarea.
Transparencia desde el principio: opero Teapot Router, un gateway para GPT y Claude Code. La anatomía de abajo es economía de protocolo, no discurso de producto — vale para cualquier endpoint compatible con Anthropic.
El mes esconde la tarea
Las medias mensuales son contabilidad honesta y dirección inútil. Dentro del mes de un mismo dev, el coste por tarea varía mucho más que el coste por persona — las tareas del mismo dev difieren en un orden de magnitud por forma, no por esfuerzo. Tres formas cubren casi todo lo que hacen los agentes:
- El bugfix quirúrgico. Pocas vueltas, contexto ajustado, el archivo ya leído antes — la caché hace la mayor parte del trabajo. La forma más barata, y la que hace que los agentes parezcan gratis.
- El scaffold o feature nueva. Muchas vueltas, pero el contexto crece de forma predecible y el prefijo estable (instrucciones, convenciones, archivos previos) cachea bien. Coste medio, muy predecible.
- El refactor profundo o sesión maratón. Cientos de vueltas, contexto en bola de nieve vuelta tras vuelta, y la tasa de acierto de caché decidiendo la cuenta más que el precio de lista del modelo. Aquí es donde mueren los presupuestos.
La bola de nieve del contexto
El mecanismo que encarece la forma tres: los agentes no tienen estado en el cable. La vuelta 15 reenvía toda la conversación previa — prompt de sistema, archivos leídos, resultados de herramientas. La entrada de cada vuelta crece con todo lo anterior, así que el coste por vuelta sube en una sesión larga incluso con precio por token fijo. Sesiones troceadas en tareas con ámbito pagan su contexto una vez cada una; una sesión interminable lo paga todo, una y otra vez. La forma de la sesión es una decisión de coste tanto como de productividad.
Por qué la misma tarea factura distinto
Dos devs corren el mismo refactor y ven cuentas muy diferentes. Sospechosos por orden de impacto: comportamiento de caché (prefijo estable relecto barato versus volátil repagado en frío), disciplina de sesión (sesiones con ámbito nuevas versus una megasesión rodante) y enrutado de modelo (flagship en cada paso versus solo en lo difícil). Nada de esto aparece en el precio de lista — aparece en los datos por petición, el único lugar para juzgar "por qué fue caro esto".
Mide en la tarea, decide en la tarea
Si tu gateway permite etiquetar peticiones o dar claves por proyecto, la tarea se vuelve tu unidad de coste: este refactor costó esto, este carril de bugfix cuesta aquello por semana. Esa granularidad es lo que hace defendible el presupuesto mensual del post anterior — ya no discutes una media mágica, lees un registro por tarea. Sin etiquetas, sesiones con ámbito más claves por proyecto son el proxy práctico.
El mes es la unidad de presupuesto; la tarea es la unidad de decisión. Conoce tus tres formas de tarea, vigila la bola de nieve del contexto y lee el coste donde se mide — por petición, por tarea — y el número mensual deja de sorprender a nadie.
Preguntas frecuentes
¿Cuánto cuesta una tarea típica?
No hay cifra universal honesta — depende por completo de la forma (vueltas, crecimiento de contexto, comportamiento de caché). Modela con la calculadora en teapotrouter.com/en/claude-code-cost-calculator y verifica contra tu registro por petición tras una semana.
¿Por qué mi tarea pequeña costó tanto?
Casi siempre la bola de nieve: una sesión larga donde cada vuelta repaga toda la conversación, o un patrón de fallo de caché que relee en frío. Ambos aparecen en las columnas de tokens por petición antes que en dólares.
¿Cómo atribuyo costes a tareas concretas?
Etiqueta peticiones o usa claves por proyecto en el gateway y agrupa el registro por etiqueta. Sin etiquetas, sesiones con ámbito más claves por proyecto son el proxy práctico.