Configuração do Cursor

Cursor é um editor de código com IA integrada que suporta provedores de API personalizados. Ao configurar o OfoxAI, você pode usar Claude, GPT-4o, Gemini e mais de 100 outros modelos no Cursor, sem precisar assinar cada serviço separadamente.

Pré-requisitos

Uma conta OfoxAI com uma API Key（Obtenha aqui ）
Cursor instalado（Download ）

O plano gratuito do Cursor suporta apenas o modo Auto e não permite usar modelos personalizados. Para configurar o OfoxAI é necessário assinar o Cursor Pro ou um plano superior.

Etapas de configuração

Etapa 1: Abrir as configurações de modelos

Clique no ícone de engrenagem no canto superior direito → Cursor Settings → selecione Models na barra lateral esquerda (marcado como ① na imagem abaixo).

Você também pode usar o atalho Cmd + , (macOS) / Ctrl + , (Windows/Linux) para abrir diretamente as configurações e depois alternar para a aba Models.

Etapa 2: Inserir a API Key e ativar o interruptor

Na página Models, encontre a seção OpenAI API Key. Primeiro ative o interruptor à direita (toggle ON), depois cole sua API Key do OfoxAI no campo de entrada (marcado como ② na imagem abaixo).

A API Key do OfoxAI pode ser inserida diretamente no campo OpenAI API Key do Cursor, pois o OfoxAI é totalmente compatível com o protocolo OpenAI.

Etapa 3: Inserir a Base URL e ativar o interruptor

Na mesma página, encontre a opção Override OpenAI Base URL. Primeiro ative o interruptor à direita (toggle ON), depois insira o endereço de API do OfoxAI (marcado como ③ na imagem abaixo).

Resumo das duas configurações:

Configuração	Valor
OpenAI API Key (interruptor ON)	Sua API Key do OfoxAI
Override OpenAI Base URL (interruptor ON)	`https://api.ofox.ai/v1`

Interface de configuração do Cursor Models

A Base URL na imagem acima é um endereço de exemplo. Por favor, insira o endereço do OfoxAI: https://api.ofox.ai/v1

Etapa 4: Adicionar modelos personalizados

Na seção Model Names, clique no campo Add or search model (marcado como ④ na imagem acima) e adicione os modelos que deseja usar:


anthropic/claude-sonnet-4.6
anthropic/claude-opus-4.6
openai/gpt-4o
openai/gpt-4o-mini
google/gemini-3.1-flash-lite-preview

Os nomes de modelos padrão do Cursor (como gpt-4o ou claude-3-5-sonnet) não funcionam com o OfoxAI. Use obrigatoriamente IDs de modelo no formato OfoxAI, como openai/gpt-4o ou anthropic/claude-sonnet-4.6.

Etapa 5: Verificar a configuração

Abra a janela de chat de IA (Cmd+L / Ctrl+L), desative o modo Auto, depois selecione um dos modelos recém-adicionados no menu suspenso e envie uma mensagem de teste:

Olá, por favor se apresente.

Se receber uma resposta normal, a configuração foi bem-sucedida.

Modelos recomendados

ID do modelo	Caso de uso
`anthropic/claude-sonnet-4.6`	Geração e refatoração de código, capacidades abrangentes
`anthropic/claude-opus-4.6`	Análise de arquitetura complexa, desempenho de ponta
`openai/gpt-4o`	Assistente de programação de uso geral
`openai/gpt-4o-mini`	Completação rápida, baixo custo
`google/gemini-3.1-flash-lite-preview`	Uso frequente, resposta rápida

Consulte o Catálogo de Modelos para ver a lista completa.

Perguntas frequentes

P: Ao clicar em Verify aparece “Invalid API Key”

Verifique os seguintes pontos:

A API Key foi copiada completamente do Console do OfoxAI ? (Atenção a espaços no início ou no final)
A Base URL está corretamente configurada como https://api.ofox.ai/v1? (Sem barra ao final)
Os dois interruptores de OpenAI API Key e Override OpenAI Base URL estão ambos ativados?

P: Os modelos adicionados não aparecem no painel de chat

Desative o modo Auto no painel de chat para ver os modelos personalizados na lista suspensa.

P: Erro “The model does not work with your current plan”

Este erro indica que seu plano atual do Cursor não suporta modelos personalizados. Você precisa fazer upgrade para o plano Cursor Pro para usar provedores de API personalizados.

P: O autocompletar de código não funciona, apenas o chat está disponível

O autocompletar inline do Cursor (autocompletar por Tab) usa os modelos próprios do Cursor por padrão. Modelos personalizados são usados principalmente para AI Chat (Cmd+L) e Composer (Cmd+I).