GuíasDesarrollo de IA
Tutorial: llamar a la API de Claude desde Node.js
1. Instalar
npm install @anthropic-ai/sdk
En el archivo .env del servidor, nunca en el repositorio:
ANTHROPIC_API_KEY=sk-ant-...
CLAUDE_MODEL=identificador-del-modelo
2. Enviar un mensaje
import Anthropic from '@anthropic-ai/sdk';
const client = new Anthropic(); // lee ANTHROPIC_API_KEY
const msg = await client.messages.create({
model: process.env.CLAUDE_MODEL!,
max_tokens: 1024,
system: 'Responde en español, en tres frases como máximo.',
messages: [{ role: 'user', content: 'Explica qué es un webhook.' }],
});
const text = msg.content.find((b) => b.type === 'text');
console.log(text?.text);
console.log(msg.usage.input_tokens, msg.usage.output_tokens);
3. Los buenos hábitos
- Clave en el servidorEn una variable de entorno, nunca en el código del navegador.
- Límite de salida
max_tokensacota la longitud y, por tanto, el coste. - Registro de tokens
usageda la entrada y la salida de cada llamada. - Una sola funciónTodas las llamadas pasan por ella: cambiar de modelo se vuelve trivial.
Después: mostrar la respuesta en streaming y obtener un JSON fiable.
Preguntas frecuentes
- ¿Se puede llamar a la API desde el navegador?
- No: la clave quedaría a la vista de todos. El navegador llama a tu servidor, que llama a la API.
- ¿Qué modelo elegir?
- La documentación de Anthropic enumera los modelos y sus identificadores. Pon el identificador en una variable de entorno para cambiarlo sin tocar el código.
- ¿Qué hacer ante un error 429 o de sobrecarga?
- El SDK reintenta automáticamente unas cuantas veces. Más allá, pon la petición en cola y vuelve a intentarlo más tarde.