Cómo obtener una clave API de Claude (y cuánto cuesta) en 2026

Sección 01Qué es la API de Claude y en qué se diferencia de una suscripción

Claude tiene dos puertas. La primera la conoce todo el mundo: la web claude.ai, la app del móvil, la ventana de chat. Escribes y Claude responde. Pagas con una suscripción: Pro a $20 al mes o Max a $100 y $200.

La segunda puerta es la API. Es la entrada para programas. Tu bot de Telegram recibe la pregunta de un cliente, se la pasa a Claude por sí solo, recibe la respuesta y se la devuelve al cliente. Ninguna persona en la cadena. Una web con asistente, una hoja de cálculo que clasifica sola los contactos entrantes, un agente que prepara cada mañana un informe de ventas: todo eso funciona a través de la API.

Lo único que conviene recordar desde el principio: son dos monederos distintos. Una suscripción Pro te da cero solicitudes gratis a la API. Un saldo en la API no desbloquea Pro en el chat. Incluso las cuentas viven en sitios diferentes: el chat está en claude.ai y la API en la Console para desarrolladores, en platform.claude.com. Puedes entrar con el mismo correo, pero cada puerta tiene su propia facturación.

Cómo se cuenta el dinero

Una suscripción funciona como la cuota del gimnasio: pagas una cantidad fija y la usas dentro de los límites. La API funciona como el contador de la luz. Cargas dinero en el saldo por adelantado y cada solicitud se lleva su parte según cuánto texto entró en Claude y cuánto salió.

El texto se mide en tokens. Un token es un trozo de palabra. La página oficial de modelos da una equivalencia: un millón de tokens son unas 555 000 palabras en inglés. Para hacer cuentas rápidas, piensa que una página de texto denso son unos mil tokens. Los precios se indican por millón de tokens, por separado para la entrada (lo que enviaste) y la salida (lo que escribió Claude). La salida siempre cuesta cinco veces más que la entrada.

Qué puedes construir con la API

• Un bot de Telegram que responde a tus clientes con tus palabras: cómo montarlo sin programador lo cuento en cómo hacer un bot de Telegram sin programador.
• Un asistente en tu web que conoce tus programas y tus precios. Cómo darle tus contenidos está en cómo entrenar la IA con el contenido de tu web.
• Un agente en tus mensajes privados que responde a los interesados y agenda llamadas.
• Procesamiento masivo: clasificar 500 reseñas, reescribir 200 descripciones de producto, corregir 50 deberes durante la noche.
• Conectar Claude a servicios sin código: Make, n8n y constructores parecidos piden precisamente esta clave API.

Si quieres usar Claude tú mismo en una ventana de chat, con la suscripción tienes de sobra. Este artículo trata del paso siguiente: cuando Claude tiene que trabajar por su cuenta dentro de tus servicios.

Sección 02Cuánto cuesta la API de Claude en 2026

Haiku 5.5 tiene precio en dos tramos. Una solicitud de hasta 100 000 tokens cuesta $0.10 de entrada y $0.50 de salida. Por encima, el precio sube a $0.50 y $2.50. Un bot con preguntas cortas casi siempre se queda en el tramo bajo.

Los cuatro modelos tienen una ventana de contexto de un millón de tokens y pueden escribir hasta 128 000 tokens en una sola respuesta. Su conocimiento llega hasta junio de 2026.

Descuentos que conviene conocer

• Procesamiento por lotes. Si no necesitas la respuesta al instante, envía las tareas en lote mediante la Batch API: el precio baja un 50%. Ideal para procesar por la noche reseñas, descripciones y deberes.
• Caché de prompts. Si cada solicitud repite el mismo bloque grande, por ejemplo unas instrucciones de bot de diez páginas, puedes guardarlo en caché. Leer de la caché en Sonnet 5.5 cuesta $0.10 en lugar de $2 por millón de tokens, y en Opus 5.5 $0.20 en lugar de $4.
• Modo rápido. Opus 5.5 tiene también la opción contraria: respuestas 2,5 veces más rápidas al doble de precio. Quien empieza no la necesita.

