Руководство администратора
Как развернуть Cusp в команде. Организация, управляемые настройки, установка и обновления, сеть, телеметрия, поддержка платформ и где хранятся данные.
Это руководство для тех, кто разворачивает Cusp и следит за соблюдением политик. Пункты с пометкой Пока нет сегодня не существуют. Мы перечисляем их, чтобы вы могли это учесть.
Настройка организации
-
Создайте организацию и пригласите людей в разделе Аккаунт → Организация. Роли: владелец, администратор и участник; см. Организации.
-
Выберите тариф в разделе Аккаунт → Тариф и оплата. Enterprise — это договор; пишите на sales@cusp.run.
-
Задайте лимиты расходов:
- месячный лимит расхода сверх тарифа;
- бюджет на участника по умолчанию, с личными бюджетами для отдельных людей.
Расход можно выгрузить в CSV для внутренних расчётов. См. Тарифы и оплата.
-
Решите, как обращаться с данными. В разделе Тариф и оплата → Модели Cusp и ваши данные на Team и Enterprise можно потребовать режим без хранения данных для моделей Cusp. Запросы к моделям Cusp никогда не уходят провайдерам, которые могут на них обучаться. См. Ваши данные.
-
Смотрите журнал в разделе Аккаунт → Организация → Журнал или выгружайте его в формате JSON Lines для SIEM.
Пока нет:
- единого входа (SAML или OIDC), SCIM, подтверждения домена и автоматического вступления;
- своих ролей;
- политик, которые облако рассылает на устройства.
Управляемые настройки
Cusp читает файл управляемых настроек, который пользователи не могут переопределить. Разверните его привычными средствами: файлом в профиле MDM, копированием через групповые политики или системой управления конфигурацией.
| ОС | Управляемые настройки | Управляемые MCP-серверы |
|---|---|---|
| macOS | /Library/Application Support/Cusp/managed-settings.json | managed-mcp.json в той же папке |
| Windows | C:\Program Files\Cusp\managed-settings.json | managed-mcp.json в той же папке |
| Linux | /etc/cusp/managed-settings.json | managed-mcp.json в той же папке |
Управляемые файлы того же формата, уже развёрнутые для других агентов (…/ClaudeCode/…, /etc/claude-code/…), тоже читаются, с приоритетом ниже,
чем у файлов Cusp. Управляемый CUSP.md в той же папке добавляет инструкции организации в каждую сессию.
Приоритет, от высшего к низшему: управляемые, затем --settings из командной строки, затем локальные настройки
проекта, затем настройки проекта, затем настройки пользователя.
- Одиночные значения берутся с самого высокого уровня, где они заданы.
- Списки объединяются.
Некоторые ключи работают иначе:
| Ключ | Что делает |
|---|---|
permissions.disableBypassPermissionsMode, permissions.disableAutoMode | Сессии нельзя переключить в режим обхода или автоматический режим. Действует с любого уровня |
permissions.blockReadsOutsideWorkingDirectories | Агент не читает файлы за пределами папок проекта |
sandbox.allowUnsandboxedCommands: false | Ни одна команда не запускается вне песочницы ОС, даже с подтверждением |
availableModels | Можно пользоваться только этими моделями. Список с самого высокого уровня заменяет остальные |
allowedMcpServers, deniedMcpServers | Какие MCP-серверы можно подключать: по имени, URL или команде |
strictKnownMarketplaces, allowedExtensions | Какие маркетплейсы и расширения Hub можно ставить. Пустой список запрещает установку |
sandbox.network.allowedDomains | Куда могут ходить команды в песочнице. Управляемый список заменяет пользовательский |
allowManagedHooksOnly, allowManagedPermissionRulesOnly, disableAllHooks | Действуют только ваши хуки и правила разрешений (только в управляемом файле) |
Настройки самого проекта не могут:
- включить автоматический режим или режим обхода;
- расширить песочницу;
- задать защищённые переменные окружения;
- добавить хуки или разрешающие правила, пока человек не доверил папку.
Если управляемый файл — невалидный JSON, он пропускается с предупреждением. Проверьте его перед развёртыванием.
Пока нет:
- родных форматов MDM (профилей конфигурации, ADMX);
- управляемых ключей для телеметрии, синхронизации, отключения Hub и обновлений;
- списка разрешённых провайдеров.
Установка и обновления
Десктопное приложение. Идентификатор run.cusp.desktop, издатель Wex Labs Limited. Загрузки — на
cusp.run/download.
| ОС | Пакеты | Примечания |
|---|---|---|
| macOS 12+ | Универсальный .dmg | Подписан и нотаризован. .pkg пока нет. Разворачивайте .app через MDM |
| Windows 10/11 x64 | .exe (NSIS, для пользователя) и .msi | Пока без подписи кода, поэтому SmartScreen предупреждает. WebView2 скачивается при установке |
| Linux x64 | .AppImage, .deb, .rpm | Для песочницы оболочки установите bubblewrap |
Тихая установка — стандартными ключами установщиков (NSIS /S, msiexec /qn). Между версиями мы её пока не проверяли.
Обновления.
- Приложение проверяет обновления при запуске и раз в день и спрашивает перед установкой. По умолчанию стабильный канал; переключиться на бету можно в приложении.
- Файлы обновлений берутся из релизов GitHub (§ Сеть).
- Пока нет: отключения обновлений, закрепления версии и выбора канала политикой.
CLI.
Будет доступно с первым публичным релизом.
- Для CI
cusp setup-tokenрегистрирует токен устройства.
Сеть
Cusp нужен исходящий HTTPS к:
| Хост | Зачем | Когда |
|---|---|---|
api.cusp.run | Аккаунт, синхронизация, модели Cusp, телеметрия, на которую вы согласились | Выполнен вход |
app.cusp.run | Веб-приложение | В браузере |
hub.cusp.run | Расширения и Hub | Просмотр и установка расширений |
github.com, objects.githubusercontent.com | Обновления приложения и CLI, загрузки | При обновлении |
models.dev | Каталог моделей (названия, лимиты, цены) | Периодически |
| API ваших провайдеров моделей | Вызовы с вашими ключами, например api.anthropic.com, api.openai.com, openrouter.ai | С вашими ключами |
api.github.com или ваш GitHub Enterprise Server | Возможности GitHub | Если подключён |
Синхронизация и удалённое управление идут по WebSocket к api.cusp.run.
На компьютере:
- Демон слушает только
127.0.0.1, на случайном порту. - Другие адреса он не принимает без
--allow-remote. - Его прокси песочницы и сервер предпросмотра тоже работают только на loopback.
Прокси и свои центры сертификации:
- CLI и демон учитывают стандартные
HTTPS_PROXY,NO_PROXYиNODE_EXTRA_CA_CERTS. Проверьте их в своей среде до развёртывания. - Пока нет: чтения системного прокси и PAC-файлов в десктопном приложении и клиентских сертификатов (mTLS).
Телеметрия
Телеметрия выключена, пока человек не согласится при настройке:
- отчёты о сбоях очищаются от путей, токенов и кода;
- метрики использования — это счётчики и времена с меткой модели.
Чтобы на компьютере она оставалась выключенной, задайте в окружении CUSP_TELEMETRY=off или DO_NOT_TRACK=1. CLI и
демон это учитывают. Пока нет: управляемой настройки, которая выключает её во всём парке в десктопном приложении.
Поддержка платформ
| macOS | Linux | Windows | |
|---|---|---|---|
| Песочница оболочки | Да (Seatbelt) | Да (bubblewrap, нужно установить) | Нет: команды оболочки отклоняются, пока человек не разрешит запуск без песочницы |
| Список разрешённых хостов в песочнице | Применяется | Только через прокси (не жёсткая блокировка) | — |
| Хранение секретов, десктоп | Keychain | Secret Service | Credential Manager |
| Хранение секретов, CLI | Keychain | Secret Service (secret-tool) | Переменные окружения |
Где хранятся данные на компьютере
| Что | Где |
|---|---|
| Данные демона (база сессий, файлы, worktree, артефакты) | ~/.cusp для CLI (изменить: CUSP_DATA_DIR). Десктопное приложение — в своей папке данных, например ~/Library/Application Support/run.cusp.desktop/daemon на macOS |
| Настройки | ~/.cusp/settings.json; в проектах — .cusp/settings.json |
| Журналы | cusp-daemon.log в папке журналов приложения или ~/.cusp/logs. Ротация 5 × 5 МБ; уровень задаёт CUSP_LOG_LEVEL |
| Локальный журнал аудита | harness/audit/<сессия>.jsonl в папке данных: решения о разрешениях и соединения через прокси, хранится 90 дней (CUSP_AUDIT_RETENTION_DAYS) |
Облако хранит данные в сроки из раздела Ваши данные.