Primera llamada a la API de Claude con TypeScript

Contenido del curso

OpenAI API

Claude API

Gemini API y Despliegue con Vercel

Vercel AI SDK

ElevenLabs API

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0011:25

Primera llamada a la API de Claude con TypeScript

Curso de Configuración de APIs de LLMs

Clase 8 de 18

Clase 8 / 18

Recursos

Conectar un modelo de inteligencia artificial desde código es el paso que separa la teoría de la práctica real. Aquí se detalla cómo realizar la primera llamada a la API de Anthropic usando TypeScript, qué estructura devuelve la respuesta, cómo extraer únicamente el texto útil y las diferencias prácticas frente a lo que ofrece OpenAI.

¿Qué necesitas para configurar tu proyecto con la API de Anthropic?

Antes de escribir una sola línea de código, hay tres pasos esenciales que la propia documentación de Anthropic establece [0:22]:

Establecer la clave de la API: copia el comando que aparece en la documentación, sustituye el valor por la API key que generaste previamente y ejecútalo en tu terminal. No recibirás ninguna confirmación visual, pero sabrás que funciona cuando obtengas tu primera respuesta.
Inicializar un proyecto de JavaScript/TypeScript: todo proyecto basado en JavaScript requiere un archivo package.json. La documentación trabaja con TypeScript, así que la extensión de los archivos será .ts.
Instalar el SDK de Anthropic: con un simple comando de NPM se agrega la dependencia oficial que permite interactuar con la API.

bash npm install @anthropic-ai/sdk

Con estas tres piezas listas, ya puedes crear tu archivo principal. La documentación sugiere llamarlo quickstart.ts [1:17].

¿Cómo se estructura el primer llamado a la API de Claude?

El snippet que Anthropic ofrece tiene similitudes claras con el de OpenAI, pero también diferencias que vale la pena notar [1:25]. La estructura básica sigue este patrón:

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

const client = new Anthropic();

async function main() { const message = await client.messages.create({ model: "claude-opus-4-0", max_tokens: 1024, messages: [ { role: "user", content: "¿Cuál es la capital de Colombia?" } ] }); console.log(message); }

main();

Tres parámetros definen esta llamada:

model: indica qué modelo utilizar. En el ejemplo se emplea Claude Opus 4.6, el más avanzado de Anthropic [1:52].
max_tokens: establece el límite máximo de tokens que el modelo puede generar en su respuesta. En el ejemplo se fijan 1024 tokens [1:58].
messages: un array que contiene los mensajes de la conversación. A diferencia de OpenAI, donde se pide un input, aquí se trabaja con un arreglo de mensajes [2:10].

Otra diferencia notable es la forma de instanciar el cliente. OpenAI utiliza su propio constructor, mientras que Anthropic requiere crear una instancia con new Anthropic() importada desde el SDK [1:32].

¿Qué devuelve la respuesta del modelo?

Al ejecutar el archivo, la API devuelve un objeto completo con metadatos valiosos [3:00]:

Identificador único de la llamada.
Modelo utilizado.
Rol del que responde (asistente).
Content: un array donde cada elemento tiene un type y un text. El texto es la respuesta real del modelo.
Estadísticas de uso: tokens de entrada (16 en el ejemplo) y tokens de salida (84). Estos números son fundamentales porque el costo de la API se calcula por millón de tokens según las tablas de precios [3:40].

¿Cómo extraer solo el texto de la respuesta?

Mostrar toda la estructura es útil para depuración, pero en producción necesitas únicamente el texto. Para eso se accede al primer elemento del array content y se valida su tipo [4:16]:

typescript const block = message.content[0]; if (block.type === "text") { console.log(block.text); }

Este patrón filtra el bloque, confirma que sea de tipo texto y extrae directamente la cadena con la respuesta.

¿Qué diferencia hay entre ejecutar con Bun y con Node?

