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