Opciones CLI (Flags)

Reúne los flags de CLI más importantes de Aider, agrupados por modelo, automatización, contexto y otros.

Los flags de CLI de Aider se pueden combinar al iniciar (p. ej. aider --model ... --test-cmd ... --yes-always) o establecer en un archivo de configuración/como variables de entorno. Los más importantes, agrupados: Modelo: --model MODEL (modelo principal, variable de entorno AIDER_MODEL); --weak-model WEAK_MODEL (para mensajes de commit/resumen del historial); --editor-model EDITOR_MODEL (escribe las ediciones de archivos en el modo Architect); --architect (activa directamente el modo Architect); --reasoning-effort VALUE y --thinking-tokens VALUE (controlan la profundidad/el presupuesto de razonamiento) Automatización/Scripting: --message/-m/--msg (envía un único mensaje, procesa la respuesta y después cierra - para scripts/CI); --message-file/-f (lee el mensaje desde un archivo); --yes-always (confirma automáticamente cada pregunta, sin preguntar); --no-auto-commits (desactiva el commit automático de los cambios del LLM, por defecto está activado); --test-cmd (define el comando de test) junto con --auto-test o, de forma puntual, --test; --lint-cmd (comandos de lint por lenguaje) junto con --auto-lint o, de forma puntual, --lint; --watch-files (vigila archivos en busca de comentarios especiales de IA que activan a Aider) Contexto: --read FILE (añade un archivo en solo lectura, se puede usar varias veces) o --file FILE (lo añade editable); --map-tokens VALUE (tamaño del mapa del repositorio, 0 lo desactiva); --map-refresh VALUE (auto/always/files/manual) Instalación/Otros: --upgrade/--update (actualiza el propio Aider); --just-check-update (solo comprueba si hay una actualización disponible); --config/-c (archivo de configuración propio); --env-file (archivo .env propio para las claves de API); --version; --help/-h

✅ ¿CUÁNDO USARLO?

Usar -m en scripts/pipelines de CI para ejecuciones únicas no interactivas

aider --message 'Fix the failing test in test_auth.py' --yes-always --test-cmd 'pytest -q' en un job de CI

Limitar la automatización de forma selectiva en lugar de permitirlo todo

aider --test-cmd 'pytest -q' --auto-test --no-auto-commits — los tests se ejecutan automáticamente, pero los commits solo después de una revisión manual

⛔ ¿CUÁNDO MEJOR NO?

Poner --yes-always por defecto en cada ejecución interactiva, sin revisar las propuestas

Con eso también se confirman automáticamente cambios arriesgados o no deseados, sin que nadie los vea antes.

Mejor: Usar --yes-always solo en contextos controlados de script/CI junto con --message; en modo interactivo, confirmar las propuestas manualmente

Dejar que las claves de API acaben en texto plano como flag en el historial de la shell

--openai-api-key/--anthropic-api-key como argumento de línea de comandos suele quedar visible en el historial de la shell y en las listas de procesos.

Mejor: Establecer las claves en su lugar mediante --env-file/.env o variables de entorno como AIDER_ANTHROPIC_API_KEY

FUENTES

Documentación de Aider — Referencia de opciones ↗ aider.chat