Configurar Cursor: API Key, Base URL e modelos

Para conectar o Cursor ao BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um Model ID atual no model plaza.

Configurações principais

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Um Model ID atual do model plaza

Pré-requisitos

• A versão atual da ferramenta está instalada
• Uma BetterToken API Key: cadastre-se e obtenha uma
• Um Model ID do model plaza

Cadastre-se e obtenha uma BetterToken API Key→

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Requisitos adicionais

• Cursor instalado (baixar o Cursor)

Instalação

Baixe e instale a versão atual no site do Cursor. Entre com uma conta do Cursor compatível com modelos personalizados e continue com as etapas abaixo.

O Cursor permite configurar modelos personalizados somente em contas de um plano avançado pago ou superior. Se sua conta ou versão do cliente não mostrar opções de modelo personalizado, API Key ou Base URL, verifique primeiro o plano do Cursor e a versão do cliente.

As regras de BYOK do Cursor limitam o BYOK OpenAI a modelos de chat padrão, sem raciocínio. A conclusão com Tab continua usando os modelos integrados do Cursor. As solicitações passam pelo backend do Cursor para montar os prompts; a API Key é enviada em cada solicitação e não é retida após a conclusão. O tratamento dos dados BYOK segue a política do provedor selecionado, não a política Zero Data Retention do Cursor.

Nos planos Teams e Enterprise, as solicitações BYOK elegíveis ainda contam no uso do Cursor pela Cursor Token Rate, enquanto o provedor do modelo cobra o custo do modelo separadamente. Confira o crédito da equipe, o uso sob demanda e os limites de gastos: as solicitações podem parar quando a cota se esgotar. Os planos individuais têm regras de uso diferentes; consulte os detalhes dos planos.

Problema conhecido: Override OpenAI Base URL é uma configuração global. Quando ativada, ela afeta todas as API Keys configuradas no Cursor, inclusive as chaves Anthropic e GPT usadas pelos modelos integrados do Cursor. A comunidade oficial do Cursor confirmou esse comportamento: configurar uma Base URL afeta todas as chaves e modelos (tópico da comunidade).

Se os modelos Claude / GPT integrados do Cursor pararem de funcionar depois que você ativar Override OpenAI Base URL, desative Override OpenAI Base URL quando não estiver usando o BetterToken. Atualmente, o Cursor não permite uma Base URL diferente para cada modelo; esse recurso continua registrado como uma solicitação (solicitação de recurso).

Configuração manual

Conclua esta configuração na interface de ajustes do Cursor. Não é necessário editar um arquivo de configuração.

Campo do Cursor	Valor
Override OpenAI Base URL	Ativado
Base URL	https://bettertoken.ai/v1
OpenAI API Key	Sua BetterToken API Key
Modelo personalizado	Um Model ID completo disponível

Configuração

Abra a página de ajustes de modelos

No Cursor, clique em Settings no canto inferior esquerdo e abra Models. Role até API Keys.

Informe a Base URL e a API Key

Em API Keys, configure os campos nesta ordem:

1. Ative Override OpenAI Base URL
2. Informe https://bettertoken.ai/v1 no campo Base URL
3. Cole sua BetterToken API Key em OpenAI API Key
4. Depois de preencher a URL e a Key, ative o botão OpenAI API Key

Informe a Key antes de ativar o botão. Isso faz o Cursor mostrar a caixa de confirmação de autenticação.

Ative a OpenAI API Key

Na caixa de confirmação, clique em Enable OpenAI API Key.

Atualize a lista e ative os modelos

De volta a Models, clique no botão de atualização à direita antes de selecionar um modelo. Aguarde a atualização da lista terminar.

Copie o Model ID exato da model plaza.

Volte ao chat e desative Auto

Depois da configuração, volte à tela de chat do Cursor e abra o seletor de modelos abaixo do campo de entrada. Se Auto estiver ativado, desative-o primeiro.

Selecione o modelo e inicie o chat

Escolha o modelo que você ativou disponível e comece a usar o chat.

Verificar a conexão

Envie uma solicitação curta de teste. Se a ferramenta responder sem erros de autenticação ou de Model ID, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.

Limites do Cursor CLI

O Cursor CLI oficial (cursor-agent) usa autenticação da conta Cursor: CURSOR_API_KEY é uma chave do Cursor, não uma BetterToken API Key. A opção --endpoint especifica o endereço do serviço Cursor; as referências oficiais de autenticação e parâmetros não documentam uma Base URL compatível com OpenAI. A configuração BYOK do aplicativo desktop desta página não se aplica ao Cursor CLI.

Trocar de modelo

Abra o seletor de modelos ou altere o campo Model na configuração. Use o Model ID exato do model plaza e reinicie a sessão atual.

Erros comuns

Erros de API personalizada e API Key

Antes de trocar modelos ou Keys, compare seus ajustes com a configuração de API OpenAI personalizada no Cursor.

O Cursor não mostra os campos Custom API, API Key ou Base URL

Verifique o plano do Cursor e a versão do cliente. Modelos personalizados estão disponíveis somente nos planos pagos compatíveis. Depois de atualizar o Cursor, abra Settings → Models novamente.

Não é possível ativar ou verificar a API Key

Informe a Base URL https://bettertoken.ai/v1 e a API Key antes de ativar o botão OpenAI API Key. Não acrescente /chat/completions à Base URL nem use uma Key do provedor Claude.

O modelo não aparece depois da atualização

Copie o Model ID exato da model plaza.

Os modelos integrados do Cursor param de funcionar

Override OpenAI Base URL é uma configuração global. Quando não estiver usando o BetterToken, desative esse botão para que o Cursor volte a usar a própria Base URL.

O chat seleciona outro modelo

Abra o seletor de modelos e desative Auto. Depois, selecione manualmente o modelo ativado.

Perguntas relacionadas

• Configuração de API OpenAI personalizada no Cursor

• Cursor Rules, AGENTS.md e .cursorignore

• Como configurar MCP no Cursor

• Claude Code ou Cursor para desenvolvimento local

• Configurar um provedor personalizado no Codex CLI

• Configurar uma API compatível com OpenAI no Cline

• API compatível com OpenAI ou API compatível com Anthropic

• Compare as ferramentas compatíveis

• Erros da API, códigos de status e limites de requisições

Detalhes técnicos

Protocolo, endpoint e campos internos do provedor

Esta configuração usa https://bettertoken.ai/v1. A ferramenta acrescenta o caminho do endpoint compatível com OpenAI. Não adicione /chat/completions nem /responses, a menos que um campo específico exija isso explicitamente.

Observações

• Copie o Model ID exato da model plaza.