Crédito del Claude Agent SDK: qué cambia para claude -p, GitHub Actions y herramientas de agentes de terceros el 15 de junio

El 15 de junio de 2026, Anthropic cambia la economía del Claude headless. claude -p, las llamadas al Claude Agent SDK, Claude Code GitHub Actions y las apps de terceros construidas sobre el Agent SDK dejan de consumir los límites normales de las suscripciones de Claude y empiezan a tirar de un crédito mensual separado para Agent SDK (Anthropic Help Center).

Suena a nota al pie de facturación. No lo es. Si tienes cron jobs, revisores de CI, scripts locales, integraciones de agentes al estilo Zed o CLIs envoltorio alrededor de claude -p, esta es la línea donde “incluido en mi plan” pasa a ser “medido contra un crédito en dólares”.

Mi lectura: es el límite de producto correcto, pero el despliegue de Anthropic deja a demasiados desarrolladores enterándose a través de modelos mentales rotos e hilos de Reddit. Programar de forma interactiva y ejecutar agentes automatizados son cargas de trabajo distintas. No deberían compartir la misma cuota. Pero si tu equipo ha montado discretamente automatización alrededor de Claude Code autenticado con suscripción, el 15 de junio es una fecha límite de migración, no un anuncio de precios.

Qué Pasa Realmente al Nuevo Crédito

El artículo de ayuda de Anthropic es explícito sobre el límite. A partir del 15 de junio, el uso de Agent SDK y claude -p en planes de suscripción de Claude consume un nuevo crédito mensual de Agent SDK, separado de los límites de uso interactivo (Anthropic Help Center). La documentación del Agent SDK repite la misma advertencia al principio de la página de resumen (Claude Docs).

Cubierto por el nuevo crédito:

Los créditos de los planes están denominados en dólares:

Anthropic también dice que los créditos son por usuario, no compartidos; se renuevan con el ciclo de facturación; el crédito no usado no se acumula; y el crédito debe reclamarse una vez, después de lo cual se renueva automáticamente (Anthropic Help Center).

Esa última parte importa para los equipos. Una cuenta Team con 20 ingenieros elegibles no obtiene un único depósito compartido para automatización. Cada persona recibe su propio crédito. Si una GitHub Action compartida está autenticada como un usuario, el crédito de ese usuario es el cuello de botella.

El Corte Práctico: claude -p Ya No Es “Solo Uso de CLI”

El comando que va a pillar a la gente por sorpresa es claude -p.

La referencia de CLI de Anthropic describe --print / -p como “Print response without interactive mode”, con flags pensados para automatización como --output-format json, --output-format stream-json, --max-turns, --json-schema y --max-budget-usd (Claude Code CLI reference). Eso lo convertía en pegamento perfecto para scripts:

git diff --staged |
  claude -p "Review this diff for security issues. Return JSON." \
  --output-format json \
  --max-turns 3 \
  --max-budget-usd 2

Después del 15 de junio, eso es uso de crédito de Agent SDK en una cuenta autenticada con suscripción. No es uso interactivo de Claude Code. No es uso normal de chat. No es una puerta lateral gratuita hacia la cuota de tu plan.

Por eso la reacción de la comunidad es tan intensa. En un hilo actual de r/ClaudeCode, los desarrolladores preguntan si el crédito se basa en tokens/modelo, hasta dónde llega realmente $200, si hace falta opt-in, cómo se contabiliza el prompt caching y si GitHub Actions está incluido (Reddit). El “oh… I didn’t realise it was GH actions too” de un comentarista es exactamente el riesgo: la gente asignó este cambio a librerías SDK, no a cada flujo headless de Claude Code.

La respuesta a la pregunta de los tokens es, en la práctica, sí: Anthropic dice que el uso por encima del crédito pasa a créditos de uso a tarifas estándar de API si los créditos de uso están activados. La página actual de precios de Claude API lista Fable 5 a $10 de entrada / $50 de salida por millón de tokens, Opus 4.8 a $5 / $25, Sonnet 4.6 a $3 / $15 y Haiku 4.5 a $1 / $5 (Claude API pricing). El consumo exacto depende del modelo, los turnos, el uso de herramientas, las lecturas de caché, las escrituras de caché y cuánto contexto del repositorio cargue el agente.

No conviertas $20 o $200 en “horas”. Esa es la unidad equivocada. Convierte tus trabajos reales en trazas de tokens y coste.

GitHub Actions: Mismo YAML, Presupuesto Distinto

Claude Code GitHub Actions entra de lleno en el alcance. La documentación de GitHub Actions de Anthropic dice que la acción está construida sobre el Claude Agent SDK y puede responder a menciones @claude, crear PRs, implementar funcionalidades, arreglar bugs o ejecutar automatización personalizada (Claude Code GitHub Actions docs). La documentación también advierte que cada interacción con Claude consume tokens de API y recomienda --max-turns, timeouts y controles de concurrencia para gestionar costes.

Esa guía importa más ahora.

Un informe diario programado como este:

name: Daily Claude Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Summarize yesterday's commits and open issues"
          claude_args: "--model sonnet --max-turns 3"

tiene dos posibles historias de facturación:

1. Si usa una clave de Claude Platform API, Anthropic dice que nada cambia. Sigue siendo facturación normal de API de pago por uso.
2. Si usa crédito de Agent SDK autenticado con suscripción, ahora consume primero el crédito de Agent SDK por usuario y luego créditos de uso si están activados.

La documentación de configuración de la acción sigue enfatizando ANTHROPIC_API_KEY para uso directo de API, y opciones de proveedores cloud para Bedrock y Vertex AI (Claude Code GitHub Actions docs). Para CI de producción, eso es más limpio que atar la automatización de un repositorio a la suscripción de una sola persona. Anthropic dice lo mismo en la guía para administradores: la automatización de producción a escala debería usar Claude Platform con una clave de API para una facturación predecible de pago por uso (Anthropic Help Center).

Mi recomendación: si un flujo puede fusionar código, comentar en PRs o ejecutarse sin supervisión siguiendo un calendario, ponlo con una clave de API y presupuestos explícitos. Reserva el crédito de Agent SDK de suscripción para automatización personal, experimentos y tooling local.

Herramientas de Agentes de Terceros: La Pregunta Tipo Zed

El caso confuso es el tooling de terceros. Los desarrolladores se preguntan: si un editor, harness local o asistente de programación se integra mediante el Agent SDK y me deja autenticarme con mi suscripción de Claude, ¿usa el nuevo crédito?

El artículo de ayuda de Anthropic dice que el crédito cubre “third-party apps that authenticate with your Claude subscription through the Agent SDK” (Anthropic Help Center). El resumen del Agent SDK también dice que Anthropic generalmente no permite que desarrolladores de terceros ofrezcan inicio de sesión de claude.ai o límites de tasa salvo aprobación previa, y les indica que usen métodos de autenticación con clave de API en su lugar (Claude Docs).

Eso deja una regla práctica:

• Si la herramienta usa tu clave de Claude Platform API, este cambio no le da un crédito mensual gratuito. Sigue siendo facturación de API.
• Si la herramienta es una app Agent SDK aprobada y autenticada con suscripción, consume el crédito de Agent SDK.
• Si la herramienta intenta hacer túnel mediante el login de Claude Code, tokens OAuth, PTYs ocultos o límites de suscripción de formas que Anthropic no ha aprobado, trátala como frágil.

La comunidad ya está construyendo alrededor de esa ambigüedad. Una publicación de r/ClaudeCode describe un “reemplazo directo de -p” basado en hooks que mantiene el trabajo dentro de Claude Code interactivo y afirma evitar los créditos de SDK (Reddit). Otra publicación de r/ClaudeAI describe clarp, una CLI local que lanza Claude Code interactivo por debajo para imitar la salida de claude -p (Reddit). El autor lo presenta como compatibilidad local, mientras los comentaristas plantean de inmediato preguntas sobre riesgo para la cuenta.

Ese es el debate real: ¿es preservación legítima de un flujo local o una elusión de cuota disfrazada de tooling? Yo no construiría infraestructura de empresa sobre estos wrappers. Aunque funcionen hoy, codifican una suposición de facturación que Anthropic está intentando eliminar activamente.

Cómo Auditar Tus Propios Flujos Hoy

Haz esto antes de esperar a que falle un job.

Primero, busca claude -p e imports de Agent SDK:

rg 'claude\s+(-p|--print)|@anthropic-ai/claude-agent-sdk|claude_agent_sdk' .

Luego busca en CI:

rg 'claude-code-action|ANTHROPIC_API_KEY|claude_args|@claude' .github .gitlab .circleci

Clasifica cada resultado:

