Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 37
Glossário 12

Ferramentas

OpenCode: seu próprio modelo no terminal

OpenCode é um assistente de codificação AI open-source que funciona diretamente no terminal. Sem assinaturas, sem vendor lock-in. Suporta autocompletar, geração de código, refatoração e explicações — tudo via API compatível com OpenAI.

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

A configuração leva alguns minutos — pelo instalador de comando único ou manualmente pelos meios nativos do OpenCode, sem alterar variáveis de ambiente.

Passo 1: Obter a chave API

Procedimento padrão para todas as ferramentas:

  1. Registro em gate.joingonka.ai/register.
  2. O bônus de 1.5M tokens gratuitos é creditado automaticamente.
  3. Crie uma API-key (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

A maneira mais simples é configurar com o instalador de um comando. Para ferramentas CLI/de arquivos, ele configurará o provedor JoinGonka (baseUrl, modelos) e salvará a chave no armazenamento nativo do OpenCode sem tocar nas variáveis de ambiente; para ferramentas de UI, mostrará os valores prontos para copiar e colar:

npx @joingonka/setup --tool opencode

O instalador é universal (sem flag, oferecerá escolher uma ferramenta da lista), solicitará a chave jg-… e, após a configuração, fará uma verificação ao vivo solicitando o gateway. Não altera as outras configurações. Abaixo, o método manual caso prefira configurar por conta própria.

Configurar manualmente (plano B)

O OpenCode armazena chaves nativamente e descreve os provedores em sua própria configuração — portanto, a configuração manual também não afeta as variáveis de ambiente, e suas outras ferramentas compatíveis com OpenAI continuarão funcionando como antes.

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

Passo 2 — descrever o provedor. Adicione em ~/.config/opencode/opencode.json (o id joingonka deve coincidir com o passo 1):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": { "baseURL": "https://gate.joingonka.ai/v1" },
      "models": {
        "moonshotai/Kimi-K2.6": { "name": "Kimi K2.6" },
        "MiniMaxAI/MiniMax-M2.7": { "name": "MiniMax M2.7" },
        "deepseek-ai/DeepSeek-V4-Flash-0731": { "name": "DeepSeek V4 Flash" }
      }
    }
  }
}

Não é necessário adicionar o campo apiKey neste arquivo — o OpenCode usará a chave de auth.json pelo id correspondente.

Seleção de modelo: por padrão, o joingonka/moonshotai/Kimi-K2.6 é adequado; para contexto longo — joingonka/MiniMaxAI/MiniMax-M2.7; o maior contexto da rede (380K) — joingonka/deepseek-ai/DeepSeek-V4-Flash-0731.

Verificação: inicie o opencode e peça para escrever uma função. Se a resposta chegar, a configuração foi 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 Gonka Network são de código aberto. Sem vendor lock-in, sem dependências proprietárias. Você controla cada componente.
  • Custo: $0.0047/1M de tokens — milhares de vezes mais barato do que qualquer alternativa proprietária. 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 são feitas através de uma rede descentralizada — não há um armazenamento centralizado dos 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. Ferramentas de terminal alternativas: Claude Code, Aider.

Parâmetros do modelo: janela de contexto de 200K tokens, comprimento máximo de resposta de até 8192 tokens (para todos os modelos da rede). 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.

Quer saber mais?

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

Obter tokens gratuitos →