Обзор агента
Kodik включает автономного агента, который читает и редактирует файлы, выполняет команды в терминале, выполняет поиск по кодовой базе, загружает страницы из интернета, управляет Integrated Browser для визуальных проверок и вызывает инструменты MCP — при этом каждое действие отображается в чате и требует вашего подтверждения (или выполняется автоматически, если вы настроили авто-одобрение).
Агент работает в одном из пяти режимов, которые определяют его поведение и набор доступных инструментов:
| Режим | Назначение | Изменяет файлы? |
|---|---|---|
| Code (по умолчанию) | Выполнение задач: чтение, редактирование, команды | Да |
| Plan | Создание плана реализации без изменений | Нет |
| Ask | Ответы на вопросы по кодовой базе | Нет |
| Debug | Гипотезы → инструментирование → минимальный фикс | Да |
| Educator | Обучение с пояснениями и интерактивными уроками | Файлы проекта — нет |
Подробнее — в разделе Режимы.
Инструменты
Заголовок раздела «Инструменты»Агент использует набор встроенных инструментов:
- Чтение и навигация —
read_file,glob,rg(ripgrep),codebase_search - Редактирование —
edit_file,create_file,delete_file,edit_notebook - Терминал —
shell(выполнение команд),command_status(опрос фоновых процессов) - Сеть —
web_fetch(только HTTPS) - Браузер —
browserдля открытия локальных страниц, проверки отрендеренного UI, скриншотов, чтения консоли и взаимодействия со страницей - Обучение —
check_understandingдля быстрых проверок понимания иcreate_lessonдля уроков Educator, сохранённых в.kodik/teach - Вспомогательные —
todo_write,memory,ask_questions,read_lints - Субагенты —
sub_agentдля делегирования подзадач - MCP — любые инструменты из подключённых MCP-серверов
Полный справочник инструментов — в разделе Инструменты.
Ключевые возможности рабочего процесса
Заголовок раздела «Ключевые возможности рабочего процесса»Планирование
Заголовок раздела «Планирование»В режиме Plan агент исследует кодовую базу и сохраняет структурированный план через инструмент generate_plan, не внося никаких изменений. Переключитесь в Code, чтобы приступить к реализации. Подробнее — в разделе Планирование.
Контрольные точки
Заголовок раздела «Контрольные точки»Kodik автоматически создаёт контрольную точку после каждого использования инструмента, сохраняя снимок рабочего пространства в теневом Git-репозитории. Вы можете откатиться к любой точке в любое время. Подробнее — в разделе Контрольные точки.
Авто-одобрение
Заголовок раздела «Авто-одобрение»По умолчанию агент запрашивает подтверждение перед каждым действием. Вы можете настроить детализированные разрешения — разрешить чтение файлов, поиск, выполнение определённых команд и многое другое — не снимая контроля над операциями редактирования. В режиме «автопилот» одобряются все действия кроме команд из списка блокировки. Подробнее — в разделе Авто-одобрение.
Прерванные ответы
Заголовок раздела «Прерванные ответы»Если соединение с провайдером обрывается после того, как Kodik уже показал текст, ход рассуждений или результаты инструментов, частичная работа остаётся в чате и помечается как interrupted перед предложением повторить запрос. Подсказка повтора также включает краткий контекст прогресса, чтобы было видно, что сохранено перед новой попыткой.
Если сбой происходит, пока инструмент или foreground-субагент ещё выполняется, Kodik останавливает эту работу и переводит карточку инструмента в завершённое состояние перед подсказкой повтора. Отмена во время permission hook также остаётся отменой: поздний результат hook не может снова открыть одобрение.
Пока Kodik тихо повторяет запрос после временной ошибки провайдера, статус в чате меняется с «Работаем» на сообщение о повторе с номером следующей попытки и задержкой, поэтому долгие ожидания не выглядят как разрыв соединения.
Во время длинных ответов живой текст и ход рассуждений передаются лёгкими обновлениями, поэтому длинные чаты и рабочие области с несколькими панелями продолжают плавно обновляться, а полные снимки состояния по-прежнему отвечают за перезагрузку, инструменты, повторы и переподключения.
В рабочих областях с несколькими панелями Kodik держит видимый выбор панели синхронизированным с выбранной сессией в хосте. Если хост не может переключить сессию, выбор панели откатывается, чтобы следующее действие чата без явной цели не ушло в другую сессию.
Если модель продолжает запрашивать инструменты сверх лимита безопасности для одного пользовательского хода, Kodik останавливает цикл инструментов и помечает чат как требующий ваших указаний. В этом состоянии нет кнопки повтора, потому что повтор, скорее всего, запустит тот же цикл; ответьте более узкими инструкциями, чтобы продолжить.
Если Kodik перезапускается, пока ход стримит текст или ход рассуждений, уже записал текст ассистента, но ещё не завершился, ждёт одобрения, задаёт интерактивный вопрос, выполняет инструмент, ждёт ответ модели после результата инструмента или сжимает контекст, восстановленный чат больше не показывает старое состояние как активное. Уже показанные текст, ход рассуждений и текст ассистента из прерванного хода возвращаются как контекст с возможностью повтора, ожидающие инструменты помечаются как отменённые, завершённые инструменты остаются видимыми с возможностью повтора для пропущенного продолжения, вопросы без ответа возвращаются как контекст только для чтения, неудачное сжатие показывается как ошибка сжатия, а прерванный ход предлагает повтор там, где это возможно.
Сообщения, которые вы поставили в очередь, пока ход выполнялся, после перезапуска восстанавливаются как редактируемые черновики в очереди.
Субагенты
Заголовок раздела «Субагенты»Агент может делегировать изолированные подзадачи дочерним агентам через инструмент sub_agent. Дочерний агент работает в своём собственном контексте и возвращает результат родителю. Подробнее — в разделе Субагенты.
Браузерный предпросмотр
Заголовок раздела «Браузерный предпросмотр»В режимах Code и Debug агент может использовать Integrated Browser, чтобы проверять всё, что рендерится в браузере. Он может запустить локальный предпросмотр, сделать скриншот, прочитать консоль, изменить размер viewport, проинспектировать элементы и взаимодействовать со страницей, пока вы наблюдаете или берёте управление на себя. Подробнее — в разделах Определение dev-сервера и Инструменты.
Просмотр изменений
Заголовок раздела «Просмотр изменений»Все правки файлов отображаются в панели изменений в чате. Вы можете принять или отклонить каждый файл по отдельности, а также открыть режим просмотра diff. Подробнее — в разделе Просмотр изменений.