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

Anthropic le permitirá ejecutar el SDK de Claude Agent en su suscripción existente de Claude a partir del 15 de junio de 2026. Antes de esto, construir cualquier cosa con el SDK de Agent significaba una clave API separada con facturación de pago por uso medida, además de lo que ya pagaba por Claude Pro o Max. A partir del 15 de junio, su plan mensual de Claude incluirá un saldo de crédito específicamente para el uso del SDK de Agent. No se requiere clave API.

Si alguna vez quiso crear un agente personalizado (un bot de despliegue, un asistente de investigación, una herramienta de clasificación) pero no quería registrar una tarjeta de facturación separada con Anthropic solo para prototipar, este es el cambio que importa. Su suscripción Pro ahora incluye $20/mes de uso del SDK de Agent. Max 20x incluye $200. Los asientos Team Premium incluyen $100.

button

Qué cambió el 15 de junio de 2026

La versión corta: el uso del SDK de Agent ahora proviene de un crédito mensual vinculado a su plan de Claude. Anteriormente se facturaba a través de la API de Anthropic con un saldo de consola separado.

Aquí está el crédito por plan, tomado directamente del 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 el uso)	$20
Asiento Enterprise Premium	$200

Algunas reglas importantes:

Los miembros de asientos Enterprise Standard no obtienen un crédito. Tienen que usar una clave API o actualizar a un asiento Premium.
Los créditos son por usuario y no transferibles. El crédito de su asiento no se puede acumular con el de un compañero de equipo.
Los créditos no utilizados no se transfieren. Lo que quede al final de su ciclo de facturación se restablece.
Se requiere una activación única. El crédito no se activará en su cuenta hasta que lo reclame una vez. Después de eso, se actualiza automáticamente cada mes.
Los usuarios de la clave API no reciben el crédito. Esto es específico del plan. Si se ha autenticado a través de ANTHROPIC_API_KEY, está en el modelo de facturación antiguo.

Qué cubre el crédito y qué no

Anthropic lo dividió cuidadosamente. Lea con atención; la línea entre "cubierto" y "no cubierto" es lo que determina si su factura cambia realmente.

Cubierto por el crédito del SDK de Agent:

Llamadas al SDK de Claude Agent desde sus propios proyectos de Python o TypeScript
El comando claude -p en Claude Code (modo no interactivo, utilizado para ejecuciones de agentes programadas)
La integración de GitHub Actions de Claude Code
Aplicaciones de terceros que se autentican usando el SDK de Agent

No cubierto (estos todavía provienen de su plan regular de Claude, o permanecen separados):

Sesiones interactivas de Claude Code (la CLI normal que usa a diario)
Conversaciones en la aplicación web o móvil de Claude
Sesiones de Claude Cowork

En otras palabras, el crédito del SDK de Agent es específicamente para cargas de trabajo programáticas, automatizadas o no interactivas. Su trabajo normal con Claude Code se rige por los límites de uso existentes del plan, que Anthropic aumentó recientemente en un 50% hasta el 13 de julio. Dos presupuestos separados, dos propósitos separados.

Esta es una elección de diseño significativa. Significa que puede experimentar con un agente personalizado construido sobre el SDK sin consumir el presupuesto que utiliza para la codificación diaria a través de Claude Code.

Cuando se le agota el crédito

El crédito cubre una cantidad fija de dólares por mes. Lo que sucede cuando lo excede depende de una configuración:

Uso adicional habilitado: Los excedentes se facturan como pago por uso a las tarifas estándar de la API contra el método de pago de su plan.
Uso adicional deshabilitado: Las solicitudes se detienen en el límite de crédito hasta que el ciclo se restablece.

Para el trabajo de prototipado, desactive el uso adicional. Obtendrá una señal de parada clara y evitará facturas sorpresa. Para automatizaciones de nivel de producción que necesitan seguir funcionando, actívelo.

El crédito siempre se usa primero. No pagará tarifas de excedente hasta que se agote su asignación mensual.

Cómo activar

El crédito no está activado por defecto. La activación es única y persiste entre ciclos de facturación, pero debe hacerlo una vez.

Inicie sesión en la cuenta de Claude que posee la suscripción (la cuenta de usuario en Pro/Max, o la cuenta de asiento en Team/Enterprise).
Visite la configuración del plan del SDK de Claude Agent (enlazado desde el artículo oficial de soporte de Anthropic).
Reclame el crédito. Después de esto, el crédito se actualiza automáticamente cada mes.

