# Codebuff

Источник: https://docs.aicentos.com/ru/clients/codebuff

Language: ru

> Подключение 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)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение при нехватке баланса: [https://aicentos.com/wallet](https://aicentos.com/wallet)

Также убедитесь, что на машине установлен Node.js и Codebuff установлен глобально:

```bash
npm install -g codebuff
```

## Конфигурация для заполнения

| Поле     | Значение                                  |
| -------- | ----------------------------------------- |
| Base URL | `https://aicentos.com/v1`                 |
| API Key  | ключ, созданный в консоли                 |
| Модель   | имя модели из «витрины моделей» в консоли |

## Шаги настройки

* Запишите эндпоинт и ключ в конфигурацию shell (`~/.zshrc` или `~/.bashrc`):

```bash
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://aicentos.com/wallet)).
* Подробнее см. на сайте документации: [https://docs.aicentos.com](https://docs.aicentos.com)