Skip to main content
Эта страница относится только к KodaCode / Koda, а не к MonkeyCode. Настройка KodaCode выполняется через форму Any OpenAI-compatible API: укажите API Key BetterToken, Base URL https://bettertoken.ai/v1 и точный Model ID.

​
KodaCode: настройка и ошибка 429

Ошибка 429 не исправляется заменой Base URL. Проверьте доступность выбранной модели и состояние баланса, затем повторите один короткий запрос. Если ошибка возникла именно в MonkeyCode, используйте отдельную инструкцию MonkeyCode; для KodaCode оставайтесь на этой странице. Model ID возьмите из руководства по моделям.

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

​
Подготовка

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

  • Установлен VS Code
  • Установлено расширение Kodacode / Koda
  • выбранный Model ID доступен у провайдера GPT

​
Установка

Установите или откройте Kodacode, затем перейдите к ручной настройке ниже.

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

​
Настройка

1

Откройте панель Koda и добавьте модель

Откройте панель KODA в боковой панели VS Code, нажмите на selector модели под полем ввода и выберите Добавить модель: Agent / Add model: Agent.
Выбор Add model: Agent в selector модели на панели Koda.
2

Заполните настройки OpenAI-compatible модели

В окне добавления модели заполните поля так:После заполнения нажмите Подключить / Connect.
В окне добавления модели Kodacode выбран Any OpenAI-compatible API и заполнены API Base, Model ID и API Key.
3

Проверьте, что модель активна

После успешного подключения выберите новую модель, например YOUR_MODEL_ID, в selector модели под полем ввода Koda. Отправьте короткое сообщение и проверьте, что ответ приходит.
4

Проверьте config.yaml

Kodacode записывает конфигурацию в ~/.koda/config.yaml. Откройте этот файл и проверьте, что модель добавлена.
Файл config.yaml Kodacode с добавленной OpenAI-compatible моделью.

​
Пример config.yaml

Ниже полная структура для проверки. Замените YOUR_API_KEY на ваш API Key BetterToken и не коммитьте реальный API Key в репозиторий.
Если вы используете не YOUR_MODEL_ID, измените и name, и model, чтобы они совпадали с Model ID поддерживаемого провайдера из model plaza.

​
Troubleshooting

  • Если подключение не работает, проверьте, что API Base равен https://bettertoken.ai/v1/, включая завершающий /.
  • Если модель недоступна, проверьте, что Model ID относится к поддерживаемый провайдер.
  • Если возникает ошибка авторизации, скопируйте API Key заново и проверьте, что нет лишних пробелов или переносов строки.
  • Если изменения в config.yaml не применились, перезапустите VS Code или выполните Developer: Reload Window.
  • BetterToken обычно не требует дополнительного User-Agent или custom headers.

​
Ссылки

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

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

​
Смена модели

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

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

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

​
Поддерживаемые провайдеры

Статусы относятся к способу подключения BetterToken, описанному на этой странице.
  • Ручная настройка: укажите API Key, Base URL и Model.
  • Не поддерживается: проверенный способ прямого подключения пока отсутствует.

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

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