Aider с Claude через шлюз: ANTHROPIC_API_BASE, файлы конфигурации, режим архитектора и исправления

Aider отправляет каждый вызов модели через LiteLLM, поэтому адрес шлюза задаётся в настройках LiteLLM, а не Aider. Для Claude это означает, что ANTHROPIC_API_BASE нужно задать корневой адрес хоста шлюза и использовать имя модели с префиксом anthropic/ . Не менее важны ещё две менее очевидные настройки: для новых идентификаторов Claude нужна запись в настройках модели, иначе Aider переходит к редактированию файлов целиком без карты репозитория.

Установите 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"

Если команда aider после этого не найдена, что часто бывает в Windows, python -m aider запускает ту же программу.

Подключитесь к Claude через шлюз

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

В документации самого Aider не описана настройка собственного базового URL Anthropic. Переменную считывает LiteLLM, который сначала проверяет ANTHROPIC_API_BASE а затем ANTHROPIC_BASE_URL— переменную, которую использует Claude Code. Подойдёт любая из них; если заданы обе, ANTHROPIC_API_BASE имеет приоритет.

Сохраняйте anthropic/ в качестве префикса имени модели. Без префикса поставщика LiteLLM не знает, куда направить запрос с незнакомым именем, и завершается с ошибкой LLM Provider NOT provided.

Сохраните настройки в файлах конфигурации

Aider считывает .aider.conf.yml и .env из домашнего каталога, корня репозитория git и текущего каталога, именно в таком порядке; файлы, прочитанные позже, имеют приоритет. Файл в домашнем каталоге действует для всех проектов.

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 обрабатывает сообщения коммитов и сводки истории чата, поэтому недорогая модель для этой задачи позволяет экономить в каждом сеансе. set-env копирует переменную в окружение до любого вызова модели, благодаря чему базовый URL не нужно добавлять в профиль оболочки.

Сохраните редактирование через diff и карту репозитория для новых моделей

Aider выбирает формат редактирования по имени модели. Для знакомых ему имён, в том числе содержащих sonnet-4-, opus-4- или haiku-4-, используются diff для редактирования и карта репозитория. Незнакомое имя, например claude-sonnet-5, приводит к переходу на переписывание файлов целиком и отключению карты репозитория. Это делает редактирование медленнее и дороже. Запись в настройках восстанавливает правильное поведение:

- 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

Неизвестные модели также вызывают предупреждение: Unknown context window size and costs, using sane defaults. Оно безвредно, но в этом случае Aider предполагает неограниченное контекстное окно и нулевую цену. Файл метаданных задаёт реальные значения:

{
  "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"
  }
}

Цены соответствуют прейскуранту Anthropic за токен, поэтому Aider показывает стоимость по прейскуранту; шлюз взимает меньшую плату. Лимит входных данных 200K — безопасный рабочий предел, даже если модель поддерживает больше.

Режим архитектора: планирование с одной моделью, редактирование с другой

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

В режиме архитектора основная модель предлагает изменение, а модель-редактор превращает его в правки файлов. Использование более мощной модели для планирования и более дешёвой для редактирования обычно обходится дешевле, чем использование мощной модели для обеих задач. В рамках сеанса /architect переключает на неё для одного сообщения, а /chat-mode architect переключает на неё до конца сеанса.

Подключение через OpenAI-совместимый API

Шлюз также поддерживает формат OpenAI Chat Completions, через который можно использовать модели GPT в той же учётной записи. Для этого способа подключения базовый URL включает /v1, а имя модели получает openai/ в качестве префикса:

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

aider --model openai/claude-sonnet-5

Для Claude предпочтительнее нативное подключение, описанное выше: метаданные модели и кеширование промптов соответствуют формату Anthropic. Если в окружении случайно задана переменная OPENAI_BASE_URL , LiteLLM использует её вместо OPENAI_API_BASE.

Модели

Короткие псевдонимы Aider (sonnet, opus, haiku) указывают на старые идентификаторы моделей, поэтому задавайте имя модели явно. Старые идентификаторы с датой, такие как claude-3-5-sonnet-20241022 , не обслуживаются.

Устранение неполадок

Если ошибка возникает на стороне модели, а не Aider, см. руководстве по ошибкам Claude API.

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.