Aider API Key: установка Aider AI и настройка Base URL

Чтобы использовать Aider API Key от BetterToken, установите Aider AI, задайте OPENAI_API_KEY и OPENAI_API_BASE, затем запустите Aider с точным Model ID.

Aider API Key и установка Aider AI

Установите Aider по официальной инструкции, а для подключения используйте API Key BetterToken и Base URL https://bettertoken.ai/v1. После настройки проверьте соединение коротким запросом в тестовом репозитории.

Сравнить сценарии можно в инструкциях по Continue CLI и Codex CLI. Актуальный Model ID выбирайте по руководству по моделям.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken
Base URL	https://bettertoken.ai/v1
Model	Актуальный Model ID из каталога моделей

Подготовка

• Установленная актуальная версия инструмента
• API Key BetterToken: зарегистрироваться и получить
• Model ID из каталога моделей

Зарегистрироваться и получить BetterToken API Key→

Уже есть аккаунт? Войдите, пополните баланс и создайте ключ в консоли.

Дополнительные требования

• Установите Python

Установка

Установите Aider

Выполните в терминале:

python -m pip install aider-install
aider-install

После установки проверьте, что Aider доступен:

aider --help

Ручная настройка

Поле	Значение
API Key	API Key BetterToken
Base URL	https://bettertoken.ai/v1
Model	Актуальный Model ID из каталога моделей

Настройте BetterToken для текущего терминала

macOS / Linux

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

Windows PowerShell

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

После setx закройте и снова откройте PowerShell. Затем перейдите в каталог проекта и выполните:

aider --model openai/YOUR_MODEL_ID

Замените YOUR_API_KEY на ваш API Key BetterToken. YOUR_MODEL_ID приведён только как пример. Замените его на актуальный ID из model plaza и сохраните префикс openai/.

Сохраните конфигурацию в .env

Чтобы не задавать переменные при каждом запуске терминала, создайте файл .env в Git-корне проекта:

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

Добавьте .env в .gitignore, чтобы API Key не попал в Git. Затем перейдите в каталог проекта и выполните:

aider

Чтобы использовать другой файл для одного проекта, укажите его явно:

aider --env-file ./aider-bettertoken.env

Опционально: .aider.conf.yml

Чтобы сохранить только несекретные настройки, создайте .aider.conf.yml в домашнем каталоге или корне проекта:

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

API Key по-прежнему передавайте через переменную OPENAI_API_KEY, а не через общий YAML-файл.

Проверка подключения

Отправьте короткий тестовый запрос. Если инструмент возвращает ответ без ошибок авторизации или Model ID, подключение работает. После изменения конфигурации полностью перезапустите инструмент.

Смена модели

Откройте селектор моделей или измените поле Model в конфигурации. Используйте точный Model ID из каталога моделей, затем перезапустите текущую сессию.

Замените модель в команде запуска на актуальный ID в model plaza:

aider --model openai/YOUR_MODEL_ID

Не удаляйте префикс openai/. Model ID должен быть совместим с OpenAI-compatible endpoint.

Частые ошибки

Симптом	Что делать
401, Unauthorized или Invalid API key	Проверьте OPENAI_API_KEY, убедитесь, что это API Key BetterToken, и удалите лишние пробелы.
429 или слишком много запросов	Проверьте доступность модели и состояние баланса. Не запускайте несколько повторов одновременно.
model not found или модель недоступна	Скопируйте актуальный ID из model plaza и передайте его Aider в формате openai/model-id.
Неверный URL запроса или 404	Проверьте, что OPENAI_API_BASE равен https://bettertoken.ai/v1. Не добавляйте /chat/completions.
Windows не видит новые переменные	setx действует только в новых терминалах. Закройте текущее окно PowerShell и откройте новое.
Aider сообщает, что модель неизвестна	Сначала проверьте ID модели и провайдер. Aider может показать предупреждение для новой модели, но используйте только актуальный ID из model plaza.

FAQ по настройке

Какой Base URL использовать в Aider?

Используйте https://bettertoken.ai/v1. Это OpenAI-compatible Base URL BetterToken.

Почему перед названием модели нужен префикс openai/?

Aider использует этот префикс для определения OpenAI-compatible модели. Без него Aider может выбрать неправильный provider.

Можно сохранить API Key в .aider.conf.yml?

Не рекомендуем. Используйте переменные окружения или .env, который добавлен в .gitignore, чтобы снизить риск раскрытия API Key в файлах проекта.

Расширенная настройка

Связанные материалы

• Настройка пользовательской модели в Continue CLI

• Настройка custom provider в Codex CLI

• Настройка custom API, Base URL и API Key в Cursor

• Настройка OpenAI-compatible API в Cline

• Сравнить поддерживаемые инструменты

• Ошибки API, коды состояния и ограничения частоты

Технические детали

Протокол, endpoint и внутренние параметры provider

В описанном сценарии используется Base URL https://bettertoken.ai/v1. Инструмент сам добавляет путь OpenAI-compatible endpoint. Не добавляйте /chat/completions или /responses к Base URL, если это не требуется конкретным полем.