Управление правами¶
Koda Desktop управляет правами на нескольких уровнях: режим подтверждений, read-only, типы разрешений и настройки доступа для задач по расписанию.
Режим подтверждений¶
Режим подтверждений определяет, насколько часто приложение будет спрашивать ваше решение перед действиями агента.
Запрашивать подтверждение¶
Агент запрашивает разрешение на каждое действие, которому нужен явный ответ пользователя.
Подходит для:
- правок в незнакомом коде
- миграций и изменений конфигурации
- правок в системных файлах
Авто-правки¶
Правки файлов применяются автоматически, остальные действия требуют подтверждения.
Подходит для:
- небольших UI-правок
- текстов и копирайта
- тестов и локальных исправлений
Без подтверждений¶
Все действия выполняются без дополнительных подтверждений.
Подходит для:
- быстрых черновиков
- задач, где вы готовы принять изменения целиком
Типы разрешений¶
Когда агент запрашивает разрешение, доступны несколько вариантов ответа:
| Тип | Действие | Длительность |
|---|---|---|
| Разрешить | Одобрить действие один раз | Только для текущего запроса |
| Разрешать всегда | Одобрить все похожие действия | В рамках текущей задачи |
| Отклонить | Отказать один раз | Только для текущего запроса |
| Отклонять всегда | Отклонять все похожие действия | В рамках текущей задачи |
При остановке ответа кнопкой Стоп приложение также закрывает все ожидающие запросы разрешений.
Read-only¶
Пункт Только чтение включает режим, в котором у агента просто нет инструментов на запись: правка файлов, команды с побочными эффектами и MCP-инструменты недоступны, а запросы разрешений отклоняются автоматически. Никаких дополнительных инструкций модели при этом не даётся.
Этот режим полезен для:
- аудита проекта
- поиска причин багов
- подготовки объяснения без правок
- проверки гипотезы перед реальной задачей
Read-only не изолирует файловую систему
Read-only убирает у агента пишущие инструменты и отклоняет запросы разрешений на изменение, а Shell принимает только простые читающие команды, как в режиме «План». Файловая система физически остаётся изменяемой.
Права для задач по расписанию¶
Для задач по расписанию доступны отдельные режимы доступа, так как подтвердить действие в фоне будет некому:
- Только чтение — агент изучает проект, но не меняет файлы и не запускает команды с побочными эффектами
- Чтение и запись — агент может самостоятельно изменять файлы проекта
- Без ограничений — агент выполняет команды и изменения без подтверждений
Смена режима¶
Режим можно менять и в уже запущенном чате: агент переключается на месте, история и контекст сохраняются. Подсказка под селектором говорит, если в этом чате смена режима всё же перезапустит агента: так бывает только со старой версией Koda CLI.
Смена режима доступа недоступна во время сжатия контекста — дождитесь завершения или остановите процесс.