Resposta curta
A forma mais barata de rodar Claude Code, Cursor ou seus próprios scripts com modelos Claude e GPT é pagar por token a uma tarifa menor e escolher o menor modelo que dá conta da tarefa. A APIVAI é um gateway de API de pagamento por uso: você aponta suas ferramentas para https://api.apivai.com e, em 2026-11-18, paga 60–63% menos que os preços de tabela da Anthropic na maioria dos modelos Claude e até 86% menos que os da OpenAI nos modelos GPT. Uma mensagem típica do Claude Code com o Claude Sonnet 4.6 custa cerca de $0.0131 em vez de $0.0345. Não há assinatura; as recargas começam em $10 com cartão ou criptomoedas, ou ¥20 via Alipay / WeChat Pay.
O que determina o custo de uma API de IA?
Toda requisição é cobrada por tokens, de três tipos:
- Tokens de entrada: tudo o que você envia, incluindo o prompt de sistema, a conversa até ali, os arquivos abertos e as definições de ferramentas. Agentes de programação enviam muita entrada, porque cada turno repete o contexto.
- Tokens de saída: o que o modelo escreve de volta. A saída custa várias vezes mais que a entrada por token, então respostas longas e grandes reescritas de código somam rápido.
- Tokens de cache: quando o mesmo prefixo (um prompt de sistema longo, um arquivo, turnos anteriores) é enviado de novo, ele pode ser gravado uma vez em um cache de prompts e lido nos turnos seguintes por um preço bem menor que a entrada nova.
A outra alavanca é o modelo. Dentro de um mesmo provedor, o modelo mais capaz pode custar várias vezes mais por token que o do dia a dia. Na APIVAI, o Fable é o nível mais capaz e mais caro, o Opus é para programação e análise complexas, o Sonnet cobre a programação do dia a dia com o melhor custo-benefício e o Haiku é a opção rápida e barata. Do lado da OpenAI, o GPT-6 Astra é o nível mais alto, o GPT-6.1 Sol o nível intermediário atual, o GPT-6.1 Terra um degrau mais rápido e barato (a OpenAI destaca raciocínio visual, uso do computador e escrita), e os modelos Luna são os menores e mais baratos.
Preços oficiais vs. APIVAI dos principais modelos
| Modelo | Entrada / saída oficial (por 1M de tokens) | Entrada / saída APIVAI | Abaixo da tabela |
|---|---|---|---|
| Claude Fable 5.1 | $10.00 / $50.00 | $3.97 / $19.87 | 60% |
| Claude Opus 5.5 | $4.00 / $20.00 | $1.52 / $7.57 | 62% |
| Claude Sonnet 5.5 | $2.00 / $10.00 | $0.75 / $3.79 | 63% |
| Claude Sonnet 4.6 | $3.00 / $15.00 | $1.14 / $5.68 | 62% |
| Claude Haiku 4.5 | $1.00 / $5.00 | $0.38 / $1.89 | 62% |
| GPT-6 Sol | $2.00 / $10.00 | $0.30 / $1.52 | 85% |
| GPT-6.1 Sol | $2.00 / $10.00 | $0.30 / $1.52 | 85% |
| GPT-6 Luna | $0.10 / $0.50 | $0.0144 / $0.0768 | 86% |
Preços em 2026-11-18. Os preços oficiais são os preços de tabela publicados pelos provedores (Anthropic, OpenAI). A página de preços sempre mostra os números do dia para todos os modelos, incluindo os preços de cache. Para ver em mais detalhe os preços do Claude entre provedores, veja a comparação de preços da API do Claude.
Quanto custa o Claude Code por mensagem e por mês?
Um turno de chat no Claude Code tem cerca de 4.000 tokens de entrada e 1.500 de saída. Turnos agênticos que leem muitos arquivos são maiores, então trate isso como um piso:
| Uso | Modelo | API oficial | APIVAI |
|---|---|---|---|
| Uma mensagem | Claude Sonnet 4.6 | $0.0345 | $0.0131 |
| Uma mensagem | Claude Opus 5.5 | $0.046 | $0.0174 |
| Uma mensagem | Claude Haiku 4.5 | $0.0115 | $0.00436 |
| 20 mensagens por dia durante um mês (600) | Claude Sonnet 4.6 | $20.70 | $7.85 |
| 20 mensagens por dia durante um mês (600) | Claude Opus 5.5 | $27.60 | $10.46 |
| 10M de entrada + 2M de saída por mês | Claude Sonnet 4.6 | $60.00 | $22.76 |
| 10M de entrada + 2M de saída por mês | GPT-6.1 Sol | $40.00 | $6.04 |
Preços em 2026-11-18; veja /pricing para as tarifas atuais. Esses números não incluem o prompt caching, que reduz as duas colunas quando o mesmo contexto é enviado de novo. Se você está escolhendo entre ferramentas, a comparação de custos Claude Code vs. Cursor analisa mais cenários.
Como configurar o Claude Code
O Claude Code usa o formato Anthropic Messages, então a base URL vai sem /v1. Defina duas variáveis de ambiente e inicie.
Mac/Linux:
ANTHROPIC_AUTH_TOKEN="your-apivai-key" \ ANTHROPIC_BASE_URL="https://api.apivai.com" \ claude
Windows PowerShell:
$env:ANTHROPIC_AUTH_TOKEN="your-apivai-key" $env:ANTHROPIC_BASE_URL="https://api.apivai.com" claude
Se ANTHROPIC_API_KEY também estiver definida no seu ambiente, ela tem prioridade e as requisições vão falhar com 401, então remova-a antes. Dentro do Claude Code, use /model para alternar entre Sonnet, Opus e Haiku. O passo a passo completo está no guia de configuração do Claude Code.
Como configurar o Cursor
- Abra Cursor Settings > Models.
- Ative Override OpenAI Base URL e digite
https://api.apivai.com/v1. - Cole sua chave da APIVAI como chave de API da OpenAI.
- Adicione como modelos personalizados os IDs que quiser, por exemplo
claude-sonnet-4-6ougpt-6.1-sol.
Mais detalhes no guia de configuração do Cursor.
Como configurar o Codex CLI
O Codex CLI (0.121 e posteriores) lê os provedores de ~/.codex/config.toml. Adicione:
model = "gpt-6.1-sol" model_provider = "apivai" [model_providers.apivai] name = "APIVAI" base_url = "https://api.apivai.com/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"
Depois defina OPENAI_API_KEY com sua chave da APIVAI e rode codex.
Como chamar pelo Python (SDK da OpenAI)
Qualquer cliente compatível com OpenAI funciona trocando a base URL. Aqui servem tanto os IDs de modelo do Claude quanto os do GPT:
from openai import OpenAI
client = OpenAI(
api_key="your-apivai-key",
base_url="https://api.apivai.com/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)Como chamar pelo Python (SDK da Anthropic)
O SDK da Anthropic usa a base URL sem /v1:
import anthropic
client = anthropic.Anthropic(
api_key="your-apivai-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)Os detalhes de endpoints e parâmetros estão na documentação.
Como manter o gasto sob controle
- Dê a cada chave o próprio orçamento. Crie chaves separadas no Dashboard para cada ferramenta, projeto ou colega e defina um orçamento em cada uma. Quando uma chave atinge o orçamento, as requisições dela param com 402 em vez de esvaziar o seu saldo.
- Escolha o modelo pela tarefa. Use o Claude Sonnet 5.5 ($0.75 / $3.79 por 1M) para a maior parte da programação, mude para o Claude Opus 5.5 só para depuração difícil ou trabalho de arquitetura, e use o Claude Haiku 4.5 ($0.38 / $1.89) para edições rápidas, resumos e scripts simples.
- Use prompt caching. No Claude Sonnet 5.5, leituras de cache custam $0.0384 por 1M de tokens e gravações em cache $0.94, contra $0.75 da entrada nova. O Claude Code usa cache sozinho; no seu próprio código com o SDK da Anthropic, marque prefixos longos e estáveis com
cache_control. - Mantenha o contexto curto. Abra sessões novas para tarefas não relacionadas e evite colar arquivos inteiros quando uma função basta. Cada token repetido é cobrado como entrada ou cache.
- Confira o Dashboard. Ele lista cada requisição com modelo, tokens e custo, para você ver qual ferramenta ou hábito está consumindo o orçamento.
Limites que vale conhecer
- Cada chave permite 60 requisições por minuto; use várias chaves se precisar de mais.
- Os endpoints suportados são Messages, contagem de tokens, Chat Completions, Responses e listagem de modelos, com streaming, chamada de ferramentas e imagens. Batch API, Files API, embeddings, geração de imagens, áudio e fine-tuning não são oferecidos; para isso, use a API oficial.
- Você paga os tokens de entrada, saída e cache a partir de um saldo pré-pago. Não há mensalidade nem mínimo.
- Recarregue a partir de $10 com cartão ou criptomoedas, ou ¥20 via Alipay / WeChat Pay. Créditos consumidos não são reembolsáveis.
- A APIVAI não armazena o conteúdo das requisições nem das respostas; só os metadados de uso são guardados para cobrança.
FAQ
A APIVAI é mais barata que uma assinatura Claude Pro ou Max?
Depende de quanto você usa. As assinaturas cobram uma mensalidade fixa com limites de uso (preços do Claude); o pagamento por uso combina com uso irregular ou moderado, e você nunca bate no teto de um plano. Compare seu volume mensal de tokens com os exemplos acima; Claude Code sem assinatura compara os planos Pro e Max com a cobrança por token.
Qual base URL eu uso?
Use https://api.apivai.com para ferramentas no formato Anthropic (Claude Code, SDK da Anthropic) e https://api.apivai.com/v1 para ferramentas no formato OpenAI (Cursor, Codex CLI, SDK da OpenAI). Um 404 geralmente significa que o /v1 está faltando ou duplicado.
Uma chave serve para modelos Claude e GPT?
Sim. A mesma chave funciona nos dois formatos; é só trocar o ID do modelo.
O Claude Code funciona exatamente como com a API oficial?
Sim, o Claude Code fala com o mesmo endpoint Messages, com streaming e chamadas de ferramentas. Você só muda as duas variáveis de ambiente.
Como evito que um script descontrolado gaste o meu saldo?
Dê ao script uma chave própria com orçamento pequeno. Quando o orçamento acaba, essa chave para de funcionar enquanto suas outras chaves continuam.
E se eu precisar de mais de 60 requisições por minuto?
Cada chave tem o próprio limite de 60 requisições por minuto, então crie várias chaves e divida o trabalho entre elas.
Crie uma conta e pegue sua primeira chave em poucos minutos.