OpenCode

O OpenCode já oferece suporte às principais famílias de modelos, como GPT, Claude, DeepSeek, Gemini e Qwen. Para cenários de uso do OpenCode, recomendamos os seguintes modelos:

coding-minimax-m2.1-free
coding-glm-4.7-free
claude-sonnet-4-5
gpt-5
gpt-5-codex

Este documento explica como instalar, configurar e iniciar o OpenCode em diferentes sistemas operacionais e como integrar a API da AIHubMix.

Antes de instalar, verifique se o seu sistema atende aos seguintes requisitos:

Node.js ≥ 18.0.0
Gerenciadores de pacotes opcionais para o seu sistema operacional:
- macOS / Linux: brew
- Arch Linux: paru
- Windows: choco, winget ou scoop

1. Instalar o OpenCode

Escolha qualquer um dos métodos de instalação abaixo, de acordo com o seu sistema operacional e as ferramentas que você usa.

1. Instalar via Node.js

# Instalação rápida com script CURL
curl -fsSL https://opencode.ai/install | bash

# Usando NPM
npm install -g opencode-ai

# Usando Bun
bun install -g opencode-ai

# Usando PNPM
pnpm install -g opencode-ai

# Usando Yarn
yarn global add opencode-ai

2. Instalar via Homebrew (macOS / Linux)

brew install sst/tap/opencode

3. Instalar via Paru (Arch Linux)

paru -S opencode-bin

4. Instalação no Windows

# Chocolatey
choco install opencode

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# Ou instale via NPM (requer Node.js)
# Observação: são necessárias permissões de administrador
npm install -g opencode-ai

Após a instalação, siga os passos abaixo para concluir a autenticação e a configuração. Execute o seguinte comando no terminal:

opencode auth login

2. Selecionar o provedor de modelos

Na tela de login, selecione AiHubMix como provedor de modelos.

3. Autorização com a chave de API

Informe a sua chave de API da AiHubMix na página de login do OpenCode para concluir a autorização.

3. Usar os modelos

1. Verificação da instalação

Execute o comando a seguir para verificar se o OpenCode foi instalado e configurado corretamente:

opencode

2. Selecionar um modelo

Digite /models, pesquise por aihubmix e selecione o modelo desejado.

4. Usar a AiHubMix no aplicativo desktop do OpenCode

Baixe o aplicativo desktop do OpenCode: https://opencode.ai/download .
Abra o OpenCode e siga os passos: /model → Connect provider → pesquise por aihubmix → informe a sua chave de API → Submit.
No painel de seleção de modelos, pesquise por aihubmix e escolha o modelo que deseja usar.

5. Configurar e atualizar modelos manualmente

Este exemplo adiciona o DeepSeek V4 Pro.

Passo 1: Confirmar o ID do modelo

Localize o modelo desejado na página de modelos da AIHubMix e copie o ID. Você também pode consultá-lo diretamente pela API:

curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | python3 -m json.tool | grep "id"

Passo 2: Abrir o arquivo de configuração

Execute no terminal o comando correspondente ao seu sistema: Mac

mkdir -p ~/.config/opencode && open -a TextEdit ~/.config/opencode/opencode.json

Linux

mkdir -p ~/.config/opencode && nano ~/.config/opencode/opencode.json

Windows (executar no PowerShell)

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

Ao abrir o arquivo, você verá um arquivo vazio ou um conteúdo JSON já existente.

Passo 3: Escrever a configuração

Se o arquivo estiver vazio, cole diretamente o conteúdo abaixo:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek-V4-Pro",
          "contextLength": 131072,
          "type": "language"
        }
      }
    }
  }
}

Se o arquivo já tiver conteúdo, basta acrescentar o novo modelo dentro de "models", separando cada modelo por vírgula:

"models": {
  "deepseek-v4-pro": {
    "name": "DeepSeek-V4-Pro",
    "contextLength": 131072,
    "type": "language"
  },
  "deepseek-v4-flash-think": {
    "name": "DeepSeek-V4-Flash-Think",
    "contextLength": 131072,
    "type": "language"
  }
}

Observação: não coloque vírgula depois do último modelo, caso contrário o formato do arquivo ficará inválido.

Salve o arquivo: Command + S no Mac, Ctrl + S no Windows. Descrição dos campos:

Campo	Descrição
`name`	ID do modelo
`contextLength`	Comprimento do contexto (em tokens)
`type`	Tipo de modelo; para conversa de texto, use `"language"`

Passo 4: Reiniciar o OpenCode

Depois de salvar o arquivo de configuração, feche o OpenCode por completo e inicie-o novamente para que o novo modelo seja carregado.

Passo 5: Verificar

Abra o seletor de modelos (atalho padrão ;), pesquise por V4 ou DeepSeek e confirme que DeepSeek-V4-Pro aparece na lista.

URL base personalizada