Qué significa eso en la vida real

«Dólares por millón» no dice nada por sí solo, así que aquí va un ejemplo real. El bot de una psicóloga responde 1000 preguntas de clientes al mes. Cada solicitud lleva las instrucciones del bot más la pregunta: unos 1500 tokens de entrada. La respuesta ronda los 300 tokens. En un mes salen 1,5 millones de tokens de entrada y 0,3 millones de tokens de salida.

Mil respuestas a clientes por 30 centavos. En serio. Por eso la recarga mínima de $5 le dura mucho a quien empieza. El dinero empieza a derretirse cuando pones Opus o Fable a trabajar con documentos enormes o te olvidas de parar un script que se ha quedado en bucle. Cómo protegerte de eso lo verás en la sección sobre ahorro.

¿Es gratis?

No. El centro de ayuda oficial lo dice claramente: la API y el Workbench de la Console se pagan con créditos prepago. A 31 de octubre de 2026, Anthropic no promete ningún saldo de prueba gratuito. Si alguien te ofrece una «clave de Claude gratis», o es la clave robada de otra persona o un revendedor que te mandará la factura más tarde. No uses ninguna de las dos.

Sección 03Registro en la Console: paso a paso

La Console para desarrolladores es tu cuenta de la API. Ahí están tu saldo, tus claves, tus estadísticas de gasto y el Workbench, donde puedes hablar con un modelo sin escribir código. La API funciona en una larga lista de países: la lista completa está en la página de regiones compatibles.

Sección 04Cómo comprar créditos

Con el saldo a cero la clave no funciona: la primera solicitud devuelve un error de créditos insuficientes. Así que primero se paga y después se crea la clave.

Sección 05Cómo crear una clave API

La clave es una contraseña que le dice a Anthropic que la solicitud viene de ti y de qué saldo debe cobrarla. Se crea en un minuto.

Sección 06Tu primera solicitud: con código y sin él

Opción 1. Sin código, directamente en el navegador

La Console tiene el Workbench, un entorno de pruebas. Eliges un modelo, escribes unas instrucciones de sistema y una pregunta y pulsas Run. Es la misma API, solo que con botones. Es el mejor sitio para pulir las instrucciones de un bot antes de conectarlo a Telegram. Ten en cuenta que las solicitudes del Workbench también se cobran de tu saldo.

Opción 2. Que Claude Code lo haga todo por ti

Si ya tienes instalado Claude Code (cómo hacerlo está en cómo usar Claude Code), no tienes que configurar nada a mano. Dile:

Tengo una clave API de Claude. Guárdala en un lugar seguro de este ordenador para que nunca acabe en el código ni en git, y luego haz una solicitud de prueba al modelo claude-sonnet-5-5 con la pregunta «Responde con una palabra: ¿funcionas?». Enséñame la respuesta y cuántos tokens ha usado.

Claude Code crea los archivos que necesita, te pide la clave y te muestra el resultado. Lo único que tienes que hacer es pegar la clave cuando te la pida.

Opción 3. Un solo comando en la terminal

Para quienes no le tienen miedo a la terminal. Primero guarda la clave en una variable de entorno:

export ANTHROPIC_API_KEY="sk-ant-tu-clave"

Después envía una solicitud. Es el ejemplo oficial de la documentación, solo he cambiado el modelo y la pregunta:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 500,
    "messages": [
      {"role": "user", "content": "¡Hola! Responde en una frase: ¿funcionas?"}
    ]
  }'

Recibes un JSON de vuelta. El texto de Claude está en el campo content, y el campo usage muestra cuántos tokens entraron y cuántos salieron. Con esas dos cifras siempre puedes calcular lo que costó una solicitud.

Opción 4. Python

pip install anthropic

import anthropic

client = anthropic.Anthropic()  # la clave se lee de ANTHROPIC_API_KEY

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=500,
    system="Eres el asistente de una psicóloga. Responde con calidez y brevedad.",
    messages=[{"role": "user", "content": "¿Cuánto dura una sesión?"}],
)

print(message.content[0].text)
print(message.usage)

