Cómo obtener una clave de API de Claude y cuándo necesitarla

Obtener una clave de API de Claude toma alrededor de un minuto. Dos configuraciones que eliges mientras la creas importan más que la clave en sí, y la mayoría de la gente las pasa por alto.

También hay una pregunta que vale la pena hacer antes de empezar: si realmente necesitas una clave de Anthropic, o si lo que estás construyendo llama a más de un proveedor.

TL;DR

Las claves se crean en la Consola en platform.claude.com, bajo Account Settings^[1].
Eliges una expiración cuando creas la clave. Esa decisión se toma una sola vez, en la creación^[1].
Los espacios de trabajo segmentan las claves y controlan el gasto por caso de uso^[1].
La autenticación es el header x-api-key, o Authorization. Los SDKs leen ANTHROPIC_API_KEY del ambiente^[1]^[2].
El Workbench te permite probar la API en un navegador sin escribir código^[1].
Si estás usando Claude junto a GPT o Gemini, una sola clave de gateway cubre las tres en lugar de tres cuentas de proveedor.

Crear la clave

La API se pone disponible a través de la Consola web^[1].

Inicia sesión en platform.claude.com.
Prueba la API en el navegador primero con el Workbench en platform.claude.com/playground, que no requiere código.
Genera la clave en Account Settings, en platform.claude.com/settings/keys.
Elige una expiración mientras la creas.
Opcionalmente colócala en un espacio de trabajo en platform.claude.com/settings/workspaces.

Los pasos 4 y 5 son los que vale la pena hacer lentamente.

Las dos configuraciones que la gente salta

La expiración se elige en la creación. Estableces la vida útil de cada clave cuando la haces^[1]. Una clave con una vida larga es una que seguirás encontrando en un viejo .env el próximo año. Para cualquier cosa que no sea infraestructura de producción de larga duración, una expiración corta es el control de seguridad más barato disponible.

Los espacios de trabajo segmentan las claves y controlan el gasto por caso de uso^[1]. Esta es la característica que convierte "el script de alguien se ejecutó toda la noche" de una sorpresa de facturación en una sorpresa acotada. Un espacio de trabajo por proyecto, o por ambiente, significa que un bucle descontrolado quema el presupuesto de ese espacio de trabajo en lugar del de la cuenta.

Ambas son decisiones que tomas una sola vez y con las que tienes que vivir. Ninguna de las dos se puede cambiar después sin rotar una clave que ya está en producción.

Usar la clave

Se aceptan dos headers. Envía uno de ellos^[1]:

Header	Valor
`x-api-key`	Tu clave de API desde la Consola
`Authorization`	Alternativa tipo Bearer

Los SDKs leen la clave del ambiente automáticamente^[2]:

export ANTHROPIC_API_KEY="sk-ant-..."

import anthropic

client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY

resp = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Summarize this changelog."}],
)

Esa es la integración completa para una configuración de un solo proveedor.

Cuándo no necesitas una clave de Anthropic

Claves por proveedor versus una sola clave de gateway: tres consolas separadas cada una con su propia clave, facturación, límites de velocidad y rotación, contra un solo cliente donde cambiar de proveedor es cambiar una cadena de modelo

El flujo de Consola anterior es la respuesta correcta cuando Claude es el único modelo que llamas.

Deja de ser la respuesta correcta en el momento en que tu producto llama dos proveedores. Entonces estás manteniendo una cuenta de Anthropic, una cuenta de OpenAI y un proyecto de Google Cloud, tres relaciones de facturación, tres conjuntos de límites de velocidad y tres cronogramas de rotación de claves, para ejecutar una sola característica. Añadir un cuarto modelo significa un cuarto de todo.

Un gateway colapsa eso. reAPI expone Claude a través de un endpoint /v1/chat/completions compatible con OpenAI, así que el mismo cliente y la misma clave alcanzan Claude, GPT y Gemini, y cambiar entre ellos es un cambio de cadena de modelo:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Summarize this changelog."}],
    max_tokens=16000,
)

La superficie nativa de Anthropic /v1/messages también está disponible, así que un SDK ya escrito contra el formato de Anthropic funciona después de cambiar la URL base.

Las tarifas están en reapi.ai/models, y la referencia actual de Opus está en reapi.ai/docs/claude-opus-5.

Una cosa que tienes que hacer bien en reAPI

Hay dos credenciales separadas, y confundirlas es el fallo de primera llamada más común.

Clave	Dónde la creas	A qué llama
Clave de gateway	consola `api.reapi.ai`	Modelos de chat: Claude, GPT, Gemini
Clave de medios	cuenta `reapi.ai`	Generación de imágenes y vídeos

Una clave de gateway enviada a un endpoint de medios falla, y lo contrario también falla. Si una primera llamada devuelve un error de autenticación y la clave parece correcta, verifica cuál de las dos tienes.

FAQ

¿Dónde obtengo una clave de API de Claude?

En la Consola en platform.claude.com, bajo Account Settings en platform.claude.com/settings/keys^[1].

¿Puedo probar la API sin escribir código?

Sí. El Workbench en platform.claude.com/playground ejecuta solicitudes en el navegador^[1].

¿Cómo autentico una solicitud?

Envía tu clave en el header x-api-key, o usa Authorization. Envía uno, no ambos^[1].

¿Qué variable de ambiente leen los SDKs?

ANTHROPIC_API_KEY^[2].

¿Puedo cambiar la expiración de una clave más tarde?

La expiración se elige cuando se crea la clave^[1]. Cambiarla significa crear una nueva clave y rotar.

¿Cómo evito que un proyecto gaste todo el presupuesto?

Usa espacios de trabajo, que segmentan las claves y controlan el gasto por caso de uso^[1].

¿Necesito una clave de Anthropic para usar Claude a través de un gateway?

No. Una clave de gateway reemplaza la cuenta por proveedor cuando estás llamando varios modelos, y el endpoint es compatible con OpenAI.

¿Por qué mi clave de reAPI devuelve un error de autenticación?

Lo más probable es que estés usando la clave de gateway en un endpoint de medios o la clave de medios en el gateway. Son credenciales separadas creadas en lugares separados.

Decidir antes de crear

La parte mecánica de cómo obtener una clave de API de Claude son cuatro clics en la Consola. La parte que vale la pena pensar es las dos configuraciones adjuntas a ella, expiración y espacio de trabajo, porque ambas se eligen una sola vez y ninguna se puede cambiar después sin rotar la clave.

Y la pregunta debajo de todo es cuántos proveedores tu producto terminará llamando. Un proveedor, una clave, y el flujo de Consola es exactamente correcto. Tres proveedores y la aritmética cambia: tres cuentas, tres facturas, tres regímenes de límite de velocidad, y un cuarto modelo significa comenzar de nuevo. Ese es el punto donde una sola clave de gateway deja de ser una conveniencia y comienza a ser la arquitectura más simple.

References

Anthropic. API overview — Console, Workbench, key creation, expiration, workspaces, and authentication headers. Retrieved July 2026 from docs.claude.com/en/api/overview
Anthropic. Get started — setting the API key and first request. Retrieved July 2026 from docs.claude.com/en/docs/get-started