Cómo obtener una API key de Claude

Cómo obtener una API key de Claude y usarla en una app

Obtén tu API key de Claude en la Claude Console, descubre qué planes de Claude incluyen créditos de API y usa Claude en iPhone, Android o la web sin código.

Oriveo TeamPublicado Actualizado 11 min de lectura
  • Para obtener una clave de API (API key) de Claude, inicia sesión en la Claude Console en platform.claude.com, abre Settings → API keys (platform.claude.com/settings/keys), haz clic en Create key y cópiala; empieza por «sk-ant-» y se muestra una sola vez. Agrega créditos en Billing y después pega la clave en una app de chat que acepte tu propia clave, como Oriveo.
  • Claude Pro no incluye uso de la API. A 18 de noviembre de 2026, los planes Max, Ultra y Team de Claude incluyen créditos de API mensuales, que se reclaman vinculando el plan a una organización de la Console.
  • A 28 de septiembre de 2026, Claude Sonnet 5 cuesta $2 por millón de tokens de entrada y $10 por millón de tokens de salida, así que un mensaje de chat típico cuesta alrededor de un centavo, según la estimación.
Oriveo en iPhone: la lista de chats, con el costo estimado de cada conversación a la derecha.

Lo que necesitas antes de empezar

Usar Claude desde una app con tu propia clave requiere tres cosas: una cuenta de la Claude Console, algo de crédito de API en esa cuenta y una app que acepte una clave de Anthropic. Ninguna exige saber programar. Toda la configuración suele tomar diez minutos, la mayor parte en el formulario de facturación.

Ayuda tener claro qué cuenta de Anthropic estás usando. Las apps de Claude en claude.ai (Free, Pro, Max, Ultra y Team) son suscripciones de consumo. La Claude Console en platform.claude.com es la plataforma de desarrolladores, donde se gestionan las claves de API y la facturación de la API. Anthropic factura las dos por separado: a 18 de noviembre de 2026, los planes Free, Pro y Enterprise no incluyen uso de la API, mientras que Max, Ultra y Team traen un monto mensual de créditos de API (lo vemos más abajo). Puedes iniciar sesión en ambas con el mismo correo.

Paso 1: crea una clave de API de Claude

Anthropic documenta el proceso en su página «Get your Claude API key». La clave se crea una vez y después no se puede volver a ver, así que ten a mano un lugar seguro donde guardarla, como un administrador de contraseñas.

  • Entra a platform.claude.com e inicia sesión, o crea una cuenta de la Console.
  • Abre Settings → API keys (platform.claude.com/settings/keys).
  • Haz clic en Create key, ponle un nombre que reconozcas —por ejemplo «Oriveo en mi celular»— y elige una fecha de expiración.
  • Copia la clave. Empieza por «sk-ant-» y la Console muestra la clave completa solo una vez, al crearla.
  • Si pierdes la clave, no hay forma de recuperarla; crea una nueva y revoca la anterior.

Paso 2: agrega créditos y pon un límite

El uso de la API de Claude se paga con créditos prepagados. En la Console, abre Settings → Billing y compra créditos; quedan disponibles en cuanto la compra se completa. Opcionalmente puedes activar la recarga automática, que compra más créditos cuando tu saldo baja de un umbral que tú eliges. Mientras mides cuánto usas, dejar la recarga automática desactivada es una forma simple de acotar tu gasto a lo que prepagaste.

A tu organización se le asigna automáticamente un nivel de uso, y cada nivel tiene rate limits (límites de solicitudes y de tokens por minuto) y un límite de gasto mensual. Puedes ver ambos en la Console, en las páginas Rate limits y Billing. Para un chat personal, los límites iniciales rara vez son el cuello de botella, pero explican el ocasional error de «rate limit» si envías muchos mensajes largos seguidos.

¿Los planes Max, Ultra o Team de Claude incluyen créditos de API?

Sí, a 18 de noviembre de 2026. Anthropic da créditos de API mensuales con estos planes: $100 USD con Max, $200 USD con Ultra y $20 o $100 USD por puesto de Team (Standard o Premium), hasta $500 USD en total por equipo. Los planes Free, Pro y Enterprise no incluyen ninguno.

Para usarlos, vincula tu plan de claude.ai a una organización de la Claude Console. Las suscripciones nuevas pueden reclamar los créditos a partir de los 7 días, y los créditos sin usar no pasan al siguiente periodo de facturación. Anthropic dice que sirven para pagar la API de Claude, Managed Agents, el Agent SDK y el Console Playground, pero no el uso adicional de Claude Code ni de la app de Claude.

Como Oriveo usa la API de Claude, una clave creada en la organización de la Console vinculada puede usar esos créditos. Cuando se acaban, la organización necesita créditos prepagados, como siempre.

Cuánto cuesta Claude por la API

