Pular para o conteúdo principal
Cursor pode conectar ao 4096bytes por configurações compatíveis com OpenAI. Depois da configuração, você pode selecionar um modelo 4096bytes no Cursor Chat ou Agent.
API Keys personalizadas no Cursor normalmente afetam apenas o modelo selecionado no Chat ou Agent. Cursor Tab, completamento, indexação e tarefas em segundo plano ainda podem usar serviços do Cursor. O escopo exato depende da versão do Cursor.

​
Pré-requisitos

  • Você concluiu Criar conta.
  • Você concluiu Obter API Key.
  • Cursor está instalado e Settings abre normalmente.
  • Você tem a API Key, Base URL e nome do modelo do 4096bytes.
Crie uma API Key dedicada para Cursor, como cursor-desktop ou cursor-work.

​
Instalar

Se Cursor não estiver instalado, abra a página de download do Cursor e escolha o pacote para macOS, Windows ou Linux.
1

Baixar o instalador

Escolha o pacote correto para sua máquina. No macOS, diferencie Apple Silicon de Intel. No Windows, diferencie x64 de ARM64.
2

Iniciar Cursor

Abra o Cursor uma vez após a instalação e confirme que o editor inicia normalmente.
3

Abrir configurações

Abra Settings e confirme que você vê configurações de modelo, IA ou Provider antes de continuar.

​
Abrir configurações de modelo

1

Abrir configurações do Cursor

Abra Settings no Cursor. Entradas comuns são o ícone de engrenagem no canto inferior esquerdo, Cursor Settings na paleta de comandos ou Cursor > Settings no menu.
2

Abrir a página de modelos

Abra Models, AI ou uma página relacionada a Providers. Encontre OpenAI API Key, API personalizada ou Override Base URL.
3

Ativar configurações compatíveis com OpenAI

Se houver um controle, ative OpenAI API Key ou configurações personalizadas de OpenAI. Preencha 4096bytes como Provider compatível com OpenAI.

​
Preencher campos de conexão

Campo no CursorValor
OpenAI API Key, API KeyA API Key criada no painel do 4096bytes.
Override OpenAI Base URL, Base URLhttps://api.4096bytes.com.
Model name, Custom modelO nome do modelo exibido no painel.
Use apenas o Base URL raiz. Não adicione /v1/chat/completions, /v1/responses ou outro caminho completo.
A API Key fica salva nas configurações locais do Cursor. Não configure uma chave pessoal em computadores compartilhados e não compartilhe capturas que exponham a chave.

​
Adicionar o nome do modelo

1

Adicionar modelo personalizado

Clique em Add model, Add custom model ou ação semelhante na lista de modelos do Cursor.
2

Informar o nome do modelo

Digite o nome do modelo exibido no painel. Ele deve corresponder exatamente, incluindo maiúsculas, hifens e números de versão.
3

Salvar configurações

Salve API Key, Base URL e nome do modelo. Se Cursor oferecer Verify ou um botão de teste, execute.

​
Selecionar e testar o modelo

Depois de salvar, abra Cursor Chat ou Agent e escolha o modelo 4096bytes no seletor. Use um prompt de baixo risco: 
Descreva a finalidade do projeto atual em uma frase. Não modifique arquivos.
Se o modelo responder, Cursor consegue enviar requisições pelo 4096bytes.

​
Sugestões

  • Use uma API Key dedicada para Cursor.
  • Comece com um prompt curto para confirmar modelo, chave e Base URL.
  • Se houver vários Providers, confira o modelo selecionado antes de enviar.
  • Em equipes, use chaves separadas por pessoa ou dispositivo para diagnosticar uso.

​
Diagnóstico

Confirme que o modelo foi adicionado à lista e reinicie o Cursor. Algumas versões atualizam o seletor somente depois de reabrir o painel de Chat.
Copie novamente o nome do modelo no painel e verifique espaços extras, maiúsculas incorretas ou sufixos de versão ausentes.
Confira se a API Key está completa. Certifique-se de não ter colado uma chave antiga, excluída ou com quebra de linha.
Use https://api.4096bytes.com como Base URL. Não informe caminho completo de endpoint nem copie formato de outro cliente.
Escolha manualmente o modelo 4096bytes no Chat ou Agent. API Keys personalizadas podem não afetar todos os recursos internos do Cursor.
Verifique saldo da conta, limites da chave, disponibilidade do modelo no grupo atual e acesso de rede a https://api.4096bytes.com.