aicentosCodebuff
Подключение OpenAI-совместимого эндпоинта aicentos в консольном агенте Codebuff
Обновлено:
Codebuff — AI-агент для кодинга, работающий в терминале: он распределяет задачи между несколькими субагентами, которые читают код, составляют план и изменяют файлы. По умолчанию он подключается к официальному хостингу; если ваша версия поддерживает переопределение OpenAI-совместимого эндпоинта, запросы можно направить на aicentos через переменные окружения.
Сначала проверьте, поддерживает ли ваша версия кастомный эндпоинт
Codebuff официально делает ставку на хостинг-режим: после входа используется официальная квота, либо официальное API через CODEBUFF_API_KEY. Кастомный Base URL есть не во всех версиях, поэтому сначала убедитесь:
- Запустите
codebuff --helpи посмотрите, есть ли опции вроде--base-url,--provider. - Проверьте, читает ли ваша версия
OPENAI_BASE_URL(в части версий —CODEBUFF_BASE_URL) для переопределения эндпоинта. - Если ни то, ни другое не поддерживается, значит текущая версия работает только с официальным сервисом и напрямую подключить aicentos нельзя.
Подготовка
Если кастомный эндпоинт поддерживается, сначала создайте на странице «API Key» в консоли отдельный ключ для Codebuff (рекомендуемое имя codebuff-cli).
- Консоль: https://aicentos.com
- Создание ключа: https://aicentos.com/keys
- Пополнение при нехватке баланса: https://aicentos.com/wallet
Также убедитесь, что на машине установлен Node.js и Codebuff установлен глобально:
npm install -g codebuffКонфигурация для заполнения
| Поле | Значение |
|---|---|
| Base URL | https://aicentos.com/v1 |
| API Key | ключ, созданный в консоли |
| Модель | имя модели из «витрины моделей» в консоли |
Шаги настройки
- Запишите эндпоинт и ключ в конфигурацию shell (
~/.zshrcили~/.bashrc):
export OPENAI_API_KEY="sk-ваш-ключ-aicentos"
export OPENAI_BASE_URL="https://aicentos.com/v1"- Перезагрузите конфигурацию:
source ~/.zshrc. - Перейдите в каталог проекта и запустите
codebuff. - Если версия поддерживает параметр
--model, можно явно указать модель при запуске; иначе переключайтесь командой выбора модели в интерактивном интерфейсе.
В части версий конфигурация пишется в JSON-файл в пользовательском каталоге конфигурации (у файлов с учётными данными по умолчанию права 600, не коммитьте их в репозиторий). Если ваша версия использует файл конфигурации, а не переменные окружения, впишите туда тот же Base URL и тот же ключ — имена полей смотрите в codebuff --help или в официальной документации.
Проверка
Сразу после запуска сделайте лёгкий тест с простым промптом — например, попросите прочитать файл и пересказать его содержимое; к полноценной работе переходите, только когда ответ приходит нормально.
Примечания
- Кастомный эндпоинт — продвинутый сценарий; имена полей могут отличаться между версиями, поэтому ориентируйтесь на вывод
codebuff --helpна вашей машине. - В
OPENAI_BASE_URLуказывайте толькоhttps://aicentos.com/v1, не дописывайте полный путь/v1/chat/completions. - Codebuff отправляет фрагменты кода и вывод терминала в качестве контекста; перед использованием убедитесь, что это соответствует требованиям вашей команды к обработке данных.
- При ошибке проверяйте по порядку: действуют ли переменные окружения в текущем терминале, совпадает ли имя модели с консолью, достаточно ли средств на счёте (https://aicentos.com/wallet).
- Подробнее см. на сайте документации: https://docs.aicentos.com