Часто задаваемые вопросы (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: удалите через пакетный менеджер, которым устанавливали.
История чатов и настройки хранятся отдельно в данных приложения. Если нужно удалить их тоже, найдите папку приложения в системной директории данных вашей ОС и удалите вручную.