Si tiene varios asientos en un plan Team, cada usuario debe reclamar de forma independiente. Los administradores no pueden reclamar en nombre de los miembros del asiento.

Configuración del SDK en Python o TypeScript

El SDK de Agent se distribuye tanto en Python como en TypeScript. Ambos se autentican de la misma manera con su plan: a través de la CLI de Claude Code en lugar de una clave API sin procesar.

Python

Instalar:

pip install claude-agent-sdk

Autentíquese iniciando sesión en Claude Code primero:

claude login

Esto almacena las credenciales vinculadas al plan localmente. El SDK de Python las detecta automáticamente; no configure ANTHROPIC_API_KEY para el uso basado en el plan.

Un agente mínimo se ve así:

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)

La misma llamada habría requerido ANTHROPIC_API_KEY y facturación de API medida antes. Ahora se deduce de su crédito de plan.

TypeScript

Instalar:

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

Autentíquese a través del mismo inicio de sesión de Claude Code:

claude login

Un agente mínimo en TypeScript:

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);

Para entornos donde el SDK no puede encontrar las credenciales de Claude Code automáticamente (ejecutores de CI, contenedores Docker, máquinas de desarrollo remotas), puede configurarlas como variables de entorno. Anthropic publica los nombres exactos de las variables en la documentación del SDK de Agent.

Si su inicio de sesión en Claude Code arroja errores de configuración antes incluso de llegar a la configuración del SDK, la solución para el error de configuración de empresa custom3p no válido cubre la causa más común.

El flujo de trabajo `claude -p`

Hay una segunda forma de usar el crédito del SDK de Agent que no implica escribir código: el comando claude -p en Claude Code.

-p pone a Claude Code en modo no interactivo. Le entrega una instrucción, la ejecuta contra su repositorio y sale. No hay sesión de ida y vuelta. Así es como se programa Claude Code en tuberías de CI, tareas cron y hooks de Git.

Un ejemplo sencillo: un hook pre-commit que pide a Claude que señale cambios riesgosos.

#!/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 invocación de claude -p después del 15 de junio se deduce de su crédito del SDK de Agent, no de su presupuesto interactivo de Claude Code. Lo que significa que puede conectarlo a flujos de trabajo automatizados sin preocuparse por agotar los límites que necesita para la codificación diaria.

Esto combina bien con el comando /goal para bucles autónomos, y con los archivos de contexto AGENTS.md para dirigir el agente de manera confiable a través de ejecuciones.

Integración con GitHub Actions

La integración de GitHub Actions de Claude Code es la tercera carga de trabajo cubierta por el crédito del SDK. Si ha conectado Claude a revisiones de PR, clasificación de problemas o generación de notas de lanzamiento, esas ejecuciones de flujo de trabajo ahora se facturan contra el crédito del SDK de Agent en el 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 constantemente y la factura solía ir a la clave API que estaba conectada a la aplicación.

Construyendo agentes reales: emparejando el SDK con Apidog

El valor real del SDK de Agent es para agentes que hacen más que responder a texto; agentes que acceden a APIs reales, consultan bases de datos, despliegan código. Para que esto funcione de manera confiable, el agente necesita un contrato definido para cada API externa que toca. Sin uno, el agente adivina las formas de las solicitudes y usted dedica su tiempo de depuración a corregir cargas útiles alucinadas.

Aquí es donde Apidog encaja en el flujo de trabajo:

Defina el contrato de la API primero en Apidog. Especifique los puntos finales, los esquemas de solicitud/respuesta y los ejemplos de cargas útiles. Esto se convierte en la fuente de la verdad.
Exporte OpenAPI y páseselo a su agente como contexto.
Use el SDK para conectar el agente con los puntos finales reales. El agente llama a su API usando los esquemas que sabe que son correctos.
Valide con la CLI de Apidog. Cada ejecución del agente puede verificar que la API aún devuelve lo que el contrato promete.

Para agentes que orquestan otras herramientas a través de servidores MCP, el flujo de trabajo de pruebas de servidor MCP con Apidog es la guía correspondiente. Obtendrá cobertura de pruebas de extremo a extremo en las herramientas que llama su agente.

