Установка

Способов два, и они не заменяют друг друга.

	приложение	docker compose
что это	один бинарник (сервер + веб-морда), при желании с окном	режим разработки с hot-reload
что нужно на машине	ничего, кроме установленного Claude Code	Docker с Compose
настройки	config.json в каталоге приложения, правится в окне	.env рядом с docker-compose.yml
кому	«поставил и пользуюсь»	«правлю код самого Clauder»

Общее требование

Claude Code должен стоять на этой машине. Clauder запускает его же CLI, а с подпиской Claude — авторизуется его OAuth-токеном из ~/.claude. Без Claude Code список сессий покажется, а чат не запустится.

Подписка Claude при этом не обязательна: без неё агент работает через облако по ключу API — DeepSeek, OpenRouter, Kimi, Z.ai, MiniMax. Подключается это в «Настройках → Модели», см. Модели и провайдеры.

Приложение

Готовые сборки выдаются по запросу — напишите в Telegram @varyen:

файл	что это
clauder-desktop-<версия>-windows-x64.exe	Windows: приложение с окном — трей, уведомления, автозапуск. Сервер внутри. Устанавливать не нужно: это один файл, запускается как есть
clauder-desktop-<версия>-macos-arm64.dmg, …-macos-x64.dmg	то же для Mac: arm64 — Apple Silicon, x64 — Intel. Бывает не в каждом релизе — образы собираются на отдельной машине, так что берите их из последнего релиза, где они есть
clauder-desktop-<версия>-linux-amd64.deb	Linux: приложение с окном — трей, уведомления, автозапуск. Сервер внутри
clauder-server-<версия>-linux-amd64.deb	Linux: сервер без окна — для домашней машины и запуска службой; интерфейс открывается в браузере
clauder-<версия>.apk	Android — клиент к серверу по сети
clauder-runtime-<версия>.apk	Android — компаньон к клиенту: сервер и Claude Code на самом телефоне. Экспериментальный, Android 10 и новее
Clauder-<версия>.ipa, Clauder-<версия>-trollstore.ipa	iPhone и iPad — клиент к серверу по сети; ставится через Sideloadly, AltStore или TrollStore, см. iPhone и iPad
clauder-<версия>.vsix	расширение для VS Code: чат панелью в редакторе, подключается к уже запущенному Clauder
clauder-cli-<версия>-windows-x64.exe, …-macos-{arm64,x64}.tar.gz, …-linux-x64.tar.gz	консольный clauder: чат из терминала (clauder "текст", clauder chat). Крошечный, сам находит запущенный Clauder, а если его нет — поднимает в трей. На Windows положите его рядом с приложением под именем clauder.exe

Сервера без окна под Windows и Mac в релизах нет — его собирают из исходников одной командой.

На Linux пакет ставится как обычно — sudo apt install ./clauder-desktop-<версия>-linux-amd64.deb, приложение появится в меню, сам файл — /usr/bin/clauder-desktop. Консольный clauder — из архива: tar -xzf clauder-cli-<версия>-linux-x64.tar.gz -C ~/.local/bin.

На Mac образ открывается как обычно: перетащите Clauder в «Программы». Приложение не нотаризовано, поэтому при первом запуске macOS может сказать, что оно повреждено или от неизвестного разработчика. Снимите карантин и откройте снова:

xattr -dr com.apple.quarantine /Applications/Clauder.app

Консольный clauder на Mac — из архива, и карантин с него снимите до первого запуска:

tar -xzf ~/Downloads/clauder-cli-*-macos-*.tar.gz -C /usr/local/bin
xattr -d com.apple.quarantine /usr/local/bin/clauder

Запущенный с карантином, он молча зависает: macOS ждёт ответа в окне проверки, и пока его не закрыть, не запускается ни этот файл, ни новый по тому же пути.

Ключ доступа и адрес приложение показывает само — в настройках, в группе «Подключение».

Дальше скачивать новые версии вручную не нужно: Clauder и Claude Code обновляются кнопкой из настроек — см. Обновление.

Сервер без окна: запуск и флаги

Это для сервера, собранного из исходников, — у приложения с окном этих флагов нет, всё то же правится в его настройках.

clauder                      # по умолчанию слушает только петлю, порт 4221
clauder --host 0.0.0.0       # открыть доступ телефону — осознанное действие
clauder --print-config       # где настройки, где сессии, какой ключ доступа
clauder --install-agent      # поднимать сервер фоном при входе в систему

Чат прямо в терминале

Тот же файл — ещё и консольный клиент: он не поднимает второй сервер, а разговаривает с уже работающим, так что чат виден и в браузере, и на телефоне.

clauder chat                 # чат в терминале: пишете строку — агент отвечает
clauder send "почини тесты"  # одно сообщение, с ответом
clauder -p "что в логах?"    # то же для скриптов
clauder sessions             # последние чаты
clauder env                  # где сервер, есть ли ключ, что за окружение

Свои слэш-команды кладутся файлами и появляются во всех клиентах сразу — как это устроено, написано в справке clauder help.

Дальше — Первый запуск.

docker compose

git clone <адрес репозитория> clauder && cd clauder
cp .env.example .env

В .env заполните минимум две строки:

Переменная	Что это
API_KEY	ключ доступа — единственный вход. Сгенерировать: openssl rand -hex 32
CLAUDE_HOME	путь к вашему ~/.claude на хосте (по умолчанию /root/.claude)

Дальше:

docker compose up -d

• Веб-интерфейс — http://localhost:4240
• Проверка API — http://localhost:4221/api/health

Первая сборка занимает пару минут: контейнеры ставят зависимости при старте. Если что-то не поднялось — docker logs clauder-api --since 5m.

Важная деталь монтирования

WORKSPACE_ROOT (по умолчанию /var/www) пробрасывается в контейнер по тому же пути, что и на хосте. Иначе Claude Code сгенерирует другой slug каталога, и сессии чата разъедутся с хостовыми — в списке появятся две половины одного проекта.

Каталог ~/.claude монтируется в api на запись, и это не небрежность: Agent SDK пишет туда сессии и обновляет OAuth-токен.

Собрать самому

Из чистого клона — одной командой:

git clone <адрес репозитория> clauder
cd clauder
./scripts/build-local.sh --check        # чего не хватает на этой машине
./scripts/build-local.sh                # собрать всё для своей системы

Готовое к установке окажется в папке releases в корне проекта; в api/desktop/out рядом остаётся всё промежуточное.

Кросс-компиляции у оболочки нет — Windows нужен MSVC с WebView2, macOS свой SDK и hdiutil, — поэтому каждая система собирает своё:

система	что получится
Linux	сервер, .deb сервера, .deb приложения с окном
macOS	сервер под arm64 и x64, их .dmg, .dmg приложения под обе архитектуры
Windows	clauder-server-…exe, clauder-desktop-…exe

Что поставить заранее: Node 20+, bun и — для приложения с окном — Rust с cargo install tauri-cli --version '^2'. На Linux ещё заголовки webview (libwebkit2gtk-4.1-dev, libayatana-appindicator3-dev, librsvg2-dev, patchelf), на macOS — xcode-select --install. Про всё это скрипт скажет сам, с командой установки.

Первая сборка идёт минут пять-десять (Rust и Nuxt), повторные заметно быстрее. Полезные флаги: --server (только сервер), --shell (только окно), --skip-web (не пересобирать веб-морду).