Pular para o conteúdo principal
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.
  • Você concluiu Obter API Key.
  • O OpenCode está instalado e opencode --version funciona.
  • A janela Use key está aberta para a API Key que você quer usar.
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.

​
Instalar

Se o OpenCode não estiver instalado, consulte as instruções mais recentes na documentação do OpenCode. macOS ou Linux: 
curl -fsSL https://opencode.ai/install | bash
Se você usa npm para CLIs globais: 
npm install -g opencode-ai
Depois da instalação, reabra o terminal e verifique: 
opencode --version

​
Copiar configuração do painel

1

Abrir API Keys

Abra o painel e vá para API Keys.
2

Escolher OpenCode

Encontre a chave que será usada no OpenCode, clique em Use key e escolha OpenCode.
3

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

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.

​
Caminhos de configuração

EscopoCaminhoUso
Configuração global~/.config/opencode/opencode.jsonUsar 4096bytes por padrão em todos os projetos.
Configuração do projetoopencode.jsonUsar 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: 
opencode
Depois que o OpenCode abrir, comece com um prompt de baixo risco: 
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

Verifique se opencode.json é JSON válido. Confirme que apiKey não tem caracteres faltando, quebras de linha ou espaços extras.
O ID do modelo deve corresponder ao nome exibido no painel. Não copie nomes de capturas de outros usuários.
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.
Sim, mas /connect apenas armazena credenciais. Provider, Base URL e lista de modelos ainda devem vir do opencode.json gerado pelo painel.