В свежей версии CLI-ассистента Koda 0.3.1 улучшена поддержка протокола ACP (Agent Client Protocol). Рассказываем, как интегрировать ассистента в популярные IDE и работать с ним напрямую — без использования терминала.

Что такое ACP

Протокол ACP позволяет ИИ-ассистенту взаимодействовать с IDE через HTTP, используя WebSocket или JSON-RPC. Архитектура напоминает классическую клиент-серверную схему: ассистент запускается в фоне, а среда разработки выступает в роли клиента.

Вся работа с агентом отображается в интерфейсе IDE — никаких терминалов. Полное описание протокола доступно по ссылке. Также есть список клиентов, поддерживающих ACP. Если ваша IDE в нём есть — вы можете подключить Koda. Если нет или возникают ошибки — сообщите нам, разберёмся.

Установка koda-cli и подготовка

Для начала потребуется установить koda-cli. Даже если вы хотите избежать терминала в дальнейшем, на этапе настройки он понадобится.

Убедитесь, что установлен Node.js версии 20.0.0 или выше. Если его нет — скачайте с официального сайта или установите через репозитории вашего дистрибутива. При необходимости используйте nvm для переключения версий.

Установите или обновите koda-cli до версии 0.3.1:

После установки обязательно авторизуйтесь командой /auth и выберите «Войти через Koda Auth». Это даёт доступ к расширенному пакету бесплатных запросов к моделям koda-base и koda-pro, а также к одному месяцу бесплатных запросов к внешним моделям, включая gpt-5.4 и minimax-m2.7.

Также полезно знать абсолютные пути к исполняемым файлам node и koda — они могут понадобиться при настройке. Узнать их можно командами:

В любой момент можно посмотреть доступные аргументы через koda --help. Ниже приведены только необходимые параметры, но вы можете настроить поведение по своему усмотрению.

Настройка Zed

Zed — современный редактор, ориентированный на ИИ-ассистентов и агентскую разработку. Его поддержка была в числе самых частых запросов от сообщества. Установить редактор можно с официального сайта.

После запуска откройте палитру команд и выберите Open Settings File. В начало конфигурационного файла добавьте один или несколько блоков для подключения Koda CLI:

Затем откройте Agent Panel через правый нижний угол интерфейса. В заголовке панели нажмите на меню и выберите Settings.

В разделе External Agents вы должны увидеть запись с названием Koda CLI и зелёной галочкой — это означает, что подключение успешно.

Теперь можно начать первую сессию: нажмите + рядом с New Thread и выберите Koda CLI.

JetBrains IDE (v2026+)

Новые версии JetBrains IDE поддерживают подключение сторонних ассистентов через ACP. Функция доступна из коробки с плагином AI Assistant. В более ранних версиях плагин нужно установить или активировать вручную.

Раньше этот плагин работал только с внутренними агентами JetBrains, но теперь в рамках бета-тестирования можно подключать и внешние — в том числе Koda CLI. Подписка и учётная запись JetBrains не требуются.

Откройте панель AI Chat, вызовите меню и выберите Add Custom Agent.

Добавьте конфигурацию, похожую на ту, что используется в Zed, но с небольшими отличиями:

Обратите внимание: параметр type здесь не нужен. Поле command должно содержать абсолютный путь к исполняемому файлу koda. Как и в Zed, можно указать разные комбинации command и args.

Проверить подключение можно сразу: нажмите + New Chat в заголовке панели AI Chat и выберите Koda CLI.

Заключение

Мы рассмотрели два популярных примера интеграции. Настройка других редакторов, поддерживающих ACP, будет аналогичной. Уточните в документации вашей IDE, есть ли встроенная поддержка протокола или доступны ли сторонние плагины.

Для VSCode существует отдельный плагин Koda. Также можно использовать koda-cli через сторонние ACP-расширения или через компаньон-плагин для прямого подключения к интерактивной сессии в терминале VSCode.

Делитесь отзывами, идеями и сообщайте о багах — мы всё читаем и стараемся помочь.

Привет. В свежей версии CLI-ассиcтента Koda 0.3.1 мы доработали поддержку ACP (Agent Client Protocol) и хотим поделиться туториалом — как настроить интеграцию с ним прямо сейчас на примере пары популярных IDE.

Протокол ACP позволяет общаться с ИИ-ассистентом напрямую по HTTP посредством WebSocket или JSON-RPC. В сущности, это классическая клиент-серверная архитектура: ассистент запускается в фоновом режиме средой разработки, которая, в свою очередь, выступает клиентом к нему же. В среде разработки имеется пользовательский интерфейс и весь агентский флоу отражается именно в нём, а не в терминале.