Identificadores de modelo para la API a 31 de octubre de 2026: claude-haiku-5-5, claude-sonnet-5-5, claude-opus-5-5, claude-fable-5-1. ¿No sabes por cuál empezar? Empieza por Sonnet 5.5: es rápido y listo. Pasa a Haiku 5.5 más adelante para tareas masivas sencillas, cuando veas que Sonnet las resuelve con margen de sobra.

Sección 07Una prueba real

El motivo más habitual para conseguir una clave API es un bot que responde a los clientes. Su corazón son las instrucciones de sistema. Aquí tienes unas instrucciones que funcionan para el bot de una nutricionista. Cambia los datos por los tuyos y pruébalas en el Workbench.

Eres el asistente de Ana, nutricionista. Respondes en Telegram a las personas interesadas en su programa «Mes Ligero».

Datos del programa:
– 4 semanas, cada lunes empieza un grupo nuevo
– un menú para cada día y una lista de la compra
– un chat con Ana, respuesta en el día los días laborables
– precio $129, pago con tarjeta o a plazos
– no apto durante el embarazo ni para personas con diabetes; en esos casos, solo consulta personal

Reglas:
– Responde breve, 2–4 frases, con educación y calidez.
– Nunca hagas diagnósticos ni des consejos médicos.
– Si la pregunta no está cubierta por los datos, di que lo consultarás con Ana y pide un número de teléfono.
– Al final de la respuesta, cuando encaje, ofrece reservar una llamada gratuita de 15 minutos.

¿Cuánto costó esa conversación? Las instrucciones más la pregunta son unos 500 tokens, la respuesta unos 150. En Sonnet 5.5 eso es aproximadamente un cuarto de centavo. En Haiku 5.5, centésimas de centavo. Mil conversaciones así en Sonnet caben en $2–3.

Un consejo de la práctica: antes del lanzamiento, lanza 20 preguntas incómodas contra las instrucciones. Sobre descuentos que no ofreces. Sobre contraindicaciones. Sobre la competencia. Una pregunta grosera. Una pregunta que no viene a cuento. Cada respuesta que no te guste se convierte en una regla nueva en las instrucciones. Así el bot se vuelve más fiable en una tarde que en una semana de errores delante de clientes reales.

Sección 08Dónde tenerlo funcionando 24/7

Mientras pruebas en la Console, todo funciona desde tu navegador. Pero un bot que atiende a los clientes día y noche no puede vivir en tu portátil. Cierras la tapa y el bot se calla. Se cae el wifi por la noche y el bot también.

Su sitio es un servidor pequeño: un ordenador en un centro de datos que funciona sin parar. Vale cualquier VPS pequeño o servidor en la nube. El bot vive allí y envía sus solicitudes a Claude día y noche. Para uno o dos bots basta con el plan más básico: 1–2 núcleos de CPU, 2 GB de RAM y un disco de 20 GB. Elige la ubicación del centro de datos en una región compatible y listo.

No tienes que configurar el servidor a mano. Instala Claude Code en él y luego simplemente habla: «despliega aquí un bot de Telegram, esta es la clave API de Claude, estas son las instrucciones del bot, haz que se reinicie solo si se cae». Si Claude Code es nuevo para ti, empieza por qué es Claude Code.

Hay otro camino sin ningún servidor: los constructores de automatizaciones como Make o n8n en la nube. Pegas allí la clave y el flujo llama a Claude por su cuenta. La pega es pagar la suscripción del propio constructor y tener menos flexibilidad.

Sección 09Cómo no gastar de más

En más de 250 proyectos implantando IA para psicólogos, coaches, abogados y vendedores de marketplaces, he visto que el dinero se escapa del saldo de la API siempre por los mismos agujeros. Esto es lo que tapa casi todos.

1. Pon un límite de gasto el primer día

Settings, Billing, la sección Spend limits, el botón Set limit. Escribe lo máximo que estás dispuesto a gastar al mes, por ejemplo $10. Cuando el gasto llega ahí, la API empieza a devolver un error y deja de cobrarte. Es el seguro principal contra un script en bucle que lanza diez mil solicitudes durante la noche.

