01 Qué recibes según tu plan
La API es la vía por la que tus propios programas hablan con Claude: un agente que procesa documentos, un bot de atención al cliente o un flujo de n8n. Hasta ahora se pagaba siempre aparte de la suscripción. Con Max y Team, una parte llega incluida cada mes en una organización de Claude Console (platform.claude.com).
| Plan | Crédito mensual | Detalle |
|---|---|---|
| Max 5x | 100 USD | Al pasar a Max 20x a mitad de ciclo recibes la diferencia prorrateada al momento. |
| Max 20x | 200 USD | Se renueva en cada ciclo de facturación. |
| Team (asiento Standard) | 20 USD por asiento | Bolsa común para toda la organización con un máximo de 500 USD. |
| Team (asiento Premium) | 100 USD por asiento | Ejemplo: 3 Standard + 2 Premium = 260 USD al mes. |
| Free, Pro y Enterprise | No incluido | Estos planes no tienen derecho al crédito. |
02 Cómo reclamarlo paso a paso
- ✓En Max, ser el titular de la suscripción; en Team, Primary Owner u Owner.
- ✓En la organización de Console, rol Owner, Admin o Billing (si no tienes organización, se crea durante el proceso).
- ✓Llevar al menos 7 días en el plan elegible.
- ✓Hacerlo desde claude.ai en un navegador, también si te suscribiste desde la app de iPhone o Android.
-
1
Abre la facturación
En claude.ai ve a Configuración > Facturación (Max) o a la configuración de la organización > Facturación (Team).
-
2
Busca la sección de créditos de API
Pulsa la opción para vincular una organización (Link organization en la interfaz en inglés).
-
3
Elige bien la organización
Selecciona una existente o crea una nueva. Usa el mismo correo que en claude.ai. Cada plan se vincula a una sola organización y no puedes cambiarla tú después: solo soporte puede hacerlo.
-
4
Acepta los términos y vincula
Son condiciones específicas del programa de créditos. Léelas antes de confirmar.
-
5
Comprueba el saldo
En platform.claude.com, en Settings > Billing, aparece en el apartado de créditos promocionales con su importe y fecha de caducidad.
03 Qué cubre y qué no
| Producto | ¿Gasta del crédito? |
|---|---|
| API de Claude (Messages y Message Batches) | Sí |
| Playground de Console | Sí |
| Claude Managed Agents | Sí |
| Claude Agent SDK y claude -p con una clave de la organización vinculada | Sí |
| Herramientas de terceros donde pegas una clave de esa organización (n8n, Make…) | Sí, porque usan la API |
| Claude Code interactivo (terminal, IDE, escritorio o web) | No |
| claude -p o Agent SDK iniciados con la sesión de tu plan | No, gastan los límites del plan |
| GitHub Action de Claude Code, extensiones de IDE o app de escritorio | No |
| Uso adicional comprado en Claude, Claude Code o Cowork | No |
| Claude en Amazon Bedrock, Google Cloud Vertex AI o Microsoft Foundry | No |
El crédito no cambia tus límites de uso en Claude ni en Claude Code. Se gasta antes que cualquier saldo comprado y, si se agota y no tienes otro saldo, la API deja de responder hasta el siguiente ingreso: nunca se carga a tu plan.
04 Tu primera clave de API, sin riesgos
-
1
Prueba primero en el Playground
Es un chat con controles de modelo e instrucciones de sistema. Te permite validar una idea antes de construir nada y ya gasta del crédito.
-
2
Crea una clave por proyecto
En Console, Settings > API Keys. Ponle un nombre descriptivo (por ejemplo, n8n-leads) para poder revocarla sin afectar al resto.
-
3
Guárdala en un .env
La clave empieza por sk-ant- y solo se muestra una vez. Guárdala en el archivo .env del proyecto y añade ese archivo a .gitignore.
-
4
Limita el gasto por proyecto
Todas las claves de la organización comparten saldo. Crea un workspace por proyecto y ponle un límite de gasto.
Revisa cómo está gestionada la clave de Anthropic en este proyecto sin mostrarla nunca completa (como mucho, sus primeros 7 caracteres).
1. Comprueba que existe un .env con ANTHROPIC_API_KEY, que .env está en .gitignore y que hay un .env.example sin valores reales.
2. Busca si la clave aparece escrita en cualquier otro archivo o en el historial de git y dime dónde.
3. Mira si está definida en el perfil de mi shell y, si es así, explícame por qué conviene quitarla y espera mi confirmación.
Termina con un resumen de lo que estaba bien, lo que has corregido y lo que tengo que hacer yo (por ejemplo, revocar la clave en Console si se filtró).05 Qué construir con el crédito en una empresa
El reparto ideal es este: Claude Code construye el programa usando tu plan, y el programa terminado consume el crédito cada vez que se ejecuta.
Extracción de documentos
Un agente con el Agent SDK que lee facturas, albaranes o contratos de una carpeta y genera un CSV con los campos clave.
Clasificación masiva
Reseñas, tickets de soporte o respuestas de encuestas procesadas en lote con Message Batches, que cuesta la mitad.
Informe diario automático
Una tarea programada con claude -p y una clave de la organización vinculada que resume cada mañana lo que pasó el día anterior.
Flujos de n8n o Make
Un nodo de Claude que clasifica correos entrantes o redacta borradores de respuesta para que una persona los revise.
Construye con el Claude Agent SDK un script que recorra la carpeta ./entrada (PDF y texto) y extraiga de cada documento: [campos, por ejemplo proveedor, fecha, base imponible, IVA y total]. Escribe una fila por documento en salida.csv y usa una columna «dudas» cuando algo no esté claro, sin inventar valores.
La clave se lee de ANTHROPIC_API_KEY en un .env que no se sube a git. Prueba primero con un solo documento y enséñame el resultado. Al acabar cada ejecución, muestra los tokens consumidos para que pueda estimar el coste mensual. Añade un README breve en español.06 Cómo estirar el saldo
- ✓Usa el modelo más pequeño que resuelva bien la tarea: Haiku para clasificar o extraer, modelos mayores solo cuando haga falta razonar.
- ✓Activa el prompt caching cuando repitas el mismo contexto largo (instrucciones, catálogos, manuales).
- ✓Manda a Message Batches todo lo que no necesite respuesta inmediata.
- ✓Revisa el consumo en la página Cost de Console durante la primera semana.
- ✓Pon límites de gasto por workspace para que un proyecto no se coma la bolsa del equipo.
Preguntas frecuentes
No. Puedes reclamarlo y gastarlo sin método de pago. Solo necesitarás tarjeta si quieres comprar saldo adicional o activar la recarga automática.
No en su uso interactivo. Solo cuenta claude -p (o el Agent SDK) cuando se ejecuta con una clave de API de la organización vinculada.
Dejas de recibir créditos nuevos, pero el saldo que ya tienes sigue disponible hasta su fecha de caducidad.
No. Es una sola bolsa por organización, calculada con los asientos del plan en cada ingreso y con un máximo de 500 USD. Para repartirlo, usa workspaces con límites de gasto.
Tú no puedes. Tienes que pedírselo al soporte de Anthropic, así que elige con calma la organización en la que vas a construir.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.