Tutorial de configuração do OpenCode: integração com a API do NextHub

O OpenCode é uma ferramenta de programação com IA em terminal que suporta integração com múltiplos modelos. Abaixo, veja como conectar o canal Claude do NextHub.

Etapas de integração

1. Instale o OpenCode

Certifique-se de que o Node.js está instalado e, em seguida, instale o OpenCode globalmente:

npm i -g opencode-ai

Após a instalação, execute-o uma vez para que ele gere a pasta de configuração padrão:

opencode

2. Abra a pasta de configuração do OpenCode

Windows (CMD)

start "" "%USERPROFILE%\.config\opencode"

macOS (Terminal)

open "$HOME/.config/opencode"

3. Edite o opencode.json — preencha a configuração do Claude

Localize opencode.json na pasta de configuração (crie-o se não existir) e, seguindo o schema oficial do OpenCode, preencha sua ApiKey e o endereço de integração do NextHub em provider.anthropic.options:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sua ApiKey do NextHub",
        "baseURL": "https://api.nexthub.cc"
      }
    }
  }
}

A Base URL não deve incluir /v1

O OpenCode anexa /v1/messages automaticamente após a baseURL, portanto basta informar o domínio puro https://api.nexthub.cc, sem adicionar /v1 no final.

4. Verifique se a configuração foi bem-sucedida

Execute o opencode, digite o comando /models e, se os modelos Claude aparecerem na lista, a configuração foi bem-sucedida:

opencode
# execute após entrar na interface interativa
# /models

Também é possível conectar o canal GPT

Acrescente o provedor openai ao mesmo opencode.json para usar os modelos da série GPT / Codex:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sua ApiKey do NextHub",
        "baseURL": "https://api.nexthub.cc"
      }
    },
    "openai": {
      "options": {
        "apiKey": "sua ApiKey do NextHub",
        "baseURL": "https://api.nexthub.cc/v1"
      }
    }
  }
}

Os dois endereços seguem critérios diferentes

O anthropic usa o protocolo Anthropic, portanto a baseURL recebe o domínio puro https://api.nexthub.cc (com /v1/messages anexado automaticamente); o openai usa o protocolo compatível com a OpenAI, portanto a baseURL precisa incluir /v1. As duas ApiKeys devem escolher os grupos correspondentes (grupo da linha Claude e grupo GPT-Azure / GPT-Pro), mas você também pode usar a mesma chave; como o grupo determina os modelos disponíveis, configurá-las separadamente costuma ser mais claro.