OpenAI
Esta página foi traduzida automaticamente. Veja o artigo original em inglês.

Como usar os modelos da OpenAI no Cursor

Atualizado: 3 days ago

A OpenAI planeja encerrar o contrato de fornecimento de modelos da OpenAI ao Cursor. Propusemos um período de transição até 12 de novembro de 2026. Durante esse período, continuaríamos fornecendo ao Cursor acesso aos modelos da OpenAI que ele usa hoje. O Cursor pode optar por encerrar o acesso antes dessa data. Divulgaremos a data oficial de encerramento assim que ela for confirmada pelas duas empresas.

Para continuar usando os modelos da OpenAI no aplicativo Cursor, escolha a opção que melhor se adapta ao seu fluxo de trabalho:

  • Use sua própria chave de API da OpenAI — continue usando os modelos da OpenAI nos recursos locais de Chat e Agente do Cursor, com cobrança conforme os preços da API da OpenAI.

  • Use a extensão do Codex para IDE — use o Codex diretamente no Cursor com uma assinatura do ChatGPT ou uma chave de API da OpenAI.

  • Use um provedor de gateway de IA — conecte o Cursor aos modelos da OpenAI por meio de uma conta em um provedor compatível, como Amazon Bedrock, Azure ou outro gateway compatível com a OpenAI.

As orientações a seguir são gerais, e o Cursor pode alterar o funcionamento e a disponibilidade desses recursos ao longo do tempo. Consulte a documentação oficial do Cursor para obter as informações mais recentes. 

Essas opções abrangem o trabalho local no aplicativo do Cursor para desktop. O Cursor não oferece suporte à opção "Use sua própria chave" no Cursor Tab, no Auto, nos Agentes na nuvem ou em segundo plano, nas Automações, na CLI do Cursor nem na API e no SDK do Cursor. Esses recursos usam modelos fornecidos ou roteados pelo Cursor e não podem usar sua chave de API da OpenAI nem suas credenciais de gateway.

Use sua própria chave de API da OpenAI

O Cursor permite usar sua própria chave de API da OpenAI para acessar os modelos da OpenAI nos recursos locais de Chat e Agente. As solicitações são enviadas pela sua conta da API da OpenAI e cobradas separadamente da sua assinatura do Cursor ou do ChatGPT.

Para configurar sua chave:

  1. Crie uma chave de API da OpenAI. O acesso à API exige uma conta da API da OpenAI com o faturamento configurado.

  2. Abra as Configurações do Cursor e selecione Modelos.

  3. Encontre a configuração da chave de API da OpenAI, cole sua chave e salve ou verifique.

  4. Ative o modelo da OpenAI que você quer usar.

  5. Selecione esse modelo no Chat ou no Agente do Cursor.

Os modelos disponíveis e os limites de uso dependem da sua organização na API da OpenAI.

Sua chave de API da OpenAI se aplica apenas às solicitações locais compatíveis do Chat e do Agente. Ela não se aplica a:

  • Cursor Tab e preenchimento automático

  • Seleção e roteamento de modelos pelo Auto

  • Agentes na nuvem ou em segundo plano

  • Automações

  • CLI do Cursor

  • API ou SDK do Cursor

  • Modelos fornecidos pelo Cursor ou proprietários

Uma assinatura do ChatGPT não inclui o uso da API da OpenAI. Se você usar uma chave de API, o uso será cobrado pela sua conta da API da OpenAI.

Use a extensão do Codex para IDE no Cursor

A extensão do Codex para IDE permite usar o agente Codex diretamente no Cursor. Ela funciona como uma extensão separada e não depende da disponibilidade dos modelos da OpenAI no seletor de modelos do próprio Cursor.

Para começar:

  1. Instale a extensão do Codex para IDE no Cursor. Clique aqui (cursor:extension/openai.chatgpt)

  2. Abra o Codex pela Barra de atividades.

  3. Selecione Entrar com o ChatGPT para usar uma assinatura elegível do ChatGPT ou selecione Usar chave de API para usar uma conta da API da OpenAI.

  4. Abra seu projeto e inicie uma tarefa pelo painel do Codex.

Você pode mover o painel do Codex para o lado direito do editor usando os controles de layout do Cursor. Ative a Barra lateral secundária no menu Exibir → Aparência e arraste a visualização do Codex para ela.

A extensão do Codex oferece sua própria experiência de agente dentro do Cursor. Ela não altera o modelo usado pelo Chat, Agente, Tab, Auto, Agentes na nuvem ou outros serviços do Cursor. Consulte Autenticação do Codex para ver as formas de login disponíveis.

Use um provedor de gateway de IA

Você também pode conectar o Cursor aos modelos da OpenAI por meio de um gateway de IA ou provedor de hospedagem compatível. Isso pode ser útil se sua organização já gerencia o acesso aos modelos e o faturamento pelo Amazon Bedrock, pelo Azure ou por outro gateway.

O Cursor pode se conectar por meio de configurações específicas do provedor ou de uma URL base personalizada compatível com a OpenAI. Serviços como OpenRouter ou Vercel AI Gateway podem funcionar quando configurados com uma API compatível, mas os modelos e recursos disponíveis dependem do provedor.

A configuração exata varia, mas as etapas gerais são:

  1. Provisione o modelo da OpenAI no seu provedor.

  2. Crie as credenciais, o endpoint e o nome do modelo ou da implantação necessários.

  3. Abra as Configurações do Cursor e selecione Modelos.

  4. Escolha a integração do provedor ou configure os ajustes da API da OpenAI com a URL base personalizada do gateway.

  5. Insira o endpoint e as credenciais fornecidos pelo seu provedor.

  6. Adicione ou ative o modelo correspondente no Cursor.

  7. Teste o modelo em uma sessão local do Chat ou do Agente.

Para o Amazon Bedrock, consulte Use modelos da OpenAI com o Amazon Bedrock.

A compatibilidade varia conforme o gateway. Um endpoint personalizado precisa oferecer suporte ao formato de API esperado pelo Cursor, e alguns controles específicos de cada modelo podem não estar disponíveis ou não ser encaminhados por uma URL base personalizada. As credenciais de gateway também abrangem apenas as solicitações locais compatíveis do Chat e do Agente; elas não se aplicam ao Cursor Tab, ao Auto, aos Agentes na nuvem ou em segundo plano, às Automações, à CLI do Cursor nem à API e ao SDK do Cursor.

Este artigo foi útil?