Anthropic Claude API - del primer token al uso de herramientas

1. Clave

Abre console.anthropic.com -> Settings -> API Keys -> Create Key. Agrega crédito prepago (mínimo US$5).

2. Primera llamada

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
const res = await client.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Refactoriza este código..." }],
});
console.log(res.content[0].type === "text" && res.content[0].text);

3. Tool use (function calling)

const res = await client.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  tools: [{
    name: "get_weather",
    description: "Devuelve el clima actual",
    input_schema: { type: "object", properties: { city: { type: "string" } }, required: ["city"] },
  }],
  messages: [{ role: "user", content: "Cómo está el clima en Madrid?" }],
});

4. Caché de prompts

Marca bloques grandes (prompt de sistema, documentación) con `cache_control: { type: "ephemeral" }`. Las solicitudes siguientes durante unos 5 min pagan cerca del 10% del precio de entrada.

Buenas prácticas

• •Usa etiquetas XML en el prompt (Claude está entrenado para ese patrón)
• •Sonnet 4.5 para código, Haiku 4 para clasificación barata
• •Activa extended thinking solo cuando el problema realmente exige razonamiento