Это если вкратце и по-обывательски. Полное описание доступно поэтой ссылке, там всё намного подробнее.А вот здесьможно найти полный список клиентов, которые поддерживают ACP. Если в этом списке есть твой любимый софт, значит с ним можно будет использовать ассистента Кода, а если нет или при работе встречаются баги —пиши нам, разберёмся.

Такой принцип можно использовать в любом ПО, которое поддерживает этот протокол. Но для полного порядка я начну с чистой установки самого ассистента. Для этого терминал нам всё-таки понадобится. Если ранее вы не использовали koda-cli, то сейчас есть отличный повод попробовать.

Установка koda-cli и подготовка

Поскольку мы начинаем с нуля, то устанавливаем node. Ничего сложного там нет, просто ставим свежайшую стабильную версию ссайтаили из репозиториев вашего дистрибутива.

Если у вас уже установлен node, убедитесь, что установленная версия >=20.0.0, а если нет — обновитесь или переключитесь с помощьюnvmна какую-нибудь посвежее.

Запускаем ассистента:

Если он уже установлен ранее — обязательно обновитесь до актуальной версии первой командой. Иначе поддержку ACP не получить.

Фактически, какая-то специфическая настройка самого ассистента не требуется. Но обязательно надо авторизоваться командой/authс выбором ”Войти через Koda Auth”. Это даст вам расширенные пакеты бесплатных запросов на наши моделиkoda-baseиkoda-pro, а также один месяц бесплатных запросов на внешние модели, включаяgpt-5.4илиminimax-m2.7.

Что ещё пригодится знать — где лежат исполняемые файлыnodeиkoda. Их абсолютные пути могут понадобиться в конфигах, но некоторые клиенты обходятся и просто названием утилиты, которая доступна через$PATH. Узнать эти пути можно примерно так:

Пока вы в терминале, можете заодно посмотреть на допустимые аргументыkoda --help. Ниже в примерахargsбудут указаны необходимые и достаточные, но это остаётся на ваше усмотрение.

Теперь перейдём к самому интересному.

Настройка Zed

Это современный и относительно новый редактор кода, который делает акцент на агентскую разработку и всяческое использование ИИ. Его поддержкув нашем сообществеочень просили. Установку редактора можно начать софициального сайта.

Запускаем и через палитру команд вызываем командуOpen Settings File. В открывшийся конфиг, в самое его начало (просто для удобства), добавляем один из следующих блоков (можно и все, почему бы и нет):

В правом нижнем углу вызываемAgent Panel:

В заголовке открытой панели через меню выбираемSettings:

В разделеExternal Agentsнам нужно увидеть строку с названием ассистента (в нашем случае Koda CLI) и зелёной галочкой:

Это значит, что всё готово к старту первой сессии. Для этого надо в заголовкеNew Threadнажать + и выбратьKoda CLI

JetBrains IDE (v2026+)

Это свежайшая версия IDE, которая поддерживает подключение к ассистентам по ACP. Она из коробки снабжается плагиномAI Assistant. Можно попробовать на более ранних версиях, плагин надо будет поставить и/или активировать. Ранее через этот плагин предлагалась только фирменная агентность JB, но теперь в рамках бета-тестирования можно подключать и сторонних ассистентов. Поэтому в нашем случае не потребуется ни подписка JetBrains, ни даже учётная запись.

На панелиAI Chatвызываем меню и там жмёмAdd Custom Agent:

Конфиг будет похож, но не полностью:

В отличие от Zed, есть нюансы: здесь не нужен параметрtype, аcommandдолжен содержать абсолютный путь до исполняемого файла. По аналогии с Zed, можно указывать разные вариантыcommandиargs.

Всё. Проверить можно сразу начав новую сессию: в заголовке панелиAI Chatнажать+ New Chatи выбратьKoda CLI:

Заключение

Здесь рассмотрены только два популярных примера. Маловероятно, что для настройки других редакторов и клиентов что-то существенно отличается, но для своего ПО вам стоит поискать документацию и расширения, если нет поддержки из коробки.

Для VSCode у нас естьотдельный плагин, хотя ничего не мешает использоватьkoda-cliчерез сторонние плагины по ACP или через наш жекомпаньондля прямой связи с интерактивной сессией вkodaв терминале VSCode.

Не забывайте делиться мнением и идеямив сообществеи багамив репозитории. Мы всё читаем, рассматриваем и стараемся помочь.