Use Aider con una API de LLM gratuita
Aider es un programador en pareja de código abierto para la terminal. Edita archivos en su repositorio de git y crea commits. Esta guía conecta Aider con modelos gratuitos mediante FreeLLMAPI. También muestra los ajustes de Aider que son importantes para los modelos gratuitos: formato de edición, modelo débil y tamaño del mapa del repositorio.
El código, los nombres de los modelos y las etiquetas del catálogo en vivo se muestran en inglés.
Paso 1: Instale FreeLLMAPI
FreeLLMAPI es una pasarela de código abierto. Se ejecuta en su computadora con Docker. Reúne los niveles gratuitos de 45 proveedores detrás de una sola clave compatible con OpenAI.
Instalar en macOS o Linux
curl -fsSL https://freellmapi.co/install.sh | bashAbra http://localhost:3001. Agregue al menos dos claves gratuitas de proveedores en la página Keys. Copie su clave unificada desde la misma página.
Paso 2: Conecte Aider
El comando de configuración escribe ~/.aider.conf.yml. Antes crea una copia de seguridad del archivo existente.
Un solo comando
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aiderEl archivo que escribe el comando se ve así:
~/.aider.conf.yml
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"El prefijo openai/ es obligatorio. Indica a Aider que envíe el nombre del modelo a una API compatible con OpenAI. Para usar variables de entorno y no un archivo, haga esto:
Solo variables de entorno
export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/autoAider busca .aider.conf.yml en su directorio personal, luego en la raíz de su repositorio de git y después en el directorio actual. El archivo que se carga al final tiene prioridad. Por eso, un archivo de proyecto puede cambiar el modelo de un solo repositorio.
Paso 3: Elija los modelos
Aider envía sus archivos y un mapa del repositorio en cada solicitud. No necesita llamadas a herramientas para su bucle principal de edición, porque lee las ediciones del texto del modelo. Son más importantes una ventana de contexto amplia y un buen seguimiento de instrucciones. La tabla muestra los modelos gratuitos con al menos 128K de contexto hoy.
| Modelo | Gratis en | Contexto | Límites gratuitos (mejor oferta) | Herramientas | Visión |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Sí | No |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 más | 1M | 40 solicitudes/min 40 RPM | Sí | Sí |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Sí | Sí |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Sí | No |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Deepseek V4.1 Flash | APINex | 1M | 5 solicitudes/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | No | No |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 solicitudes/min 20 solicitudes/día 250,000 tokens/min ~3M | Sí | Sí |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sí | Sí |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 solicitudes/min 50 solicitudes/día 50 req/day account-wide (1,000 after a $10 purchase) | Sí | Sí |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 solicitudes/min 50 solicitudes/día Shared rate limit | Sí | No |
| DeepSeek V4 Flash 0731 | ElectronHub, Router9 | 1M | 10,000 credits/month (~$1), shared; account-anniversary reset | No | No |
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 más | 262K | 30 solicitudes/min 250 solicitudes/día 70,000 tokens/min ~6M | Sí | Sí |
Se muestran 12 de 184 modelos gratuitos que coinciden. Ver todos los modelos.
Datos en vivo del catálogo de FreeLLMAPI (versión 2026.11.19, revisado 2026-11-19). Los límites gratuitos cambian con frecuencia. El catálogo se revisa todos los días.
Use openai/auto para que el enrutador elija un modelo. Use openai/auto:smart para preferir los modelos con mayor inteligencia. Para fijar un modelo, use openai/ y un ID del catálogo de GET /v1/models.
También puede configurar los modelos de una sesión en la línea de comandos. Este ejemplo usa los modelos más sólidos para las ediciones. Usa modelos rápidos para los mensajes de commit y los resúmenes del historial del chat:
Modelos para una sesión
aider --model openai/auto:smart --weak-model openai/auto:fastPara un perfil planificado, cree una cadena de respaldo en el panel de FreeLLMAPI, por ejemplo una cadena llamada coding. Después, use --model openai/auto:coding. Un nombre de perfil desconocido devuelve un error 400, así que la solicitud no pasa a otra cadena sin aviso.
Ajustes de Aider para modelos gratuitos
Aider conoce los ajustes de los modelos más conocidos. Un modelo de pasarela como auto no es conocido, así que configure estos valores usted mismo.
| Ajuste | Qué hace | Valor recomendado para modelos gratuitos |
|---|---|---|
edit-format | El formato que usa el modelo para enviar ediciones: whole, diff, diff-fenced o udiff | diff para modelos sólidos. whole para modelos débiles, porque es más simple, pero envía más tokens. |
weak-model | El modelo para los mensajes de commit y los resúmenes del historial del chat | openai/auto:fast, para que las tareas pequeñas no usen la cuota de su modelo sólido |
map-tokens | El número de tokens para el mapa del repositorio. 0 lo desactiva. | 1024 o menos en niveles gratuitos pequeños |
architect | Un modelo planifica el cambio y un modelo editor escribe las ediciones | Opcional. Duplica el número de solicitudes. |
~/.aider.conf.yml con ajustes para modelos gratuitos
openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024Para dar a Aider la ventana de contexto de un modelo de pasarela, agregue un archivo .aider.model.metadata.json. La clave es el nombre completo del modelo. Aider busca este archivo en los mismos lugares que el archivo de configuración.
~/.aider.model.metadata.json
{
"openai/auto": {
"max_input_tokens": 128000,
"max_output_tokens": 8192,
"litellm_provider": "openai",
"mode": "chat"
}
}Límites de uso y conmutación
Los niveles gratuitos tienen límites por minuto y por día. FreeLLMAPI cuenta el uso de cada clave. Cuando un proveedor envía un error 429, el enrutador envía la solicitud al siguiente modelo de su cadena. Aider no ve el error y continúa.
- Agregue claves de cuatro o más proveedores. Más proveedores dan más solicitudes por día.
- Agregue solo los archivos que quiere cambiar con
/add. Cada archivo está en cada solicitud. - Use
/clearentre tareas para enviar un historial de chat más corto. Un historial corto también reduce los tokens por minuto. - Use
/droppara quitar los archivos que ya no necesita.
Solución de problemas
| Problema | Causa | Solución |
|---|---|---|
| "Modelo openai/auto: tamaño de ventana de contexto y costos desconocidos, se usan valores predeterminados razonables." | Aider no conoce el modelo de la pasarela | Esta advertencia suele ser inofensiva. Para quitarla, agregue .aider.model.metadata.json. |
| La edición no se aplicó | El modelo no siguió el formato de edición | Use --edit-format whole, o un modelo más sólido |
401 "Invalid API key" | Aider envía una clave distinta, por ejemplo desde otro archivo de configuración | Revise los archivos de configuración del directorio personal, de la raíz de git y del directorio actual |
| Aider llama a api.openai.com | Se usa el prefijo openai/, pero no se configuró la base URL | Configure openai-api-base o OPENAI_API_BASE |
| "Todos los modelos alcanzaron su límite tras N intentos" | Todas las claves llegaron a su límite | Agregue claves de más proveedores, o reduzca map-tokens |
Preguntas frecuentes
¿Puedo usar Aider gratis?
Sí. Aider es de código abierto. Apúntelo a FreeLLMAPI con openai-api-base y el prefijo de modelo openai/. La pasarela usa niveles gratuitos de proveedores, así que la inferencia cuesta $0.
¿Cómo uso Aider con una API compatible con OpenAI?
Configure OPENAI_API_BASE y OPENAI_API_KEY, y luego ejecute aider --model openai/
¿Qué formato de edición debo usar con modelos gratuitos?
Use diff para modelos sólidos, porque envía menos tokens. Si las ediciones no se aplican, use whole. Es más simple para modelos débiles, pero envía el archivo completo cada vez.
¿Qué significa 'Unknown context window size and costs, using sane defaults'?
Aider no conoce el nombre del modelo, así que usa valores predeterminados. La advertencia suele ser inofensiva. Agregue .aider.model.metadata.json con la ventana de contexto para quitarla.
¿Cuál es el mejor modelo gratuito para Aider?
Use un modelo con una ventana de contexto amplia y un buen seguimiento de instrucciones. La tabla de esta página muestra los modelos gratuitos más sólidos con 128K o más de contexto hoy.
Guías relacionadas
- Use OpenCode con una API de LLM gratuita
- Use Codex CLI con modelos gratuitos
- Mejores API gratuitas de modelos para programar
- URL base gratuitas compatibles con OpenAI
- API LLM gratuita con contexto de 1 millón de tokens
Fuentes
- Aider docs: OpenAI-compatible APIs (revisado 20 November 2026)
- Aider docs: YAML config file (revisado 20 November 2026)
- Aider docs: options reference (revisado 20 November 2026)
- Aider docs: edit formats (revisado 20 November 2026)
- Aider docs: model warnings (revisado 20 November 2026)
- Aider docs: advanced model settings (revisado 20 November 2026)
- FreeLLMAPI CLI generators (revisado 20 November 2026)