Anthropic tiene además su propio techo según el nivel de tu cuenta. En el nivel Start es de $500 al mes, en Build de $1000. Las cuentas nuevas a veces empiezan en un nivel Evaluation todavía más bajo, y sus límites suben solos a medida que usas la API.

2. Ajusta el modelo a la tarea

Usar Fable 5.1 para clasificar contactos es como ir en limusina a comprar el pan. Entre Haiku y Fable hay una diferencia de precio de cien veces. La regla es sencilla: empieza con Sonnet 5.5 y después prueba la misma tarea en Haiku 5.5. Si la calidad se mantiene, cambia. Recurre a Opus y Fable solo donde Sonnet se equivoca de verdad.

3. Limita la longitud de la respuesta

El parámetro max_tokens de una solicitud es el techo de longitud de la respuesta. Para un bot bastan 300–500. La salida cuesta cinco veces más que la entrada, así que una sola línea en las instrucciones, «responde en 2–4 frases», ahorra dinero directamente.

4. No arrastres todo el historial en cada solicitud

La API no recuerda por sí sola los mensajes anteriores. Para que el bot recuerde la conversación, el programa reenvía el hilo entero cada vez. En el décimo mensaje pagas por los diez. Quédate con los últimos 10–15 turnos y resume los más antiguos en un texto corto.

5. Guarda en caché las instrucciones largas

Si las instrucciones del bot son largas (lista de precios, programas, respuestas a preguntas frecuentes), activa la caché. Una lectura de caché cuesta el 5% del precio normal de entrada en Sonnet y Opus 5.5. Dile a Claude Code: «activa el prompt caching para las instrucciones de sistema del bot».

6. Los trabajos masivos, por lotes

Clasificar 300 reseñas para mañana es trabajo para la Batch API. Mitad de precio y resultados en menos de 24 horas, normalmente mucho antes.

7. Revisa Usage una vez por semana

La página Usage muestra el gasto por días y por modelos. Un pico repentino es la señal para comprobar si un script se ha atascado o si se ha filtrado una clave.

Sección 10Cómo proteger la clave

La clave es el acceso a tu dinero. Quien la tiene gasta tu saldo. Hay bots que rastrean internet día y noche buscando claves sk-ant- en código público, y las encuentran en cuestión de minutos.

• No envíes la clave por mensajería, ni siquiera a ti mismo en Mensajes guardados. No la pongas en capturas de pantalla ni en documentos compartidos.
• No escribas la clave dentro del código. Su sitio es una variable de entorno o un archivo de secretos que nunca entra en git. Claude Code lo configura si se lo pides.
• Una clave por proyecto. Si se filtra la clave de la web, desactivas solo esa y el bot sigue funcionando.
• A un colaborador externo dale una clave aparte con vida corta y bórrala cuando termine el trabajo.
• ¿Sospechas de una filtración? Borra la clave en la página API keys de inmediato y crea una nueva. Después revisa en Usage si hay gastos que no son tuyos.

Sección 11Cuando algo sale mal

La forma más rápida de resolver cualquier error es copiar su texto completo y pasárselo a Claude Code o a Claude en el chat con la pregunta «qué significa esto y cómo lo arreglo». Cada respuesta de la API incluye un request_id. Si alguna vez tienes que escribir al soporte de Anthropic, envíalo junto con tu descripción.

Sección 12API, suscripción o Claude Code: qué elegir

En la práctica, los tres trabajan juntos. La suscripción es para tu trabajo diario. Claude Code sirve para construir el bot o el agente. La API es lo que mantiene ese bot funcionando solo después. Si todavía estás eligiendo IA, la comparación con sus principales rivales está en Claude 5, GPT-5 y Gemini 3.

Sección 13Todo el camino en un minuto

Empieza hoy con una sola acción: recarga $5 y prueba en el Workbench las instrucciones del bot de la sección 7 con diez preguntas reales de tus clientes. Cinco dólares, y sabrás con seguridad si la IA puede llevar tus conversaciones.