Sua Primeira Chamada à API

🟢Iniciante

✅

Última verificação: 2026-06-20.

O formato da API abaixo é estável, mas os IDs de modelo e as versões do SDK mudam. Veja a tabela de modelos atuais.

Confirme na fonte oficial.

A API permite que o seu programa converse com o Claude. Três passos: obtenha uma chave, instale o SDK, envie uma mensagem.

1. Obtenha uma chave de API

Crie uma no Anthropic Console. Depois, defina-a como uma variável de ambiente para que ela nunca fique no seu código:

export ANTHROPIC_API_KEY="sk-ant-..."

:::warning Nunca faça commit da sua chave Mantenha as chaves em variáveis de ambiente ou em um gerenciador de segredos — nunca no controle de versão. Veja Segurança. :::

2. Instale o SDK

Python

pip install anthropic

TypeScript

npm install @anthropic-ai/sdk

cURL

Nada para instalar — você só precisa do curl.

3. Faça a chamada

Toda requisição é uma lista de messages. O modelo responde com content.

Python

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

TypeScript

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

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "In one sentence, what is an API?" },
  ],
});

console.log(message.content[0].text);

cURL

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

O que acabou de acontecer

• model — qual Claude usar. Não codifique de forma fixa às cegas; veja Escolhendo um Modelo.
• max_tokens — um limite para o tamanho da resposta (em tokens). Ele não define a janela de contexto.
• messages — a conversa até o momento. A API é stateless: para continuar um chat, reenvie todo o histórico a cada vez.
• system (opcional) — uma instrução de nível superior que define o papel do Claude para a chamada.

Próximo

• Escolha o modelo certo e estime o custo → Escolhendo um Modelo · Tokens e Preços
• Faça streaming das respostas e mantenha uma conversa → Streaming e Multi-Turno
• Deixe o Claude chamar suas funções → Uso de Ferramentas
• Trechos prontos para produção → Trechos de API