Aider + Gonka AI — Programación en pareja con IA

Aider es uno de los mejores asistentes de programación con IA para terminal. Funciona con Git, entiende la estructura del proyecto, crea commits y edita varios archivos a la vez. No es solo un chat con IA: es programación en pareja de verdad, donde tu compañero de IA lee tu código, propone cambios y los aplica.

Aider es compatible con APIs compatibles con OpenAI desde el primer momento. Conectarte a JoinGonka Gateway son tres líneas en el archivo de configuración, 30 segundos de ajuste. Después de eso: programación en pareja sin límites por $0.0069/1M tokens.

Paso 1: Instalar Aider y obtener la clave

Instalación de Aider:

# pip
pip install aider-chat

# pipx (recommended)
pipx install aider-chat

# Homebrew (macOS)
brew install aider

API key: regístrate en gate.joingonka.ai/register, recibe 3M tokens gratis, crea una clave jg-xxx.

Paso 2: Configurar Aider

La forma más sencilla de obtener un bloque de configuración listo es con el instalador de JoinGonka:

npx @joingonka/setup --tool aider

El instalador te pedirá la clave jg-… e imprimirá el bloque para .aider.conf.yml (dirección, clave, modelo), junto con un .aider.model.metadata.json opcional con los límites reales del modelo, para que Aider no advierta sobre una ventana de contexto desconocida. No escribe los archivos: pega el bloque tú mismo; el instalador verificará el funcionamiento de la clave y del modelo con una solicitud real al gateway. A continuación, el mismo camino paso a paso.

Configurar manualmente (plan B)

Opción 1: variables de entorno: para una sola sesión en el terminal actual. No las añadas a ~/.bashrc: una OPENAI_* global interceptará tus otras herramientas compatibles con OpenAI. En PowerShell, las mismas variables se definen con $env:.

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

Ejecución:

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

Opción 2 (recomendada): el archivo .aider.conf.yml en la raíz del proyecto: la vía más nativa: endpoint, clave y modelo en un solo archivo, sin tocar las variables de entorno globales (una OPENAI_* global interceptaría tus otras herramientas compatibles con 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 del comportamiento del modelo en un .aider.model.settings.yml aparte (define SOLO parámetros del modelo, ni endpoint ni clave):

# .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

Aider toma los límites reales del modelo del archivo .aider.model.metadata.json junto a la configuración; sin él, advierte sobre una ventana de contexto desconocida:

{ "openai/MiniMaxAI/MiniMax-M2.7": { "max_input_tokens": 200000, "max_output_tokens": 8192,
    "max_tokens": 8192, "litellm_provider": "openai", "mode": "chat" } }

Opción 3: alias en el shell por comodidad:

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

Verificación: entra en un repositorio Git y ejecuta gonka-aider. Aider mostrará información sobre el modelo y te propondrá añadir archivos al contexto. Pídele que haga un cambio en un archivo: si Aider crea un commit, todo funciona.

Funcionalidades de Aider + Gonka

Aider no es solo un chat. Es una herramienta completa para la programación en pareja con AI:

Trabajo con Git: Aider crea automáticamente commits para cada cambio. Es fácil revertir cualquier decisión de la AI mediante git undo.
Contexto del proyecto: Aider construye un mapa del repositorio (repo map) — entiende las dependencias entre archivos, importaciones y la estructura del proyecto. El modelo recibe el contexto completo.
Ediciones multiarchivo: puede modificar de 5 a 10 archivos simultáneamente para implementar una funcionalidad. Cada archivo es un diff independiente, cada edición es rastreable.
Entrada de voz: soporte para --voice — dicte sus tareas en lugar de escribir.
Linting y tests: integración con linters y marcos de pruebas — Aider ve los errores y los corrige automáticamente.

Con Gonka, todo esto cuesta centavos. Una sesión típica de programación en pareja (2-4 horas) consume entre 10 y 30M de tokens — lo que equivale a $0.01-$0.03 a través de JoinGonka Gateway. Con OpenAI, serían $50-$200 por la misma sesión.

Otras herramientas de terminal alternativas: Claude Code, OpenCode.

Parámetros del modelo: ventana de contexto de MiniMax M2.7 — 200K tokens, DeepSeek V4 Flash — 380K; la longitud máxima de respuesta a través de Gateway — 8192 tokens para MiniMax M2.7 y GLM-5.3 Flash, 32768 para DeepSeek V4 Flash. Para la mayoría de las tareas de programación en pareja, esto es suficiente.

Aider + Gonka = programación profesional por pares con IA por centavos. Integración con Git, ediciones multifile, contexto del proyecto, todo por $0.01-0.03/sesión en lugar de $50-200 con OpenAI.

← Cline + Gonka AI — Agente de IA en VS Code LangChain + Gonka AI — Aplicaciones de IA por centavos →

¿Quieres saber más?

Explora otras secciones o empieza a ganar GNK ahora mismo.

Obtener tokens gratuitos →