API de Anthropic (Claude): cómo obtener tu API key y empezar

Publicado el 3 de junio de 2026 · Actualizado el 10 de noviembre de 2026 · 15 min de lectura · Por el equipo de Master en Claude · Blog MasterEnClaude

La API de Claude de Anthropic te permite integrar el modelo en tus propias aplicaciones, scripts y flujos de trabajo automatizados. Si ya usas Claude a través de la interfaz web pero quieres ir más allá, esta guía te llevará desde cero hasta tener tu primera integración funcionando en Python, con ejemplos reales y sin dar nada por supuesto.

Paso 1: entrar en la consola de Anthropic y crear tu API key

La consola de Anthropic (Claude Console) está en platform.claude.com. La dirección antigua, console.anthropic.com, sigue valiendo: redirige ahí. Desde la consola gestionas tus claves, los límites de uso y el gasto. Crear la cuenta es gratuito; pagas solo por los tokens que consumes (entrada y salida), sin cuota mensual fija.

1. Inicia sesión en la consola, o crea una cuenta si aún no la tienes.
2. Abre Settings → API keys.
3. Pulsa Create key, ponle un nombre que reconozcas (por ejemplo, «pruebas-portátil») y elige su caducidad.
4. Copia la clave y guárdala en un sitio seguro: la consola la enseña entera una sola vez. Si la pierdes, no se recupera; se crea otra.

Ojo con una confusión muy frecuente: la suscripción de claude.ai (planes Pro, Max o Team) y la API son dos cosas distintas y se facturan por separado. Aun así, según el centro de ayuda de Anthropic, los planes Max y Team incluyen créditos mensuales para la API; el plan Pro no.

Por seguridad, nunca escribas la clave directamente en el código fuente ni la subas a un repositorio; usa una variable de entorno:

# En tu terminal (o en tu fichero .env)
export ANTHROPIC_API_KEY="sk-ant-api03-XXXXXXXXXX"

Paso 2: instalar el SDK de Python

Anthropic mantiene un SDK oficial para Python (y otro para TypeScript/JavaScript). Para Python:

# Crea un entorno virtual primero (recomendado)
python -m venv venv
source venv/bin/activate   # En Windows: venv\Scripts\activate

# Instala el SDK
pip install anthropic

El SDK requiere Python 3.10 o superior (comprobado en la versión 1.11 del paquete, octubre de 2026). Es compatible con el ecosistema estándar de Python y no tiene dependencias pesadas.

Paso 3: tu primera llamada a la Messages API

La API principal de Claude se llama Messages API. Cada petición tiene como mínimo tres campos: el modelo a usar, el número máximo de tokens de respuesta y el array de mensajes de la conversación.

import anthropic

# El SDK coge la API key de la variable de entorno ANTHROPIC_API_KEY
cliente = anthropic.Anthropic()

mensaje = cliente.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Explícame qué es la API de Claude en dos párrafos, en español."
        }
    ]
)

# El texto de la respuesta está en el primer bloque de contenido
print(mensaje.content[0].text)

Si todo está bien configurado, deberías ver la respuesta de Claude en la terminal en pocos segundos. Así de sencillo es el flujo básico.

Los modelos disponibles: Haiku, Sonnet, Opus y Fable

A 10 de noviembre de 2026, la gama actual de Anthropic tiene cuatro modelos, con distinto equilibrio entre velocidad, capacidad y coste:

Para empezar, claude-sonnet-5-5 es una buena elección en la mayoría de casos: mucha capacidad a un coste contenido. Los identificadores cambian con cada generación; la lista vigente está siempre en la documentación oficial de modelos.

Paso 4: conversaciones multi-turno

La Messages API es stateless: no guarda historial entre peticiones. Para implementar una conversación, tienes que enviar el historial completo en cada llamada:

import anthropic

cliente = anthropic.Anthropic()

# Historial de la conversación (lo gestionas tú)
historial = []