Por padrão, o OpenCode envia as requisições da AIHubMix para https://aihubmix.com/v1. Se você precisar que as requisições passem por um gateway próprio, um proxy corporativo ou um nó de aceleração, é possível sobrescrever esse endereço por meio de options.baseURL, sem precisar modificar o código-fonte do OpenCode nem reinstalá-lo.

Passo 1: Abrir o arquivo de configuração

Abra ~/.config/opencode/opencode.json conforme descrito na seção 5 (no Windows, %USERPROFILE%\.config\opencode\opencode.json).

Passo 2: Adicionar `options.baseURL`

Adicione options.baseURL no provider aihubmix. Basta incluir esse único campo: o OpenCode faz automaticamente um merge profundo com a configuração interna, então não é necessário reescrever o provider inteiro:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "options": {
        "baseURL": "https://api.inferera.com"
      }
    }
  }
}

Observação: o baseURL só precisa ser informado no nível do domínio (por exemplo, https://api.inferera.com). Caminhos como /v1 e /chat/completions são acrescentados automaticamente pelo SDK. Não adicione /v1 manualmente (por exemplo, https://api.inferera.com/v1), pois o resultado seria /v1/v1/ e retornaria 404.

Passo 3: Reiniciar e verificar

Feche o OpenCode por completo e inicie-o novamente. Você pode executar o comando abaixo para confirmar que a configuração entrou em vigor:

opencode debug config

Na saída, o endereço informado deve aparecer em provider.aihubmix.options.baseURL; a partir daí, todas as requisições de modelo serão enviadas para esse endereço. Descrição dos campos:

Campo	Descrição
`options.baseURL`	Endereço de requisição personalizado; tem prioridade sobre o endereço padrão. Basta informar no nível do domínio, os caminhos são acrescentados automaticamente

7. Perguntas frequentes e dicas

Se a chave de API não passar na validação, faça login novamente no Console da AiHubMix e verifique se a chave é válida: https://console.aihubmix.com/token
Consultar a documentação de ajuda integrada: opencode → /help
Documentação oficial do OpenCode: https://opencode.ai/docs/

Última atualização: 2026-07-29

Assistentes de codificação

Integrações IDE

Agente / Workflow

SDKs e frameworks

1. Instalar o OpenCode

1. Instalar via Node.js

2. Instalar via Homebrew (macOS / Linux)

3. Instalar via Paru (Arch Linux)

4. Instalação no Windows

2. Selecionar o provedor de modelos

3. Autorização com a chave de API

3. Usar os modelos

1. Verificação da instalação

2. Selecionar um modelo

4. Usar a AiHubMix no aplicativo desktop do OpenCode

5. Configurar e atualizar modelos manualmente

Passo 1: Confirmar o ID do modelo

Passo 2: Abrir o arquivo de configuração

Passo 3: Escrever a configuração

Passo 4: Reiniciar o OpenCode

Passo 5: Verificar

URL base personalizada

Passo 1: Abrir o arquivo de configuração

Passo 2: Adicionar `options.baseURL`

Passo 3: Reiniciar e verificar

7. Perguntas frequentes e dicas

​1. Instalar o OpenCode

​1. Instalar via Node.js

​2. Instalar via Homebrew (macOS / Linux)

​3. Instalar via Paru (Arch Linux)

​4. Instalação no Windows

​2. Iniciar e fazer login no OpenCode

​1. Fazer login no OpenCode

​2. Selecionar o provedor de modelos

​3. Autorização com a chave de API

​3. Usar os modelos

​1. Verificação da instalação

​2. Selecionar um modelo

​4. Usar a AiHubMix no aplicativo desktop do OpenCode

​5. Configurar e atualizar modelos manualmente

​Passo 1: Confirmar o ID do modelo

​Passo 2: Abrir o arquivo de configuração

​Passo 3: Escrever a configuração

​Passo 4: Reiniciar o OpenCode

​Passo 5: Verificar

​ URL base personalizada

​Passo 1: Abrir o arquivo de configuração

​Passo 2: Adicionar options.baseURL

​Passo 3: Reiniciar e verificar

​7. Perguntas frequentes e dicas

1. Instalar o OpenCode

1. Instalar via Node.js

2. Instalar via Homebrew (macOS / Linux)

3. Instalar via Paru (Arch Linux)

4. Instalação no Windows

2. Iniciar e fazer login no OpenCode

1. Fazer login no OpenCode

2. Selecionar o provedor de modelos

3. Autorização com a chave de API

3. Usar os modelos

1. Verificação da instalação

2. Selecionar um modelo

4. Usar a AiHubMix no aplicativo desktop do OpenCode

5. Configurar e atualizar modelos manualmente

Passo 1: Confirmar o ID do modelo

Passo 2: Abrir o arquivo de configuração

Passo 3: Escrever a configuração

Passo 4: Reiniciar o OpenCode

Passo 5: Verificar

URL base personalizada

Passo 1: Abrir o arquivo de configuração

Passo 2: Adicionar `options.baseURL`

Passo 3: Reiniciar e verificar

7. Perguntas frequentes e dicas