Primeros pasos con la API de Claude

Revisada el 2026-10-09 · vigente hasta 2027-01-07

Para llamar a Claude desde tu código necesitas una cuenta en la Console, una clave de API en una variable de entorno y el SDK oficial.¹

Con eso, la primera llamada son diez líneas de Python.

La API de pago por uso es independiente de las suscripciones del chat. Se factura por tokens, así que conviene elegir bien el modelo y fijar un límite de salida.

Requisitos

• Una cuenta en la Claude Console (plataforma de desarrolladores).¹
• Una clave de API creada en esa cuenta.¹
• Python 3 y pip.

Pasos

1. Crea la cuenta en la Console y genera una clave de API.¹
2. Guarda la clave en la variable de entorno ANTHROPIC_API_KEY. El SDK la lee solo, así que no hace falta pasarla en el código.¹ Nunca la pegues en un archivo del proyecto ni en un repositorio. Si la necesitas en un proyecto, ponla en un .env fuera de git.
3. Crea una carpeta con un entorno virtual e instala el SDK: pip install anthropic.¹
4. Escribe la primera llamada:

import anthropic
 
client = anthropic.Anthropic()
 
message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Explícame qué es un token en dos frases."}],
)
 
for block in message.content:
    if block.type == "text":
        print(block.text)

5. Ejecuta el archivo. La respuesta llega como una lista de bloques de contenido; por eso se recorre y se imprime solo el texto.¹
6. Mira el campo usage de la respuesta: indica los tokens de entrada y de salida de esa llamada, que es lo que se factura.¹

El ejemplo de la documentación usa claude-opus-5-5; aquí va Sonnet 5.5, más barato (ver la tabla de abajo), para hacer pruebas.

Elegir modelo y coste

Modelos actuales y precio base por millón de tokens (MTok), de entrada y de salida:²³

Modelo	ID de API	Para qué	Entrada / salida
Fable 5.1	claude-fable-5-1	Razonamiento exigente y trabajo agéntico largo	10 $/50$
Opus 5.5	claude-opus-5-5	Programación agéntica larga y trabajo de conocimiento	4 $/20$
Sonnet 5.5	claude-sonnet-5-5	Mejor equilibrio entre velocidad e inteligencia	2 $/10$
Haiku 5.5	claude-haiku-5-5	Tareas rápidas y de gran volumen (clasificar, extraer, enrutar)	desde 0,10 $/0,50$

• Los cuatro tienen una ventana de contexto de 1M de tokens y hasta 128K tokens de salida.²
• Si dudas, la documentación recomienda empezar por Opus 5.5 y subir a Fable 5.1 si tus pruebas siguen sin alcanzar.²
• La API por lotes (Batch) cuesta la mitad, y leer de la caché de prompts cuesta una fracción del precio de entrada.²
• Los precios son en dólares y cambian: la tabla vigente está en la página de precios.³ Para elegir según la tarea, mira mejor modelo para cada tarea.

Errores frecuentes

• Subir la clave a un repositorio público. Si pasa, revócala en la Console y crea otra.
• Olvidar max_tokens: es obligatorio y limita el coste de la salida.¹
• Usar el modelo más caro para tareas simples.
• Confundir la suscripción del chat con la API: se pagan por separado.

Cómo lo uso

• proposal-generator-app, un proyecto en incubación, llama a la API con el SDK oficial de TypeScript (@anthropic-ai/sdk). La clave va en ANTHROPIC_API_KEY, dentro de un .env.local que su .gitignore deja fuera de git.
• El mismo proyecto usa Supabase y tiene su keepalive: ver Supabase sin pausas.
• A mi entender, el patrón de esta receta (clave en el entorno, nunca en el código) es el que hay que copiar en cualquier proyecto nuevo.

Véase también

• Tokens
• Superficies de Claude

Referencias

Footnotes

1. Get started with Claude. Anthropic. Consultado el 2026-10-09. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹

2. Models overview. Anthropic. Consultado el 2026-10-09. ↩ ↩² ↩³ ↩⁴

3. Pricing. Anthropic. Consultado el 2026-10-09. ↩ ↩²