Aider + Gonka AI — programação em par com AI

Aider é um dos melhores assistentes de codificação com AI para terminal. Funciona com Git, entende a estrutura do projeto, cria commits e edita vários arquivos simultaneamente. Não é apenas um chat com AI — é uma programação em par completa, onde o parceiro de AI lê seu código, propõe alterações e as aplica.

O Aider suporta APIs compatíveis com OpenAI nativamente. A conexão com o JoinGonka Gateway exige apenas 2 variáveis de ambiente e 30 segundos de configuração. Depois disso — programação em par ilimitada por $0.0069/1M de tokens.

Passo 1: Instalar Aider e obter a chave

Instalação do Aider:

# pip
pip install aider-chat

# pipx (recommended)
pipx install aider-chat

# Homebrew (macOS)
brew install aider

API key: registre-se em gate.joingonka.ai/register, receba 3M tokens grátis, crie uma chave jg-xxx.

Passo 2: Configurar o Aider

A maneira mais fácil de obter o bloco de config pronto é com o instalador do JoinGonka:

npx @joingonka/setup --tool aider

O instalador vai pedir a chave jg-… e imprimir o bloco para o .aider.conf.yml (endereço, chave, modelo), além de um .aider.model.metadata.json opcional com os limites reais do modelo, para que o Aider não avise sobre uma janela de contexto desconhecida. Ele não grava os arquivos — cole o bloco você mesmo; o instalador vai testar a chave e o modelo com uma requisição real ao gateway. Abaixo está o mesmo caminho passo a passo.

Configurar manualmente (plano B)

Opção 1: variáveis de ambiente (a mais simples):

export OPENAI_API_BASE=https://gate.joingonka.ai/v1
export OPENAI_API_KEY=jg-your-key

Execução:

aider --model openai/MiniMaxAI/MiniMax-M2.7

Opção 2: arquivo por projeto .aider.conf.yml na raiz do projeto — o caminho mais nativo: endpoint, chave e modelo em um só arquivo, sem mexer nas variáveis de ambiente globais (um OPENAI_* global iria capturar suas outras ferramentas compatíveis com OpenAI):

# .aider.conf.yml
openai-api-base: https://gate.joingonka.ai/v1
openai-api-key: jg-your-key
model: openai/MiniMaxAI/MiniMax-M2.7

Opcional — ajuste fino do comportamento do modelo em um .aider.model.settings.yml separado (ele define SOMENTE parâmetros do modelo, não o endpoint nem a chave):

# .aider.model.settings.yml
- name: openai/MiniMaxAI/MiniMax-M2.7
  edit_format: diff
  use_repo_map: true
  extra_params:
    max_tokens: 8192  # Gateway output cap

Opção 3: alias no shell para mais praticidade:

alias gonka-aider='OPENAI_API_BASE=https://gate.joingonka.ai/v1 OPENAI_API_KEY=jg-your-key aider --model openai/MiniMaxAI/MiniMax-M2.7'

Verificação: entre em um repositório Git e execute gonka-aider. O Aider vai mostrar informações do modelo e sugerir adicionar arquivos ao contexto. Peça uma alteração em um arquivo — se o Aider criar um commit, está tudo funcionando.

Recursos do Aider + Gonka

Aider não é apenas um chat. É uma ferramenta completa para programação em dupla com AI:

Trabalho com Git: O Aider cria automaticamente commits para cada alteração. É fácil reverter qualquer decisão da AI através de git undo.
Contexto do projeto: O Aider constrói um mapa do repositório (repo map) — entende dependências entre arquivos, imports e estrutura do projeto. O modelo recebe o contexto completo.
Edições multiarquivo: pode modificar de 5 a 10 arquivos simultaneamente para implementar uma funcionalidade. Cada arquivo é um diff separado, cada edição é rastreável.
Entrada de voz: suporte para --voice — dite suas tarefas em vez de digitar.
Linting e testes: integração com linters e frameworks de teste — o Aider vê os erros e os corrige automaticamente.

Com o Gonka, tudo isso custa centavos. Uma sessão típica de programação em dupla (2-4 horas) consome 10-30M de tokens — o que equivale a $0.01-$0.03 via JoinGonka Gateway. Com a OpenAI, seriam $50-$200 pela mesma sessão.

Ferramentas de terminal alternativas: Claude Code, OpenCode.

Parâmetros do modelo: janela de contexto do MiniMax M2.7 — 200K tokens, do DeepSeek V4 Flash — 380K; o comprimento máximo de resposta via Gateway — 8192 tokens no MiniMax M2.7 e GLM-5.3 Flash, 32768 no DeepSeek V4 Flash. Para a maioria das tarefas de programação em dupla, isso é suficiente.

Aider + Gonka = programação em pares profissional com IA por centavos. Integração Git, edições multifile, contexto do projeto — tudo por $0.01-0.03/sessão em vez de $50-200 na OpenAI.

← Cline + Gonka AI — agente AI no VS Code LangChain + Gonka AI — aplicativos AI por uma fração do custo →

Quer saber mais?

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

Obter tokens gratuitos →