Режимы запуска CLI¶

Koda Desktop запускает локального агента через Koda CLI — без него приложение работать не может. Доступно три режима запуска, которые настраиваются в общих настройках приложения.

Встроенный (по умолчанию)¶

CLI уже входит в состав Koda Desktop. Отдельно устанавливать Node.js и npm не нужно.

Когда использовать: всегда, если нет специальных требований. Это самый надёжный и быстрый режим.

npx-пакет¶

Загружает @kodadev/koda-cli через Node.js.

Требования:

• Node.js
• npm
• доступ в интернет при первом запуске

Когда использовать: если нужно использовать свежую версию CLI до выхода обновления Desktop.

Глобальный koda¶

Использует команду koda, установленную глобально и доступную через PATH.

Требования:

• Node.js
• глобально установленный пакет @kodadev/koda-cli

Когда использовать: если вы уже используете Koda CLI и хотите, чтобы Desktop использовал ту же версию.

Как работает CLI-процесс¶

Во всех режимах Koda Desktop запускает CLI как отдельный процесс для каждого чата с параметром --acp. Обмен сообщениями происходит через стандартные потоки (stdin/stdout) по протоколу ACP (Agent Client Protocol).

Отдельный терминал или PTY для связи приложения с агентом не используется.

Выбор режима¶

Если вы не уверены, оставьте Встроенный. Выбор применяется, когда для чата в следующий раз запускается агент — новый чат или повторный запрос.

Приложение проверяет доступность CLI при открытии настроек:

• если Node.js не найден, режимы npx и глобальный будут помечены предупреждением;
• если npx или глобальная команда koda не найдены, соответствующие режимы будут помечены предупреждением.

Диагностика проблем¶

Если CLI не запускается:

1. Проверьте текущий режим в настройках.
2. Для встроенного режима — обновите Koda Desktop.
3. Для npx — проверьте Node.js и npm.
4. Для глобального — проверьте, что команда koda доступна в терминале.
5. Посмотрите вкладку Логи в настройках для текста ошибки.

Если агент не находит установленные утилиты (git, python и другие), проверьте PATH — см. решение проблем.