Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 52
Glossário 12

Ferramentas

OpenCode: seu próprio modelo no terminal

O OpenCode é um assistente de coding com AI open-source que roda direto no terminal. Sem assinaturas, sem vendor lock-in. Suporta autocompletar, geração de código, refatoração e explicações — tudo por meio de uma API compatível com OpenAI.

Diferente das ferramentas proprietárias (GitHub Copilot, Cursor Pro), o OpenCode é totalmente gratuito e aberto. O único gasto é o provedor de API para o LLM. Com o JoinGonka Gateway, esse gasto cai para $0.30 por mês.

A configuração leva alguns minutos — com o instalador em um único comando ou manualmente com os recursos nativos do OpenCode, sem mexer em variáveis de ambiente.

Passo 1: Obter a chave API

Procedimento padrão para todas as ferramentas:

  1. Cadastre-se em gate.joingonka.ai/register.
  2. O bônus de 3M tokens grátis chega após a confirmação do seu endereço.
  3. Crie uma chave de API (formato jg-xxx) no Dashboard.

A mesma chave funciona com Cursor, Cline, Continue.dev e qualquer cliente compatível com OpenAI.

Passo 2: Configurar o OpenCode

O mais simples é configurar com o instalador em um único comando. Ele registra o provedor JoinGonka no config do OpenCode — o endereço do gateway e os modelos da rede com suas janelas de contexto e tetos de resposta —, salva a chave no armazenamento nativo do OpenCode, sem mexer nas variáveis de ambiente, e define o DeepSeek V4 Flash como modelo padrão, caso você ainda não tenha escolhido o seu:

npx @joingonka/setup --tool opencode

O instalador é universal (sem a flag, ele pede para escolher uma ferramenta da lista), pergunta pela chave jg-… e, após a configuração, faz uma verificação ao vivo com uma requisição ao gateway. Não mexe nas demais configurações. Abaixo está o método manual, caso você prefira configurar por conta própria.

Configurar manualmente (plano B)

O OpenCode armazena as chaves de forma nativa e descreve os provedores no próprio config — por isso a configuração manual também não mexe nas variáveis de ambiente, e suas outras ferramentas compatíveis com OpenAI continuam funcionando como antes.

Passo 1 — salvar a chave. Execute opencode auth login, escolha Other, digite o id do provedor joingonka e cole a chave jg-…. O OpenCode vai salvá-la em ~/.local/share/opencode/auth.json.

Passo 2 — descrever o provedor. Adicione em ~/.config/opencode/opencode.json (o id joingonka precisa ser igual ao do passo 1):

{
  "$schema": "https://opencode.ai/config.json",
  "model": "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": { "baseURL": "https://gate.joingonka.ai/v1" },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": { "name": "DeepSeek V4 Flash", "limit": { "context": 380000, "output": 32768 } },
        "zai-org/GLM-5.3-Flash": { "name": "GLM-5.3 Flash", "limit": { "context": 390000, "output": 8192 } },
        "MiniMaxAI/MiniMax-M2.7": { "name": "MiniMax M2.7", "limit": { "context": 200000, "output": 8192 } }
      }
    }
  }
}

Não é preciso adicionar o campo apiKey a esse arquivo — o OpenCode usa a chave do auth.json pelo id correspondente. O bloco limit é obrigatório: sem ele, o OpenCode não conhece a janela do modelo e não comprime o histórico a tempo.

Escolha do modelo: por padrão, joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 (contexto de 380K e a resposta mais longa da rede, também é a que o instalador define); para tarefas de raciocínio e o contexto mais longo da rede (390K), joingonka/zai-org/GLM-5.3-Flash; para tarefas curtas e edições rápidas, joingonka/MiniMaxAI/MiniMax-M2.7.

Verificação: rode opencode e peça para escrever uma função. Se a resposta vier, a configuração está concluída.

Por que OpenCode + Gonka é a melhor combinação

Três razões pelas quais a combinação OpenCode + Gonka é ideal para desenvolvedores:

  • Totalmente open-source: tanto o OpenCode quanto a rede Gonka são de código aberto. Sem vendor lock-in, sem dependências proprietárias. Você controla cada componente.
  • Custo: $0.0069/1M de tokens — milhares de vezes mais barato que qualquer análogo proprietário. O GitHub Copilot custa $19-39/mês com limites. OpenCode + Gonka — sem limites, por centavos.
  • Privacidade: seu código não é enviado para servidores da Microsoft/OpenAI/Anthropic. As solicitações passam por uma rede descentralizada — não existe um repositório central para seus dados.

O OpenCode suporta muitos provedores de LLM, mas com o JoinGonka Gateway você obtém o equilíbrio ideal entre preço, qualidade e privacidade. Outras ferramentas de terminal alternativas: Claude Code, Aider.

Parâmetros do modelo: janela de contexto — 200K tokens no MiniMax M2.7 (380K no DeepSeek V4 Flash, 390K no GLM-5.3 Flash), comprimento máximo da resposta — até 8192 tokens (no DeepSeek V4 Flash — até 32768). Lista atual de modelos: GET https://gate.joingonka.ai/v1/models.

OpenCode + Gonka = assistente de programação de IA totalmente open-source por $0.30/mês. Sem assinaturas, sem vendor lock-in, sem enviar código para servidores corporativos. Tokens gratuitos no início.
← OpenClaw + Gonka AI — agentes AI acessíveis Continue.dev + Gonka AI — AI para VS Code/JetBrains →

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

Obter tokens gratuitos →