Часто задаваемые вопросы (FAQ)¶
Что такое Koda Desktop и чем он отличается от плагина для IDE¶
Koda Desktop — это самостоятельное настольное приложение, которое не требует установки в среду разработки. Оно работает с любой папкой на диске, поддерживает чаты, git-действия и вложения. Плагин для IDE, наоборот, встраивается в VS Code или JetBrains и работает внутри редактора.
Вы можете использовать оба продукта — они не конфликтуют.
Нужна ли учётная запись для работы¶
Да, для работы с агентом нужен вход в аккаунт Koda. Без входа приложение не сможет получить доступ к моделям. Войдите в Настройки → Аккаунт и завершите авторизацию в браузере.
Обязательно ли устанавливать Node.js¶
Нет. Встроенный режим запуска агента использует CLI, который уже входит в состав Koda Desktop. Node.js и npm нужны только если вы выбрали режим npx-пакет или Глобальный koda в настройках.
Приложение не запускается на моей платформе¶
Koda Desktop поддерживает:
- macOS (Apple Silicon, arm64);
- Windows 10/11 (x64);
- Linux (AppImage, deb, pacman, x64).
Если приложение не запускается, проверьте версию операционной системы и архитектуру процессора. Для macOS может потребоваться снять атрибут quarantine:
Как перенести историю чатов на другой компьютер¶
История чатов и настройки хранятся локально в данных приложения. Перенос между компьютерами не предусмотрен. На новом компьютере проекты и чаты нужно будет создавать заново.
Сколько чатов можно создать¶
Ограничение — до 100 сессий и до 2000 записей в каждой сессии. При достижении лимита старые сессии архивируются.
См. также: управление контекстом
Можно ли отменить действие после того, как разрешил¶
Если агент уже выполнил действие, отменить его штатными средствами приложения нельзя. Используйте git для возврата изменений: создайте новый чат и попросите агента откатить изменения через git revert.
Вложения не прикрепляются или не отправляются¶
Проверьте формат и размер файла. Поддерживаются:
- изображения: PNG, JPG, WEBP, GIF;
- документы: PDF, DOCX;
- текстовые: TXT, MD, CSV, JSON, XML, LOG.
Один файл — до 20 МБ, суммарно в запросе — до 50 МБ, не более 10 файлов за раз.
Чат не сохраняется или пропал после перезапуска¶
Сессии сохраняются локально. Если приложение было закрыто во время ответа, сессия помечается как завершённая. Откройте чат и отправьте новый запрос, чтобы продолжить.
Где найти логи приложения¶
Вкладка Логи в настройках показывает служебные сообщения текущей сессии. Для более подробной диагностики включите Отладочный лог.
См. также: логи и диагностика
Как удалить приложение полностью¶
- macOS: удалите Koda Desktop из папки Applications.
- Windows: удалите через «Установка и удаление программ».
- Linux: удалите через пакетный менеджер, которым устанавливали.
История чатов и настройки хранятся отдельно в данных приложения. Если нужно удалить их тоже, найдите папку приложения в системной директории данных вашей ОС и удалите вручную.