Para usuarios del SDK, conecta el seguimiento de costes al stream de resultados. La documentación de seguimiento de costes de Anthropic dice que total_cost_usd y costUSD son estimaciones del lado del cliente, no datos de facturación autoritativos, pero son útiles para entender el desarrollo (Claude Docs). La misma página dice que el SDK expone uso de tokens por paso, uso por modelo, tokens de lectura de caché, tokens de creación de caché y totales acumulados.

Usa eso para crear un perfil de consumo:

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

for await (const message of query({
  prompt: "Review this repo for flaky tests",
  options: { maxTurns: 3 },
})) {
  if (message.type === "result") {
    console.log({
      estimatedCostUsd: message.total_cost_usd,
      modelUsage: message.modelUsage,
    });
  }
}

No uses estimaciones de coste del lado del cliente para facturar a tus propios usuarios. Anthropic dice explícitamente que uses la Usage and Cost API o la Claude Console para facturación autoritativa (Claude Docs).

Añade también cortes duros. Para claude -p, usa --max-turns y --max-budget-usd. Para GitHub Actions, usa timeouts de workflow, controles de concurrencia de GitHub y prompts ajustados. Para agentes SDK, restringe herramientas. Un revisor de solo lectura no debería tener Bash, Edit y Write por defecto.

Las Preguntas de Opt-In y Exceso de Uso

La pregunta operativa sin resolver más importante es el opt-in. Anthropic dice que el crédito requiere un opt-in único, reclamado una vez desde tu cuenta de Claude, y luego se renueva automáticamente. Para administradores de Team y Enterprise, los usuarios elegibles debían recibir un email con detalles e instrucciones antes del 15 de junio de 2026 (Anthropic Help Center).

Un hilo actual de r/Anthropic pregunta lo obvio: ¿qué pasa si no haces opt-in? ¿claude -p sigue funcionando contra los límites normales de suscripción, se detiene hasta que reclames el crédito o cae en créditos de uso? El artículo no deja claro ese fallback (Reddit).

Así que no diseñes en torno a un fallback adivinado. Reclama el crédito si eres elegible. Si eres administrador, di a los usuarios dónde reclamarlo y qué automatizaciones pueden usarlo. Si ejecutas flujos compartidos, muévelos a una clave de API.

Para el exceso de uso, Anthropic es más claro. El uso de Agent SDK consume primero el crédito mensual. Después, el uso pasa a créditos de uso a tarifas estándar de API solo si los créditos de uso están activados. Si los créditos de uso no están activados, las solicitudes de Agent SDK se detienen hasta que el crédito se renueve (Anthropic Help Center).

Eso es bueno desde el punto de vista de control de gasto. También significa que tu automatización puede fallar en cerrado. Prepárate para eso. CI debería mostrar “Agent SDK credit exhausted” como un fallo de facturación/configuración, no como un error de modelo intermitente. Los scripts locales deberían imprimir un mensaje claro y salir con código distinto de cero. Los agentes de larga duración deberían guardar checkpoints antes de cada turno caro.

La Conclusión para Desarrolladores

Este cambio no es la muerte de claude -p. Es el fin de fingir que un bucle de agente headless tiene el mismo perfil de coste que una persona sentada en un IDE.

Para desarrolladores individuales, el nuevo crédito es útil. Un usuario Pro obtiene $20 mensuales para scripts. Un usuario Max 20x obtiene $200. Eso alcanza para automatización pensada, no para agentes always-on ilimitados.

Para equipos, la respuesta es aburrida y correcta: usa claves de API para automatización de producción. Mantén personales los créditos de Agent SDK de suscripción. Añade logging de costes. Limita turnos. Prefiere Haiku o Sonnet cuando la tarea no necesite un modelo frontier. Trata las herramientas wrapper que rodean el nuevo límite como experimentos, no infraestructura.

La separación del 15 de junio resuelve un problema real: tu script nocturno no debería comerse en silencio la misma cuota que necesitas para programar de forma interactiva. Crea otro: los desarrolladores ahora tienen que pensar como usuarios de API siempre que Claude se ejecute sin una persona en el loop.

Es un intercambio justo. Pero solo funciona si auditas antes de que el contador empiece a morder.

Los lectores que quieran probar Claude Fable 5 por su cuenta pueden usarlo a través de OneHop: un endpoint drop-in, alrededor de un 30% por debajo del precio de lista, con $10 gratis para cuentas nuevas y sin tarjeta requerida. Mira Claude Fable 5 en OneHop o empieza con $10 gratis.

Lecturas adicionales: Primeros pasos con Claude Fable 5.