Переменные и настройки
В докере всё это живёт в .env рядом с docker-compose.yml (образец — .env.example). В приложении те же настройки правятся в окне и хранятся в config.json в каталоге clauder-data.
Не ищите файл, если у вас приложение
Всё, что ниже помечено как переменная, в приложении есть отдельной строкой в настройках. Открывать config.json руками не нужно.
Обязательный минимум
| Переменная | Что это |
|---|---|
API_KEY | ключ доступа — единственный вход. openssl rand -hex 32. Короче 8 символов — считается выключенным |
CLAUDE_HOME | путь к вашему ~/.claude на хосте (монтируется в контейнер на запись) |
Каталоги и порты
| Переменная | Что это |
|---|---|
CLAUDE_DATA_DIR | каталог сессий внутри контейнера |
CLAUDE_DATA_DIRS | несколько источников: windows=/data/claude-windows,wsl=/data/claude-wsl |
EXTRA_CLAUDE_HOME | второй профиль — сторона WSL или Windows |
WORKSPACE_ROOT | рабочий корень; пробрасывается по тому же пути, что и на хосте |
EXTRA_WORKSPACE_ROOT | ещё один корень — добавлять осознанно, всё смонтированное агенту доступно |
API_PORT | порт api внутри контейнера |
CLAUDER_DB | путь к SQLite-индексу |
Агент
| Переменная | Что это |
|---|---|
AGENT_ENABLED | выключает чат целиком: остаётся просмотр |
AGENT_WORKSPACE_ROOTS | каталоги, разрешённые как cwd |
AGENT_PERMISSION_MODE | режим прав: bypassPermissions, default, plan, acceptEdits |
AGENT_MODEL | модель по умолчанию |
AGENT_FALLBACK_MODEL | на что падать, когда основная недоступна |
AGENT_SETTING_SOURCES | откуда CLI берёт настройки |
AGENT_FILE_CHECKPOINTS | точки отката файлов |
AGENT_AUTO_TITLE | называть чат по первому сообщению |
AGENT_ENTRYPOINT | чем запускать CLI |
AGENT_MAX_RUNS | потолок одновременных сессий |
AGENT_IDLE_TTL_MIN | минуты простоя до автозакрытия сессии |
CLAUDE_BIN | путь к установленному claude, если он не находится сам |
Уведомления и бот
| Переменная | Что это |
|---|---|
VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY | свои ключи Web Push (npx web-push generate-vapid-keys); без них api создаёт свои |
VAPID_SUBJECT | контакт для push-сервиса |
TELEGRAM_BOT_TOKEN | токен бота от @BotFather |
TELEGRAM_APP_URL | адрес, который бот подставляет в кнопки «Открыть» |
HOOK_TOKEN | общий секрет для приёма событий хуков; openssl rand -hex 32. Пустой или прежняя заглушка change-me-hook-token — хуки выключены |
Наблюдение за файлами
| Переменная | Что это |
|---|---|
CLAUDER_WATCH_POLL_MS | как часто опрашивать хвост файла |
CLAUDER_WATCH_LAZY | не следить за тем, на что никто не смотрит |
CLAUDER_WATCH_LINGER_MS | сколько держать слежение после ухода зрителя |
CLAUDER_WATCH_NETWORK | режим для сетевых монтирований, где события теряются |
Соседи и мост
| Переменная | Что это |
|---|---|
CLAUDER_PEER, CLAUDER_PEER_URL | второй Clauder рядом |
CLAUDER_FOREIGN_ROOTS | чужие корни, которые видно только на чтение |
CLAUDER_COMPANION_HOMES | 0 отключает автопоиск второй стороны WSL/Windows |
HOST_BRIDGE_ENABLED, HOST_BRIDGE_SCRIPTS | мост на хост |
HOST_CLAUDE_BIN, HOST_CLAUDE_PERMISSION_MODE | чем и как мост запускает claude на той стороне |
Прочее
| Переменная | Что это |
|---|---|
CLAUDER_SHELL | оболочка для терминала |
CLAUDER_WEB_PACK | собранная веб-морда, которую сервер раздаёт сам |
GH_TOKEN | токен GitHub для выпуска релизов из чата — агенту он тоже виден, см. Безопасность |
Полный список с комментариями — в .env.example репозитория; он и есть источник правды.