La visión más amplia se encuentra en la guía de flujo de trabajo de API con diseño primero: cuando el agente tiene un contrato contra el cual validar, su tiempo como desarrollador se eleva en la pila para escribir mejores contratos y restricciones, no para perseguir errores de esquema JSON en la salida del agente.

Descargue Apidog gratis si desea que la capa de contrato respalde sus proyectos del SDK de Agent.

Cuando aún desee una clave API separada

El crédito basado en el plan es la opción predeterminada correcta para la mayoría de los desarrolladores. Todavía hay casos en los que una clave API independiente tiene sentido:

Agentes de producción que necesitan presupuestos predecibles. Los créditos del plan tienen un límite en cantidades fijas de dólares. Si está ejecutando un agente que necesita una escalabilidad ilimitada, una clave API basada en el uso proporciona a finanzas y operaciones una línea de facturación más clara.
Acceso multi-organización. Las claves API no están vinculadas a un solo usuario. Si un equipo quiere acceso compartido a una fuente de facturación, eso sigue siendo un trabajo de clave API.
Asientos Enterprise Standard. Estos no reciben créditos del SDK de Agent. Si está en un asiento Enterprise Standard y necesita acceso al SDK, una clave API es el camino.

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

Una lista de verificación clara antes de empezar

[ ] Confirme que su plan está en la lista de elegibles (Pro, Max 5x, Max 20x, Team Standard, Team Premium, Enterprise basado en el uso, asiento Enterprise Premium)
[ ] Reclame la activación única para el crédito del SDK de Agent
[ ] Decida si habilita el uso adicional (desactivado para prototipado, activado para producción)
[ ] Ejecute claude login para autenticar el SDK con su plan
[ ] Instale el paquete del SDK de Python o TypeScript
[ ] Cree un agente mínimo y confirme que se ejecuta sin ANTHROPIC_API_KEY configurado
[ ] Verifique el saldo de crédito en la configuración de su cuenta después de las primeras ejecuciones

Preguntas frecuentes

¿Necesito eliminar mi antigua ANTHROPIC_API_KEY para que funcione el crédito del plan? El SDK utiliza las credenciales locales de Claude Code cuando existen, lo que significa que claude login es suficiente para cambiar el SDK a la facturación basada en el plan. Si tiene ANTHROPIC_API_KEY configurada en su entorno para otras herramientas, déjela; el SDK preferirá la autenticación del plan cuando esté presente.

¿Qué cuenta como una "solicitud" contra el crédito? El crédito se denomina en dólares, no en solicitudes. Cada llamada al SDK se factura a las mismas tarifas que Anthropic publica para el uso de la API; su saldo de crédito disminuye por el costo de cada llamada al modelo, incluido el uso de herramientas y los tokens de contexto. No hay una tarifa por solicitud adicional.

¿Puedo compartir mi crédito con un compañero de equipo? No. Los créditos son por usuario y no transferibles. Cada asiento de Team o Enterprise tiene su propia bolsa de créditos.

¿Qué sucede con mi antiguo saldo de consola de API de Anthropic? Permanece donde está. El crédito del plan es un mecanismo de facturación separado. Si tenía un saldo prepagado en su consola de API, eso aún funciona para cualquier carga de trabajo de clave API.

¿El SDK de Agent es lo mismo que Claude Code? No. Claude Code es la CLI oficial y las extensiones de IDE que Anthropic distribuye. El SDK de Agent es una biblioteca de programación (Python o TypeScript) para construir agentes personalizados. El crédito cubre el SDK más el comando no interactivo claude -p en Claude Code; Claude Code interactivo se mantiene en el uso regular de su plan.

¿Cambiará mi factura de GitHub Actions? Si su acción utiliza la integración oficial de GitHub Actions de Claude Code y el crédito se reclama en la cuenta del usuario que la instaló, esas ejecuciones ahora se deducen del crédito del SDK en lugar de cualquier facturación de clave API.

¿Funciona el crédito fuera del SDK de Agent y claude -p? No para las cuatro superficies cubiertas (SDK en Python/TS, claude -p, GitHub Actions, aplicaciones de terceros del SDK de Agent). Cualquier otro uso de Claude se rige por los límites normales de su plan o su clave API, dependiendo de dónde se origine la solicitud.