Общие настройки¶
Окно настроек открывается кнопкой Настройки в нижней части боковой панели.

Вкладка «Общие» окна настроек
Тема¶
Доступны три режима оформления:
- светлая тема;
- тёмная тема;
- системная тема.
При выборе системной темы Koda Desktop следует настройкам ОС.
Аккаунт¶
Во вкладке Аккаунт видно состояние входа, email, тариф и доступные лимиты.
Подробно о входе, тарифах и лимитах — на странице Аккаунт.
Запуск CLI¶
Блок Запуск CLI выбирает, как Koda Desktop запускает локального агента: встроенный CLI, npx-пакет или глобальную команду koda.
Приложение проверяет доступность вариантов при открытии настроек и помечает недоступные предупреждением.
Подробно о режимах запуска — на странице Запуск CLI.
Автоматическое сжатие контекста¶
Переключатель Автоматически сжимать контекст (включён по умолчанию) разрешает агенту сжимать контекст самому. Сжатие запускается после того, как модель подтвердит размер контекста: за 40 000 токенов до лимита, а для окон меньше 40 000 токенов — при заполненности 75 %.
Если выключить его, контекст можно сжать вручную — кнопкой в меню индикатора заполненности. Превышение лимита контекста при этом по-прежнему остановит отправку запроса.
Подробно о сжатии — на странице управления контекстом.
Ограничение числа шагов агента¶
Переключатель Ограничивать число шагов агента (включён по умолчанию) задаёт, сколько обращений к модели агент может сделать за один ход, прежде чем остановится. По умолчанию — 100 обращений.
При включённом переключателе рядом появляется поле Запросов к модели за один ход — целое число от 1 до 10 000. Выключите переключатель, чтобы снять ограничение: агент будет работать, пока не завершит задачу или не остановится по другой причине.
О поведении при остановке — в разделе почему задача остановилась.
Системные уведомления¶
Переключатель Системные уведомления включает оповещения от операционной системы, когда окно приложения не в фокусе: завершение задачи, запрос подтверждения, результат задачи по расписанию.
Подробно о поведении уведомлений — на странице Системные уведомления.
Звук завершения ответа¶
Переключатель Звук завершения ответа (включён по умолчанию) включает короткий звуковой сигнал, когда агент закончил ответ в обычном чате.
Сигнал не зависит от переключателя Системные уведомления и не проигрывается для задач по расписанию и чатов из Telegram.
Подробно о поведении — на странице Системные уведомления.
Отладочный лог¶
Переключатель Отладочный лог включает дополнительные служебные сообщения во вкладке «Логи». Это полезно, когда агент не стартует, модель не появляется в списке или запрос останавливается неожиданно.
Проверка обновлений¶
Кнопка Проверить обновления проверяет, доступна ли новая версия, и показывает результат рядом с кнопкой.
Подробнее об установке и обновлении — на странице установки.
Где сохраняются настройки¶
Настройки, проекты и история чатов сохраняются локально в данных приложения. История нужна, чтобы вы могли вернуться к старому диалогу, восстановить контекст задачи и продолжить работу без повторного пересказа.