> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Configure um modelo 4096bytes personalizado no Cursor

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.

<Warning>
  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.
</Warning>

## Pré-requisitos

* Você concluiu [Criar conta](/pt-BR/quickstart/create-account).
* Você concluiu [Obter API Key](/pt-BR/quickstart/get-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](https://cursor.com/downloads) e escolha o pacote para macOS, Windows ou Linux.

<Steps>
  <Step title="Baixar o instalador">
    Escolha o pacote correto para sua máquina. No macOS, diferencie Apple Silicon de Intel. No Windows, diferencie x64 de ARM64.
  </Step>

  <Step title="Iniciar Cursor">
    Abra o Cursor uma vez após a instalação e confirme que o editor inicia normalmente.
  </Step>

  <Step title="Abrir configurações">
    Abra **Settings** e confirme que você vê configurações de modelo, IA ou Provider antes de continuar.
  </Step>
</Steps>

## Abrir configurações de modelo

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Preencher campos de conexão

| Campo no Cursor                        | Valor                                    |
| -------------------------------------- | ---------------------------------------- |
| `OpenAI API Key`, `API Key`            | A API Key criada no painel do 4096bytes. |
| `Override OpenAI Base URL`, `Base URL` | `https://api.4096bytes.com`.             |
| `Model name`, `Custom model`           | O nome do modelo exibido no painel.      |

Use apenas o Base URL raiz. Não adicione `/v1/chat/completions`, `/v1/responses` ou outro caminho completo.

<Warning>
  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.
</Warning>

## Adicionar o nome do modelo

<Steps>
  <Step title="Adicionar modelo personalizado">
    Clique em **Add model**, **Add custom model** ou ação semelhante na lista de modelos do Cursor.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Salvar configurações">
    Salve API Key, Base URL e nome do modelo. Se Cursor oferecer **Verify** ou um botão de teste, execute.
  </Step>
</Steps>

## 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:

```text theme={null}
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

<AccordionGroup>
  <Accordion title="O novo modelo não aparece">
    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.
  </Accordion>

  <Accordion title="model not found">
    Copie novamente o nome do modelo no painel e verifique espaços extras, maiúsculas incorretas ou sufixos de versão ausentes.
  </Accordion>

  <Accordion title="Falha de autenticação">
    Confira se a API Key está completa. Certifique-se de não ter colado uma chave antiga, excluída ou com quebra de linha.
  </Accordion>

  <Accordion title="Endereço de requisição errado">
    Use `https://api.4096bytes.com` como Base URL. Não informe caminho completo de endpoint nem copie formato de outro cliente.
  </Accordion>

  <Accordion title="Cursor ainda usa modelos oficiais">
    Escolha manualmente o modelo 4096bytes no Chat ou Agent. API Keys personalizadas podem não afetar todos os recursos internos do Cursor.
  </Accordion>

  <Accordion title="As requisições falham mesmo com configuração correta">
    Verifique saldo da conta, limites da chave, disponibilidade do modelo no grupo atual e acesso de rede a `https://api.4096bytes.com`.
  </Accordion>
</AccordionGroup>