La API se tarifica por token, con una tarifa aparte para los tokens que envías (entrada) y los que Claude escribe (salida). La tabla muestra las tarifas publicadas de Anthropic para los modelos actuales a 28 de septiembre de 2026, con un costo estimado para un mensaje de chat típico de 2,000 tokens de entrada y 600 de salida. Del lado de la entrada van también los turnos anteriores de la conversación, que una app reenvía con cada mensaje.

La aritmética para Sonnet 5 es 2,000 × $2 / 1,000,000 + 600 × $10 / 1,000,000 = $0.010. Tus propios mensajes variarán, así que toma la última columna como una guía de orden de magnitud. El monto final es el de la factura de Anthropic, no el de una estimación.

Cuánto cuesta Claude por la API
ModeloEntrada (USD / 1M tokens)Salida (USD / 1M tokens)Costo estimado por mensaje típico
Claude Haiku 4.51.005.00unos $0.005
Claude Sonnet 52.0010.00unos $0.010
Claude Opus 5.54.0020.00unos $0.020
Claude Fable 5.110.0050.00unos $0.050

Paso 3: agrega la clave en Oriveo

Oriveo es una app de chat de IA multimodelo para iPhone, Android y la web que funciona con tus propias claves. Anthropic es uno de sus 15 proveedores oficiales, en la sección «Proveedores directos de IA» («Acceso directo a proveedores oficiales de IA» en la web). Las etiquetas de abajo son las que muestra la app en español.

Oriveo comprueba la clave en cuanto tocas «Continuar», pidiéndole a Anthropic la lista de modelos que tu clave puede usar, y luego sincroniza esa lista. Si Anthropic rechaza la clave, normalmente por un error al copiarla, Oriveo la guarda igualmente y muestra «Guardado, pero la clave parece no válida. Puedes verificarla más tarde en los ajustes del proveedor.», para que puedas corregirla antes de chatear.

Paso 3: agrega la clave en Oriveo
PasoiPhoneAndroidWeb
Abrir la lista de proveedoresPestaña «Proveedores»Pestaña «Proveedores»«Proveedores» en la barra lateral
Iniciar la configuración«Agregar proveedor»«Agregar proveedor»«Agregar proveedor»
Elegir el proveedorAnthropic, en «Proveedores directos de IA»Anthropic, en «Proveedores directos de IA»Anthropic, en «Acceso directo a proveedores oficiales de IA»
Pegar la claveCampo «API Key» bajo «Conectar Anthropic»Campo «Clave API» bajo «Conectar Anthropic»Campo de la clave bajo «Conectar Anthropic»; «Obtén tu clave en Claude» enlaza a la Console
Confirmar«Continuar»«Continuar»«Continuar»
Esperar la comprobación«Validando conexión y sincronizando modelos...»«Validando conexión y sincronizando modelos…»«Validando conexión y sincronizando modelos...»

Paso 4: elige un modelo y empieza a chatear

Una vez conectado Anthropic, sus modelos aparecen en el selector de modelos. Elige el que mejor se adapte a la tarea: Haiku para preguntas rápidas del día a día, Sonnet como opción predeterminada sólida, Opus o Fable para el razonamiento y la escritura más difíciles. Puedes cambiar de modelo a mitad de la conversación, incluidos modelos de otros proveedores que hayas conectado, y la conversación sigue con el nuevo modelo.

En las apps de iPhone y Android, la primera vez que envías un mensaje a un proveedor, Oriveo muestra un aviso corto —«Estás a punto de usar Anthropic»— que explica que tu mensaje se enviará a Anthropic para generar la respuesta. En todas las plataformas, cada mensaje muestra a su lado un costo estimado, calculado a partir del precio publicado de Anthropic y los tokens que indica la respuesta.

Usar tu clave de Claude en iPhone y Android

Los pasos de arriba funcionan igual en el celular. En la app de Oriveo para iPhone o Android, abre la pestaña «Proveedores», toca +, elige Anthropic, pega la clave y toca «Continuar». Una clave larga es más fácil de pasar al celular con un administrador de contraseñas; evita mandártela por correo o por chat.

Las apps de iPhone y Android envían tus mensajes directamente a Anthropic, y la clave se guarda en el almacenamiento seguro del teléfono: el Llavero (Keychain) en iPhone y el Keystore en Android. La sincronización en la nube no sube las claves de API, así que un segundo dispositivo no recibirá tu clave por sincronización. Pégala también ahí, o crea una clave aparte para cada dispositivo.

Cuida tu clave

Una clave de Anthropic puede gastar tu saldo, así que trátala como una contraseña. Oriveo mantiene las claves de los proveedores en tu dispositivo o en tu navegador, no como registros de cuenta. Las apps de iPhone y Android envían las solicitudes de Claude a Anthropic directamente; la app web envía las solicitudes por un reenvío en tiempo real en el servidor de Oriveo: tu clave solo se usa para esa solicitud y no se guarda como dato de tu cuenta, y los chats BYOK no se almacenan como registros de chat. Oriveo no agrega recargo a los precios de Anthropic.

  • Crea una clave por app o dispositivo, para poder revocar una sin afectar a las demás.
  • Usa créditos prepagados sin recarga automática, o un umbral de recarga bajo, mientras conoces tu consumo.
  • Revisa la página de uso de la Console después de unos días y compárala con las estimaciones de la app.
  • Si una clave termina pegada en algún lugar público, revócala en la Console y crea otra.

