# Если что-то не работает

> Сообщения Buff Code, кабинета и коннектора при установке, входе, выборе контекста, вызове моделей и инструментов: что они значат и что сделать.

Все сообщения ниже — настоящие: так Buff Code, кабинет и коннектор пишут на самом деле.
Найдите своё и сделайте то, что написано справа.

## Установка и запуск

| Что видите | Что значит и что делать |
| --- | --- |
| `buff: command not found` после установки | Путь дописан в профиль оболочки, но текущий терминал его не прочитал. Откройте новый терминал или выполните `source ~/.bashrc` (или профиль вашей оболочки). |
| macOS: «Не удаётся проверить разработчика» | Приложение не заверено Apple. Системные настройки → Конфиденциальность и безопасность → «Всё равно открыть». См. [Установка](/docs/buff-code/install#первый-запуск-на-macos-и-windows). |
| 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 снова спрашивает организацию | Так задумано: контекст хранится [по папкам](/docs/buff-code/sign-in#контекст-запоминается-по-папкам). Вход при этом один. |

## Модели

| Что видите | Что значит и что делать |
| --- | --- |
| «Коннектор компании не вернул моделей для организации X» | Администратор не выбрал модель для «Разработки задач» или у организации нет тарифа. См. [Модели и расход](/docs/buff-code/models). |
| В `/models` пусто, провайдера Buff нет | Вход не выполнен или контекст не выбран. Проверьте строку состояния; `/org`. |
| Над полем ввода «Нет модели — войдите в Buff» | Вход ещё не выполнен (или вы нажали «Позже» в знакомстве). «Войти в Buff» — там же. |
| Отказ из-за баланса | На балансе организации нет средств. Пополнить может владелец; ход записан, но не списан. Остаток и запас — «Баланс и расход» (`/balance`). |
| «коннектор не достучался до Buff — попробуйте ещё раз» | Коннектор потерял связь с Buff. Повторите; если долго — администратор проверяет коннектор в кабинете. |

## Инструменты, знания, репозитории

| Что видите | Что значит и что делать |
| --- | --- |
| В `/mcps` нет серверов `buff`, `knowledge`, `repos` | Вход не выполнен, контекст не выбран или коннектор старый: знания требуют v0.14.0, репозитории — v0.15.0. |
| Модель написала «добавляю запись», а записи нет | В `buff run` формы подтверждения отменяются, а без подтверждения ничего не записывается. Работайте в интерфейсе — появится форма. См. [База знаний](/docs/buff-code/knowledge). |
| «Buff ещё готовит ответ: репозиторий проекта загружается впервые или поиск очень широкий» | Не ошибка: первый вызов в проекте или тяжёлый поиск. Модель повторит вызов через полминуты. |
| Пишущий инструмент подключения отказал | У учётной записи подключения нет прав на запись. Это ограничение подключения, а не Buff Code, — администратор коннектора. |

## Работа в окне и консоли

| Что видите | Что значит и что делать |
| --- | --- |
| Свой MCP-сервер: «Не запустился — Команда не найдена…» | Программы сервера нет на этой машине или путь неверный. «Изменить» в «Расширения → MCP»; см. [Расширения](/docs/buff-code/work/extensions#mcp-серверы). |
| Хук или команда проекта не выполняются, над полем ввода — полоса о проверке | Пришедшее из репозитория не запускается, пока вы его не посмотрели. «Проверить» в настройках или `/trust`. |
| «Сначала отправьте первое сообщение сессии: сообщение коммита сочиняется в её контексте» | «Сочинить сообщение» в окне Git нажато в новой сессии. Отправьте задачу, затем повторите — или напишите сообщение сами. |
| «Модель не предложила сообщение — напишите его сами или попробуйте ещё раз» | Модель ответила не текстом. Повторите или напишите сообщение коммита сами. |
| Автоматизация во вкладке «Ждут разрешения» | Запуск дошёл до действия, которое режим запуска не разрешает. Откройте его сессию и ответьте на запрос; режим меняется в «Изменить». |
| Сценарий не начинается, агент правит скрипт | Скрипт сценария не прошёл проверку — агент получил ошибку с номером строки и исправляет сам. Ход прогона — «Сценарии → Прогоны». |

## Сессии в кабинете

| Что видите | Что значит и что делать |
| --- | --- |
| «Чужие сессии разработки видит только владелец организации» | Вы открыли сессию другого разработчика, не будучи владельцем. Так задумано. |
| «Сессии разработки сейчас недоступны» | Хранилище записей временно недоступно; работа в Buff Code при этом продолжается, записи не теряются. Повторите позже. |
| В сессии «Вызовы без сохранённого текста» | В ходах не было текстового сообщения разработчика — например, только служебные вызовы. Раскройте «Служебные вызовы (N)». |
| «За выбранный период сессий нет» | Под фильтры для «Спросить по выборке» не попало ни одной сессии. Расширьте период или снимите фильтр. |

## Ничего не подошло

Напишите на [страницу обратной связи](/contact) или на info@buff.systems: версию (`buff --version`),
систему, что делали и что увидели. Записи сессии помогают разобраться быстрее — укажите её
название или время.