def chat(mensaje_usuario: str) -> str:
    historial.append({"role": "user", "content": mensaje_usuario})

    respuesta = cliente.messages.create(
        model="claude-sonnet-5-5",
        max_tokens=2048,
        system="Eres un asistente experto en Python. Respondes siempre en español.",
        messages=historial
    )

    texto = respuesta.content[0].text
    historial.append({"role": "assistant", "content": texto})
    return texto

# Ejemplo de conversación
print(chat("¿Qué es un decorador en Python?"))
print(chat("¿Puedes mostrarme un ejemplo práctico?"))

Fíjate en el parámetro system: es el system prompt, las instrucciones que Claude recibirá antes del primer mensaje del usuario. Es donde defines el comportamiento, el tono y las restricciones de tu asistente.

Paso 5: tool use (llamadas a función)

Una de las capacidades más potentes de la API es el tool use, que permite a Claude decidir cuándo llamar a funciones externas. Defines las tools con un schema JSON y Claude devuelve una respuesta estructurada cuando quiere invocar alguna:

import anthropic, json

cliente = anthropic.Anthropic()

# Definimos una tool para consultar el tiempo
tools = [
    {
        "name": "obtener_tiempo",
        "description": "Devuelve el tiempo actual de una ciudad española",
        "input_schema": {
            "type": "object",
            "properties": {
                "ciudad": {
                    "type": "string",
                    "description": "Nombre de la ciudad (ej: Madrid, Barcelona)"
                }
            },
            "required": ["ciudad"]
        }
    }
]

respuesta = cliente.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    tools=tools,
    messages=[{"role": "user", "content": "¿Qué tiempo hace en Sevilla?"}]
)

# Si Claude quiere usar la tool:
if respuesta.stop_reason == "tool_use":
    for bloque in respuesta.content:
        if bloque.type == "tool_use":
            print(f"Claude quiere llamar a: {bloque.name}")
            print(f"Con parámetros: {json.dumps(bloque.input, ensure_ascii=False)}")

¿Quieres ir más allá? Construye tu primer agente con herramientas paso a paso: Tool use en la API de Claude con Python →

Streaming: respuestas en tiempo real

Para mostrar la respuesta de forma progresiva (como en claude.ai), usa el método stream:

import anthropic

cliente = anthropic.Anthropic()

with cliente.messages.stream(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Escribe un poema corto sobre el mar."}]
) as stream:
    for fragmento in stream.text_stream:
        print(fragmento, end="", flush=True)
print()  # Salto de línea al terminar

Gestión de costes y límites de uso

La API de Claude cobra por tokens de entrada y de salida, con un precio por millón de tokens distinto para cada modelo (los precios vigentes están en la página de precios de Anthropic). Para controlar el gasto:

• Configura un límite de gasto mensual en la consola.
• Usa max_tokens siempre para evitar respuestas innecesariamente largas.
• Usa Haiku para tareas de alto volumen y reserva Sonnet, Opus o Fable para las complejas.
• Activa prompt caching si envías el mismo system prompt en muchas peticiones: las lecturas de caché cuestan una fracción del precio normal de entrada.

Precios detallados y ejemplos de coste →

Si quieres profundizar en los aspectos más avanzados de la API (visión, documentos, prompt caching, batch API), te recomendamos empezar por nuestra guía gratuita de Claude y seguir con el curso de Claude en español, ya abierto, donde tratamos todos estos temas con proyectos prácticos.

Errores comunes al empezar

• AuthenticationError: la API key no está bien configurada. Comprueba la variable de entorno con echo $ANTHROPIC_API_KEY.
• OverloadedError: los servidores de Anthropic están bajo carga alta. Implementa retry con backoff exponencial.
• max_tokens demasiado bajo: la respuesta se corta. Aumenta el valor o implementa streaming.
• Context window excedido: el historial de conversación es demasiado largo. Usa estrategias de resumen o ventana deslizante.

Para conectar la API con herramientas externas de forma estandarizada, lee también nuestro artículo sobre ¿Qué es MCP (Model Context Protocol)?. Y si quieres usar Claude directamente como agente de programación en tu terminal, consulta Qué es Claude Code.

Preguntas frecuentes sobre la API de Anthropic