Modelos OpenAI no Cursor: 12 de novembro, BYOK, Codex e gateways

Para continuar usando modelos OpenAI no Cursor, use sua própria chave de API (BYOK) nas solicitações locais compatíveis do Chat e do Agent. Escolha a extensão Codex para usar seu agente de programação ou acessar o serviço com uma assinatura ChatGPT elegível. Use um gateway compatível se sua equipe já administra o acesso aos modelos e a cobrança por esse serviço.

Cada opção tem requisitos de conta e limites de recursos diferentes. Confira esses pontos antes de comprar créditos de API ou mudar o endpoint.

12 de novembro ainda é uma data proposta

Em 2026-10-27, 12 de novembro de 2026 continua sendo uma data proposta para o encerramento. As orientações atuais da OpenAI para o Cursor informam que a data definitiva depende da confirmação das duas empresas. O texto também diz que o Cursor pode encerrar o acesso antes.

A cronologia tem dois momentos relevantes:

2026-08-28: a OpenAI anunciou a intenção de encerrar o contrato após a aquisição do Cursor pela SpaceX. Propôs 12 de novembro e informou que não incluiria modelos futuros no acordo.
Em 2026-10-27: a página de ajuda da OpenAI ainda apresenta essa data como uma proposta. Ela documenta BYOK, a extensão Codex e gateways compatíveis como alternativas de acesso.

A OpenAI atribuiu a decisão a preocupações com o cumprimento de seus termos. Essa é a justificativa declarada pela empresa. Para planejar a migração, o que importa é o acordo que sustenta o acesso aos modelos OpenAI fornecido pelo próprio Cursor.

Configure uma alternativa antes de contar com o prazo proposto. Estas instruções mantêm formas compatíveis de trabalhar dentro do editor, mas não preservam todos os recursos do Cursor.

Confira primeiro o plano, o recurso e a cobrança

O BYOK nativo do Cursor atende às solicitações locais compatíveis do Chat e do Agent. Ele não cobre Tab, Auto, Cloud ou Background Agents, Automations, Cursor CLI nem Cursor API/SDK. Instalar a extensão Codex não altera esses recursos do Cursor.

A elegibilidade do plano também importa. Em 2026-10-27, a documentação atual dos planos do Cursor exclui explicitamente as chaves de API pessoais do Cursor Plus. A ajuda sobre BYOK cobre Premium, Super, Ultra e determinados planos antigos. Confira o que seu plano atual permite antes de trocar.

Em um workspace Enterprise, o administrador pode restringir chaves pessoais. Os controles ficam em Team Settings → Models → Personal API Keys (BYOK). Um gateway configurado nos campos da OpenAI também precisa da permissão de BYOK para OpenAI.

As formas de cobrança são separadas:

Opção	Conta ou plano que paga pelo uso dos modelos
Chave OpenAI no Cursor	Sua conta da API OpenAI
Codex com login do ChatGPT	A franquia do seu plano ChatGPT elegível e os créditos adicionais aplicáveis
Codex com uma chave de API OpenAI	Sua conta da API OpenAI
Gateway no Cursor	Sua conta no gateway ou no provedor de hospedagem

As cobranças de API são separadas das assinaturas do Cursor e do ChatGPT. Uma assinatura ChatGPT não fornece saldo para a API OpenAI.

Teams e Enterprise têm outro custo a considerar. Em 2026-10-27, as solicitações BYOK sujeitas à cobrança pagam a Cursor Token Rate de USD $0.25 por milhão de tokens. A taxa se aplica aos tokens de entrada, saída e cache, além das cobranças do provedor. Planos individuais não pagam essa taxa, e as isenções de modelos listadas também valem para BYOK.

“Local” descreve o fluxo de trabalho no aplicativo desktop. Segundo a documentação de BYOK do Cursor, as solicitações ainda passam pelo backend do Cursor para construir o prompt. A política Zero Data Retention do Cursor não se aplica ao BYOK. Confira a política de tratamento de dados do seu provedor.

Opção 1: adicione sua própria chave de API OpenAI

Escolha esta opção para usar a interface nativa do Chat e do Agent do Cursor com um modelo OpenAI compatível.

Atualmente, o Cursor documenta o BYOK da OpenAI para modelos padrão de chat sem raciocínio. Adicionar o ID de um modelo de raciocínio mais recente não garante suporte. Escolha entre os modelos aceitos pelo seu cliente atual e pela sua conta de API.

