Guia Técnico · Anthropic API

Como Usar a API do ClaudeGuia Completo 2026

Do primeiro request até produção: autenticação, escolha de modelo, streaming, controle de custos e boas práticas para integrar o Claude em Python, Node.js ou qualquer REST client.

Modelos Disponíveis

Todos os modelos compartilham a mesma API — só mude o parâmetro model.

ModeloMelhor paraInput /1MOutput /1MContexto
Claude Opus 4Tarefas complexas, análise profunda, código difícil$15$75200K
Claude Sonnet 4.5Uso geral, produção, equilíbrio custo/qualidade$3$15200K
Claude Haiku 4.5Volume alto, tarefas simples, chatbots$0.80$4200K

Preços em USD por 1M tokens. BRL = USD × 5,70 + IOF 5,38%.

Primeiros Passos

1. Obter a chave de API

Acesse console.anthropic.com, crie uma conta, adicione créditos de pagamento e gere uma API key em “API Keys”. Guarde a chave — ela não é exibida novamente.

2. Instalar o SDK

Python

pip install anthropic

Node.js / TypeScript

npm install @anthropic-ai/sdk

3. Configurar variável de ambiente

export ANTHROPIC_API_KEY=“sk-ant-...”

Ou adicione ao .env e use python-dotenv / dotenv.

Exemplos de Código

Primeiro request (Python)python
import anthropic

client = anthropic.Anthropic(api_key="sua-chave-aqui")

message = client.messages.create(
    model="claude-sonnet-4-5-20251001",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explique o que é RAG em 3 parágrafos."}
    ]
)

print(message.content[0].text)
Streaming de resposta (Node.js)typescript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

const stream = client.messages.stream({
  model: "claude-sonnet-4-5-20251001",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Liste 5 frameworks de IA." }],
});

for await (const chunk of stream) {
  if (chunk.type === "content_block_delta") {
    process.stdout.write(chunk.delta.text);
  }
}
Sistema de prompt com contextopython
message = client.messages.create(
    model="claude-sonnet-4-5-20251001",
    max_tokens=2048,
    system="Você é um assistente especializado em análise financeira. "
           "Responda sempre em português brasileiro. "
           "Seja objetivo e cite fontes quando relevante.",
    messages=[
        {"role": "user", "content": "Quais são os riscos de investir em LLMs em 2026?"}
    ]
)
REST direto (curl)bash
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20251001",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Olá!"}]
  }'

Estimativa de Custos

Valores estimados. Custo real varia conforme tamanho dos prompts. BRL = USD × 5,70 + IOF.

Chatbot com 1.000 usuários/dia

500 tokens input · 300 tokens output · Sonnet 4.5

~R$ 92/mês

~US$ 0.54/dia

Extração de dados (10k docs/mês)

2,000 tokens input · 500 tokens output · Haiku 4.5

~R$ 3,4/mês

~US$ 0.02/dia

Análise jurídica (100 docs/dia)

8,000 tokens input · 2,000 tokens output · Opus 4

~R$ 2.308/mês

~US$ 13.50/dia

Para cálculo preciso: ranking de custo-benefício ou o comparativo de preços de API.

Boas Práticas para Produção

Nunca hardcode a chave de API

Use variáveis de ambiente (`ANTHROPIC_API_KEY`). Jamais comite a chave no repositório — use `.env` + `.gitignore`.

Defina sempre max_tokens

Sem limite definido, respostas podem ser truncadas de forma imprevisível. Calcule o máximo necessário para sua tarefa e defina com margem de 20%.

Use system prompt para contexto fixo

Persona, idioma, formato de resposta e restrições devem ir no `system`, não no `user`. Isso reduz tokens e melhora a consistência.

Implemente retry com exponential backoff

A API retorna 429 (rate limit) em pico de carga. O SDK oficial já inclui retry automático — use-o em vez de implementar o seu.

⚠️

Evite contextos desnecessariamente longos

Tokens de contexto são cobrados. Mantenha apenas as mensagens relevantes para a tarefa atual. Para histórico longo, use sumarização.

⚠️

Não use Opus para tarefas simples

Claude Opus custa 10× mais que Haiku. Para extração de dados estruturados, classificação e perguntas simples, Haiku é suficiente e muito mais econômico.

Perguntas Frequentes

Como obter uma chave de API do Claude?

Acesse console.anthropic.com, crie uma conta, adicione créditos de pagamento e gere uma API key em "API Keys". O processo leva menos de 5 minutos.

A API do Claude funciona em português?

Sim, nativamente. Claude Sonnet e Opus têm excelente desempenho em português brasileiro — textos naturais, sem erros gramaticais grosseiros e com entendimento de contexto cultural.

Qual modelo do Claude devo usar para produção?

Claude Sonnet 4.5 é o padrão para a maioria das aplicações de produção: boa qualidade, velocidade adequada e custo controlável. Use Haiku para volume alto, Opus para tarefas que exigem raciocínio profundo.

Existe limite de rate na API do Claude?

Sim. No tier inicial: 50 requests/minuto, 40.000 tokens/minuto. O limite aumenta conforme o gasto histórico. O SDK oficial faz retry automático em caso de 429.

Posso usar a API do Claude no Brasil?

Sim. A API funciona globalmente sem restrição geográfica. O pagamento é em dólar via cartão de crédito internacional. IOF de 5,38% é cobrado pelo banco.

Continue lendo