Установка

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

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

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

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

Приложение

Готовые сборки — на странице релизов:

файл	что это
clauder-desktop-<версия>-windows-x64.exe	Windows: приложение с окном — трей, уведомления, автозапуск. Сервер внутри. Устанавливать не нужно: это один файл, запускается как есть
clauder-desktop-<версия>-macos-arm64.dmg	то же для Mac на Apple Silicon. Бывает не в каждом релизе — образ собирается на отдельной машине, так что берите его из последнего релиза, где он есть
clauder-<версия>.apk	Android — клиент к серверу по сети
clauder-runtime-<версия>.apk	Android — компаньон к клиенту: сервер и Claude Code на самом телефоне. Экспериментальный, только Android 17 и новее
clauder-<версия>.vsix	расширение для VS Code: чат панелью в редакторе, подключается к уже запущенному Clauder
clauder-cli-<версия>-windows-x64.exe, clauder-cli-<версия>-macos-arm64.tar.gz	консольный clauder: чат из терминала (clauder "текст", clauder chat). Крошечный, сам находит запущенный Clauder, а если его нет — поднимает в трей. На Windows положите его рядом с приложением под именем clauder.exe

Готовых сборок под Linux, под Mac на Intel и сервера без окна в релизах нет — их собирают из исходников одной командой.

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

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

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

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

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

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

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

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

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 https://github.com/varyen/clauder.git && 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 https://github.com/varyen/clauder.git
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 (не пересобирать веб-морду).