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

Список сессий пуст

Проверьте, что CLAUDE_HOME указывает на настоящий ~/.claude хоста и что внутри есть projects/. Подсказать путь может ./scripts/detect-claude-homes.sh, а в приложении — clauder --print-config: он печатает каталоги, которые сервер читает на самом деле.

Чат не запускается

Скорее всего, в смонтированном ~/.claude нет живого OAuth-токена — залогиньтесь в Claude Code на хосте. Каталог монтируется на запись не случайно: SDK обновляет там токен и пишет сессии.

У приложения причина обычно другая: не нашёлся установленный claude. Путь задаётся явно — CLAUDE_BIN или раздел «Агент» в настройках.

EADDRINUSE в логах api

Хот-релоад не успел отпустить порт после правки: docker compose restart api.

В контейнере api нет java, gh или curl

Образ отстал от api/Dockerfile. docker compose build api пересоберёт его, но работающий контейнер останется на старом слое до docker compose up -d api.

Прежний чат отдаёт 404

Api перезапускался, а сессии агента живут в памяти. Просто отправьте сообщение снова — клиент сделает resume.

Ответ 410 значит другое: сессию завершили кнопкой, и её надо продолжать заново.

Сообщения чужой сессии видно только после завершения ответа

Не подключён хук UserPromptSubmit — api о них попросту не знает. См. Хуки.

«Продолжить в чате» недоступно

Сессия из другого источника — например, Windows при запуске в WSL. Для неё работает ответ через хостовый мост, если тот настроен.

Цифры расхода отстают или пусты

Индекс догоняется сканированием и первым заходом упирается в бюджет — повторный запрос доберёт остаток. Совсем сломанный индекс лечится удалением clauder.db рядом с каталогом сессий: он пересоберётся (вместе с ним уедут избранное, названия и отметки «прочитано»).

Бот показывает 409 Conflict

Один токен — один полинг. Clauder в докере и он же в приложении не могут крутить одного бота вдвоём.

В браузере нет уведомлений

Web Push требует https (или localhost). В локальной сети по http уведомления есть только в приложении, в Android и в боте — см. Уведомления.

Проекты раздвоились

Обычно это WORKSPACE_ROOT, проброшенный в контейнер не по тому же пути, что на хосте: Claude Code сгенерирует другой slug каталога, и сессии чата разъедутся с хостовыми.

Терминал работает построчно

Так и задумано на Windows: pty у Bun там пока нет, поэтому оболочка идёт через каналы. Что при этом не работает — в разделе Терминал.