n8n как код: правим workflow из Cursor и Claude Code

Почему workflow стоит держать как код

n8n хранит сценарии в своей базе, и правите вы их в веб-редакторе. Для одного-двух workflow это удобно. Проблемы начинаются, когда сценариев становится много и они важны для бизнеса: кто и что менял, как откатиться на прошлую рабочую версию, как показать правку на ревью, как дать AI-агенту безопасно поправить сценарий, не сломав соседние.

Ответ тот же, что в разработке: workflow надо превратить в файлы в репозитории. Тогда каждая правка - это коммит с историей и диффом, откат - это git revert, а ревью - обычный pull request. А раз это код в git, то и работать с ним можно из своего редактора и подключить AI-агента, который видит реальный контекст вашего n8n.

Что делает n8n-as-code

n8n-as-code - открытый инструментарий (MIT), который превращает репозиторий в полноценную среду разработки n8n. Это независимый community-проект, он не аффилирован с n8n. Коротко, что он умеет:

Работает это через API вашего инстанса n8n: инструмент подключается к нему, тянет схемы нод и сами сценарии. Секреты и локальное состояние остаются у вас на машине.

Три способа подключить: Cursor, Claude Code, CLI

Инструмент один, а точек входа три - выбираете под свой рабочий процесс.

1. Cursor или VS Code - расширение

   Ставите расширение etienne-lescot.n8n-as-code из VS Code Marketplace или Open VSX, открываете папку-репозиторий, в настройках создаете окружение n8n (адрес инстанса и API-ключ) и тянете сценарии. Дальше правите workflow прямо в редакторе, а рядом - агент Cursor, у которого уже есть контекст вашего n8n.

2. Claude Code - плагин

   Ставится как плагин: /plugin marketplace add https://github.com/EtienneLescot/n8n-as-code, затем /plugin install n8n-as-code@n8nac-marketplace. После этого просто просите Claude собрать или поправить нужный workflow - навык n8n-architect сам подтянет схемы, проверит сценарий и синхронизирует его.

3. CLI - для скриптов и CI

   Через npx n8nac, без установки. Заводите окружение и синхронизируете:

   npx --yes n8nac env add Dev --base-url https://n8n.example.com --workflows-path workflows/dev printf '%s' "$N8N_API_KEY" | npx --yes n8nac env auth set Dev --api-key-stdin npx --yes n8nac env use Dev npx --yes n8nac update-ai

   После этого сценарии лежат файлами в workflows/dev, а команда update-ai генерит контекст для любого агента.

Как выглядит цикл правки

Собранный процесс получается такой: pull сценария из n8n в репозиторий, правка (руками в редакторе или запросом к агенту), валидация тем же движком, что проверяет схемы нод и связи, push обратно в n8n и коммит в git. Агент при этом не гадает: он видит реальные схемы ваших нод и правит по ним, а не по памяти.

Именно этим подходом мы у себя прогнали и починили каталог готовых сценариев - проверили 2061 workflow и нашли, что 84% из открытых коллекций сломаны. Валидация как код - не абстракция, а то, что реально ловит битые связи и несуществующие версии нод до того, как сценарий попадет в прод.