Siga as instruções da OpenAI para configurar o Cursor:

Configure a cobrança da sua conta da API OpenAI.
Crie sua própria chave na página de chaves de API da OpenAI.
Abra Cursor Settings → Models e localize as configurações da chave de API OpenAI.
Se você já configurou um gateway, desative Override OpenAI Base URL antes de usar sua chave oficial da OpenAI.
Cole a chave em OpenAI API Key e clique em Save. Ative Use OpenAI API Key se sua interface mostrar essa opção.
Ative um modelo OpenAI compatível na lista de modelos.
Abra um novo Chat local, desative Auto e selecione explicitamente esse modelo.
Envie Reply with exactly: connection-ok.

O resultado esperado é uma resposta no Chat do Cursor. Confira o uso da API no projeto correspondente para confirmar qual conta recebeu a solicitação. Depois, teste a operação do Agent de que você precisa com a verificação simples de edição abaixo.

Opção 2: instale a extensão Codex para IDE

Escolha o Codex quando precisar de seu agente de programação ou quiser usar uma assinatura ChatGPT elegível dentro do Cursor. Ele tem uma interface própria e não depende do seletor nativo de modelos OpenAI do Cursor.

Os planos ChatGPT elegíveis incluem Plus, Pro, Business, Edu e Enterprise, sujeitos às permissões do workspace. Confira a disponibilidade atual do Codex por plano. ChatGPT Plus e Cursor Plus são assinaturas diferentes.

Abra a página oficial da extensão Codex para IDE.
Em Install or enable Codex, escolha Cursor e conclua a instalação.
Abra um projeto local e selecione o ícone do Codex na barra de atividades, a Activity Bar.
Se o ícone não aparecer, abra a Command Palette e execute Codex: Open Codex Sidebar.
Escolha Sign in with ChatGPT e conclua o login no navegador. Para cobrança pela API, escolha Use API Key, insira sua chave OpenAI e selecione OK.
Abra um arquivo de código e adicione uma função selecionada ao contexto do prompt do Codex.
Peça ao Codex para explicar a função e um caso-limite, sem editar arquivos.

Leia a resposta na conversa do Codex e compare-a com o código selecionado. Use os controles de modelo e conta do próprio Codex para verificar a conexão.

Para configurar o agente, selecione o ícone de engrenagem na barra lateral e depois Codex Settings. A referência de configurações da extensão da OpenAI separa esses controles das configurações do editor. Eles não configuram a página Models nativa do Cursor.

A documentação de autenticação confirma que o login com chave de API gera cobranças na sua conta OpenAI Platform. Esse login permite trabalhar localmente com o Codex. Recursos que exigem acesso à nuvem ou a um workspace do ChatGPT podem continuar indisponíveis.

Se escolher esta opção, envie as próximas tarefas pelo painel do Codex. Ao escrever no Chat do Cursor, você continua usando a configuração separada do Cursor.

Opção 3: conecte um gateway compatível com OpenAI

Escolha um gateway que forneça a conta, o modelo e o formato de API necessários ao seu fluxo no Cursor. A OpenAI lista Amazon Bedrock, Azure e outros provedores compatíveis como opções.

Azure e Bedrock têm configurações específicas de cada provedor. As etapas abaixo usam um endpoint personalizado compatível com OpenAI. Consulte as instruções de implantação do provedor para obter as credenciais e os nomes dos modelos.

Para as etapas específicas do OpenRouter, consulte o guia separado de configuração do Cursor com OpenRouter.

Obtenha a chave de API do provedor, a Base URL documentada e o ID exato do modelo.
Confirme que o provedor aceita o formato de API e as ferramentas exigidos pelo modelo escolhido no Cursor.
Abra Cursor Settings → Models → API Keys.
Na seção OpenAI, ative Override OpenAI Base URL e insira a Base URL do provedor.
Insira a credencial do gateway em OpenAI API Key, ative Use OpenAI API Key e salve.
Adicione ou ative o ID exato do modelo fornecido pelo provedor.
Reinicie o Cursor, abra um novo Chat local, desative Auto e selecione esse modelo.
Envie a solicitação curta de conexão e confira o registro de uso do provedor.

O suporte do Cursor documenta esses controles nas orientações para configurar modelos personalizados. Use o ID do modelo aceito pelo endpoint, incluindo qualquer prefixo obrigatório. Um nome exibido por outro provedor pode identificar uma rota diferente.

