Como configurar o cursor do gate.ai no Cursor

Gate.AI compatível com a forma de integração OpenAI permite que os desenvolvedores conectem o Cursor ao Gate.AI usando a chave API do Gate.AI, a URL base compatível com OpenAI e o ID de modelo suportado, até junho de 2026. Para desenvolvedores que desejam enviar solicitações de modelos no Cursor Chat, Composer, Agent ou interfaces de código semelhantes através do Gate.AI, em vez do provedor de modelos padrão, essa configuração é especialmente importante. Este guia cobre apenas o processo de configuração do Cursor; para um entendimento mais amplo sobre integração de API, consulte o Guia de Integração da API do Gate.AI.

Pré-requisitos

• Cursor instalado.
• Chave API do Gate.AI disponível.

Conteúdo baseado na documentação oficial do Gate.AI e nas capturas de tela de configuração do Cursor fornecidas, até junho de 2026.

O que você pode fazer após concluir este guia?

Após configurar o Gate.AI no Cursor, você poderá adicionar o Gate.AI como uma rota de modelo personalizada no Cursor, inserindo sua chave API do Gate.AI e a URL base compatível com OpenAI, selecionando modelos como deepseek/deepseek-v3.2, e usando esse modelo na interface de chat ou do agente do Cursor.

Este guia cobre apenas a configuração na interface do Cursor. Não inclui integração via SDK, configuração do Claude Code, Claude Desktop ou permissões empresariais.

Passo 1: Abrir configurações do Cursor

Este passo abrirá a área de configuração do Cursor, onde você gerencia modelos e configurações de API.

Ação: No Cursor, vá ao canto superior direito e clique no ícone de configurações. A rota de entrada do Cursor descrita na documentação oficial do Gate.AI é Menu superior direito → Configurações.

Antes de alterar a configuração do modelo, acesse as configurações do Cursor pelo menu superior direito.

Passo 2: Abrir configurações de modelos

Este passo acessa a página de configuração de modelos do Cursor.

Ação: Dentro das configurações do Cursor, na barra lateral esquerda, selecione Modelos. Se a lista completa de modelos não estiver visível, escolha Ver todos os modelos. Segundo a documentação oficial do Gate.AI, o caminho para adicionar modelos personalizados no Cursor é Modelos → Ver todos os modelos.

Gerencie modelos embutidos, modelos personalizados e configurações de API na aba de modelos.

Passo 3: Clicar em adicionar modelo personalizado

Este passo cria uma nova entrada de modelo personalizado para o Gate.AI.

Ação: Role até o final da lista de modelos e clique em Adicionar modelo personalizado. A documentação oficial do Gate.AI indica que o caminho de configuração do Cursor deve rolar até o final e selecionar Adicionar modelo personalizado.

Após adicionar o modelo personalizado, será exibido um campo para inserir o ID do modelo do Gate.AI.

Passo 4: Inserir o ID do modelo do Gate.AI

Este passo informa ao Cursor qual modelo suportado pelo Gate.AI deve processar as solicitações.

Ação: No Cursor, insira o ID do modelo do Gate.AI e clique em Adicionar. Use o formato provider/nome-do-modelo, por exemplo, deepseek/deepseek-v3.2. Segundo a documentação do Gate.AI, o ID do modelo deve ser obtido na loja de modelos e não deve usar auto na configuração.

De acordo com a documentação oficial do Gate.AI (até junho de 2026), o ID do modelo deve seguir o formato provider/nome-do-modelo, sendo deepseek/deepseek-v3.2 um exemplo de ID suportado.

Passo 5: Inserir a chave API do Gate.AI e a URL base

Este passo conecta o campo de API compatível com OpenAI do Cursor ao Gate.AI.

Ação: Na seção Chave API, ative a opção Chave API do OpenAI e cole sua chave API do Gate.AI. Depois, ative Sobrescrever URL base do OpenAI e insira:

[URL base compatível com OpenAI do Gate.AI]

A documentação oficial do Gate.AI lista essa URL como compatível com OpenAI e reforça que o caminho correto da API é /openai/v1, não apenas /v1.

Insira no Cursor o ID do modelo do Gate.AI, a chave API e a URL base.

Passo 6: Selecionar o modelo do Gate.AI no Cursor Chat

Este passo garante que o Cursor possa usar o modelo do Gate.AI na troca de mensagens de código.

