Aider con DeepSeek, Claude o cualquier modelo compatible con OpenAI

Configúralo

1. Instala Aider. Aider 0.86 es compatible con Python 3.10 a 3.12, y su propio instalador, aider-install, configura una versión de Python adecuada para él. Nosotros usamos pip install aider-chat en un entorno virtual de Python 3.12.

python -m pip install aider-install
aider-install

2. Conéctalo a la API con dos variables de entorno y añade el prefijo openai/ a todos los modelos, también a los de Claude. El modelo débil escribe los mensajes de commit y los resúmenes, así que uno barato es suficiente.

export OPENAI_API_BASE="https://api.zurelay.com/v1"
export OPENAI_API_KEY="zr_live_..."
aider --model openai/claude-sonnet-5-5 --weak-model openai/deepseek-v4.1-flash
# or all on DeepSeek
aider --model openai/deepseek-v4.1-flash --weak-model openai/deepseek-v4.1-flash

3. Cuéntale a Aider sobre los modelos. Estos dos archivos en tu carpeta de usuario corrigen su advertencia, su formato de edición y la visualización del costo (siguiente sección). Los precios son los actuales de Zurelay, por token.

{
  "openai/deepseek-v4.1-flash": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000003,
    "output_cost_per_token": 0.00000012,
    "cache_read_input_token_cost": 0.00000000074,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/claude-sonnet-5-5": {
    "max_input_tokens": 1000000,
    "input_cost_per_token": 0.00000079,
    "output_cost_per_token": 0.00000395,
    "cache_read_input_token_cost": 0.000000079,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

- name: openai/deepseek-v4.1-flash
  edit_format: diff
  use_repo_map: true
- name: openai/claude-sonnet-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: openai/deepseek-v4.1-flash

4. Guarda la configuración en ~/.aider.conf.yml, para que un aider normal arranque con ella. Contiene tu clave, así que mantenla fuera de git.

model: openai/claude-sonnet-5-5
weak-model: openai/deepseek-v4.1-flash
openai-api-base: https://api.zurelay.com/v1
openai-api-key: zr_live_...

Lo que Aider hace mal con los modelos nuevos

Aider busca un modelo por su nombre completo, y en la versión 0.86.2 no reconocía ni openai/claude-sonnet-5-5 ni openai/deepseek-v4.1-flash. Sin los archivos anteriores:

• Muestra una advertencia en cada inicio: Unknown context window size and costs, using sane defaults, y luego pregunta si quieres abrir su documentación. Basta con una entrada de max_input_tokens en el archivo de metadatos para detenerla.
• Usa el formato de edición de archivo completo, así que el modelo devuelve íntegros todos los archivos que cambia. Eso cuesta más tokens de salida en archivos grandes y es más lento. edit_format: diff hace que envíe solo bloques de buscar y reemplazar; ambos modelos los aplicaron sin problemas en nuestra prueba. Si las ediciones de un modelo fallan una y otra vez, vuelve a whole para ese modelo.
• No muestra el costo. Con los precios en el archivo de metadatos, la línea de costo de Aider coincidió con nuestra factura: indicó $0.0036 para una edición con Claude que Zurelay facturó en $0.00357.

Claude: ¿openai/ o anthropic/?

Aider también puede llegar a Claude mediante el formato de Anthropic: --model anthropic/claude-sonnet-5-5 con ANTHROPIC_API_BASE=https://api.zurelay.com (sin /v1) y ANTHROPIC_API_KEY con la misma clave. Funcionó, y Aider reconocía el modelo de esa forma. Pero con --cache-prompts pagó por escribir la caché del prompt en nuestras dos ejecuciones y nunca leyó de ella, a unos $0.0035 por edición. Con openai/, la segunda edición leyó de la caché 2,863 de sus 3,682 tokens de prompt sin ningún ajuste, y costó $0.0025. Nosotros usaríamos openai/ para todos los modelos.

Lo que costó en nuestra prueba

Ediciones en un archivo pequeño de Python en un repositorio git nuevo, cada una confirmada por Aider. Cada edición son dos solicitudes: el cambio con el modelo principal y un mensaje de commit de DeepSeek V4.1 Flash. Zurelay facturó:

El prompt propio de Aider es pequeño, de unos 2,800 a 3,700 tokens con el mapa del repositorio, así que un día de ediciones con DeepSeek cuesta centavos. Las dos ediciones con anthropic/ no aparecen en la tabla.

Cosas que conviene saber

• La línea de costo de Aider no cuenta los aciertos de caché en los modelos openai/: indicó $0.0045 por la edición que nos facturaron en $0.0025. Tu página de uso de Zurelay muestra la cifra real.
• En Windows, el chat de Aider necesita una consola real. En Git Bash mostró Can't initialize prompt toolkit: Found xterm-256color; usa PowerShell, el Símbolo del sistema o Windows Terminal. Las ejecuciones de un solo comando con --message funcionan en cualquier parte.
• Aider lee .aider.conf.yml, .aider.model.settings.yml y .aider.model.metadata.json desde tu carpeta de usuario, la raíz de tu repositorio git y la carpeta actual. Nosotros probamos la carpeta de usuario.

Precios de los modelos con los que puedes combinarlo

Por 1M de tokens, el precio de lista del laboratorio y el de Zurelay:

Probado el 3 de noviembre de 2026 con Aider 0.86.2 en Python 3.12, en Windows, con la API de Zurelay. La configuración resumida está en Aider en la documentación. Documentación del propio Aider: APIs compatibles con OpenAI y ajustes de modelo.