Usar sua chave no Cursor

Ative o Override OpenAI Base URL, adicione modelos personalizados e saiba quais recursos do Cursor ainda usam o backend próprio.

O Cursor aceita trazer sua própria chave (BYOK): defina uma base URL compatível com OpenAI mais sua chave do OLETOKEN, e as requisições do Chat passam a consumir seu saldo do OLETOKEN.

Antes de começar

Você já criou uma chave de API e guardou a chave completa.
Você tem um ID de modelo da vitrine de modelos.
Sua versão do Cursor aceita modelos personalizados (Settings → Models mostra o botão "Add Model").

Configuração

Abra as configurações: ⌘⇧J (macOS) / Ctrl⇧J (Windows, Linux), ou ⌘⇧P → Cursor Settings.
Vá em Models → Model Names → + Add Model, digite o ID do modelo que deseja e pressione Enter.
Na mesma página, em API Keys → OpenAI API Key, clique em + e cole sua chave do OLETOKEN.
Ative Override OpenAI Base URL e informe o endereço compatível com OpenAI incluindo /v1:
```
https://<your-base-url>/v1
```
O Cursor acrescenta /chat/completions a ele, então o /v1 não é opcional.
Clique em Verify. Para nomes de modelo que não são da própria OpenAI, a verificação pode falhar — isso é um alarme falso; em vez disso, envie uma mensagem no Chat para testar.
De volta ao editor, pressione ⌘L / Ctrl+L para abrir o Chat e escolha seu modelo na lista suspensa.

Bom saber

Somente Chat e Plan são cobertos. Composer, preenchimento por Tab e Inline Edit continuam rodando no backend próprio do Cursor e não gastam seu saldo do OLETOKEN.
Seus modelos Anthropic embutidos podem ser afetados. Com o Override OpenAI Base URL ativado, os modelos Claude inclusos no Cursor também podem ser roteados para este site. Se você ainda quiser os oficiais, adicione os IDs dos modelos Claude como modelos personalizados em + Add Model e selecione esses na lista suspensa.
Para reverter: desative o Override OpenAI Base URL. A chave e os modelos cadastrados podem permanecer.
Você também pode instalar a extensão do Claude Code no Cursor (o Cursor aceita o marketplace do VS Code) — veja usar o VS Code. Esse caminho fala o protocolo Anthropic Messages e não se limita a Chat / Plan.

Solução de problemas

Sintoma	Causa e solução
Verify falha	Alarme falso para nomes de modelo que não são da OpenAI — teste no Chat
401	A chave foi colada incompleta ou está desativada; copie novamente
404	Falta `/v1` no Override OpenAI Base URL
Novo modelo ausente no Chat	O ID do modelo está escrito errado, ou você não trocou para ele na lista de modelos do Chat
Saldo insuficiente	Adicione créditos primeiro