El uso de Claude Agent SDK puede consumir los límites del plan, los créditos mensuales de API que se añadieron a los planes Max y Team el 7 de octubre o la facturación por token. Este artículo detalla cada precio, los importes de los créditos, el ahorro por caché y un cálculo de costo para una ejecución de agente.
El Claude Agent SDK no tiene precio propio. La factura viene del modelo que hay detrás, y a partir del 8 de octubre de 2026 puede llegarte de tres formas distintas: a través de tus límites de suscripción, a través de los nuevos créditos mensuales de API de los planes Max y Team, o mediante la facturación por token tradicional. Si eliges mal la vía, te topas con un límite a mitad de una ejecución o pagas más de lo necesario. Este artículo explica cada opción con las cifras de las páginas de precios y de ayuda de Anthropic, y después calcula lo que cuesta una sola ejecución de agente con tres modelos distintos.
El Agent SDK es una biblioteca de Python y TypeScript que lleva el bucle de agente de Claude Code, sus herramientas integradas, las sesiones y los hooks dentro de tu propio programa. La documentación de Anthropic lo describe como una biblioteca que ejecuta el binario de Claude Code en un proceso que tú gestionas. Su página de precios no incluye ninguna tarifa del SDK, así que lo que pagas es el uso del modelo: tokens de entrada, tokens de salida y actividad de caché.
Dónde se cobran esos tokens depende de cómo se autentique el SDK:
| Vía | Se factura en | Ideal para | Ojo con |
|---|---|---|---|
| Límites de suscripción | Cuota del plan | Scripts personales y tareas nocturnas | Compartir un solo grupo con tus chats |
| Créditos mensuales | Dólares que caducan | Prototipos y proyectos secundarios | Sin acumulación al final del ciclo |
| Por token | Dólares que compras | Productos con usuarios reales | Sin tope salvo que lo definas |
💡 Los proveedores de nube son una cuarta vía. El SDK puede ejecutarse en Amazon Bedrock, Google Cloud o Microsoft Foundry. Esas facturas llegan del proveedor de nube, y los créditos de Max y Team no se aplican allí.
Los resultados de búsqueda están llenos de afirmaciones contradictorias porque las reglas cambiaron tres veces este año:
claude -p, las GitHub Actions de Claude Code y las apps de terceros creadas con el SDK pasarían a un crédito mensual independiente facturado a tarifas completas de API: 20 $ en Pro, 100 $ en Max 5x y 200 $ en Max 20x.Si un artículo dice que los suscriptores Pro reciben un crédito de 20 $ para el SDK, está describiendo el plan que se pausó.
La ayuda de Anthropic para el SDK indica que el uso que pasa por tu inicio de sesión de Claude sigue contando contra los límites de tu suscripción, igual que claude -p. Esa es la vía adecuada para la automatización personal: un script en tu equipo portátil o una tarea nocturna en tu propia máquina. Una suscripción cuesta 20 $ al mes en Pro, 100 $ en Max 5x y 200 $ en Max 20x, y no pagas nada por token.
La trampa está en compartir. El SDK usa el mismo grupo que cada chat y cada sesión de programación interactiva que abres, así que un bucle de agente largo puede dejarte sin cuota para el resto del día.
El 7 de octubre de 2026, Anthropic añadió créditos mensuales de API a los planes Max y Team. Se aplican a la API de Claude, a Claude Managed Agents, al Claude Agent SDK y al playground de la Console.
| Plan | Crédito mensual |
|---|---|
| Max 5x | 100 $ |
| Max 20x | 200 $ |
| Team, puesto Standard | 20 $ por puesto |
| Team, puesto Premium | 100 $ por puesto |
| Free, Pro y Enterprise | No elegibles |
Un crédito se gasta a los precios de API de la sección siguiente, así que 100 $ equivalen a 100 $ en tokens. La programación interactiva con Claude Code y el uso extra dentro de las apps de Claude quedan excluidos, y los créditos no modifican tus límites del plan.
Los créditos no se activan solos. Sigue estos pasos:
Unas cuantas reglas determinan hasta dónde llega el dinero:
Your credit balance is too low to access the Anthropic API.Estos son los precios de lista por millón de tokens de la página de precios de Anthropic, consultados el 8 de octubre de 2026.
| Modelo | Entrada | Salida | Lectura de caché |
|---|---|---|---|
| Claude Fable 5.1 | 10 $ | 50 $ | 0,25 $ |
| Claude Opus 5.5 | 4 $ | 20 $ | 0,20 $ |
| Claude Sonnet 5.5 | 2 $ | 10 $ | 0,10 $ |
| Claude Sonnet 5 | 2 $ | 10 $ | 0,20 $ |
| Claude Haiku 5.5 (prompts de hasta 100.000 tokens) | 0,10 $ | 0,50 $ | 0,01 $ |
| Claude Haiku 4.5 | 1 $ | 5 $ | 0,10 $ |
Claude Haiku 5.5 cuesta más cuando un prompt supera los 100.000 tokens: 0,50 $ de entrada y 2,50 $ de salida.
💡 Claude Sonnet 5 se lanzó con 2 $ y 10 $ como precio de introducción hasta el 31 de agosto de 2026. La página de Anthropic indica ahora que ese es el precio estándar y que la subida prevista al 1 de septiembre, a 3 $ y 15 $, no se producirá. Cualquier página que siga mostrando esa subida está desactualizada.
Los modelos desde la versión 4.7 usan un tokenizador más reciente que genera alrededor de un 30 % más de tokens para el mismo texto que la generación 4.6 y anteriores. Compara el costo de una tarea terminada, no solo el precio por token.
El SDK usa el caché de prompts por su cuenta. Una escritura de caché de 5 minutos cuesta 1,25 veces el precio base de entrada, una escritura de 1 hora cuesta 2 veces, y una lectura de caché cuesta 0,1 veces. Opus 5.5 y Sonnet 5.5 se leen a 0,05 veces, y Fable 5.1 a 0,025 veces. Un bucle de agente reenvía un prefijo largo y estable en cada paso, así que la mayoría de sus tokens de entrada acaban siendo lecturas baratas.
Con una credencial de API, el caché dura 5 minutos por defecto. Si tus ejecuciones están más separadas que eso, define la variable de entorno ENABLE_PROMPT_CACHING_1H. La opción de 1 hora cuesta más escribirla y compensa cuando las ejecuciones posteriores leen el mismo prefijo.
Los tokens no son toda la factura. Revisa estos puntos antes de presupuestar:
inference_geo: "us" en los modelos Claude 4.6 y posteriores.Imagina una ejecución de corrección de errores: el agente lee algunos archivos, edita código, ejecuta las pruebas y repite unos 30 pasos. Supongamos 600.000 tokens de entrada en esos pasos, formados por 20.000 tokens sin caché, 40.000 escritos en el caché de 5 minutos y 540.000 leídos de él, más 30.000 tokens de salida. Son cifras ilustrativas, no una medición, pero tienen la forma de un bucle de agente con caché.
En Sonnet 5.5, el cálculo es:
En total, 0,494 $. Si aplicas la misma forma a tres modelos, un crédito de 100 $ compra cantidades de trabajo muy distintas:
| Modelo | Costo por ejecución | Ejecuciones con un crédito de 100 $ |
|---|---|---|
| Claude Haiku 5.5 | unos 0,03 $ | más de 3.600 |
| Claude Sonnet 5.5 | unos 0,49 $ | unas 200 |
| Claude Opus 5.5 | unos 0,99 $ | unas 100 |
Hay dos lecciones claras. Primero, el caché ahorra aproximadamente dos tercios: la misma ejecución en Sonnet 5.5 sin caché costaría 1,50 $. Segundo, la salida es la parte cara. Esos 30.000 tokens de salida son alrededor del 5 % del volumen y el 61 % del costo. Un crédito de Max 20x simplemente duplica cada cifra de la última columna.
Cada llamada a query() termina con un mensaje de resultado que incluye total_cost_usd, el costo estimado de esa llamada. El campo modelUsage lo desglosa por modelo, incluidas las lecturas y escrituras de caché. Hay tres detalles que confunden a la gente:
total_cost_usd y modelUsage incluyen el trabajo de los subagentes, pero usage no, así que usage subcuenta en cuanto se ejecutan subagentes.output_tokens de cada paso es un valor provisional. Lee el recuento real de salida en el mensaje de resultado.💡
total_cost_usdes una estimación del lado del cliente basada en una tabla de precios incluida en el SDK. Anthropic indica que, para una facturación oficial, uses la Usage and Cost API o la página de uso de la Console, y que nunca factures a tus propios clientes a partir de la estimación.
import { query } from "@anthropic-ai/claude-agent-sdk";
for await (const message of query({
prompt: "Fix the failing test in src/auth.ts",
options: { maxBudgetUsd: 2 },
})) {
if (message.type === "result") {
console.log(message.subtype, message.total_cost_usd);
}
}
La opción maxBudgetUsd en TypeScript, o max_budget_usd en Python, detiene una llamada cuando su propio gasto supera el límite. Solo cuenta esa llamada: el gasto recuperado de una sesión reanudada no le suma, y un /clear reinicia el presupuesto. El resultado llega entonces con el subtipo error_max_budget_usd.
Para fijar un techo en todo un proyecto, asígnale su propio workspace de la Console y define el límite de gasto de ese workspace. Cada credencial y workspace de una organización vinculada consume del mismo saldo de créditos, así que un límite por workspace evita que una tarea descontrolada se coma la cuota del mes.
Los créditos de Team son 20 $ por puesto Standard y 100 $ por puesto Premium, agrupados en un saldo único con un tope de 500 $ al mes. Un equipo con tres puestos Standard y dos Premium recibe 260 $ al mes, y añadir un puesto Premium eleva el crédito del mes siguiente a 360 $. El importe lo determinan los puestos del plan al inicio de cada mes de facturación. Vincular una organización también la sitúa en al menos el nivel de uso Start, o en el nivel Build si el crédito mensual supera los 200 $.
Si lanzas un producto, cuenta con la facturación por API. Anthropic no permite que los desarrolladores externos ofrezcan en sus productos el inicio de sesión de claude.ai ni sus límites de uso, incluidos los agentes creados con el SDK, salvo que Anthropic lo haya aprobado de antemano. Los créditos mensuales están pensados para crear y ejecutar tus propias aplicaciones y agentes, así que mantén el tráfico de clientes en la facturación por token, donde controlas los límites de gasto por workspace.
Claude Managed Agents es la alternativa alojada: Anthropic ejecuta el bucle de agente en un entorno sandbox en la nube que gestiona. Factura las mismas tarifas de tokens más 0,08 $ por hora de sesión, contadas solo mientras la sesión está en marcha. El tiempo inactivo no cuenta. Una sesión de una hora en Sonnet 5.5 con 50.000 tokens de entrada y 15.000 de salida cuesta 0,10 $ + 0,15 $ + 0,08 $, es decir, 0,33 $. Con el SDK no hay cargo por tiempo de ejecución, pero la máquina en la que corre la pagas tú. Los créditos de Max y Team funcionan en ambos casos.
Antes de gastar créditos ajustando un agente, redacta y prueba su prompt de sistema en un modelo de chat. Claude Sonnet 5 está disponible en PicassoIA, pensado para programación en varios pasos y tareas de uso de herramientas, lo que lo convierte en un lugar práctico para probar un prompt antes de conectarlo al SDK.
💡 La escala de effort también mueve la factura del SDK. Más effort significa más tokens de salida, y la salida es el lado caro de cada tabla de precios de arriba.
Para comparar cómo responde un modelo más ligero o más pesado al mismo prompt, Claude Haiku 4.5, Claude Opus 4.7 y Claude Fable 5 están en la misma colección.
Todas las fotos de este artículo salieron de P Image, un modelo de texto a imagen de PicassoIA que devuelve una imagen terminada en menos de un segundo. Admite 16:9, 1:1, 9:16 y tamaños personalizados, ofrece upsampling de prompts para ideas breves y acepta una semilla para que un resultado que te guste pueda reproducirse exactamente.
Pruébalo ahora. Describe una escena en una sola frase, por ejemplo una mesa, una ventana y la luz de última hora de la tarde. Ejecútalo, cambia un solo detalle y vuelve a ejecutarlo. Diez intentos llevan unos minutos, y al final tendrás una idea de cómo las palabras sobre cámara, luz y textura dan forma a una foto.
PicassoIA también ofrece 91 modelos de texto a imagen y 87 modelos de texto a video, además de modelos de música, voz y lenguaje, todos en la lista completa de modelos. Elige uno, escribe un prompt y crea algo propio hoy mismo.
Elige tu idioma
