Назад в блог

Инструменты и интеграцииИнструкция

Конфиг Aider для своего API-ключа: .aider.conf.yml и Windows setx

Храните свой API-ключ и base URL в .aider.conf.yml, разберитесь с порядком загрузки и ловушкой setx на Windows; плюс оценка стоимости сессии.

Автор: CheapTokens TeamОпубликовано 3 мин чтения

Терминал с командами, которые подключают Aider к OpenAI-совместимому API
Содержание
  1. Windows: setx и новый терминал
  2. Какая модель для каких правок
  3. Первая правка
  4. Не вводить заново: .aider.conf.yml
  5. Сколько стоит сессия
  6. Если не работает

Чтобы направить Aider на CheapTokens, хватит двух переменных, OPENAI_API_BASE и OPENAI_API_KEY, и аргумента модели вида openai/<id модели>. Базовые шаги (установка, первый запрос, ошибки 401/404/400/402) разобраны в статье How to connect Aider to CheapTokens; здесь — то, чего в ней нет: setx на Windows, конфиг-файл с порядком загрузки и оценка стоимости сессии.

Источник — документация Aider про OpenAI-совместимые API (страница проверена 26 октября 2026 года; даты и версии на ней нет, а последняя aider-chat на PyPI в этот день — 0.86.2).

Windows: setx и новый терминал#

На Mac и Linux переменные задают через export. На Windows (PowerShell или cmd) используйте setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

На Windows есть подвох. setx записывает переменные для будущих сессий, а не для той, где вы печатаете, поэтому закройте терминал и откройте новый, прежде чем запускать Aider. Если переменные заданы, а Aider всё равно просит ключ, обычная причина — в этом.

Какая модель для каких правок#

Аргумент модели — openai/ и полный id, поэтому у CheapTokens в команде два слэша:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

У MiniMax-M2.7 контекст 180K и ответ до 8 192 токенов — подходит для небольших и средних правок, где ответы короткие. Если правки приходят длинными диффами, стоит попробовать DeepSeek-V4-Flash: до 32 768 токенов в ответе, контекст 380K и одна цена в любое время суток.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Полный id берите из документации CheapTokens или из списка моделей на странице цен.

Первая правка#

Aider работает внутри git-репозитория, так что начните с него. Добавьте файл и попросите что-нибудь небольшое:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Если Aider отвечает правкой файла, ключ, base URL и id модели в порядке.

Неверный id модели рядом с полным id, который работает, и первая правка
Неверный и полный id модели, первый запрос

Не вводить заново: .aider.conf.yml#

Aider читает .aider.conf.yml из домашней папки, затем из корня git-репозитория, затем из текущей папки, и более поздний файл главнее. Поэтому в глобальный файл можно положить ключ и адрес, а в файл репозитория — выбор модели. Если нужен один конкретный файл и ничего больше, aider --config <file> загрузит только его.

Файл в домашней папке (пример, подставьте свой ключ):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Теперь достаточно aider — он стартует с нужным endpoint и моделью. Если коммитите файл в репозиторий, ключ оставьте вне его: в переменной окружения или в .env; строка с ключом — для вашей домашней папки.

Для модели, которую Aider не знает, в документации описан model-settings-file (.aider.model.settings.yml), где можно указать её настройки.

Сколько стоит сессия#

Aider с каждым сообщением заново отправляет добавленные файлы и историю чата, поэтому вход растёт быстрее выхода. Допустим, рабочая сессия из примерно 20 сообщений отправляет 400 000 токенов на входе и получает 40 000 на выходе (допущение для примера — подставьте свои числа). На MiniMax-M2.7 это $0.026, и в сумме, с учётом входа и выхода, дешевле OpenRouter. Таблица ниже считает ту же сессию по нашим моделям:

Модель Стоимость OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400 000 входных и 40 000 выходных токенов всего. Цены за 1M токенов актуальны и меняются вместе с нашими тарифами; столбец OpenRouter показывает справочные цены для той же нагрузки.

Как держать входную часть небольшой (файлы только для чтения, /drop, размер карты репозитория) — в статье сколько стоит Aider. Актуальные цены всегда на странице цен.

Если не работает#

  • Aider просит ключ или обращается не к тому сервису. Процесс не видит переменные. На Windows перезапустите терминал после setx; на Mac и Linux выполните echo $OPENAI_API_BASE в той же оболочке.
  • Конфиг будто игнорируется. Вспомните порядок: домашняя папка, корень репозитория, текущая папка. Файл ближе к вам перекрывает глобальный.
  • Model not found, 404 или ошибка аутентификации. Разобраны в статье How to connect Aider to CheapTokens.

Тот же OpenAI-совместимый адрес работает и в других инструментах; если вы пользуетесь ещё и агентом в редакторе, загляните в подключение OpenCode или в обзор куда вставить свой API-ключ.

Теги: