Aider с Claude и GPT через OpenAI-совместимый API

Aider — open-source инструмент для парного программирования с ИИ, который работает в терминале. Вы запускаете его внутри git-репозитория, добавляете файлы в чат и описываете нужное изменение; Aider правит файлы и коммитит результат в git. Aider обращается к моделям через библиотеку LiteLLM, поэтому умеет работать с любым OpenAI-совместимым API, в том числе с APIVAI. Оплата идёт за токены с предоплаченного баланса, без подписки.

Aider определяет формат API по префиксу в имени модели:

Выбирайте OpenAI-совместимый путь, если нужна одна настройка для всех моделей и свободное переключение между Claude и GPT. Выбирайте путь Anthropic, если вы работаете в основном с Claude и хотите опцию Aider --cache-prompts: она использует кэширование промптов Claude, и повторяющийся контекст (карта репозитория и файлы в чате) оплачивается по более низкой цене чтения из кэша. Оба пути используют один и тот же ключ APIVAI.

Следите за /v1: OpenAI base URL заканчивается на /v1, а Anthropic base URL — нет, потому что LiteLLM сам добавляет к нему /v1/messages. ANTHROPIC_API_BASE — переменная окружения LiteLLM, её нет в справочнике опций самого Aider, но Aider её учитывает, так как все запросы к моделям идут через LiteLLM. Общие сведения об обоих форматах — на странице OpenAI-совместимый API и в документации.

1. Зарегистрируйтесь на apivai.com
2. Пополните баланс от $10 картой, криптовалютой, Alipay или WeChat Pay
3. Создайте ключ в Dashboard (можно задать ему отдельный лимит бюджета) и скопируйте его

Документация Aider рекомендует такой установщик:

В macOS или Linux:

В Windows:

После setx откройте новое окно терминала: окно, в котором вы выполнили команду, новых значений не видит.

Пишите ID модели после префикса openai/ точно. Чтобы работать с GPT, запустите с --model openai/gpt-5.5 или переключитесь прямо в сессии командой /model openai/gpt-6-sol.

Зачем --edit-format diff: Aider выбирает формат правок по имени модели. Для незнакомых имён он откатывается на whole, где модель переписывает каждый изменённый файл целиком, а это намного больше выходных токенов. diff передаёт только изменённые блоки и хорошо подходит для современных моделей Claude и GPT.

Aider читает файл .env из домашнего каталога, из корня git-репозитория и из текущего каталога. С таким файлом достаточно запустить просто aider:

«Слабая» модель (weak model) пишет сообщения коммитов и сжимает историю чата, поэтому дешёвая модель здесь экономит деньги без ущерба для качества кода. Не храните ключ в git: положите файл в домашний каталог или добавьте .env в .gitignore.

В Windows используйте setx, как в шаге 3. Всегда указывайте --model: без него Aider выберет свою модель по умолчанию, и это может быть не та модель, которая вам нужна.

Цены за 1 млн входных / выходных токенов на 2026-10-07. Список моделей со временем меняется, поэтому берите ID из GET https://api.apivai.com/v1/models или со страницы цен, а не копируйте старые названия.

Разумный вариант по умолчанию — Claude Sonnet 4.6 как основная модель и Claude Haiku 4.5 как weak model. Для трудной задачи есть режим architect: сильная модель планирует, а более дешёвая вносит правки, например aider --architect --model openai/claude-opus-5-5 --editor-model openai/claude-sonnet-4-6.

Каждый запрос Aider отправляет карту репозитория, добавленные в чат файлы и всю беседу до этого момента. Возьмём типичный запрос примерно на 15 000 входных и 1 500 выходных токенов (токены рассуждений считаются выходными) с Claude Sonnet 4.6:

• Один запрос: $0.0234 ($0.0675 по официальной цене).
• Рабочий день из 60 запросов: $1.41 ($4.05 по официальной цене).
• Месяц из 22 таких рабочих дней (1 320 запросов): $30.93 ($89.10 по официальной цене).

Тот же месяц на Claude Haiku 4.5 обошёлся бы в $10.38, а на GPT-6 Luna — в $0.437. Чтобы тратить меньше, убирайте ненужные файлы командой /drop, очищайте длинную историю через /clear и включайте --cache-prompts на пути Anthropic. В Dashboard видны все запросы с токенами и стоимостью; в сравнении цен Claude API все модели приведены рядом с официальными ценами.

• 401 / AuthenticationError: ключ неверный, удалён или исчерпал бюджет, либо переменная не задана в этом терминале. После setx в Windows откройте новое окно.
• 404 / NotFoundError: неверный base URL. OPENAI_API_BASE должен заканчиваться на /v1 ровно один раз (не /v1/v1 и не без него). В ANTHROPIC_API_BASE /v1 быть не должно.
• «LLM Provider NOT provided»: у имени модели нет префикса. Пишите openai/claude-sonnet-4-6, а не claude-sonnet-4-6.
• Model not found: ID после префикса должен точно совпадать с ID из GET /v1/models, а не с отображаемым названием.
• Пустые или обрезанные ответы: рассуждения (thinking) включены по умолчанию, и их токены съедают лимит вывода. Поднимите лимит для всех моделей в .aider.model.settings.yml (в домашнем каталоге или в корне репозитория):

• 429: лимит по умолчанию — 60 запросов в минуту на ключ. Подождите немного или попросите поддержку повысить лимит.
• «Unknown context window size and costs, using sane defaults»: безвредное предупреждение для моделей, которых Aider не знает. Скрыть его можно флагом --no-show-model-warnings. Из-за этого Aider может показывать стоимость $0.00; реальные цифры — в Dashboard.

Да. На OpenAI-совместимом пути один ключ и один base URL покрывают обе семьи моделей; переключайтесь командой /model openai/gpt-5.5 или /model openai/claude-sonnet-4-6.

Нет. Нужны только ключ APIVAI и предоплаченный баланс. Подписки нет, вы платите только за использованные токены.

Он позволяет включить --cache-prompts, и повторяющиеся карта репозитория и файлы обходятся дешевле. Если вам нужны и модели GPT, OpenAI-совместимый путь проще.

Нет. Содержимое запросов и ответов не логируется; для биллинга сохраняются только данные об использовании: модель, токены и стоимость.

В любом инструменте, который принимает OpenAI-совместимый или Anthropic-адрес, например в Continue для VS Code и JetBrains или в Claude Code (см. руководство по настройке Claude Code).

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Aider.