# Buff Code

> Среда разработки для инженеров, которые пишут код сами: консоль и приложение на моделях, знаниях и подключениях вашей организации, с записью каждого хода.

**Buff Code** — среда разработки для инженеров, которые пишут код сами. Это программа в
терминале (`buff`) и приложение для Linux, macOS и Windows. Модель, с которой работает
инженер, выбирает администратор организации; знания, репозитории и подключения — те же,
что у остальной платформы; расход идёт по тарифу организации; каждый ход записывается и
виден в кабинете.

Это второй способ работать с Buff. В веб-приложении задачу ведёт платформа: сама пишет код,
проверяет его и приносит на приёмку. В Buff Code код пишет инженер, а модель помогает ему
в его папке и терминале — с тем же знанием о компании.

_Иллюстрация: Разработчик спросил, как у команды принято вносить и выкладывать изменения. Модель открыла правило в базе знаний организации и ответила по нему._

## Как это устроено

```
Buff Code  ──▶  коннектор компании  ──▶  Buff
(машина          (ваша сеть,              (модели, знания,
 разработчика)    шлюз разработчика)       биллинг, записи)
```

- **Buff Code ходит только в коннектор вашей компании.** [Коннектор](/docs/connector) стоит в
  вашей сети; администратор включает на нём [шлюз разработчика](/docs/buff-code/gateway).
  На машине разработчика нет ни ключей провайдеров, ни настроек моделей, ни прямого выхода к Buff.
- **Вход — по коду из кабинета.** Разработчик вводит адрес коннектора, подтверждает код в
  кабинете и выбирает организацию и проект. Подробно: [Вход и рабочий контекст](/docs/buff-code/sign-in).
- **Модели — организации.** Какая модель ответит, решает администратор; расход попадает в
  биллинг с подписью «Buff Code · устройство». См. [Модели и расход](/docs/buff-code/models).
- **Инструменты, знания и код — общие.** Модель в Buff Code читает и вызывает всё, что
  подключено к коннектору ([Инструменты подключений](/docs/buff-code/tools)), читает и предлагает
  записи в [базу знаний](/docs/buff-code/knowledge) и ищет по [репозиториям проекта](/docs/buff-code/repositories)
  без клона на машине.
- **Каждый ход записывается.** Запрос к модели и ответ сохраняются целиком в данных организации.
  Разработчик видит свои сессии, владелец — все, а по записям можно
  [задавать вопросы](/docs/buff-code/sessions/ask). См. [Сессии разработки](/docs/buff-code/sessions).

## С чего начать

| Кто | Что сделать | Где описано |
| --- | --- | --- |
| Администратор | Включить шлюз разработчика на коннекторе и сообщить команде адрес | [Шлюз разработчика](/docs/buff-code/gateway) |
| Администратор | Выбрать модель для «Разработки задач» — её же получит Buff Code | [Модели и расход](/docs/buff-code/models) |
| Разработчик | Поставить консоль одной командой или приложение со страницы «Скачать» | [Установка](/docs/buff-code/install) |
| Разработчик | При первом запуске ввести адрес коннектора, подтвердить код, выбрать проект | [Вход и рабочий контекст](/docs/buff-code/sign-in) |
| Разработчик | Работать с агентом: поставить задачу, проверить и откатить изменения, вести план и цель, запускать задачи по расписанию | [Работа в Buff Code](/docs/buff-code/work) |
| Руководитель | Смотреть записи работы и задавать по ним вопросы | [Сессии разработки](/docs/buff-code/sessions) |

## Что нужно

- [Коннектор](/docs/connector/install) **v0.17.0** или новее с включённым шлюзом разработчика.
  Более старые версии дают часть возможностей: вход, модели и инструменты подключений — с v0.13.0,
  база знаний — с v0.14.0, репозитории проекта — с v0.15.0, название тарифа вместо модели — с v0.16.0,
  запись сессии разработки самим Buff Code и списание под каждым ответом в кабинете — с v0.17.0,
  остаток и расход прямо в Buff Code — с v0.18.0.
- Учётная запись в Buff и участие в организации, к которой привязан коннектор.
- Отдельного тарифа нет: Buff Code работает в рамках [тарифа организации](/docs/tariffs).

## Страницы раздела

| Страница | О чём |
| --- | --- |
| [Установка](/docs/buff-code/install) | Консоль одной командой, приложение пакетом, подпись выпусков, обновления, массовая раскатка |
| [Шлюз разработчика](/docs/buff-code/gateway) | Для администратора: конфигурация коннектора, сертификат, кого пускает |
| [Вход и рабочий контекст](/docs/buff-code/sign-in) | Код входа, выбор организации и проекта, память по папкам, устройства и их отзыв |
| [Команды](/docs/buff-code/commands) | Справочник консоли и команд внутри Buff Code |
| [Работа в Buff Code](/docs/buff-code/work) | Окно и консоль каждый день: сессия, режимы, изменения и откат, план и цель, побочный диалог, Git, автоматизации, сценарии, расширения, настройки |
| [Модели и расход](/docs/buff-code/models) | Откуда берётся модель, как считается и где виден расход |
| [Инструменты подключений](/docs/buff-code/tools) | Трекеры, документы, свои MCP-серверы; пишущие инструменты; журнал вызовов |
| [База знаний](/docs/buff-code/knowledge) | Что модель читает, как предлагает новую запись и почему запись требует подтверждения |
| [Репозитории проекта](/docs/buff-code/repositories) | Поиск и чтение кода проекта без клона на машине |
| [Сессии разработки](/docs/buff-code/sessions) | Что записывается, где смотреть, вопросы по записям, выгрузка, журнал аудита |
| [Если что-то не работает](/docs/buff-code/troubleshooting) | Сообщения Buff Code и коннектора: что значат и что делать |