Proxy da API do Claude

Use os modelos Claude com o Claude Code, o SDK da Anthropic ou qualquer ferramenta compatível com OpenAI.

Resposta curta

A APIVAI é um proxy da API do Claude: aponte o Claude Code ou o SDK da Anthropic para https://api.apivai.com (sem /v1), ou qualquer ferramenta compatível com OpenAI para https://api.apivai.com/v1, e use os mesmos modelos Claude com uma chave da APIVAI. Em 2026-10-10, o Claude Sonnet 4.6 (ID do modelo claude-sonnet-4-6) custa $1.15 / $5.74 por milhão de tokens de entrada / saída, contra $3.00 / $15.00 no preço oficial da Anthropic. Pagamento por uso a partir de um saldo pré-pago.

BASE URLhttps://api.apivai.com

O APIVAI oferece os modelos Claude em dois formatos. Escolha o que sua ferramenta espera — confundi-los é a causa mais comum de erros 404.

FormatoBase URLEndpointCabeçalho de autenticaçãoUsado por
Nativo da Anthropichttps://api.apivai.com/v1/messagesx-api-keyClaude Code, Anthropic SDK
Compatível com OpenAIhttps://api.apivai.com/v1/chat/completionsAuthorization: BearerCursor, Cline, Aider, OpenAI SDK

O que importa é o endereço final: as requisições precisam chegar a https://api.apivai.com/v1/messages (formato Anthropic) ou https://api.apivai.com/v1/chat/completions (formato OpenAI). Cada ferramenta acrescenta algo diferente à base URL. O SDK da Anthropic e o Claude Code acrescentam /v1/messages, então usam https://api.apivai.com; a maioria das ferramentas no estilo OpenAI acrescenta /chat/completions, então usa https://api.apivai.com/v1. Há exceções — o provedor anthropic do Continue e o modo Claude do Chatbox acrescentam só /messages e precisam de https://api.apivai.com/v1 —, então siga o guia da sua ferramenta.

Claude Code

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.apivai.com" export ANTHROPIC_AUTH_TOKEN="YOUR_APIVAI_API_KEY" claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.apivai.com" $env:ANTHROPIC_AUTH_TOKEN="YOUR_APIVAI_API_KEY" claude

Se ANTHROPIC_API_KEY já estiver definida, remova-a primeiro, ou ela será usada no lugar da sua chave da APIVAI: unset ANTHROPIC_API_KEY (PowerShell: Remove-Item Env:ANTHROPIC_API_KEY).

Comece com um prompt curto para confirmar a conexão antes de iniciar uma sessão longa de agente.

Com essas duas variáveis, o Claude Code é cobrado por token do seu saldo da APIVAI, então não é preciso um plano Claude Pro ou Max. Quanto isso custa por mês e quando um plano sai mais barato: Claude Code sem assinatura.

Anthropic SDK

Python

import anthropic client = anthropic.Anthropic( api_key="YOUR_APIVAI_API_KEY", base_url="https://api.apivai.com", ) message = client.messages.create( model="claude-sonnet-4-6", max_tokens=1024, messages=[{"role": "user", "content": "Hello!"}], ) print(message.content[0].text)

Node.js

import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ apiKey: process.env.APIVAI_API_KEY, baseURL: "https://api.apivai.com", }); const message = await client.messages.create({ model: "claude-sonnet-4-6", max_tokens: 1024, messages: [{ role: "user", content: "Hello!" }], }); // message.content is an array of content blocks console.log(message.content.map((b) => (b.type === "text" ? b.text : "")).join(""));

cURL (Messages API)

curl https://api.apivai.com/v1/messages \ -H "x-api-key: YOUR_APIVAI_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-6", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello!"}] }'

Adicione "stream": true ao corpo para receber a resposta como server-sent events.

Claude pelo formato OpenAI

Ferramentas que só aceitam um provedor no estilo OpenAI também podem usar os modelos Claude — aponte-as para a base URL com /v1 e informe um ID de modelo Claude.

curl https://api.apivai.com/v1/chat/completions \ -H "Authorization: Bearer YOUR_APIVAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-sonnet-4-6", "messages": [{"role": "user", "content": "Hello!"}] }'

Erros comuns

ErroCausa comum
401A chave está ausente, mal formatada ou não está visível para o processo que iniciou a ferramenta.
404A base URL tem /v1 onde não deveria, não tem ou tem duas vezes.
model_not_foundO modelo configurado não está na resposta atual de GET /v1/models.

Todos os códigos de erro com causas e soluções: códigos de erro da API do Claude.

Perguntas frequentes

Qual base URL o Claude Code precisa?

https://api.apivai.com, sem barra no final e sem /v1. O Claude Code acrescenta /v1/messages por conta própria.

Por que recebo um 404?

O endereço final está errado — geralmente /v1 falta, sobra ou está repetido. Ele precisa ser https://api.apivai.com/v1/messages ou https://api.apivai.com/v1/chat/completions. O Claude Code e o SDK da Anthropic usam https://api.apivai.com; a maioria das ferramentas no estilo OpenAI usa https://api.apivai.com/v1; veja as exceções no guia da sua ferramenta.

Por que recebo um 401 com uma chave correta?

Provavelmente ANTHROPIC_API_KEY também está definida no seu terminal e tem prioridade. Remova-a ou confira no painel se a chave ainda tem orçamento.

A mesma chave pode chamar modelos GPT?

Sim. Use um ID de modelo GPT, como gpt-5.5, pela base URL no formato OpenAI https://api.apivai.com/v1.

Quantas requisições posso enviar?

Cada chave permite 60 requisições por minuto por padrão; fale com o suporte para um limite maior.