Cómo Usar el SDK de Agente Claude con tu Plan de Claude

Anthropic permitirá usar el SDK de Claude Agent con una suscripción existente de Claude a partir del 15 de junio de 2026. Antes, cualquier proyecto con el SDK de Agent requería una clave API separada y facturación de pago por uso, además de Claude Pro o Max. Desde esa fecha, el plan mensual de Claude incluye un saldo de crédito específico para el SDK de Agent. No se requiere clave API.

Prueba Apidog hoy

Si quería crear un agente personalizado —por ejemplo, un bot de despliegue, un asistente de investigación o una herramienta de clasificación— sin registrar una tarjeta de facturación separada con Anthropic solo para prototipar, este cambio es relevante. Claude Pro incluye $20/mes de uso del SDK de Agent. Max 20x incluye $200. Los asientos Team Premium incluyen $100.

Qué cambió el 15 de junio de 2026

El uso del SDK de Agent ahora se descuenta de un crédito mensual vinculado a su plan de Claude. Antes se facturaba mediante la API de Anthropic con un saldo separado en la consola.

Crédito mensual por plan, según el anuncio de Anthropic:

Plan	Crédito mensual del SDK de Agent
Pro	$20
Max 5x	$100
Max 20x	$200
Team Standard, por asiento	$20
Team Premium, por asiento	$100
Enterprise, basado en uso	$20
Asiento Enterprise Premium	$200

Reglas que debe tener claras antes de implementarlo:

• Los miembros de asientos Enterprise Standard no obtienen crédito. Deben usar una clave API o actualizar a un asiento Premium.
• Los créditos son por usuario y no transferibles. No puede acumular el crédito de varios compañeros.
• Los créditos no utilizados no se transfieren. El saldo restante se restablece al final del ciclo de facturación.
• Debe activarlo una vez. El crédito no aparece en la cuenta hasta que lo reclama.
• Los usuarios autenticados con ANTHROPIC_API_KEY no usan este crédito. Ese flujo sigue el modelo de facturación por API.

Qué cubre el crédito

El crédito aplica a cargas programáticas, automatizadas o no interactivas.

Cubierto por el crédito del SDK de Agent:

• Llamadas al SDK de Claude Agent desde proyectos Python o TypeScript.
• El comando claude -p en Claude Code.
• La integración de GitHub Actions de Claude Code.
• Aplicaciones de terceros autenticadas mediante el SDK de Agent.

No cubierto:

• Sesiones interactivas de Claude Code.
• Conversaciones en la aplicación web o móvil de Claude.
• Sesiones de Claude Cowork.

En la práctica, el crédito del SDK de Agent está pensado para automatizaciones. Su uso diario en Claude Code sigue usando los límites normales del plan, que Anthropic aumentó recientemente en un 50% hasta el 13 de julio.

Esto permite probar agentes personalizados sin consumir el presupuesto interactivo que utiliza para programar con Claude Code.

Qué pasa cuando se agota el crédito

El comportamiento depende de la configuración de uso adicional:

• Uso adicional habilitado: los excedentes se facturan como pago por uso a las tarifas estándar de la API.
• Uso adicional deshabilitado: las solicitudes se detienen al llegar al límite del crédito hasta el siguiente ciclo.

Para prototipos, desactive el uso adicional. Obtendrá un límite claro y evitará cargos inesperados. Para automatizaciones de producción que no pueden detenerse, actívelo.

El crédito siempre se consume primero. Solo se factura excedente cuando se agota la asignación mensual.

Cómo activar el crédito

La activación no ocurre por defecto. Debe hacerla una vez.

1. Inicie sesión en la cuenta de Claude que posee la suscripción.
2. Abra la configuración del plan del SDK de Claude Agent desde el artículo oficial de soporte de Anthropic.
3. Reclame el crédito.
4. Verifique que el saldo aparece en la configuración de su cuenta.

Si usa un plan Team, cada usuario debe reclamar su propio crédito. Los administradores no pueden activarlo por otros miembros.

Configurar el SDK en Python

Instale el paquete:

pip install claude-agent-sdk

Autentíquese con Claude Code:

claude login

El SDK detecta las credenciales locales vinculadas al plan. Para usar el crédito del plan, no configure ANTHROPIC_API_KEY.

Agente mínimo:

from claude_agent_sdk import Agent

agent = Agent(
    system_prompt="You are a code review assistant.",
)

response = agent.run(
    "Review the diff in /tmp/patch.diff and flag concerns."
)

print(response.text)

Antes, esta llamada requería ANTHROPIC_API_KEY y facturación medida por API. Ahora se descuenta del crédito del plan si la autenticación se hace mediante Claude Code.

Configurar el SDK en TypeScript

Instale el paquete:

npm install @anthropic-ai/claude-agent-sdk

Autentíquese:

claude login

Agente mínimo:

import { Agent } from "@anthropic-ai/claude-agent-sdk";

const agent = new Agent({
  systemPrompt: "You are a code review assistant.",
});

const response = await agent.run(
  "Review the diff in /tmp/patch.diff and flag concerns."
);

console.log(response.text);

En entornos donde el SDK no pueda detectar credenciales locales —CI, Docker o máquinas remotas— configure las variables de entorno indicadas en la documentación del SDK de Agent.

Si claude login falla por configuración antes de llegar al SDK, revise la solución para el error de configuración de empresa custom3p no válido.

Usar claude -p para automatizaciones

También puede usar el crédito sin escribir código mediante claude -p.