Aquí aparece una diferencia práctica importante [4:50]. Bun JS detecta automáticamente las variables de entorno definidas en archivos locales como .env, lo que simplifica la ejecución:

bash bun index.ts

Con Node JS, la situación cambia. Al intentar node index.ts se produce un error de módulo. La documentación recomienda usar npx tsx index.ts [5:20]. Pero incluso con ese comando, si no se ha exportado la variable de entorno en la terminal, la API devuelve un error de autenticación [5:42].

Para solucionarlo hay que ejecutar manualmente el export:

bash export ANTHROPIC_API_KEY="tu-api-key"

Tras ese paso, al relanzar npx tsx index.ts la respuesta llega correctamente [6:18]. Esta diferencia evidencia por qué Bun resulta más ágil para prototipos rápidos: menos configuración, ejecución directa de TypeScript y detección automática de variables de entorno.

Con la primera conexión funcionando, el siguiente paso natural es aprender a estructurar llamados que permitan conversaciones con memoria de contexto, utilizando un endpoint diferente de Anthropic. Si ya trabajaste con OpenAI y ahora con Claude, cuéntanos cuál te parece más interesante o qué otro modelo te gustaría explorar.

Gabriel Obregón

Hace 7 meses

🧠 USO DE CLAUDE (ANTHROPIC) CON TYPESCRIPT

⚙️ CONFIGURACIÓN INICIAL

Antes de programar, debes completar 3 pasos clave:

🔑 1. Configurar la API key

• Ejecutar un comando en la terminal con tu clave

• No hay confirmación visual

• Sabes que funciona cuando recibes la primera respuesta

📦 2. Inicializar el proyecto

• Crear el archivo package.json

• Usar TypeScript (archivos .ts)

📥 3. Instalar el SDK oficial

• Ejecutar:

npm install @anthropic-ai/sdk

📄 4. Crear archivo principal

• Se recomienda llamar al archivo quickstart.ts

📡 PRIMER LLAMADO A LA API

El uso es similar a OpenAI, pero con diferencias importantes

🧩 Importar y configurar cliente

• Importar el SDK:

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

• Crear instancia del cliente:

const client = new Anthropic();

📤 Ejemplo de llamada

const message = await client.messages.create({

model: "claude-opus-4-0",

max_tokens: 1024,

messages: [

{ role: "user", content: "¿Cuál es la capital de Colombia?" }

]

});

🔑 PARÁMETROS CLAVE

🤖 model

• Define el modelo a usar

• Ejemplo: Claude Opus 4 (uno de los más potentes)

📏 max_tokens

• Límite máximo de tokens en la respuesta

• Ejemplo: 1024

💬 messages

• Lista (array) de mensajes

• Simula una conversación

• Diferencia clave:

• Claude usa messages

• OpenAI usa input

OpenAI API

Construye tu propio ChatGPT

Cómo funciona la API de OpenAI

Conexión con la API de OpenAI

Cómo mantener contexto en conversaciones con OpenAI

Conectar OpenAI con Next.js paso a paso

Cómo integrar audio e imágenes en un chatbot

Claude API

Configuración de API keys en Anthropic

Primera llamada a la API de Claude con TypeScript

Streaming y mensajes múltiples en Anthropic

Integración de OpenAI y Anthropic en un solo chat

Gemini API y Despliegue con Vercel

Cómo generar tu API key de Google Gemini

Despliegue de Next.js con Vercel en 3 pasos

Vercel AI SDK

AI SDK: un solo código para todos los LLMs

Configurar el AI SDK de Vercel en TypeScript

AI SDK de Vercel: tres proveedores, un solo código

ElevenLabs API

Eleven Labs: text to speech con IA

Tu primera conversión de texto a voz con Eleven Labs

IA generativa: qué sigue después del curso

Primera llamada a la API de Claude con TypeScript

Progreso del curso

OpenAI API

Claude API

Gemini API y Despliegue con Vercel

Vercel AI SDK

ElevenLabs API

Recursos

Recursos