Назад до блогу

Інструменти та інтеграціїПосібник

Файл конфігурації Aider для вашого власного API-ключа: .aider.conf.yml і Windows setx

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

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

Термінал з командами, які підключають Aider до OpenAI-сумісного API
На цій сторінці
  1. Windows: setx і новий термінал
  2. Яка модель для яких правок
  3. Запустіть першу правку
  4. Припиніть передруковувати: .aider.conf.yml
  5. Скільки коштує сесія
  6. Якщо не працює

Двох змінних, OPENAI_API_BASE і OPENAI_API_KEY, та аргументу моделі на кшталт openai/<model id> достатньо, щоб спрямувати Aider на CheapTokens. Покрокові основи (встановлення, перший запит, 401/404/400/402) є в How to connect Aider to CheapTokens; ця сторінка охоплює те, що той посібник оминає: Windows setx, файл конфігурації та порядок його завантаження, а також оцінку вартості сесії.

Джерело: документація 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 або зі списку моделей на сторінці pricing.

Запустіть першу правку#

Aider працює всередині git-репозиторію, тож починайте в ньому. Додайте файл і попросіть щось невелике:

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

Коли Aider відповідає правкою файлу, ключ, базовий URL і id моделі — усе правильно.

Неправильний id моделі поруч із повним id, який працює, далі перша правка
Неправильний id проти повного id, і перший запит

Припиніть передруковувати: .aider.conf.yml#

Aider читає .aider.conf.yml з вашої домашньої директорії, потім з кореня git-репозиторію, потім з поточної директорії, і пізніші файли перемагають. Тож глобальний файл може містити ключ і базовий URL, а файл репозиторію може вибирати модель. Якщо ви хочете один конкретний файл і нічого більше, 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 сам запускається з правильним ендпоінтом і моделлю. Якщо ви комітите файл у репозиторій, залиште ключ поза ним і тримайте його у змінній середовища або у файлі .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 вихідних токенів загалом. Ціни за 1 млн токенів актуальні та змінюються разом із нашими тарифами; стовпець OpenRouter показує довідкові ціни для того самого навантаження.

Як тримати вхідну частину малою (файли лише для читання, /drop, розмір карти репозиторію) описано в How much does Aider cost. Актуальні ціни завжди на сторінці pricing.

Якщо не працює#

  • Aider просить API-ключ або звертається не до того сервісу. Змінні не видно процесу. На Windows перезапустіть термінал після setx; на Mac і Linux виконайте echo $OPENAI_API_BASE у тій самій оболонці.
  • Ваша конфігурація, здається, ігнорується. Пам'ятайте порядок: домашня директорія, корінь репозиторію, поточна директорія. Файл, ближчий до вас, перекриває глобальний.
  • Модель не знайдено, 404 або помилка автентифікації. Вони розглянуті в How to connect Aider to CheapTokens.

Та сама OpenAI-сумісна адреса працює в інших інструментах; якщо ви також користуєтеся агентним редактором, дивіться connecting OpenCode або огляд where to plug in your own API key.

Теги: