Записаться на демо
Меню
Как это работаетДля руководителяСравнениеКейсыТарифыБлогДокументация Записаться на демо

Главная / Документация / Рабочая машина

Подключение рабочей машины

После подключения агент на машине разработчика получает знания и правила проекта в контекст при работе с кодом и инструменты mcp__ai-council__*. Машины для задач агента в Workspace настраиваются отдельно.

Что понадобится

  • Claude Code на машине разработчика.
  • Сетевой доступ к серверу Council по тому же адресу, что у интерфейса. Выход в интернет не нужен: пакеты загружаются с сервера.
  • Добавленный и проанализированный проект: доставка работает по проанализированным сущностям.

Установка

  1. Меню учётной записи → Profile & API Keys → + Create Key.
  2. Скопируйте команду из блока Install hooks on your machine: адрес и ключ в ней уже подставлены. Ключ показывается целиком один раз, в списке остаётся только префикс.
  3. Выполните команду на своей машине.
  4. Откройте Claude Code в каталоге проекта и начните новую сессию.
AI_COUNCIL_API_TOKEN=aic_xxx AI_COUNCIL_URL=https://<адрес> \
  bash -c "$(curl -fsSL https://<адрес>/install-hooks.sh)"

Команда распаковывает хуки в ~/.claude/hooks/, записывает адрес и токен в ~/.claude/settings.json и регистрирует хуки и MCP-сервер Council. Повторный запуск ничего не задваивает. Хуки обновляются сами при старте новой сессии после обновления сервера.

Ключ личный

Хуки обращаются к серверу от имени владельца ключа, доступ изолирован по пользователю. Не используйте один ключ на всю команду.

Что происходит в сессии

Хуки и MCP — разные каналы. Хуки добавляют контекст сами в названные моменты, инструменты MCP агент вызывает по своей инициативе.

МоментЧто делают хуки
Начало сессииПодтягивают обновление хуков и, если сессия открыта по задаче, добавляют заметку задачи
Каждый запросДобавляют правила проекта порциями: за несколько запросов агент получает весь свод
Первое чтение кодаОтклоняют его, пока в сессии не вызван ни один инструмент базы знаний, и подсказывают, что вызвать
Чтение и правка файлаДобавляют правила и записи знаний, привязанные к файлу, в пределах заданных объёмов
Правка файловСообщают серверу об изменении, чтобы анализ перечитал изменённое
Завершение ходаОдин раз за сессию показывают список проверок, если в рабочем дереве есть незакоммиченные изменения
Запись знанийПривязывают записанное к файлам, с которыми шла работа

Черновики

Переключатель Draft mode на экране Profile & API Keys: ваши записи знаний и конвенции сохраняются черновиками и видны только вам до подтверждения. У агентов задач черновиков нет: записи сохраняются на ветке задачи и переносятся на ветку по умолчанию при слиянии.

Объём доставки контекста

Profile & API Keys → Context delivery. Пределы задаются в символах для вашей учётной записи и считаются только по каналам ниже; то, что агент запросил инструментами, в них не входит. У каждого канала три положения: No limit, Limit и Off.

КаналЧто приходит
Rules with every promptПравила проекта перед каждым запросом, по очереди
Rulebook at the startВесь свод правил один раз, до первого действия агента
Rules for a fileПравила для файла, который агент читает или правит
Knowledge for a fileЗаписи знаний об этом файле
Whole sessionОбщий предел на разговор
Knowledge already sentСрок, в течение которого выданная запись не присылается повторно целиком

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

СимптомПричина и действие
Знания и правила не приходятПроект не проанализирован или файл вне проанализированных сущностей
Инструменты mcp__ai-council__* не отвечаютПроверьте AI_COUNCIL_URL и токен в ~/.claude/settings.json и доступность адреса
Агенту не хватает контекста под работуУменьшите Rules with every prompt и Knowledge for a file или переведите их в Limit
Одно и то же знание приходит повторноУвеличьте окно Knowledge already sent
Failed to connect … port 443Установка работает без TLS: замените в команде https на http или настройте TLS
Ключ скомпрометированОтзовите ключ в списке или нажмите Regenerate

Дальше: Анализ проекта