¿No funciona? Errores comunes de la API key de Claude

La mayoría de los problemas de configuración vienen de un puñado de causas, y el error normalmente indica cuál. Esta lista sigue la página de errores de Anthropic a 18 de noviembre de 2026.

  • 401 authentication_error: la clave se copió incompleta, fue revocada o venció. Vuelve a copiarla o crea una nueva.
  • «Your credit balance is too low to access the Anthropic API»: a la organización de la Console no le queda crédito. Compra créditos en Settings → Billing o activa la recarga automática.
  • 402 billing_error: hay un problema con tus datos de pago. Revísalos en la Console.
  • 403 permission_error: la clave no tiene permiso para usar ese recurso. Revisa la configuración de tu organización y de tu workspace en la Console.
  • 429 rate_limit_error: enviaste muchas solicitudes o mensajes muy largos en poco tiempo. Espera un minuto y vuelve a intentarlo. Si el detalle dice enforced_spend_limit_reached, tu organización alcanzó el límite de gasto mensual de su nivel, y las solicitudes seguirán fallando hasta el día 1 del mes siguiente (00:00 UTC), salvo que solicites un nivel superior en la página Rate limits de la Console.
  • 400 invalid_request_error que menciona un límite de gasto: alcanzaste un límite que configuraste tú. Súbelo en la Console.
  • 529 overloaded_error: Anthropic está saturado temporalmente. Vuelve a intentarlo en un rato.
  • Falta un modelo nuevo de Claude: actualiza la lista de modelos del proveedor en la app después de que Anthropic lo lance.
  • Esperabas que tu plan Claude Pro cubriera esto: no lo hace. Pro no incluye créditos de API; los planes Max, Ultra y Team, sí.
  • En Oriveo, una clave que Anthropic rechaza aparece como «Clave API no válida» en iPhone y Android («API Key inválida» o «Acceso caducado» en la web).

Preguntas frecuentes

¿Dónde consigo una clave de API de Claude?
En la Claude Console, en platform.claude.com, dentro de Settings → API keys. Haz clic en Create key, ponle nombre y cópiala de inmediato; la clave completa, que empieza por «sk-ant-», se muestra solo una vez.
¿Claude Pro incluye acceso a la API?
No. A 18 de noviembre de 2026, los planes Free, Pro y Enterprise no incluyen uso de la API; el uso de la API se paga con créditos prepagados en la Claude Console. Los planes Max, Ultra y Team son distintos: incluyen créditos de API mensuales.
¿Puedo usar mi suscripción Claude Max para la API?
En parte. A 18 de noviembre de 2026, Max incluye $100 USD en créditos de API al mes (Ultra, $200 USD; Team, $20 o $100 USD por puesto, hasta $500 USD). Vincula el plan a una organización de la Console para reclamarlos; los créditos sin usar no se acumulan y no sirven para pagar el uso adicional de Claude Code ni de la app de Claude.
¿Hay una API key de Claude gratis?
A 18 de noviembre de 2026, Anthropic no indica ningún crédito gratis para las cuentas nuevas de la Console. La API se paga con créditos prepagados, aparte de los créditos mensuales que traen los planes Max, Ultra y Team.
¿Cuánto cuesta usar Claude con mi propia clave de API?
Pagas por token. A 28 de septiembre de 2026, Claude Sonnet 5 cuesta $2 por millón de tokens de entrada y $10 por millón de tokens de salida, lo que da alrededor de un centavo por un mensaje de chat típico, según la estimación. Los modelos más pesados cuestan más por mensaje.
¿Puedo usar una clave de API de Claude en mi iPhone o mi celular Android?
Sí, con una app que acepte tu propia clave. En Oriveo, abre «Proveedores», toca «Agregar proveedor», elige Anthropic, pega la clave y continúa. Las apps nativas envían las solicitudes a Anthropic directamente.
¿Necesito escribir código para usar la API de Claude?
No. Necesitas una cuenta de la Console, crédito y una clave; una app de chat BYOK se encarga de las solicitudes de la API por ti. El código solo hace falta si quieres construir tu propio software sobre la API.
¿Mi clave de API de Claude está segura en Oriveo?
Oriveo mantiene las claves en tu dispositivo o en tu navegador, no como registros de cuenta, y las apps nativas se conectan a Anthropic directamente. Aun así, limita los riesgos: usa una clave por app y créditos prepagados, y revoca la clave si alguna vez queda expuesta.

Lecturas relacionadas

Chatea con Claude usando tu propia clave

Agrega tu clave de Anthropic a Oriveo en iPhone, Android o la web, alterna entre Claude y otros 700+ modelos, y ve el costo estimado de cada mensaje.