Обзорное знакомство с плагином¶
Если хочется быстро почувствовать, чем Koda полезна в реальной работе, не обязательно сразу читать всю документацию подряд. Достаточно понять, какие режимы у неё есть и в какой момент какой из них удобнее включать.
Ниже — короткая карта возможностей.
Режим чата — это самый естественный способ начать знакомство с Koda. Вы задаёте вопрос, прикладываете нужный контекст и получаете ответ: объяснение, пример, идею для рефакторинга или план действий.
Когда это полезно
Чат хорош, когда нужно разобраться в коде, обсудить решение, получить пример или быстро проверить гипотезу.

Агент нужен для задач, которые состоят из нескольких шагов: изучить проект, найти нужные места, подготовить изменения, проверить результат. Он нужен там, где обычного ответа уже мало и требуется довести задачу до конца.
Когда это полезно
Агент стоит выбирать для более объёмных задач с изменением файлов: рефакторинга, добавления функциональности, исправления связанных ошибок и наведения порядка в проекте.

Автодополнение помогает в тот момент, когда вы и так уже пишете код.
Это самый «незаметный» режим.
Koda подсказывает продолжение строк и блоков, не ломая рабочий ритм и не заставляя каждый раз формулировать отдельный запрос.
Когда это полезно
Автодополнение экономит время на рутинных участках: шаблонных конструкциях, типах, обработчиках, повторах существующего стиля кода.

Сравнение режимов¶
| Режим | Изменение файлов | Многошаговость | Контекст |
|---|---|---|---|
| Чат | ❌ Нет | ✅ Да | Файлы, код, документация |
| Агент | ✅ Да | ✅ Да | Все источники + инструменты |
| Автодополнение | ✅ Да | ❌ Нет | Текущий файл + контекст |
Практический сценарий¶
На практике режимы часто сменяют друг друга в рамках одной задачи. Например, это может выглядеть так:
1. Чат: «Покажи хороший подход к форме с валидацией»
2. Агент: «Внеси изменения в мой проект по этому подходу»
3. Автодополнение: корректирую мелкие детали
Такой переход между режимами — не обходной путь, а обычный рабочий процесс.