Ключевые параметры
Подготовка
- Установленная актуальная версия инструмента
- API Key BetterToken: зарегистрироваться и получить
- Model ID из каталога моделей
Дополнительные требования
- Установите Python
Установка
Установите Aider
Выполните в терминале:Ручная настройка
Настройте BetterToken для текущего терминала
- macOS / Linux
- Windows PowerShell
YOUR_API_KEY на ваш API Key BetterToken. YOUR_MODEL_ID приведён только как пример. Замените его на актуальный ID из model plaza и сохраните префикс openai/.
Сохраните конфигурацию в .env
Чтобы не задавать переменные при каждом запуске терминала, создайте файл.env в Git-корне проекта:
.env в .gitignore, чтобы API Key не попал в Git. Затем перейдите в каталог проекта и выполните:
Опционально: .aider.conf.yml
Чтобы сохранить только несекретные настройки, создайте.aider.conf.yml в домашнем каталоге или корне проекта:
OPENAI_API_KEY, а не через общий YAML-файл.
Проверка подключения
Отправьте короткий тестовый запрос. Если инструмент возвращает ответ без ошибок авторизации или Model ID, подключение работает. После изменения конфигурации полностью перезапустите инструмент.Смена модели
Откройте селектор моделей или измените полеModel в конфигурации. Используйте точный Model ID из каталога моделей, затем перезапустите текущую сессию.
Замените модель в команде запуска на актуальный ID у провайдера GPT:
openai/. Model ID должен быть совместим с OpenAI-compatible endpoint.
Частые ошибки
FAQ по настройке
Какой Base URL использовать в Aider? Используйтеhttps://www.bettertoken.ai/v1. Это OpenAI-compatible Base URL BetterToken.
Почему перед названием модели нужен префикс openai/?
Aider использует этот префикс для определения OpenAI-compatible модели. Без него Aider может выбрать неправильный provider.
Можно сохранить API Key в .aider.conf.yml?
Не рекомендуем. Используйте переменные окружения или .env, который добавлен в .gitignore, чтобы снизить риск раскрытия API Key в файлах проекта.
Расширенная настройка
Поддерживаемые провайдеры
Статусы относятся к способу подключения BetterToken, описанному на этой странице.
Что означают способы настройки
Что означают способы настройки
- Ручная настройка: укажите API Key, Base URL и Model.
- Не поддерживается: проверенный способ прямого подключения пока отсутствует.
Связанные материалы
- Настройка пользовательской модели в Continue CLI
- Настройка custom provider в Codex CLI
- Настройка custom API, Base URL и API Key в Cursor
- Настройка OpenAI-compatible API в Cline
Технические детали
Протокол, endpoint и внутренние параметры provider
Протокол, endpoint и внутренние параметры provider
В описанном сценарии используется Base URL
https://www.bettertoken.ai/v1. Инструмент сам добавляет путь OpenAI-compatible endpoint. Не добавляйте /chat/completions или /responses к Base URL, если это не требуется конкретным полем.