Buff Code
Если что-то не работает
Сообщения Buff Code, кабинета и коннектора при установке, входе, выборе контекста, вызове моделей и инструментов: что они значат и что сделать.
Все сообщения ниже — настоящие: так Buff Code, кабинет и коннектор пишут на самом деле.
Найдите своё и сделайте то, что написано справа.
| Что видите | Что значит и что делать |
|---|
buff: command not found после установки | Путь дописан в профиль оболочки, но текущий терминал его не прочитал. Откройте новый терминал или выполните source ~/.bashrc (или профиль вашей оболочки). |
| macOS: «Не удаётся проверить разработчика» | Приложение не заверено Apple. Системные настройки → Конфиденциальность и безопасность → «Всё равно открыть». См. Установка. |
| Windows: «Система Windows защитила ваш компьютер» | «Подробнее» → «Выполнить в любом случае». Один раз. |
| Приложение висит на заставке | Обычно это чужая копия Buff Code, запущенная раньше. Закройте все окна и процессы buff, запустите заново. |
| «Buff Code не настроен: запустите buff — вход и выбор организации там» | buff run или buff models запущены без терминала (в скрипте, CI) и не могут спросить вход. Сделайте первый вход интерактивно командой buff в той же папке. |
| Что видите | Что значит и что делать |
|---|
| «Неверный адрес коннектора: …» | Адрес не разбирается как URL. Возьмите его из кабинета: карточка коннектора, строка «Вход для Buff Code» — с https:// и портом. |
| «Коннектор компании не ответил: …» | Шлюз недоступен с вашей машины: не та сеть, VPN, порт закрыт или коннектор остановлен. Проверьте curl -I <адрес>; администратор — журнал коннектора, строку developer gateway: listening. |
| Ошибка сертификата при подключении | Сертификат шлюза выпущен вашим центром сертификации, которому машина не доверяет. Укажите его файл переменной NODE_EXTRA_CA_CERTS перед запуском buff, либо попросите администратора поставить публичный сертификат. |
| «Бэкенд не выдал код входа» | Коннектор подключён к Buff, но Buff не ответил. Повторите через минуту; если повторяется — администратор смотрит состояние коннектора в кабинете. |
| «Код входа истёк — начните вход заново» | Код живёт десять минут. Запустите buff ещё раз и подтвердите новый код. |
| «Вход отклонили в кабинете» | На странице входа нажали «Это не я». Если это были вы — начните вход заново. |
| Кабинет: «Слишком много неверных кодов. Подождите 10 минут и запустите вход в консоли заново» | Пять неверных кодов за десять минут. Подождите, запустите buff заново и введите новый код внимательно: восемь букв, без цифр и гласных. |
| «Вход повреждён — войдите заново» | Устройство отозвано в кабинете или его ключ на машине не совпал. Запустите buff и пройдите вход заново; если это не вы отзывали — спросите владельца организации. |
| «Вы пока не состоите ни в одной организации Buff…» | Вход прошёл, но вас ещё не добавили ни в одну организацию. Попросите администратора добавить вас и выберите организацию снова. |
| «этот коннектор работает для организации X, а вход выполнен в другую» | Вы подтвердили вход в другой организации. /org — выберите ту, к которой привязан коннектор. |
| Что видите | Что значит и что делать |
|---|
| «Сначала выберите организацию: /org» | В этой папке контекст ещё не выбран. Выполните /org, затем /project. |
| «Этого нет среди доступного вам: организация, проект или пространство без прав» | Выбранное перестало быть вам доступно — вас исключили из проекта или проект удалили. Выберите другой через /project. |
| «Сначала выберите проект в рабочем контексте Buff Code (/project)» | Инструменты репозиториев проекта требуют выбранного проекта: «Без проекта» им не хватает. /project. |
| В другой папке Buff Code снова спрашивает организацию | Так задумано: контекст хранится по папкам. Вход при этом один. |
| Что видите | Что значит и что делать |
|---|
| «Коннектор компании не вернул моделей для организации X» | Администратор не выбрал модель для «Разработки задач» или у организации нет тарифа. См. Модели и расход. |
В /models пусто, провайдера Buff нет | Вход не выполнен или контекст не выбран. Проверьте строку состояния; /org. |
| Над полем ввода «Нет модели — войдите в Buff» | Вход ещё не выполнен (или вы нажали «Позже» в знакомстве). «Войти в Buff» — там же. |
| Отказ из-за баланса | На балансе организации нет средств. Пополнить может владелец; ход записан, но не списан. Остаток и запас — «Баланс и расход» (/balance). |
| «коннектор не достучался до Buff — попробуйте ещё раз» | Коннектор потерял связь с Buff. Повторите; если долго — администратор проверяет коннектор в кабинете. |
| Что видите | Что значит и что делать |
|---|
В /mcps нет серверов buff, knowledge, repos | Вход не выполнен, контекст не выбран или коннектор старый: знания требуют v0.14.0, репозитории — v0.15.0. |
| Модель написала «добавляю запись», а записи нет | В buff run формы подтверждения отменяются, а без подтверждения ничего не записывается. Работайте в интерфейсе — появится форма. См. База знаний. |
| «Buff ещё готовит ответ: репозиторий проекта загружается впервые или поиск очень широкий» | Не ошибка: первый вызов в проекте или тяжёлый поиск. Модель повторит вызов через полминуты. |
| Пишущий инструмент подключения отказал | У учётной записи подключения нет прав на запись. Это ограничение подключения, а не Buff Code, — администратор коннектора. |
| Что видите | Что значит и что делать |
|---|
| Свой MCP-сервер: «Не запустился — Команда не найдена…» | Программы сервера нет на этой машине или путь неверный. «Изменить» в «Расширения → MCP»; см. Расширения. |
| Хук или команда проекта не выполняются, над полем ввода — полоса о проверке | Пришедшее из репозитория не запускается, пока вы его не посмотрели. «Проверить» в настройках или /trust. |
| «Сначала отправьте первое сообщение сессии: сообщение коммита сочиняется в её контексте» | «Сочинить сообщение» в окне Git нажато в новой сессии. Отправьте задачу, затем повторите — или напишите сообщение сами. |
| «Модель не предложила сообщение — напишите его сами или попробуйте ещё раз» | Модель ответила не текстом. Повторите или напишите сообщение коммита сами. |
| Автоматизация во вкладке «Ждут разрешения» | Запуск дошёл до действия, которое режим запуска не разрешает. Откройте его сессию и ответьте на запрос; режим меняется в «Изменить». |
| Сценарий не начинается, агент правит скрипт | Скрипт сценария не прошёл проверку — агент получил ошибку с номером строки и исправляет сам. Ход прогона — «Сценарии → Прогоны». |
| Что видите | Что значит и что делать |
|---|
| «Чужие сессии разработки видит только владелец организации» | Вы открыли сессию другого разработчика, не будучи владельцем. Так задумано. |
| «Сессии разработки сейчас недоступны» | Хранилище записей временно недоступно; работа в Buff Code при этом продолжается, записи не теряются. Повторите позже. |
| В сессии «Вызовы без сохранённого текста» | В ходах не было текстового сообщения разработчика — например, только служебные вызовы. Раскройте «Служебные вызовы (N)». |
| «За выбранный период сессий нет» | Под фильтры для «Спросить по выборке» не попало ни одной сессии. Расширьте период или снимите фильтр. |
Напишите на страницу обратной связи или на info@buff.systems: версию (buff --version),
систему, что делали и что увидели. Записи сессии помогают разобраться быстрее — укажите её
название или время.