Por exemplo, o guia do BetterToken para Cursor especifica https://www.bettertoken.ai/v1 e sua própria chave de API BetterToken. Seu catálogo atual listava gpt-6-luna em 2026-10-27. Isso confirma a presença no catálogo, mas não a compatibilidade nativa com o Cursor. Antes de selecionar o modelo, confira o modo de API e o suporte a ferramentas, considerando a restrição publicada pelo Cursor para modelos de raciocínio.

No campo Base URL do BetterToken, mantenha /v1. Não acrescente /chat/completions nem /responses. Esses são caminhos de recursos, como explica a referência da API.

Confira a substituição da Base URL ao voltar para modelos gerenciados pelo Cursor. Em uma discussão de suporte sobre o roteamento do Cursor, a equipe confirmou que a substituição também afeta as seleções de modelos OpenAI integrados. Desative-a ao voltar para a rota gerenciada pelo Cursor. Escolher um nome GPT conhecido não muda o endpoint por si só.

Verifique todo o processo de edição

Teste a operação necessária antes de transferir uma sessão de programação para a nova opção. Uma resposta curta confirma a conectividade básica, mas não comprova que as ferramentas de edição funcionam.

Abra uma pasta de projeto descartável. No Agent local do Cursor ou na barra lateral do Codex, envie:

Create cursor-route-check.txt containing this single line:
connection-ok

Use your file-editing tool, then read the file back.
Do not use a shell command to create or modify the file.
Stop after confirming its contents.

O resultado esperado é um arquivo com connection-ok e uma interação concluída de edição e releitura. Inspecione o arquivo. No acesso por chave de API ou gateway, confira também o modelo e o uso registrados pelo provedor.

Se o texto funcionar, mas a edição falhar, investigue a compatibilidade das ferramentas antes de substituir a chave. Em uma discussão de suporte do Cursor de julho de 2026, Harm Alhusen identificou que seu proxy descartava respostas custom_tool_call, causando falhas nas edições. O suporte do Cursor explicou que as ferramentas personalizadas da OpenAI precisam permanecer intactas em todo o percurso de solicitação e resposta.

Esse relato descreve uma falha de integração diagnosticada. Ele não explica a causa de toda tarefa interrompida do Agent. Se o modelo necessário não concluir o teste pelo BYOK nativo, tente o Codex com uma conta e um modelo compatíveis.

Corrija a falha correspondente ao sintoma

Use o sintoma para escolher a próxima verificação. Mudar todas as configurações de uma vez dificulta isolar erros de roteamento.

Sintoma	Verificação e próxima ação
Os campos de chave de API ou Base URL não aparecem	Confira seu plano e cliente do Cursor. No Enterprise, peça ao administrador para revisar as restrições de chaves pessoais. Reabra Models depois que o acesso for liberado.
A autenticação falha	Confirme que a chave pertence ao provedor do endpoint configurado e que a cobrança da API está ativa. Salve a combinação corrigida e repita uma solicitação curta.
`AI Model Not Found` ou `Model name is not valid`	Confira o ID exato do modelo do provedor, se a opção de uso da chave está ativa e a permissão de BYOK para OpenAI. Após corrigir, inicie uma nova conversa.
`You've reached your monthly usage limit` ao usar um gateway	Confira os limites de gastos da equipe no Cursor e o crédito do provedor. As cobranças de tokens aplicáveis do Cursor ainda podem bloquear solicitações BYOK da equipe.
Um modelo GPT integrado falha após ativar a substituição da Base URL	Desative a substituição antes de testar a rota gerenciada pelo Cursor, enquanto o modelo continuar disponível nela.
A resposta começa, mas as ferramentas ou edições falham	Confira o protocolo e o processamento das chamadas de ferramentas desse modelo. Repita o teste com o arquivo descartável após corrigir a configuração do provedor ou do cliente.

A conversa com o suporte do Cursor de setembro a outubro de 2026 documenta várias dessas falhas de permissão e limite de gastos. São verificações úteis, não uma confirmação de que sua conta tem a mesma causa.

Se a solicitação continuar falhando, registre a versão do Cursor, o ID do modelo selecionado, o host do endpoint, a data e hora e o ID da solicitação. Não inclua credenciais nem conteúdo privado dos prompts nos dados de diagnóstico compartilhados.