n8n это платформа автоматизации с визуальным редактором: workflow собирается из узлов, один принимает вебхук, другой ходит во внешний API, третий отвечает. Проще всего поставить её одной командой через Docker, после чего редактор открывается на http://localhost:5678. Дальше в статье лицензия, три способа установки, первый вход и workflow из трёх узлов, который отправляет вопрос в Claude. Если вам нужен агент с инструментами, а не линейная цепочка, после этой статьи переходите к материалу как создать ИИ-агента.
Обзор самой идеи (где LLM в автоматизации окупается и как не сжечь бюджет) лежит отдельно: LLM в n8n: практические паттерны. Здесь только установка и первый запуск.
Академия n8n: что есть на официальном сайте
Запрос «академия n8n» имеет прямой ответ. В документации есть страница Learning paths: она отправляет в n8n Academy на learn.n8n.io, где курсы построены на упражнениях с настоящими workflow, тестах и итоговом экзамене, а по завершении выдают значок и сертификат (проходной балл 70%). На 13 ноября 2026 в списке курсов четыре позиции:
| Код | Название курса |
|---|---|
| QS101 | n8n Quickstart |
| N8N101 | Essentials: Your First Workflows |
| N8N102 | Integrations: APIs & Connected Workflows |
| N8N103 | In Practice: AI, Testing & Best Practices |
Названия в списке английские. Русской версии курсов в этом списке мы не нашли, внутрь самих курсов не заходили и о языке уроков ничего не утверждаем. Язык интерфейса самого n8n задаёт переменная N8N_DEFAULT_LOCALE: по умолчанию en, непереведённые строки n8n показывает по-английски. Есть ли в вашей версии русская локализация, мы не проверяли.
Что такое n8n и под какой лицензией
В описании репозитория n8n назван fair-code платформой автоматизации с готовыми AI-возможностями и более чем 400 интеграциями. Исходный код доступен для чтения, но по классификации Open Source Initiative это не open source: документация n8n объясняет, что лицензия ограничивает использование, поэтому проект себя так не называет.
Лицензия называется Sustainable Use License. Она применима к самостоятельно установленной версии, облачный n8n Cloud идёт по платной подписке со своими условиями. Документация перечисляет три ограничения:
- использовать и изменять программу можно только для собственных внутренних бизнес-целей либо для некоммерческих и личных задач;
- распространять её или передавать другим можно только бесплатно и в некоммерческих целях;
- нельзя менять, удалять или скрывать уведомления о лицензии, авторских правах и другие пометки правообладателя.
В FAQ n8n разбирает границы на примерах. Разрешено запускать несколько экземпляров, строить автоматизации для клиентов на своём экземпляре, если клиенты не могут создавать и править workflow, брать плату за создание, настройку и обучение. Запрещено размещать n8n как сервис, где клиенты строят свои workflow, давать внешним пользователям собирать workflow через ваш продукт, форкать код для собственного продукта автоматизации, убирать брендинг и предлагать n8n как есть, пользоваться платными функциями без лицензии Enterprise.
Мы не даём юридических оценок и не обещаем, что ваш сценарий подпадает под разрешённые. Условия вендора читаете и принимаете вы. Если случай пограничный, документация советует писать на license@n8n.io.
Три способа установки
Документация n8n сейчас выделяет одну основную дорогу: Docker. Страница про отдельный docker run на 13 ноября 2026 помечена как устаревшая и отсылает к Docker Compose, а страница про npm предупреждает, что установки через npm объявлены устаревающими с n8n 3.0.
| Способ | Что нужно | Что получите |
|---|---|---|
| One-line setup | Docker с плагином docker compose v2 | Папку n8n с compose.yml и .env, n8n на порту 5678, встроенную SQLite, комплектную песочницу (только для разработки и тестов) |
| Docker Compose вручную | Docker Engine и Compose v2, не меньше 4 ГБ RAM и 2 vCPU | Тот же набор, но файлы вы ведёте сами, для боевого запуска можно взять Postgres |
| npm | Node.js 20.19-24.x включительно | n8n без контейнера, но путь объявлен устаревающим |
One-line setup
Предупреждение из документации n8n. Комплектная песочница рассчитана на разработку и тесты, не на продакшен. Её контейнер
sandbox-runner-1работает сprivileged: trueи Docker-in-Docker, изоляция слабая: если код вырвется из песочницы, он попадёт на хост, поэтому раннер приравнивается к root на хосте. Ставьте этот комплект на отдельную машину или виртуальную машину, где больше ничего нет, и никогда не открывайте его в интернет.
Самый короткий путь из документации:
curl -fsSL https://get.n8n.io | sh
Скрипт проверяет, что Docker установлен и запущен, создаёт в текущей папке каталог n8n, пишет конфигурацию с уникальными секретами, скачивает n8n и запускает его. Адрес редактора скрипт печатает, когда всё поднялось. Команды на каждый день:
docker compose -f ./n8n/compose.yml down
docker compose -f ./n8n/compose.yml up -d
curl -fsSL https://get.n8n.io | sh -s -- --upgrade
Первая останавливает n8n, вторая запускает снова, третья обновляет. Не хотите запускать чужой скрипт вслепую: документация предлагает скачать его, прочитать и только потом выполнить (curl -fsSL https://get.n8n.io -o get-n8n.sh, затем less get-n8n.sh и sh get-n8n.sh). На Windows команду нужно запускать из WSL с включённой интеграцией Docker Desktop: обычные Command Prompt и PowerShell скрипты оболочки не понимают. Git Bash компания n8n для этой команды не проверяла.
В набор входят и служебные контейнеры для помощника n8n Assistant: песочница, где выполняется написанный ассистентом код, и поиск. Они стартуют вместе с n8n, хотя сам ассистент выключен, пока вы не добавите ключ провайдера модели. Наружу открыт только порт 5678.
Для боевого запуска документация отсылает в два места. База данных: скрипт ставит SQLite, а для команды или продакшена советуют Postgres и установку по инструкции с Docker Compose. Песочница: продакшен-вариант описан на странице Set up n8n Assistant, это размещаемый вами сервис песочницы n8n с раннерами Sysbox, лучше всего на Kubernetes, либо управляемый вариант Daytona, сторонний сервис, который получает данные ваших workflow. Мы эти конфигурации не разворачивали.
Docker одной командой docker run
Страница с этой командой помечена в документации устаревшей, и мы её не запускали. Приводим как есть для тех, кому нужен один контейнер без Compose. Вместо <YOUR_TIMEZONE> подставьте свой часовой пояс, например Europe/Moscow:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="<YOUR_TIMEZONE>" \
-e TZ="<YOUR_TIMEZONE>" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
Том n8n_data хранит данные между перезапусками, GENERIC_TIMEZONE нужна расписаниям вроде Schedule Trigger. По умолчанию n8n складывает workflow, учётные данные и историю запусков в SQLite. Для нагрузки документация советует Postgres, а каталог .n8n всё равно оставлять на постоянном томе: в нём лежат ключи шифрования.
Порт в команде опубликован без адреса. По документации Docker, так он открывается на всех адресах хоста, и редактор n8n станет доступен из сети. Для запуска только на своём компьютере напишите -p 127.0.0.1:5678:5678. Доступ ограничивается хостом в Docker Engine 28.0.0 и новее: по предупреждению в документации Docker, в более старых выпусках хосты из того же сегмента L2 (например, подключённые к одному коммутатору) могут достучаться до портов, опубликованных на localhost. Версию сервера показывает docker version --format '{{.Server.Version}}', на старой версии обновите Docker.
npm
Нужен Node.js версии между 20.19 и 24.x включительно. Попробовать без установки:
npx n8n
Поставить глобально и запускать:
npm install n8n -g
n8n start
Обновление: npm update -g n8n. В самой документации сказано, что npm-установка объявлена устаревающей с n8n 3.0, а на странице one-line setup написано, что подход с npx n8n и npm install n8n с версии 3.0 перестанет работать, при этом уже существующие npm-установки пока продолжают жить. Для нового проекта берите Docker. Ассистент n8n при установке через npm недоступен.
Первый запуск и вход
Откройте http://localhost:5678. Дальше n8n ведёт по шагам настройки прямо в приложении: так описан первый запуск в документации по управлению пользователями. Что именно просит первый экран, мы не описываем: эту часть мы не проходили.
Из документации стоит знать две вещи. Во-первых, поддерживаемого способа убрать экран входа в современных версиях n8n нет, даже для локальной разработки. Во-вторых, почтовый сервер SMTP необязателен: без него не заработает сброс пароля, а ссылки-приглашения для коллег придётся копировать и отправлять вручную.
Ключ Claudexia для первого workflow
Для запросов в Claude нужен ключ с префиксом sk_cdx_. На странице регистрации нужны логин, пароль и подтверждение пароля либо вход через Google, GitHub или Telegram. Поля email нет, подтверждать почту не нужно. Минимальное пополнение один доллар, платить можно рублями через СБП, картой РФ или криптовалютой. Ключ создаётся в кабинете. Подробнее о ключах: как получить ключ Claude API.
Проверить, что API отвечает, можно до всякого n8n. Неверный ключ сервер отклоняет, и мы сняли это 17 ноября 2026 запросом с заведомо неправильным ключом:
curl -i https://api.claudexia.tech/v1/messages \
-H "x-api-key: sk_cdx_wrong" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
В ответ пришёл HTTP/2 401 и тело в формате Anthropic: {"type":"error","error":{"type":"authentication_error","message":"Invalid or missing API key. ..."}}. Ожидайте такой же 401 и в n8n, если ключ в учётных данных набран неверно.
Workflow: Webhook, запрос к Claude, ответ
Задача из трёх узлов: клиент шлёт POST с вопросом, n8n передаёт его в Claude и возвращает ответ вызвавшему.
Узел 1. Webhook
Создайте workflow и добавьте узел Webhook. Он запускает workflow, когда на его адрес приходит запрос.
| Поле | Значение |
|---|---|
| HTTP Method | POST |
| Path | ask (по умолчанию n8n подставляет случайную строку, путь можно задать вручную) |
| Authentication | None на время проверки; для боевого запуска включите Header auth или другой метод из списка: Basic auth, Header auth, JWT auth, n8n User Auth |
| Respond | Using 'Respond to Webhook' Node |
У узла два адреса, тестовый и боевой. Нажмите Listen for test event: тестовый вебхук регистрируется, живёт 120 секунд и показывает пришедшие данные в редакторе. Тестовый адрес строится по шаблону http://localhost:5678/webhook-test/ask: webhook-test это путь по умолчанию для тестовых вебхуков. Вызов с той же машины:
curl -X POST "http://localhost:5678/webhook-test/ask" \
-H "content-type: application/json" \
-d '{"question":"Назови столицу Франции одним словом"}'
Данные запроса узел отдаёт как { body, headers, params, query }, поэтому вопрос будет доступен как $json.body.question.
Узел 2. HTTP Request
Добавьте узел HTTP Request после Webhook и заполните:
| Поле | Значение |
|---|---|
| Method | POST |
| URL | https://api.claudexia.tech/v1/messages |
| Authentication | Generic Credential Type, затем Header Auth. Name: x-api-key, Value: ваш ключ sk_cdx_... |
| Send Headers | включить, Name: anthropic-version, Value: 2023-06-01 |
| Send Body | включить, Body Content Type: JSON, Specify Body: Using JSON |
Тело запроса. Двойные фигурные скобки n8n вычисляет как выражение, подставляя вопрос из вебхука:
{
"model": "claude-sonnet-5-5",
"max_tokens": 500,
"messages": [
{ "role": "user", "content": "{{ $json.body.question }}" }
]
}
Если у вас уже есть работающий curl-запрос, узел умеет импортировать curl-команду вместо ручного заполнения полей: так сказано в документации узла. Ключ вносите в учётные данные Header Auth, а не пишете прямо в поле URL или тела.
Про версию заголовка: в документации Anthropic на 13 ноября 2026 актуальной названа 2026-10-21, а 2023-06-01 остаётся в списке версий. Мы пишем 2023-06-01, как в других материалах блога. Как шлюз Claudexia отнесётся к 2026-10-21 в этом узле, мы не проверяли.
Есть оговорка. Если в вопросе окажутся кавычки или переводы строки, подстановка в такое тело JSON может его сломать. Как лучше экранировать значение в n8n, мы не проверяли, на первых запусках шлите простой текст.
Узел 3. Respond to Webhook
Узел отвечает вызвавшему. Ответ Claude приходит в формате Anthropic: массив content из блоков. У моделей с включёнными рассуждениями первым может прийти блок thinking, поэтому текст берут из блоков с type: "text", а не по номеру позиции. Настройки:
| Поле | Значение |
|---|---|
| Respond With | First Incoming Item |
Эта настройка вернёт JSON первого элемента, то есть весь ответ API целиком; вызвавшая сторона достаёт текст из блоков content с type: "text", например в JavaScript так: body.content.filter(b => b.type === "text").map(b => b.text).join(""). Если текстовых блоков нет, смотрите stop_reason: ответ мог оборваться по лимиту max_tokens. Режим Text вернул бы только текст, но по документации он по умолчанию отдаёт HTML (Content-Type: text/html), а с версии 1.103.0 n8n оборачивает HTML-ответы вебхуков в <iframe>. Для вызова из кода такой ответ неудобен, поэтому для API-клиентов оставляйте JSON.
Боевой запуск
Тестовый адрес живёт две минуты, для постоянной работы переключите узел Webhook на Production URL и опубликуйте workflow: боевой вебхук регистрируется при публикации, его путь начинается с webhook (http://localhost:5678/webhook/ask). Данные боевых запусков в редакторе не показываются, их смотрят на вкладке Executions у workflow. Чтобы внешние сервисы (например GitHub) могли достучаться до n8n с вашего компьютера, нужен публичный адрес. Встроенный туннель документация разрешает только для разработки и тестов: для продакшена он небезопасен. Комплект из one-line setup в интернет открывать нельзя (предупреждение в разделе про установку), поэтому для публичного вебхука нужна конфигурация для продакшена, на которую ссылается тот же раздел: Docker Compose с Postgres и продакшен-вариант песочницы.
Штатный узел Anthropic: есть ли свой base URL
Вместо HTTP Request можно взять узлы Anthropic и Anthropic Chat Model. Страница документации про учётные данные Anthropic описывает только API-ключ и необязательный пользовательский заголовок, поля адреса там нет. Но в исходном коде n8n на GitHub (ветка master на 13 ноября 2026) у учётных данных Anthropic есть поле Base URL со значением по умолчанию https://api.anthropic.com и описанием «переопределить адрес API по умолчанию», и оба узла этот адрес читают. Отдельное сообщение об ошибке в узле прямо упоминает AI-шлюзы и подсказывает выбрать модель, которую шлюз поддерживает.
Для Claudexia в это поле пишут https://api.claudexia.tech без /v1: путь /v1/... дописывает сам узел. Проверка учётных данных в n8n идёт запросом GET /v1/models, а на Claudexia этот адрес отвечает 200 даже без ключа или с неверным. Поэтому зелёная галочка в окне учётных данных ключ не подтверждает, проверяйте его настоящим запросом, как выше. Откройте у себя окно создания учётных данных Anthropic и найдите там Base URL: именно версию вашей установки мы не открывали.
Узел Anthropic Chat Model рассчитан на агентов: по документации Tools Agent поддерживает его среди своих моделей. Про сборку такого агента и про цикл вызовов инструментов читайте в статье как создать ИИ-агента, а про сами схемы инструментов в материале Function calling и tool use в Claude.
Куда двигаться дальше
- Расходы. Автоматика запускается без вас: заведите отдельный ключ под n8n и ограничьте
max_tokens, подробнее в статье LLM в n8n. - Свои инструменты. n8n умеет подключаться к MCP-серверам; как они устроены, объясняет руководство по MCP-серверам для Claude.
- Другие агенты. Где n8n стоит среди прочих инструментов, смотрите в обзоре лучшие ИИ-агенты 2026.
Источники
Страницы открыты 13 и 17 ноября 2026.
- Лицензия: Sustainable Use License и Community license, License FAQ.
- Установка: one-line setup, Docker, Docker Compose, npm, управление пользователями, Set up n8n Assistant, публикация портов в Docker.
- Обучение: Learning paths и курсы n8n Academy.
- Узлы: Webhook, HTTP Request, Respond to Webhook, учётные данные Anthropic, Tools Agent.
- Код и цены: репозиторий n8n на GitHub, страница цен.
Частые вопросы
Есть ли академия n8n на русском языке?
Официальная n8n Academy работает на learn.n8n.io. На 13 ноября 2026 в её списке четыре курса с английскими названиями, русской версии мы там не нашли. О языке самих уроков не знаем, внутрь курсов не заходили.
n8n бесплатный?
Самостоятельно установленную версию можно использовать бесплатно по Sustainable Use License, пока вы соблюдаете её условия (внутренние задачи бизнеса, личное и некоммерческое использование). Облачный n8n Cloud платный: на странице цен 13 ноября 2026 тариф Starter стоил 20 евро в месяц при оплате за год и включал 2,5 тысячи запусков workflow, у Starter и Pro есть пробный период без банковской карты.
Можно ли поставить n8n без Docker?
Через npm можно, если на машине стоит Node.js версий 20.19-24.x. Но документация называет такой путь устаревающим с n8n 3.0, а ассистент n8n при нём недоступен. Для нового проекта берите Docker.
Работает ли штатный узел Anthropic с Claudexia?
В исходниках n8n у учётных данных Anthropic есть поле Base URL, и мы ожидаем, что https://api.claudexia.tech без /v1 подойдёт, но связку не прогоняли. Если поле в вашей версии не нашлось, берите узел HTTP Request, как в статье.
Что нельзя отдавать workflow с Claude?
То же, что любой другой модели: пароли, ключи, персональные данные клиентов. Список и объяснения в статье что нельзя отправлять в языковую модель.