Привет. В свежей версии 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 на какую-нибудь посвежее.
Запускаем ассистента:
npm install -g @kodadev/koda-cli@latest koda # или прямой запуск без установки npx -y @kodadev/koda-cli@latest
Если он уже установлен ранее — обязательно обновитесь до актуальной версии первой командой. Иначе поддержку ACP не получить.
Фактически, какая-то специфическая настройка самого ассистента не требуется. Но обязательно надо авторизоваться командой /auth с выбором ”Войти через Koda Auth”. Это даст вам расширенные пакеты бесплатных запросов на наши модели koda-base и koda-pro, а также один месяц бесплатных запросов на внешние модели, включая gpt-5.4 или minimax-m2.7.
Что ещё пригодится знать — где лежат исполняемые файлы node и koda. Их абсолютные пути могут понадобиться в конфигах, но некоторые клиенты обходятся и просто названием утилиты, которая доступна через $PATH. Узнать эти пути можно примерно так:
# linux/macos which node npx koda # windows cmd where node npx koda # windows powershell (Get-Command node, npx, koda).Path
Пока вы в терминале, можете заодно посмотреть на допустимые аргументы koda --help. Ниже в примерах args будут указаны необходимые и достаточные, но это остаётся на ваше усмотрение.
Теперь перейдём к самому интересному.
Настройка Zed
Это современный и относительно новый редактор кода, который делает акцент на агентскую разработку и всяческое использование ИИ. Его поддержку в нашем сообществе очень просили. Установку редактора можно начать с официального сайта.
Запускаем и через палитру команд вызываем команду Open Settings File. В открывшийся конфиг, в самое его начало (просто для удобства), добавляем один из следующих блоков (можно и все, почему бы и нет):
Примеры настроек
{ "agent_servers": { // после npm i -g @kodadev/koda-cli@latest "Koda CLI": { "type": "custom", "command": "koda", // может быть абсолютный путь "args": ["--acp"], }, // после npm i -g @kodadev/koda-cli@latest "Koda CLI node": { "type": "custom", "command": "node", // может быть абсолютный путь "args": [ "<абсолютный путь до koda>", "--acp", ], }, // вместо npm i -g @kodadev/koda-cli@latest "Koda CLI npx from npm": { "type": "custom", "command": "npx", // может быть абсолютный путь "args": [ "@kodadev/koda-cli@latest", "--acp", ], }, // другие ассистенты... } // другие настройки... }
В правом нижнем углу вызываем 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:
Конфиг будет похож, но не полностью:
{ "selectedAuthType": "koda-auth", "default_mcp_settings": { "use_idea_mcp": true, "use_custom_mcp": true }, "agent_servers": { "Koda CLI": { "command": "<абсолютный путь до koda>", "args": ["--acp"], }, }, }
В отличие от Zed, есть нюансы: здесь не нужен параметр type , а command должен содержать абсолютный путь до исполняемого файла. По аналогии с Zed, можно указывать разные варианты command и args.
Всё. Проверить можно сразу начав новую сессию: в заголовке панели AI Chat нажать + New Chat и выбрать Koda CLI:
Заключение
Здесь рассмотрены только два популярных примера. Маловероятно, что для настройки других редакторов и клиентов что-то существенно отличается, но для своего ПО вам стоит поискать документацию и расширения, если нет поддержки из коробки.
Для VSCode у нас есть отдельный плагин, хотя ничего не мешает использовать koda-cli через сторонние плагины по ACP или через наш же компаньон для прямой связи с интерактивной сессией в koda в терминале VSCode.
Не забывайте делиться мнением и идеями в сообществе и багами в репозитории. Мы всё читаем, рассматриваем и стараемся помочь.
