¿Qué es Aider?
Aider es un agente de programación en pareja con IA de código abierto que se ejecuta en tu terminal y opera directamente dentro de tu repositorio git. Mapea tu proyecto, genera diffs de código, aplica los cambios a tus archivos y hace un auto-commit de cada uno con un mensaje generado por IA — todo a través de un endpoint de API compatible con OpenAI.
- Realiza ediciones inline o basadas en diff y hace commits de los cambios con mensajes generados por IA.
- Mapea todo tu repositorio para dar al modelo contexto sobre todos los archivos relevantes, no solo los que indicas.
- Acepta comandos estructurados en el chat como
/add,/architect,/undoy/run(para devolver la salida de tests al modelo). - Se conecta a cualquier endpoint compatible con OpenAI mediante
OPENAI_API_BASE+OPENAI_API_KEY; cambia de modelo por turno con--model openai/<slug>.
¿Por qué enrutar Aider a través de Tokonomix?
El flujo de trabajo de Aider alterna entre ediciones de línea rápidas y repetitivas y decisiones arquitectónicas críticas. Tokonomix hace ambas más eficientes: cambia de modelo por tarea con una sola clave — sin configurar proveedores separados — y añade un paso de verificación justo donde equivocarse resulta más caro.
- Cambia al instante entre modelos directos rápidos (para ediciones de línea frecuentes) y el
tokonomix-consensusmultimodelo para grandes refactorizaciones o cambios arquitectónicos arriesgados. - Acceso con una sola clave a más de 130 modelos de Anthropic, OpenAI, Google, Meta, Mistral y más — todos detrás de un único endpoint compatible con OpenAI.
- Controla el coste con precisión mediante límites de gasto por llamada, para que un bucle desbocado o un contexto sobredimensionado no desborde tu presupuesto.
- Activa el enrutamiento EU / soberanía para mantener los datos de repos propietarios en cumplimiento normativo — algo vital, ya que Aider transmite código fuente real en cada llamada a la API.
Conectar Aider a Tokonomix
Aider funciona de inmediato con Tokonomix — proporciona la URL base y tu clave tok-, y elige el slug de modelo adecuado para cada tarea. Instala Aider con python -m pip install aider-install && aider-install (o pipx install aider-chat).
- Genera (o copia) tu clave API
tok-desde el panel de Tokonomix. - Establece
OPENAI_API_BASEenhttps://tokonomix.ai/api/v1. - Establece
OPENAI_API_KEYcon tu clave de Tokonomix. - Lanza Aider con
--model openai/tokonomix-consensuspara turnos de diseño/refactorización, o un slug directo comoopenai/anthropic/claude-sonnet-4-6para ediciones rápidas.
export OPENAI_API_BASE="https://tokonomix.ai/api/v1"
export OPENAI_API_KEY="tok-..."
# Fast, high-volume edits (cheap, direct model)
aider --model openai/anthropic/claude-sonnet-4-6
# Major refactors, /architect turns, or risky changes (multi-model + judge)
aider --model openai/tokonomix-consensusCrea una cuenta gratuita en tokonomix.ai/dashboard/signup — incluye un saldo inicial gratuito — y luego pega la clave en tu shell como OPENAI_API_KEY.
Consenso vs directo: cuándo usar cada uno
La eficiencia de Aider proviene de ajustar la elección del modelo al riesgo de la tarea. Usa modelos directos para ediciones de código rutinarias; reserva tokonomix-consensus para decisiones estructurales o de alto impacto, donde una segunda y tercera opinión se pagan solas.
| Tarea en Aider | Modelo recomendado | Por qué |
|---|---|---|
| Corregir typos, renombrar funciones, actualizar unas pocas líneas | openai/anthropic/claude-sonnet-4-6 | Alta frecuencia; un modelo rápido es suficientemente preciso a un coste y latencia mínimos. |
| Implementar funcionalidades en módulos existentes | openai/anthropic/claude-sonnet-4-6 | Los turnos rápidos de edición/commit se benefician de bajo overhead — ideal para feedback ágil en cambios de alcance reducido. |
| Refactorización a gran escala, migración o rediseño entre archivos | openai/tokonomix-consensus | La salida multimodelo más un juez independiente reduce el riesgo de errores de un solo modelo en cambios que afectan toda la base de código. |
| Diseño de nueva arquitectura o razonamiento de diseño crítico | openai/tokonomix-consensus | Varias perspectivas de LLMs mantienen el diseño coherente y detectan errores sutiles y costosos de forma temprana. |
El modelo tokonomix-consensus ejecuta varios LLMs de primer nivel en paralelo y usa un juez para resolver desacuerdos, por lo que su latencia es mucho mayor que la de un modelo directo. Para el bucle habitual de edición/commit de Aider, usa un modelo directo; cambia a consenso solo para /architect, refactorizaciones de repo completo u otros turnos de diseño cruciales.
Verificar que funciona
Prueba la integración con una edición de una sola línea para confirmar el enrutamiento de Tokonomix y la respuesta del modelo.
- Ejecuta Aider en un repo de prueba con un modelo directo y realiza una edición sencilla de archivo.
- Comprueba que Aider aplica la edición, imprime el diff y crea un commit de git.
- Abre tu panel de Tokonomix y confirma que la solicitud y el uso de tokens quedan registrados.
aider --model openai/anthropic/claude-sonnet-4-6 --message "insert a # Hello World comment at the top of main.py"
# Success: Aider prints a diff, applies the change, and logs the call on your Tokonomix dashboard.