Cómo conseguir una API key de Claude paso a paso

Las API keys no se generan en claude.ai (la app de chat), sino en la Claude Console, el panel para developers de Anthropic. Entra en console.anthropic.com desde el navegador y regístrate con tu email o con tu cuenta de Google. Recibirás un enlace de verificación. Ábrelo desde el mismo navegador para que la sesión quede iniciada. Durante el alta te pedirá datos básicos: nombre, nombre de la organización (si trabajas por tu cuenta, pon tu nombre o el de tu proyecto) y para qué vas a usar la API. Nada de esto es vinculante; puedes cambiarlo después. Al terminar llegarás al panel principal, donde verás accesos a la documentación, al entorno de pruebas (Workbench) y a la configuración de la cuenta. Si ya usas Claude Pro o Max en claude.ai, puedes usar el mismo email, pero ten claro que son productos separados con facturación separada.

La API funciona con crédito prepago: cargas saldo y cada llamada lo va descontando según los tokens consumidos. Sin saldo, tu clave existirá pero las peticiones fallarán. En la Console, busca la sección de facturación (Billing o Plans & Billing en la configuración de la cuenta). Añade tu tarjeta y compra crédito; con 5-10 USD tienes de sobra para aprender y prototipar. Los precios están en dólares, así que tu banco aplicará el cambio de divisa. Si facturas como empresa en España, introduce tu NIF-IVA para que la factura salga correcta a efectos de IVA intracomunitario; en LATAM revisa si tu tarjeta tiene habilitadas las compras internacionales, porque es la causa más común de rechazo. En esa misma zona de facturación encontrarás opciones para recargar automáticamente y para fijar límites de gasto mensuales. Actívalos ahora, antes de escribir una sola línea de código.

Ve a la sección de API keys de la Console (suele estar en la configuración de la cuenta o accesible desde el menú lateral). Pulsa el botón para crear una clave nueva, ponle un nombre descriptivo, por ejemplo 'portatil-pruebas' o 'proyecto-chatbot-dev', y selecciona el workspace (si solo tienes el predeterminado, déjalo). Al confirmar, verás la clave completa: empieza por sk-ant- seguido de una cadena larga. Cópiala en ese momento y pégala en un gestor de contraseñas (1Password, Bitwarden o el llavero de tu sistema). La Console solo te la muestra completa una vez; después únicamente verás los últimos caracteres para identificarla. Usar una clave por proyecto o por entorno te permite revocar una sin romper las demás y ver qué está consumiendo saldo.

Nunca pegues la clave directamente en tu código: acabará en GitHub antes de lo que crees. Lo estándar es guardarla en la variable de entorno ANTHROPIC_API_KEY, que es la que el SDK oficial lee automáticamente. En macOS y Linux añádela a tu fichero de configuración del shell (~/.zshrc en macOS moderno, ~/.bashrc en la mayoría de distribuciones Linux) y recárgalo. En Windows usa PowerShell con setx, que la guarda de forma permanente para tu usuario; después cierra y vuelve a abrir la terminal para que la nueva sesión la recoja. El último comando de cada bloque comprueba que la variable existe mostrando solo sus primeros caracteres, para que no quede la clave entera en el historial de la pantalla. Sustituye sk-ant-TU_CLAVE_AQUI por tu clave real.

# macOS / Linux (zsh). Si usas bash, cambia ~/.zshrc por ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-ant-TU_CLAVE_AQUI"' >> ~/.zshrc
source ~/.zshrc
echo ${ANTHROPIC_API_KEY:0:10}

# Windows (PowerShell). Después cierra y abre una terminal nueva
setx ANTHROPIC_API_KEY "sk-ant-TU_CLAVE_AQUI"
$env:ANTHROPIC_API_KEY.Substring(0,10)

Antes de instalar nada, verifica que la clave y el saldo funcionan con una petición directa a la Messages API. Este comando envía un mensaje al modelo claude-opus-5-5 usando la variable de entorno del paso anterior. Si todo va bien, recibirás un JSON con un campo content que contiene la respuesta de Claude en texto. Si recibes un error, el mensaje te dice exactamente qué pasa: un 401 (authentication_error) significa que la clave es incorrecta o no se está leyendo; un 400 que mencione crédito o saldo indica que tienes que cargar dinero (paso 2); un 429 es que has superado el límite de peticiones, así que espera unos segundos. La cabecera anthropic-version es obligatoria; sin ella la API rechaza la petición. En Windows ejecuta este comando en Git Bash o WSL, porque las comillas en PowerShell se comportan distinto.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "Hola Claude, confirma en una frase que mi API key funciona."}
    ]
  }'

Ahora que sabes que la clave funciona, usa el SDK oficial, que es como trabajarás en proyectos reales. Instálalo con pip y crea un fichero prueba_claude.py con el código de abajo. Fíjate en que no pasamos la clave en ningún sitio: el cliente la lee sola de ANTHROPIC_API_KEY. Ejecútalo con python prueba_claude.py y deberías ver la respuesta impresa en la terminal. Si te aparece un error del tipo 'Could not resolve authentication method', es que la terminal donde ejecutas no ve la variable: abre una nueva o revisa el paso 4. Te recomiendo crear un entorno virtual para cada proyecto y así no mezclar versiones de librerías. A partir de aquí ya tienes la base para construir lo que quieras: chatbots, resúmenes de documentos, clasificación de emails o automatizaciones para tu negocio.

# En la terminal:
# python -m venv .venv && source .venv/bin/activate   (Windows: .venv\Scripts\activate)
# pip install anthropic

import anthropic

client = anthropic.Anthropic()  # lee ANTHROPIC_API_KEY automáticamente

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=300,
    messages=[
        {"role": "user", "content": "Dame 3 ideas de apps sencillas que pueda construir con la API de Claude."}
    ],
)

print(message.content[0].text)
print(f"Tokens usados: {message.usage.input_tokens} entrada / {message.usage.output_tokens} salida")