🚀 Integrando o Cursor com Modelos Personalizados CodingPlanX

Introdução: O Cursor é um editor de código alimentado por IA profundamente amado pelos desenvolvedores, apresentando poderosos recursos integrados de Grandes Modelos de Linguagem (LLM). No entanto, devido a restrições de rede, controle de custos (usando APIs de proxy de terceiros ou modelos mais baratos como DeepSeek) ou necessidades de implantação em intranet corporativa, frequentemente precisamos configurar uma URL de API e uma Chave de API personalizadas.

Este tutorial irá guiá-lo passo a passo sobre como concluir facilmente essa configuração.

---

📋 Pré-requisitos

Antes de começar, certifique-se de ter as seguintes informações prontas:

1. Cursor Instalado: Certifique-se de que seu Cursor esteja atualizado para a versão mais recente.
2. API Key: ex: sk-xxxxxxxxxxxxxxxxxxxxxxxx.
3. Base URL: Seu endereço de proxy de API personalizado.
   • Nota: Geralmente precisa terminar com /v1, por exemplo, https://api.codingplanx.ai/v1.
4. Nome do Modelo: O nome padrão do modelo que você pretende usar (ex: gpt-4o, claude-3-5-sonnet, deepseek-chat, etc.).

---

⚙️ Passos Detalhados de Configuração

Passo 1: Abrir Configurações do Cursor

1. Inicie o editor Cursor.
2. Clique no ícone de Engrenagem ⚙️ no canto superior direito ou use o atalho para abrir as configurações:
   • Windows / Linux: Ctrl + ,
   • macOS: Cmd + ,

Passo 2: Vá para a Página de Configuração de Modelos

Na barra de navegação esquerda do painel de configurações, encontre e clique na guia Models.

Passo 3: Configurar a Chave de API (API Key)

1. Role a página Models para baixo até encontrar a seção OpenAI API Key.
2. Cole sua API Key personalizada na caixa de entrada.
3. Clique no botão Verify (Verificar) à direita. (Se a verificação falhar neste momento, não se preocupe, pois ainda não configuramos a URL).
4. ⚠️ Nota Importante: Certifique-se de que a guia oficial Cursor Tab e outras opções de assinatura paga acima estejam no estado apropriado (se você estiver usando uma API de terceiros gratuita, é recomendável desativar as opções de modelos oficiais).

Passo 4: Configurar a Base URL (Substituir Endpoint Padrão)

Este é o passo mais crucial, pois determina para onde suas requisições são enviadas:

1. Abaixo da caixa de entrada OpenAI API Key, encontre a opção Override OpenAI Base URL.
2. Expanda esta opção e insira o endereço da sua interface personalizada na caixa.

   💡 Formato de Exemplo:

   • CodingplanX AI: https://api.codingplanx.ai/v1

3. Após preencher, você deve pressionar a tecla Enter para salvar as configurações.

Passo 5: Adicionar Nomes de Modelos Personalizados (Opcional, mas Recomendado)

Se o modelo que você está usando não estiver na lista padrão do Cursor (ex: deepseek-coder), você precisará adicioná-lo manualmente:

1. Role até o topo da página Models e encontre a seção Model Names.
2. Clique em + Add Model.
3. Digite o nome do seu modelo com precisão (ex: deepseek-chat) e pressione Enter para confirmar.
4. Ative a chave ao lado do modelo que você acabou de adicionar, e é recomendável desativar outros modelos que você não usa para evitar selecionar o errado.

---

✅ Teste e Verificação

Após a configuração, precisamos testar se funciona:

1. Retorne à interface de edição de código.
2. Pressione Ctrl + L (Windows) ou Cmd + L (macOS) para abrir a janela de Chat à direita.
3. Na parte inferior da janela de chat, clique no nome do modelo exibido atualmente e mude para o modelo que você acabou de configurar (ex: gpt-4o ou deepseek-chat).
4. Envie uma saudação simples, por exemplo: "Quem é você? Por favor, diga-me a versão do seu modelo."
5. Se a IA responder normalmente e rapidamente, parabéns, a configuração foi bem-sucedida! 🎉

---

❓ FAQ e Solução de Problemas

---

📝 Conclusão: Dominar a configuração de API personalizada não apenas reduz significativamente o custo do uso de programação assistida por IA, mas também permite que você alterne livremente entre vários LLMs de ponta. Se você achou este tutorial útil, sinta-se à vontade para compartilhá-lo com seus amigos desenvolvedores!