Aider con Claude a través de una pasarela: ANTHROPIC_API_BASE, archivos de configuración, modo arquitecto y soluciones

Aider envía todas las llamadas al modelo a través de LiteLLM, por lo que apuntarlo a una pasarela es un ajuste de LiteLLM y no de Aider. Para Claude, eso significa ANTHROPIC_API_BASE configurado con la raíz del host de la pasarela y un nombre de modelo con el prefijo anthropic/ . Hay otros dos ajustes menos evidentes que son igual de importantes: los identificadores de los modelos de Claude más recientes necesitan una entrada en la configuración del modelo; de lo contrario, Aider recurre a editar archivos completos sin un mapa del repositorio.

Instalar Aider

python -m pip install aider-install
aider-install

# or the one-line installer (installs Python 3.12 if needed)
curl -LsSf https://aider.chat/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

Si el comando aider no se encuentra después, algo habitual en Windows, python -m aider ejecuta el mismo programa.

Conectar con Claude a través de la pasarela

export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_BASE=https://aiprimetech.io

aider --model anthropic/claude-sonnet-5

setx ANTHROPIC_API_KEY your_gateway_key
setx ANTHROPIC_API_BASE https://aiprimetech.io
# open a new terminal, then:
aider --model anthropic/claude-sonnet-5

La documentación de Aider no cubre una URL base personalizada de Anthropic. LiteLLM lee la variable y comprueba ANTHROPIC_API_BASE primero y después ANTHROPIC_BASE_URL, la variable que utiliza Claude Code. Cualquiera de las dos funciona; si ambas están configuradas, ANTHROPIC_API_BASE tiene prioridad.

Mantén el prefijo anthropic/ en el nombre del modelo. Sin un prefijo de proveedor, LiteLLM no sabe adónde enviar un nombre que no reconoce y falla con LLM Provider NOT provided.

Guardar los ajustes en archivos de configuración

Aider lee .aider.conf.yml y .env desde tu directorio personal, la raíz del repositorio git y el directorio actual, en ese orden, y los archivos posteriores tienen prioridad. Un archivo en el directorio personal se aplica a todos los proyectos.

model: anthropic/claude-sonnet-5
weak-model: anthropic/claude-haiku-4-5
set-env:
  - ANTHROPIC_API_BASE=https://aiprimetech.io
model-settings-file: ~/.aider.model.settings.yml
model-metadata-file: ~/.aider.model.metadata.json

ANTHROPIC_API_KEY=your_gateway_key

weak-model gestiona los mensajes de commit y los resúmenes del historial de chat, por lo que usar ahí un modelo económico ahorra dinero en cada sesión. set-env copia la variable en el entorno antes de cualquier llamada al modelo, lo que evita tener que incluir la URL base en el perfil de tu shell.

Mantener las ediciones mediante diff y el mapa del repositorio en los modelos más recientes

Aider elige su formato de edición según el nombre del modelo. Los nombres que reconoce, incluidos los que contienen sonnet-4-, opus-4- o haiku-4-, reciben ediciones diff y el mapa del repositorio. Un nombre que no reconoce, como claude-sonnet-5, hace que recurra a reescribir archivos completos y omita el mapa del repositorio. Esto hace que las ediciones sean más lentas y costosas. Una entrada de configuración restablece el comportamiento correcto:

- name: anthropic/claude-sonnet-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5

- name: anthropic/claude-opus-5-5
  edit_format: diff
  use_repo_map: true
  weak_model_name: anthropic/claude-haiku-4-5
  editor_model_name: anthropic/claude-sonnet-5
  editor_edit_format: editor-diff

Los modelos desconocidos también generan una advertencia: Unknown context window size and costs, using sane defaults. Es inofensiva, pero Aider asume entonces una ventana ilimitada y un precio de cero. El archivo de metadatos le proporciona valores reales:

{
  "anthropic/claude-sonnet-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000002,
    "output_cost_per_token": 0.00001,
    "litellm_provider": "anthropic",
    "mode": "chat"
  },
  "anthropic/claude-opus-5-5": {
    "max_tokens": 64000,
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "input_cost_per_token": 0.000004,
    "output_cost_per_token": 0.00002,
    "litellm_provider": "anthropic",
    "mode": "chat"
  }
}

Los precios son los precios de catálogo de Anthropic por token, por lo que el indicador de costes de Aider muestra el coste de catálogo; la pasarela factura menos. Un límite de entrada de 200K es un máximo de trabajo seguro, incluso cuando un modelo admite más.

Modo arquitecto: planifica con un modelo y edita con otro

aider --architect --model anthropic/claude-opus-5-5 --editor-model anthropic/claude-sonnet-5

En el modo arquitecto, el modelo principal propone el cambio y el modelo editor lo convierte en modificaciones de archivos. Usar un modelo más potente para planificar y uno más económico para editar suele costar menos que utilizar el modelo potente para ambas tareas. Dentro de una sesión, /architect cambia a él para un solo mensaje y /chat-mode architect cambia para el resto de la sesión.

La vía compatible con OpenAI

La pasarela también admite el formato Chat Completions de OpenAI, que es la vía para los modelos GPT en la misma cuenta. En esta vía, la URL base sí incluye /v1, y el nombre del modelo lleva el openai/ prefijo:

export OPENAI_API_KEY=your_gateway_key
export OPENAI_API_BASE=https://aiprimetech.io/v1

aider --model openai/claude-sonnet-5

Para Claude, es preferible la vía nativa anterior: los metadatos del modelo y el almacenamiento en caché de prompts se ajustan al formato de Anthropic. Si en tu entorno se ha configurado por error OPENAI_BASE_URL , LiteLLM lo utiliza con preferencia sobre OPENAI_API_BASE.

Modelos

Los alias cortos de Aider (sonnet, opus, haiku) apuntan a identificadores de modelos antiguos, así que indica el nombre del modelo explícitamente. Los identificadores antiguos con fecha, como claude-3-5-sonnet-20241022 , no están disponibles.

Resolución de problemas

Para los errores que proceden del modelo y no de Aider, consulta guía de errores de la API de Claude.

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.