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

# OpenCode

> Configure o 4096bytes no OpenCode

O OpenCode pode conectar ao 4096bytes por meio de um Provider compatível com OpenAI. Grave a configuração `opencode.json` gerada pelo painel em um arquivo de configuração do OpenCode.

Prefira copiar a configuração pela janela **Use key** do painel. A aba OpenCode inclui a API Key, o Base URL e os nomes de modelo atuais no formato do OpenCode.

## Pré-requisitos

* Você concluiu [Criar conta](/pt-BR/quickstart/create-account).
* Você concluiu [Obter API Key](/pt-BR/quickstart/get-api-key).
* O OpenCode está instalado e `opencode --version` funciona.
* A janela **Use key** está aberta para a API Key que você quer usar.

<Warning>
  A API Key em `opencode.json` fica salva localmente em texto simples. Não envie arquivos de configuração, capturas de tela ou saída do terminal que contenham a API Key completa.
</Warning>

## Instalar

Se o OpenCode não estiver instalado, consulte as instruções mais recentes na [documentação do OpenCode](https://opencode.ai/docs).

macOS ou Linux:

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
```

Se você usa npm para CLIs globais:

```bash theme={null}
npm install -g opencode-ai
```

Depois da instalação, reabra o terminal e verifique:

```bash theme={null}
opencode --version
```

## Copiar configuração do painel

<Steps>
  <Step title="Abrir API Keys">
    Abra o painel e vá para **API Keys**.
  </Step>

  <Step title="Escolher OpenCode">
    Encontre a chave que será usada no OpenCode, clique em **Use key** e escolha **OpenCode**.
  </Step>

  <Step title="Copiar configuração">
    Copie o conteúdo `opencode.json` gerado. O exemplo serve apenas como referência. Use o Base URL, a API Key e os nomes de modelo exibidos no seu painel.
  </Step>

  <Step title="Gravar o arquivo de configuração">
    Para uso global, grave em `~/.config/opencode/opencode.json`. Para uso apenas no projeto, grave `opencode.json` na raiz do projeto.
  </Step>
</Steps>

## Caminhos de configuração

| Escopo                  | Caminho                            | Uso                                             |
| ----------------------- | ---------------------------------- | ----------------------------------------------- |
| Configuração global     | `~/.config/opencode/opencode.json` | Usar 4096bytes por padrão em todos os projetos. |
| Configuração do projeto | `opencode.json`                    | Usar esta configuração apenas no projeto atual. |

Crie o arquivo manualmente se ele não existir. A configuração do projeto tem prioridade maior que a configuração global.

## Verificar

Salve a configuração, entre no diretório de um projeto e execute:

```bash theme={null}
opencode
```

Depois que o OpenCode abrir, comece com um prompt de baixo risco:

```text theme={null}
Descreva em uma frase a finalidade do diretório atual. Não modifique arquivos.
```

Se o OpenCode responder sem erro de autenticação ou de modelo, a configuração está ativa.

## Problemas comuns

<AccordionGroup>
  <Accordion title="OpenCode mostra falha de autenticação">
    Verifique se `opencode.json` é JSON válido. Confirme que `apiKey` não tem caracteres faltando, quebras de linha ou espaços extras.
  </Accordion>

  <Accordion title="OpenCode não encontra o modelo">
    O ID do modelo deve corresponder ao nome exibido no painel. Não copie nomes de capturas de outros usuários.
  </Accordion>

  <Accordion title="A configuração não entra em vigor">
    Confirme que você editou o arquivo que o OpenCode está lendo. Um `opencode.json` na raiz do projeto sobrescreve campos equivalentes da configuração global.
  </Accordion>

  <Accordion title="Posso configurar a API Key com /connect?">
    Sim, mas `/connect` apenas armazena credenciais. Provider, Base URL e lista de modelos ainda devem vir do `opencode.json` gerado pelo painel.
  </Accordion>
</AccordionGroup>