Ação: Feche as configurações do Cursor, abra o Cursor Chat, Composer, Agent ou outra interface de diálogo, e no seletor de modelos, escolha o modelo que você adicionou. Segundo a documentação oficial do Gate.AI, o modelo adicionado estará disponível para seleção em Chat, Composer, Agent e outras interfaces de diálogo.

Você deve ver o nome do modelo configurado, como deepseek/deepseek-v3.2, no seletor de modelos.

Após configurar, selecione o modelo do Gate.AI no seletor de modelos do Cursor e envie comandos.

Quais valores devem ser inseridos na configuração do gate.ai no Cursor?

| Campo do Cursor | Valor de entrada | Regras de configuração | | --------------------------- | -------------------------------------------------------------- | ------------------------------------------------- | | ID do modelo personalizado | Exemplo: deepseek/deepseek-v3.2 | Use o formato provider/nome-do-modelo, não auto. | | Chave API do OpenAI | Sua chave API do Gate.AI | Confirme que a chave está válida e copiada corretamente. | | URL base do OpenAI | [URL base do Gate.AI] | Use /openai/v1, não apenas /v1. | | Seletor de modelos | O modelo que você adicionou | Selecione antes de testar comandos. |

O ID do modelo e a URL base são os campos mais críticos na configuração do gate.ai no Cursor. Se o Cursor aceitar a chave, mas não roteá-la, verifique primeiro o formato do ID do modelo e a URL base, antes de alterar outras configurações.

O que fazer se o Gate.AI não funcionar no Cursor? Lista de verificação de problemas

• Situação: Cursor mostra erro 401 ou falha na conexão.

  • Causa: Chave API do Gate.AI inválida, expirada, revogada, desativada, copiada incorretamente ou saldo insuficiente.
  • Solução: Verifique o status da chave API do Gate.AI, copie novamente a chave, confirme saldo suficiente na conta. A documentação oficial do Gate.AI indica que chaves inválidas ou saldo insuficiente são causas comuns de falha na autenticação ou solicitação.

• Situação: Cursor indica que o modelo não está disponível ou não foi encontrado.

  • Causa: Erro de digitação no ID do modelo, uso de formato incorreto ou valor auto.
  • Solução: Copie o ID exato do modelo na lista do Gate.AI e use um ID específico, como deepseek/deepseek-v3.2.

• Situação: Cursor retorna erro de caminho de API desconhecido ou 404.

  • Causa: URL base inserida incorretamente.
  • Solução: Substitua pelo valor correto, como /openai/v1.

• Situação: Modelo personalizado não aparece no Cursor Chat.

  • Causa: Configuração do Cursor não salva ou a lista de modelos não foi atualizada.
  • Solução: Salve as configurações, feche e reinicie o Cursor, e verifique novamente o seletor de modelos.

• Situação: Um modelo funciona, outro não.

  • Causa: O ID do modelo não corresponde exatamente ao do Gate.AI ou há restrições na conta ou na política de risco.
  • Solução: Confirme o formato do ID na documentação do Gate.AI e verifique se há restrições na conta ou na política de risco que possam limitar o uso de certos modelos.

Próximos passos: o que mais pode ser configurado ou desenvolvido?

Para integrações mais amplas de desenvolvedor, consulte o Guia de Integração da API do Gate.AI. Este guia explica detalhadamente o papel da API do Gate.AI na integração compatível com OpenAI.

Para referências de configuração oficial, utilize a documentação do Gate.AI. Para seleção de modelos, consulte a lista de modelos do Gate.AI. Se houver questões de orçamento ou uso, revise os preços do Gate.AI antes de usar em produção.

Perguntas frequentes

Posso usar auto como ID de modelo no Cursor?

Não. A documentação do Gate.AI indica que o configuração do Cursor deve usar um ID de modelo específico do mercado, não auto.

** Qual URL base do Gate.AI devo inserir no Cursor?**

Use /openai/v1. A documentação oficial do Gate.AI reforça que o caminho compatível com OpenAI é /openai/v1, não apenas /v1.

** Onde escolho o modelo do Gate.AI após a configuração?**

Abra o Cursor Chat, Composer, Agent ou outra interface de diálogo, e no seletor de modelos do Cursor, escolha o modelo que você adicionou.

** Por que a chave API funciona em outro lugar, mas não no Cursor?**

Possivelmente, o Cursor está usando uma entrada de modelo não salva, URL base incorreta ou ID de modelo errado. Verifique novamente o ID do modelo, a chave API, o switch de API e o switch de URL base, além do seletor de modelos.