GuíasDesarrollo de IA

Tutorial: llamar a la API de Claude desde Node.js

Por el equipo de Banzai LabsActualizado el 2 min de lectura

index.tsPOSTClaude{ JSON }Clave en el servidorTu servidor llama a la API, nunca el navegador
Tu servidor Node.js llama a la API de Claude con una clave guardada en el servidor y recibe JSON.

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 salidamax_tokens acota la longitud y, por tanto, el coste.
  • Registro de tokensusage da 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.

Para leer después

Todas las guías