Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 32
Glossário 12

Ferramentas

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

Aider é um dos melhores assistentes de IA para codificação via terminal. Funciona com Git, entende a estrutura do projeto, cria commits e edita vários arquivos simultaneamente. Não é apenas um chat com IA — é programação em par (pair programming) real, onde um parceiro de IA lê seu código, sugere mudanças e as aplica.

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

Passo 1: Instalar Aider e obter a chave

Instalação do Aider:

# pip
pip install aider-chat

# pipx (recomendado)
pipx install aider-chat

# Homebrew (macOS)
brew install aider

Chave API: registre-se em gate.joingonka.ai/register, obtenha 10M tokens grátis, crie a chave jg-xxx.

Passo 2: Configurar o Aider

A maneira mais simples é configurar usando o instalador de um comando só. Para ferramentas CLI/de arquivos, ele registrará automaticamente o provedor JoinGonka (baseUrl, modelos), e para ferramentas de UI, mostrará os valores prontos para inserção:

npx @joingonka/setup --tool aider

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

Configurar manualmente (plano B)

Método 1: variáveis de ambiente (o mais simples):

export OPENAI_API_BASE=https://gate.joingonka.ai/v1
export OPENAI_API_KEY=jg-sua-chave

Execução:

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

Método 2: arquivo per-project .aider.conf.yml na raiz do projeto — o caminho mais nativo: endpoint, chave e modelo em um único arquivo, sem alterar variáveis de ambiente globais (o OPENAI_* global interceptaria suas outras ferramentas compatíveis com OpenAI):

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

Opcional: configuração fina do comportamento do modelo em um arquivo .aider.model.settings.yml separado (define APENAS os parâmetros do modelo, não o endpoint ou a chave):

# .aider.model.settings.yml
- name: openai/MiniMaxAI/MiniMax-M2.7
  edit_format: diff
  use_repo_map: true
  extra_params:
    max_tokens: 8192  # limite de saída através do Gateway

Método 3: alias no shell para maior conveniência:

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

Verificação: vá até um repositório Git e execute gonka-aider. O Aider exibirá informações sobre o modelo e sugerirá adicionar arquivos ao contexto. Peça para alterar um arquivo — se o Aider criar um commit, tudo está funcionando.

Recursos do Aider + Gonka

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

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

Com Gonka, tudo isso custa uma fração. Uma sessão típica de programação em par (2-4 horas) consome 10-30M de tokens: isso equivale a $0.01-0.03 através do JoinGonka Gateway. Com OpenAI, seriam $50-200 pela mesma sessão.

Ferramentas de terminal alternativas: Claude Code, OpenCode.

Parâmetros do modelo: a janela de contexto do Kimi K2.6 é de 200K tokens, o comprimento máximo de resposta através do Gateway é de até 8192 tokens (para todos os modelos da rede). Para a maioria das tarefas de programação em par, 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.

Quer saber mais?

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

Obtenha 10M tokens grátis →