Anthropic Claude API — do primeiro token até tool use

1. Chave

console.anthropic.com → Settings → API Keys → Create Key. Adicione crédito pré-pago (mínimo US$5).

2. Primeira chamada

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: "Refatore 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: "Retorna clima atual",
    input_schema: { type: "object", properties: { city: { type: "string" } }, required: ["city"] },
  }],
  messages: [{ role: "user", content: "Como está o clima em SP?" }],
});

4. Prompt caching

Marque blocos grandes (prompt de sistema, documentação) com `cache_control: { type: "ephemeral" }`. Requisições subsequentes em até 5 min pagam cerca de 10% do preço de entrada.

Boas práticas

• •Use XML tags no prompt (Claude é treinado pra isso)
• •Sonnet 4.5 pra código, Haiku 4 pra classificação barata
• •Extended thinking só quando o problema realmente exige raciocínio