OpenCode

Instale o cliente

OpenCode 1.19.5 foi testado com duas solicitações, streaming e um ciclo de ferramenta/resultado do cliente usando uma resposta local sintética. Isso comprova cliente/protocolo, não fornecedor real nem cobrança de produção. Instale esta versão pelo pacote npm oficial e revise mudanças antes de atualizar.

npm install -g opencode-ai@1.19.5
opencode --version

Antes de começar

Abra um terminal novo, configure uma chave com escopos e consulte os modelos disponíveis para sua conta antes de usar o cliente. A configuração compartilhada inclui comandos Bash e PowerShell.

• Credenciais e consulta de modelos

Configure o provedor

Mescle o bloco gerado no opencode.json existente, preservando os demais provedores. A configuração lê a chave do ambiente, não do arquivo do projeto. Selecione notholy/MODEL_ID usando /models.

• Documentação OpenCode

Confira os limites do cliente

Use @ai-sdk/openai-compatible para Chat Completions. As ferramentas são executadas na sua máquina sob as permissões do OpenCode. Compatibilidade de API não autoriza comandos. Comece em um repositório descartável e valide uma solicitação curta antes de habilitar ferramentas.

Configuração do cliente

Selecione um modelo publicado para gerar a configuração. Confirme o acesso da sua conta com GET /v1/models antes de enviar uma solicitação.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "notholy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NotHoly",
      "options": {
        "baseURL": "https://api.notholy.com/v1",
        "apiKey": "{env:NOTHOLY_API_KEY}"
      },
      "models": {
        "notholy-pulse": {
          "name": "NotHoly Pulse Flash",
          "limit": {
            "context": 1048576,
            "output": 131072
          }
        }
      }
    }
  },
  "model": "notholy/notholy-pulse"
}

Referência de configuração: um exemplo gerado não certifica o cliente completo. Confira os limites acima. Mantenha chaves de API no ambiente privado.