ComeçarAtualizado em 26 de setembro de 20265 min de leitura

API do Claude no Brasil: como usar o Claude Opus 5 pagando em reais

A API do Claude é o jeito de usar os modelos da Anthropic dentro do seu código, do Claude Code e das suas ferramentas de desenvolvimento. Para quem está no Brasil, o obstáculo raramente é técnico: é a cobrança em dólar, no cartão internacional, com IOF e câmbio variando todo mês.

Este guia explica o que é a API, quais são as formas de pagar daqui e como fazer a primeira chamada ao Claude Opus 5 em poucos minutos.

O que é a API do Claude

O Claude tem duas portas de entrada:

• O app (site e aplicativo), em que você conversa com o modelo numa janela de chat.
• A API, em que o seu programa envia mensagens e recebe respostas por HTTP. É ela que alimenta o Claude Code, integrações, bots, automações e produtos com IA.

Pela API, cada requisição vai para o endpoint POST /v1/messages com o nome do modelo, as mensagens e o limite de tokens da resposta. A resposta volta em JSON, com o texto e os dados de consumo.

O modelo usado neste guia é o Claude Opus 5, cujo identificador na API é claude-opus-5. Ele tem janela de contexto de 1 milhão de tokens e respostas de até 128 mil tokens.

Como pagar a API do Claude estando no Brasil

A Anthropic cobra a API em dólar. Na página oficial de preços, a forma de pagamento para contas comuns é o cartão de crédito, e todos os valores são em USD. Na prática, quem está no Brasil tem três caminhos:

A open33 está no terceiro caminho: plano mensal com valor fixo em reais, pago no Pix ou no cartão nacional, e uma API compatível com o SDK oficial da Anthropic.

A open33 é um serviço independente. Não é a Anthropic e não é afiliada a ela.

Os detalhes de custo e pagamento estão em dois guias próprios: quanto custa a API do Claude em reais e como pagar a API do Claude com Pix.

O que muda no seu código

Quase nada. A API da open33 segue o mesmo formato da API da Anthropic, então os SDKs oficiais funcionam sem adaptação. Você só troca duas coisas:

1. A URL base: https://api.open33.tech (sem /v1 no final).
2. A chave: a que aparece no seu painel da open33.

Os SDKs oficiais leem essas duas informações de variáveis de ambiente:

export ANTHROPIC_BASE_URL="https://api.open33.tech"
export ANTHROPIC_API_KEY="SUA_CHAVE"

A primeira chamada

Com as variáveis definidas, o código é o mesmo da documentação oficial.

Python (pip install anthropic):

import anthropic

client = anthropic.Anthropic()  # lê ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY

resposta = client.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    messages=[{"role": "user", "content": "Explique o que é uma API REST em 3 frases."}],
)

for bloco in resposta.content:
    if bloco.type == "text":
        print(bloco.text)

TypeScript (npm install @anthropic-ai/sdk):

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

const client = new Anthropic(); // lê ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY

const resposta = await client.messages.create({
  model: "claude-opus-5",
  max_tokens: 16000,
  messages: [{ role: "user", content: "Explique o que é uma API REST em 3 frases." }],
});

for (const bloco of resposta.content) {
  if (bloco.type === "text") console.log(bloco.text);
}

cURL:

curl https://api.open33.tech/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 16000,
    "messages": [{"role": "user", "content": "Olá, Claude!"}]
  }'

Repare que o código percorre os blocos da resposta e imprime só os de tipo text. O Claude Opus 5 pode incluir outros blocos antes do texto, como os de raciocínio, então não conte com o texto estar sempre na primeira posição.

Os tutoriais completos estão em API do Claude com Python e API do Claude com TypeScript.

Onde usar

• Claude Code: defina as duas variáveis no terminal e abra o Claude Code. O passo a passo está em Claude Code em reais.
• Seu app ou backend: use o SDK oficial da sua linguagem com a URL base da open33.
• Outras ferramentas: as que permitem configurar uma URL própria para a API da Anthropic usam os mesmos dois dados. Teste a sua ferramenta antes de levar para produção.

Recursos da API que você vai usar

• Streaming: a resposta chega aos pedaços, enquanto é gerada. Veja streaming na API do Claude.
• Tool use: o Claude chama funções do seu código. Veja tool use na API do Claude.
• Cache de prompt: partes repetidas do prompt ficam em cache e custam menos. Veja cache de prompt.
• Contexto longo: até 1 milhão de tokens por requisição. Veja 1 milhão de tokens de contexto.

Limites de uso

Toda conta de API tem limite, inclusive direto na Anthropic. Na open33, cada plano tem limites de requisições e de tokens, informados no painel. Quando você passa do limite, a API responde com o erro 429 até a janela seguinte. O guia de erros da API do Claude mostra como tratar esse e outros erros.