El flag -p ejecuta Claude Code en modo no interactivo: recibe una instrucción, trabaja sobre el repositorio y termina. Esto encaja en CI, cron jobs y hooks de Git.

Ejemplo de hook pre-commit:

#!/usr/bin/env bash
# .git/hooks/pre-commit

DIFF=$(git diff --cached)

claude -p "Review this diff for security issues, secret leaks, and breaking changes. Return PASS or FAIL with reasoning:\n\n$DIFF"

Cada ejecución de claude -p después del 15 de junio se descuenta del crédito del SDK de Agent, no del presupuesto interactivo de Claude Code.

Puede combinarlo con el comando /goal para bucles autónomos y con archivos AGENTS.md para dar contexto estable al agente.

Integración con GitHub Actions

La integración de GitHub Actions de Claude Code también queda cubierta por el crédito del SDK.

Si usa Claude para revisiones de PR, clasificación de issues o generación de notas de lanzamiento, esas ejecuciones se facturan contra el crédito del SDK de Agent del usuario que instaló la aplicación de GitHub.

Esto es útil para proyectos como Clawsweeper, el bot de clasificación de GitHub construido con Claude Code, donde la automatización se ejecuta continuamente.

Construir agentes reales con Apidog

El SDK de Agent es más útil cuando el agente no solo responde texto, sino que interactúa con APIs, bases de datos o sistemas de despliegue.

Para eso necesita contratos claros. Sin un contrato de API, el agente puede inventar estructuras de request, usar payloads incorrectos o asumir respuestas que no existen.

Un flujo práctico con Apidog:

1. Defina el contrato de la API en Apidog. Incluya endpoints, esquemas de request/response y ejemplos.
2. Exporte OpenAPI. Use ese archivo como contexto para el agente.
3. Conecte el agente a endpoints reales con el SDK. El agente debe llamar la API siguiendo los esquemas definidos.
4. Valide con la CLI de Apidog. Cada ejecución puede comprobar que la API responde según el contrato.

Para agentes que orquestan herramientas mediante servidores MCP, use el flujo de pruebas de servidor MCP con Apidog. Así puede validar de extremo a extremo las herramientas que invoca el agente.

La idea completa está en la guía de flujo de trabajo de API con diseño primero: si el agente tiene un contrato contra el cual validar, usted dedica menos tiempo a depurar JSON alucinado y más tiempo a mejorar restricciones, esquemas y casos de prueba.

Puede descargar Apidog gratis para usarlo como capa de contrato en proyectos con el SDK de Agent.

Cuándo seguir usando una clave API separada

El crédito basado en el plan es adecuado para la mayoría de desarrolladores, pero una clave API independiente sigue teniendo sentido en algunos casos:

• Agentes de producción con presupuestos separados. Una clave API facilita aislar facturación y control financiero.
• Acceso compartido entre organizaciones o equipos. Las claves API no dependen de un único usuario.
• Asientos Enterprise Standard. No reciben crédito del SDK de Agent, por lo que deben usar clave API o actualizar de plan.

La guía de acceso gratuito e ilimitado a la API de Claude cubre otras rutas de uso de Claude que no requieren un plan Pro ni una clave API de pago.

Checklist antes de empezar

• [ ] Confirmar que su plan es elegible: Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise basado en uso o asiento Enterprise Premium.
• [ ] Reclamar la activación única del crédito del SDK de Agent.
• [ ] Decidir si habilitar uso adicional.
• [ ] Ejecutar claude login.
• [ ] Instalar el SDK de Python o TypeScript.
• [ ] Crear un agente mínimo.
• [ ] Confirmar que funciona sin ANTHROPIC_API_KEY.
• [ ] Revisar el saldo de crédito después de las primeras ejecuciones.

Preguntas frecuentes

¿Necesito eliminar mi antigua ANTHROPIC_API_KEY?

No necesariamente. Para usar el crédito del plan, autentíquese con claude login. Si mantiene ANTHROPIC_API_KEY para otras herramientas, puede dejarla, pero verifique que el SDK esté usando la autenticación del plan.

¿Qué cuenta como una solicitud contra el crédito?

El crédito se expresa en dólares, no en número de solicitudes. Cada llamada consume saldo según el costo del modelo, tokens de contexto y uso de herramientas, siguiendo las tarifas publicadas por Anthropic para la API.

¿Puedo compartir mi crédito con otro miembro del equipo?

No. Los créditos son por usuario y no transferibles.

¿Qué pasa con mi saldo anterior de la consola API de Anthropic?

Permanece separado. El crédito del plan no reemplaza el saldo prepagado ni la facturación de cargas que sigan usando clave API.

¿El SDK de Agent es lo mismo que Claude Code?

No. Claude Code es la CLI y el conjunto de extensiones de IDE. El SDK de Agent es una biblioteca para construir agentes personalizados en Python o TypeScript. El crédito cubre el SDK, claude -p, GitHub Actions y apps de terceros autenticadas con el SDK.

¿Cambiará mi factura de GitHub Actions?

Sí, si usa la integración oficial de GitHub Actions de Claude Code y el crédito está reclamado en la cuenta del usuario que instaló la app. Esas ejecuciones se descuentan del crédito del SDK.

¿El crédito funciona fuera del SDK de Agent y claude -p?

No. Solo cubre las superficies indicadas: SDK en Python/TypeScript, claude -p, GitHub Actions de Claude Code y aplicaciones de terceros que usan el SDK de Agent. Otros usos siguen los límites normales del plan o la facturación de la clave API.