Tu primera llamada a la API

🟢Principiante

✅

Última verificación: 2026-06-20.

La forma de la API que se muestra a continuación es estable, pero los IDs de modelo y las versiones del SDK cambian. Consulta la tabla de modelos actual.

Confirma con la fuente oficial.

La API permite que tu programa hable con Claude. Tres pasos: consigue una clave, instala el SDK y envía un mensaje.

1. Consigue una clave de API

Crea una en la Consola de Anthropic. Después, configúrala como variable de entorno para que nunca quede en tu código:

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

:::warning Nunca subas tu clave al control de versiones Mantén las claves en variables de entorno o en un gestor de secretos, nunca en el control de versiones. Consulta Seguridad. :::

2. Instala el SDK

Python

pip install anthropic

TypeScript

npm install @anthropic-ai/sdk

cURL

No hay nada que instalar: solo necesitas curl.

3. Haz la llamada

Cada solicitud es una lista de messages. El modelo responde con content.

Python

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

TypeScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

console.log(message.content[0].text);

cURL

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

Qué acaba de pasar

• model — qué Claude usar. No lo codifiques a ciegas; consulta Elegir un modelo.
• max_tokens — un tope para la longitud de la respuesta (en tokens). No define la ventana de contexto.
• messages — la conversación hasta el momento. La API es sin estado: para continuar un chat, vuelve a enviar todo el historial cada vez.
• system (opcional) — una instrucción de nivel superior que establece el rol de Claude para la llamada.

Siguiente

• Elige el modelo adecuado y estima el coste → Elegir un modelo · Tokens y precios
• Transmite respuestas en streaming y mantén una conversación → Streaming y multiturno
• Deja que Claude llame a tus funciones → Uso de herramientas
• Fragmentos listos para producción → Fragmentos de la API