Resposta curta
O Cursor deixa você trocar a base URL da OpenAI pela sua. Defina como https://api.apivai.com/v1, cole uma chave da APIVAI como chave de API da OpenAI, adicione os IDs de modelo que quiser e o chat do Cursor passa a usar modelos Claude e GPT cobrados por token a partir de um saldo pré-pago.
Em 2026-11-18, o Claude Sonnet 4.6 custa assim $1.14 / $5.68 por milhão de tokens de entrada / saída, contra $3.00 / $15.00 no preço de tabela da Anthropic. A mesma chave também funciona no VS Code com Cline ou Continue e em plugins da JetBrains que aceitam um endpoint compatível com OpenAI.
Vale mais a assinatura do Cursor ou a sua própria chave?
| Opção | Como você paga | Observações |
|---|---|---|
| Planos do próprio Cursor | Assinatura mensal fixa | Os limites de uso dependem do plano; veja os preços do Cursor |
| Cursor + chave da API oficial | Por token, a preço de tabela | $3.00 / $15.00 para o Claude Sonnet 4.6 |
| Cursor + chave da APIVAI | Por token, abaixo do preço de tabela na maioria dos modelos | $1.14 / $5.68 para o Claude Sonnet 4.6; 60 requisições/min por chave |
A sua própria chave costuma sair mais barata quando você usa o Cursor pouco ou de forma irregular, e permite escolher exatamente qual modelo responde. Uma assinatura pode fazer mais sentido se você programa o dia todo e fica dentro dos limites do plano.
Uma ressalva: alguns recursos do Cursor podem funcionar só com os modelos do próprio Cursor e não com uma chave personalizada. Em versões anteriores isso incluiu coisas como o autocompletar Tab e alguns recursos de agente ou de aplicar alterações. Quais recursos usam a sua chave pode mudar entre versões, então confira a seção de chaves de API da documentação do Cursor para a sua versão. Para uma comparação mais ampla, veja Claude Code vs. Cursor: comparação de custos.
Como configurar o Cursor com a sua própria chave de API?
Passo 1: pegue uma chave de API
- Cadastre-se em apivai.com com seu e-mail e um código de verificação
- Recarregue o saldo: a partir de $10 com cartão ou criptomoedas, ou ¥20 via Alipay / WeChat Pay
- Crie uma chave no Dashboard, se quiser com orçamento próprio, e copie
Passo 2: aponte o Cursor para a API
Os nomes das configurações abaixo são os das versões atuais; na sua podem aparecer com redação um pouco diferente.
- Abra o Cursor Settings (Cmd+, no macOS, Ctrl+, no Windows e no Linux) e vá até a seção Models
- Encontre a configuração chamada mais ou menos Override OpenAI Base URL, ative e digite:
https://api.apivai.com/v1
- Cole sua chave da APIVAI no campo OpenAI API Key
- Clique em Verify (ou no botão equivalente). Ative a troca de base URL antes de verificar; senão o Cursor confere a chave na OpenAI e a recusa.
Passo 3: adicione os IDs de modelo personalizados
Na mesma seção Models, adicione como modelo personalizado cada ID que quiser, por exemplo claude-sonnet-4-6, e ative. Digite o ID exatamente como aparece na tabela abaixo. Para ver quais IDs a sua chave enxerga, faça GET https://api.apivai.com/v1/models com a chave.
Quais modelos você pode usar e quanto custam?
Preços por 1M de tokens em 2026-11-18. Todos os modelos e a tabela de preços atual estão na página de preços.
| ID do modelo | Modelo | Entrada | Saída | Use para |
|---|---|---|---|---|
claude-sonnet-5-5 | Claude Sonnet 5.5 | $0.75 | $3.79 | Programação do dia a dia: o melhor custo-benefício (mais novo e mais barato que o 4.6) |
claude-sonnet-4-6 | Claude Sonnet 4.6 | $1.14 | $5.68 | Amplamente suportado; o Sonnet 5.5 é mais novo e mais barato |
claude-opus-5-5 | Claude Opus 5.5 | $1.52 | $7.57 | Refatorações complexas e depuração |
claude-fable-5-1 | Claude Fable 5.1 | $3.97 | $19.87 | Os problemas mais difíceis |
claude-haiku-4-5 | Claude Haiku 4.5 | $0.38 | $1.89 | Edições rápidas e baratas |
gpt-6.1-sol | GPT-6.1 Sol | $0.30 | $1.52 | Alternativa da OpenAI |
gpt-6-luna | GPT-6 Luna | $0.0144 | $0.0768 | O GPT menor e mais barato |
Qual modelo escolher para cada tarefa?
- Perguntas, pequenas edições, renomeações, explicar código: Claude Haiku 4.5 ou GPT-6 Luna. São rápidos e custam pouco por turno.
- Funcionalidades e correções do dia a dia: Claude Sonnet 5.5 (ou o anterior Claude Sonnet 4.6). É o padrão sensato para a maioria.
- Grandes refatorações, bugs difíceis espalhados por muitos arquivos, decisões de design: Claude Opus 5.5.
- Problemas em que o Opus trava: Claude Fable 5.1, a opção mais capaz e mais cara. Use em tarefas difíceis pontuais, não como padrão.
- Uma segunda opinião: mude para o GPT-6.1 Sol quando quiser que outra família de modelos revise o mesmo código.
## Quanto custa o Cursor com a sua própria chave?
O custo depende de quantos tokens cada requisição envia. Três casos típicos com o Claude Sonnet 4.6:
- Um turno de chat de cerca de 4.000 tokens de entrada e 1.500 de saída: $0.0131 ($0.0345 a preço de tabela).
- Uma execução de agente que lê muitos arquivos e faz 15 requisições de cerca de 40.000 tokens de entrada e 2.000 de saída cada: $0.854 ($2.25 a preço de tabela). Execuções de agente custam mais porque cada passo reenvia os arquivos e a conversa até ali.
- Um mês de 30 turnos de chat por dia durante 30 dias: $11.77 ($31.05 a preço de tabela). Somando duas execuções de agente por dia útil (cerca de 44 por mês), entram mais uns $37.59.
O mesmo mês de turnos de chat com o Claude Haiku 4.5 sairia por $3.92. O Dashboard mostra os tokens e o custo de cada requisição, então você vê seus números reais em um ou dois dias. A comparação de preços da API do Claude traz a tabela completa ao lado dos preços oficiais.
Como usar a mesma chave no VS Code com o Cline?
O Cline é uma extensão do VS Code com modo agente. Nas versões atuais você abre as configurações do Cline e escolhe um API Provider. Há duas formas de conectar:
- Provedor OpenAI Compatible: defina a Base URL como
https://api.apivai.com/v1, cole sua chave da APIVAI como chave de API e informe um ID de modelo comoclaude-sonnet-4-6ougpt-6.1-sol. - Provedor Anthropic: cole sua chave, ative a opção chamada mais ou menos Use custom base URL e digite
https://api.apivai.com(sem/v1, porque o Cline acrescenta o caminho sozinho). Escolha um modelo Claude na lista.
Os dois funcionam. O provedor Anthropic fala o formato nativo do Claude; o OpenAI Compatible permite misturar modelos Claude e GPT com uma só configuração.
Como configurar o Continue no VS Code ou na JetBrains?
O Continue é configurado em um arquivo. As versões recentes usam config.yaml (as antigas usavam config.json com os mesmos campos). Adicione uma entrada de modelo com o provedor openai e a base URL da APIVAI:
models:
- name: Claude Sonnet via APIVAI
provider: openai
model: claude-sonnet-4-6
apiBase: https://api.apivai.com/v1
apiKey: your-keyAdicione uma entrada por modelo; a documentação do Continue lista os outros campos.
E os outros plugins da JetBrains?
As IDEs da JetBrains (IntelliJ IDEA, PyCharm, WebStorm e outras) funcionam com qualquer plugin que aceite um endpoint compatível com OpenAI. O Continue tem uma versão para JetBrains que usa o mesmo arquivo de configuração. As versões recentes do JetBrains AI Assistant também conseguem se conectar a provedores externos compatíveis com OpenAI; veja a documentação do AI Assistant para o menu atual. Em qualquer desses plugins os valores são os mesmos: base URL https://api.apivai.com/v1, sua chave da APIVAI e um ID de modelo da tabela. Veja API compatível com OpenAI para os detalhes gerais.
Solução de problemas
- "Invalid API key" ou 401: ative a troca de base URL antes de verificar a chave. Confira também se a chave foi copiada inteira, se não foi excluída e se ainda tem orçamento no Dashboard.
- 404: a base URL está errada. Ferramentas no formato OpenAI (Cursor, o provedor OpenAI Compatible do Cline, Continue) precisam de
/v1exatamente uma vez. Configurações no formato Anthropic (o provedor Anthropic do Cline) não podem ter/v1. - Modelo não encontrado: o ID do modelo precisa bater exatamente, por exemplo
claude-sonnet-4-6, e não um nome de exibição. - 429: o limite é de 60 requisições por minuto por chave. Execuções de agente podem atingi-lo; espere um pouco ou divida o trabalho entre várias chaves.
Todos os códigos de erro da API e suas soluções estão reunidos em códigos de erro da API do Claude.
FAQ
Ainda preciso de uma assinatura do Cursor?
As condições do Cursor para usar sua própria chave mudaram ao longo do tempo, então veja os preços do Cursor para saber o que o seu plano permite. O lado da API não precisa de assinatura: você só recarrega um saldo na APIVAI.
A APIVAI vê o meu código?
A APIVAI não armazena nem inspeciona o conteúdo das requisições ou das respostas. Só metadados de uso, como modelo, contagem de tokens, custo e horário, são guardados para cobrança.
Posso usar modelos Claude e GPT com uma chave só?
Sim. Uma chave funciona com todos os modelos da página de preços, tanto no formato OpenAI (https://api.apivai.com/v1) quanto no formato Anthropic (https://api.apivai.com).
O autocompletar Tab usa a minha chave?
Provavelmente não. Alguns recursos do Cursor podem funcionar só com os modelos do próprio Cursor. No Continue você mesmo pode definir um modelo de autocompletar.
Como mantenho os custos sob controle?
Dê ao editor uma chave própria com orçamento, use por padrão um modelo mais barato e confira o Dashboard, que lista cada requisição com seu custo. Para fluxos de trabalho no terminal, veja o guia de configuração do Claude Code.
Crie uma conta na APIVAI e recarregue a partir de $10 para começar.