Интеграция Claude и n8n на собственном VPS

Что вы создаете

Три рабочих AI-процесса (workflow) на уже запущенном экземпляре n8n: вебхук, который суммирует любой переданный ему текст; планировщик для чтения лент, преобразующий статьи в структурированные строки таблицы; и AI-агент, который самостоятельно обращается к HTTP API для ответов на вопросы. Это no-code аналог вызова Claude API из Python на вашем VPS: тот же API, те же токены, тот же счет, но оркестрация выполняется в узлах n8n, а не в скрипте.

Я исхожу из того, что n8n уже запущен за HTTPS согласно руководству по self-hosted n8n на Docker. Если это не так, выполните настройку сначала: вебхукам требуется реальная TLS-конечная точка, а хранилище учетных данных, куда вы собираетесь поместить API-ключ, требует резервной копии ключа шифрования, о которой напоминает это руководство.

Интересные проблемы здесь связаны не с перетаскиванием элементов (drag-and-drop). Они касаются выбора модели для каждого узла, полей промптов, которые автоматически подставляют undefined, и того факта, что автоматизация работает без присмотра. Процесс, который стоит полцента за запуск, дешев, пока цикл повторных попыток не выполнит его четыре тысячи раз за ночь. Большая часть этого руководства посвящена именно таким вопросам.

Одна учетная запись, зашифрованная ключом, который вы сохранили в резервной копии

Получите API key в консоли Anthropic на сайте platform.claude.com: перейдите в Settings, затем в API Keys и создайте ключ, например, с именем n8n-vps. Он отображается только один раз. При создании консоль предложит выбрать срок действия ключа; запишите эту дату, так как истекший ключ приведет к остановке автоматизированных процессов с ошибкой 401, описанной ниже в разделе режимов сбоя. Пополните баланс или настройте биллинг; использование API оплачивается за каждый токен из предоплаченных средств. Подписка Pro не покрывает расходы на API, однако планы Claude Max и Team теперь включают ежемесячные кредиты для Claude API ($100 для Max 5x, $200 для Max 20x, до $500 для Team), которые можно активировать, привязав организацию Console в настройках биллинга claude.ai. Эти кредиты оплачивают вызовы API, подобные тем, что делает n8n, не распространяются на Claude Code и сгорают в конце каждого расчетного периода. Если вы планировали создать эти три рабочих процесса бесплатно, в FAQ по ценообразованию Anthropic указано, что новые пользователи получают небольшое количество бесплатных кредитов для тестирования API. Таким образом, с новой учетной записью Console можно протестировать эти процессы до настройки биллинга; после исчерпания кредитов каждый вызов Claude будет оплачиваться по количеству токенов. Некоторые функции не требуют оплаты сверх стоимости токенов, например, эндпоинт для подсчета токенов и до 1550 бесплатных часов выполнения кода на организацию в месяц, хотя ни один из этих трех рабочих процессов не использует выполнение кода. В том, что покрывают бесплатные API-кредиты приведены подробности.

В n8n: перейдите в Credentials, нажмите Create credential, выберите Anthropic, вставьте ключ в поле API Key и сохраните. Каждый узел Claude в любом рабочем процессе ссылается на эту сохраненную учетную запись; вам не нужно вставлять ключ в каждый узел отдельно.

Два примечания по эксплуатации. Во-первых, n8n шифрует сохраненные учетные данные с помощью N8N_ENCRYPTION_KEY. Если вы явно задали эту переменную окружения в файле compose согласно руководству n8n, ваши учетные данные сохранятся после пересборки контейнера; если вы позволили n8n сгенерировать ключ автоматически, а затем потеряли том, все сохраненные учетные данные, включая этот ключ, превратятся в невосстановимый зашифрованный текст. Сделайте резервную копию ключа сейчас, если вы этого еще не сделали. Во-вторых, рассматривайте хранилище учетных данных n8n как зону поражения: любой, кто может использовать вашу учетную запись Anthropic, может выполнять запросы от вашего имени. В версии Community это вы и владелец инстанса; документация n8n гласит: «Только владелец инстанса и пользователь, создавший учетные данные, имеют доступ к рабочим процессам и учетным данным», поэтому другие учетные записи Member не могут получить к ним доступ. Совместное использование рабочих процессов и учетных данных — это платная функция в self-hosted n8n (Business или Enterprise), и как только вы предоставляете доступ к рабочему процессу, его редакторы могут использовать все учетные данные, которые он задействует. Поэтому, если в этот инстанс заходит кто-то еще, ознакомьтесь с тем, какие средства контроля доступа предусмотрены в платной лицензии n8n, прежде чем выдавать учетные записи. Установите лимит расходов в консоли в разделе Settings, чтобы ограничить возможные затраты в случае компрометации или неконтролируемой работы инстанса.

Выбор модели осуществляется для каждого узла отдельно

Выпадающий список моделей в узлах Claude в n8n заполняется динамически через API, поэтому в нем отображаются только те модели, к которым есть доступ с вашим ключом. Модели, используемые в этом руководстве, с ценами за миллион входных/выходных токенов на октябрь 2026 года: Claude Haiku 4.5 (claude-haiku-4-5) по цене $1/$5 с контекстным окном 200K, Claude Sonnet 5 (claude-sonnet-5) по цене $2/$10 и Claude Opus 4.8 (claude-opus-4-8) по цене $5/$25, обе с контекстным окном 1M токенов. Также существует Claude Fable 5 (claude-fable-5) по цене $10/$50 для наиболее сложных задач логического вывода; в рамках этого руководства она не требуется. Используйте именно эти идентификаторы. claude-haiku-4-5 является псевдонимом для зафиксированного снимка claude-haiku-4-5-20251001, который также работает, но устаревший идентификатор, скопированный из старого руководства, может указывать на уже выведенную из эксплуатации модель и привести к ошибке. Цены меняются, поэтому проверяйте platform.claude.com, прежде чем доверять любым цифрам, включая приведенные здесь.

С момента первой публикации этого руководства Anthropic выпустила более новые модели, и в документации теперь Haiku 4.5, Sonnet 5, Opus 4.8 и Fable 5 помечены как устаревшие. Они по-прежнему работают. На странице вывода из эксплуатации указано, что Haiku 4.5 будет выведена из эксплуатации не ранее 15 октября 2026 года; эта дата прошла, и по состоянию на 20 октября 2026 года на странице Haiku 4.5 все еще отображается как активная без уведомления о выводе из эксплуатации. Sonnet 5, Opus 4.8 и Fable 5 будут выведены из эксплуатации не ранее середины 2027 года. Anthropic уведомляет как минимум за 60 дней до вывода из эксплуатации публично выпущенной модели, поэтому следите за страницей вывода из эксплуатации, если в ваших рабочих процессах зафиксирована Haiku 4.5. Текущая линейка включает Claude Haiku 5.5 (claude-haiku-5-5, выпущена 7 октября 2026 года) по цене от $0.10/$0.50 для запросов до 100,000 токенов и $0.50/$2.50 для запросов свыше этого объема, Claude Sonnet 5.5 (claude-sonnet-5-5) по цене $2/$10, Claude Opus 5.5 (claude-opus-5-5) по цене $4/$20 и Claude Fable 5.1 (claude-fable-5-1) по цене $10/$50. Токенизатор Haiku 5.5 считает тот же текст примерно на 30% большим количеством токенов, чем Haiku 4.5, поэтому сравнивайте реальные затраты на выполнение на странице использования в консоли, а не только прейскурантные цены.

Правило, которое стоит взять за привычку: выбирайте модель для каждого узла, а не для всей платформы целиком. Классификация, извлечение данных, суммаризация, маршрутизация — основные задачи автоматизации — отлично выполняются на Haiku при стоимости вдвое ниже, чем у Sonnet, и в пять раз ниже, чем у Opus. Оставьте Sonnet для агентов и многошаговых рассуждений, а Opus — для редких рабочих процессов, где цена ошибки превышает стоимость токенов. Рабочий процесс с пятью узлами Claude может и должен сочетать разные модели.

Два узла Claude: какой и где использовать

n8n поставляется с двумя различными интеграциями Anthropic, и выбор неподходящей — самая частая ошибка новичков.

Узел Anthropic — это обычный узел приложения: один запрос на входе, один ответ на выходе. Его ресурс Text содержит операцию Message a Model, а также операции для анализа изображений и документов. Используйте его всегда, когда логика рабочего процесса находится внутри n8n: триггер, вызов Claude, следующий узел. Рабочие процессы 1 и 2 ниже используют его или его аналог для цепочек.

Узел Anthropic Chat Model — это вспомогательный узел, небольшое дополнение, которое предоставляет модель для корневого узла, такого как AI Agent или Basic LLM Chain. У него нет собственного триггера и выхода; он предоставляет выбор модели и параметры выборки, такие как Maximum Number of Tokens и Sampling Temperature. Важное примечание из документации n8n, которое стоит запомнить: выражения внутри вспомогательных узлов всегда вычисляются относительно первого входного элемента, а не каждого элемента. Размещайте выражения для каждого элемента в полях подсказок (prompt) корневого узла, а не во вспомогательном узле. И одно примечание со стороны Anthropic: для моделей Claude 4.7 и новее (это все модели в данном руководстве, кроме Haiku 4.5) установка температуры, top_p или top_k в значение, отличное от стандартного, приводит к ошибке 400. Поэтому оставляйте параметры Sampling Temperature, Top K и Top P не заданными для этих моделей.

Рабочий процесс 1: получение webhook, отправка резюме

Классический пример автоматизации с ИИ: любой POST-запрос на URL обрабатывается, сокращается и отправляется в Slack или на электронную почту.

1. Узел Webhook, HTTP-метод POST, путь summarize. n8n предоставляет тестовый и рабочий URL; рабочий URL начинает прослушивание только после публикации рабочего процесса.
2. Узел Anthropic, модель Message a Model, модель claude-haiku-4-5, Max Tokens около 300.
3. Узел Slack (или Send Email), отправка текста ответа в канал.

В этом узле выражения n8n взаимодействуют с Claude. Тело POST-запроса попадает в $json.body, поэтому поле сообщения пользователя выглядит так:

Summarize the following feedback in three bullets, then one line:
verdict: praise | complaint | churn-risk. No preamble.

{{ $json.body.text }}

Инструкции по роли и формату следует размещать в поле системного промпта узла, а не в сообщении пользователя. Системный промпт остается неизменным, в то время как полезная нагрузка меняется; это обеспечивает стабильность поведения и позволяет легко прочитать промпт спустя полгода. Протестируйте работу прямо с VPS:

curl -X POST https://n8n.example.com/webhook/summarize \
  -H 'Content-Type: application/json' \
  -d '{"text": "Third support ticket this month about slow disk IO..."}'

Стоимость одного запуска на модели Haiku: полезная нагрузка в 1200 токенов плюс промпт обходятся примерно в $0.0012 на вход, 300 токенов на выходе — $0.0015, итого около четверти цента. Тысяча запусков в месяц обойдется менее чем в $3. Тот же узел при использовании Opus 4.8 будет стоить примерно в пять раз дороже. Это соотношение, умноженное на количество создаваемых вами рабочих процессов, объясняет, почему важно осознанно выбирать модель для каждого узла.

Рабочий процесс 2: регулярный сбор RSS в структурированные строки

Теперь рассмотрим задачу по расписанию с выводом структурированных данных: ежечасное чтение RSS-ленты, классификация каждого элемента и добавление строк в таблицу.

1. Триггер по расписанию (Schedule Trigger), каждый час.
2. Чтение RSS (RSS Read), URL ленты. На выходе — по одному элементу на статью.
3. Базовая цепочка LLM (Basic LLM Chain) с вложенным узлом Anthropic Chat Model, настроенным на claude-haiku-4-5, и вложенным узлом Structured Output Parser, содержащим JSON-схему.
4. Google Sheets (или Postgres), добавление строки для каждого элемента.

Structured Output Parser превращает запрос «Claude, верни JSON» из надежды в обязательство: он проверяет ответ модели на соответствие вашей схеме и выдает ошибку при несоответствии, вместо того чтобы записывать некорректные данные. Пример схемы:

{
  "type": "object",
  "properties": {
    "category": { "type": "string", "enum": ["release", "security", "tutorial", "other"] },
    "relevance": { "type": "number" },
    "one_line_summary": { "type": "string" }
  },
  "required": ["category", "relevance", "one_line_summary"]
}

Промпт цепочки ссылается на элемент ленты:

Classify this article for a VPS hosting audience.

Title: {{ $json.title }}
Content: {{ $json.contentSnippet }}

Здесь меняется расчет стоимости: она зависит от количества элементов, а не от количества запусков. Пятьдесят статей в час, двадцать четыре часа в сутки — это 36 000 вызовов Claude в месяц. На модели Haiku это составит примерно 40–90 долларов в зависимости от длины статей, на Opus — примерно в пять раз больше. Выполняйте дедупликацию перед узлом LLM (простая проверка IF по ранее встреченным ссылкам или узел Remove Duplicates в n8n), и число вызовов резко сократится, так как большинство ежечасных опросов не содержат ничего нового. Самый дешевый токен — это тот, который вы не потратили.

Рабочий процесс 3: AI-агент, использующий инструменты

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

Конкретный пример сборки: помощник по эксплуатации, который отвечает на вопрос «что не работает и почему», используя данные вашего мониторинга:

1. Chat Trigger (или webhook) — сюда поступает вопрос.
2. AI Agent с под-узлом Anthropic Chat Model, настроенным на claude-sonnet-5. Агенты планируют и выстраивают цепочки вызовов инструментов; Haiku может управлять простыми агентами с одним инструментом, но Sonnet — это разумный минимум, когда инструментов становится много.
3. Узел HTTP Request, подключенный в качестве инструмента, направленный на ваш API статуса Uptime Kuma или конечную точку Zabbix. Второй HTTP-инструмент может обращаться к любому другому сервису с REST API.

Две настройки выполняют основную часть работы. System Message агента определяет его задачу: «Ты помощник по эксплуатации. Используй инструмент статуса для проверки текущего состояния мониторинга перед ответом. Сообщай только о тех мониторах, которые не работают, с указанием длительности простоя». А описание каждого инструмента — это не документация для людей, а способ, с помощью которого Claude решает, когда его вызвать. Описание «Возвращает текущее состояние (в сети/не в сети) для всех отслеживаемых сервисов в формате JSON» будет вызываться в нужные моменты; описание «status API» будет проигнорировано или использовано неверно. При подключении узла HTTP Request в качестве инструмента включите опцию Optimize Response и выберите только нужные поля JSON, иначе каждый подробный ответ API будет передан в контекст модели как входные токены, за которые вы платите.

Установите Max Iterations для агента (по умолчанию 10) на минимально возможное рабочее значение; это разница между «агент сдался после 4 вызовов инструментов» и циклом из дюжины обращений к модели. Учитывайте структуру биллинга: каждая итерация повторно отправляет всю историю диалога, системное сообщение, вопрос и все предыдущие результаты работы инструментов в качестве входных токенов. Запуск агента на шесть итераций может легко составить в сумме 20 000 входных токенов и 2 000 выходных: для Sonnet 5 при цене $2/$10 это около $0.06, что примерно в двадцать раз дороже простого запуска суммаризации. Если вы обнаружите, что подключаете слишком много инструментов к одному агенту, это тот момент, когда запуск MCP-серверов на вашем VPS становится более чистой архитектурой.

Ограничения затрат, так как за этим никто не следит

Автоматизированный рабочий процесс требует контроля, который человек за клавиатурой обеспечивает неявно. Существует четыре уровня защиты, от самых простых к сложным.

Максимальное количество токенов (Max Tokens) на каждом узле Claude. Это жесткое ограничение на объем вывода. Для суммаризатора достаточно 300 токенов, для классификатора — 100. Это ограничивает наиболее затратную часть расходов (среди моделей в этом руководстве цена составляет от 5 до 50 долларов за миллион выходных токенов против 1–10 долларов за входные, при этом вывод стоит в пять раз дороже ввода) и служит аварийным тормозом: ошибка в промпте, из-за которой Claude начинает многословить, обойдется в 300 токенов, а не в 8000.

Выбор модели для каждого узла. Описано выше; разница в цене между Haiku 4.5 и Opus 4.8 составляет пятикратный рычаг, до десятикратного при переходе к Fable 5, а в текущей линейке, от Haiku 5.5 до Fable 5.1, разница достигает стократного размера для промптов до 100 000 токенов. Настройка занимает десять секунд.

Ограничение циклов. Установите Max Iterations для агентов. Настройте таймаут рабочего процесса в его параметрах, чтобы зависшее выполнение завершалось, а не продолжало потреблять ресурсы. Будьте осторожны с параметром Retry On Fail для каждого узла: это подходящий инструмент для временных ошибок, но повторные попытки увеличивают стоимость. Значение Max Tries, равное 3, с интервалом Wait Between Tries в 5000 мс означает, что при постоянной ошибке вы заплатите до трех раз за каждый элемент, прежде чем процесс остановится. Никогда не настраивайте повтор для узла, который уже успешно выполнил дорогостоящую операцию.

Рабочий процесс обработки ошибок как последняя линия обороны. Создайте рабочий процесс, начинающийся с узла Error Trigger, который отправляет имя сбойного процесса и текст ошибки в Slack, а затем укажите его в качестве Error Workflow в настройках каждого AI-процесса. Это позволяет отловить наиболее неприятный сценарий: когда процесс, запускаемый по расписанию, выдает ошибку при каждом выполнении, каждый час, в течение недели, расходуя токены перед завершением. Сочетайте это с ежемесячным лимитом расходов в Anthropic Console и проверяйте страницу использования в консоли в первые несколько дней после активации любых задач по расписанию. Если вы хотите точно понимать, за что вам выставляют счета, руководство по использованию токенов подробно разбирает этот вопрос.

Режимы сбоев и соответствующие сообщения

Узел мгновенно завершается с ошибкой "Authorization failed - please check your credentials." API вернул код 401. Тело ответа имеет следующий вид (текущие ответы также содержат поле request_id):

{"type": "error", "error": {"type": "authentication_error", "message": "invalid x-api-key"}}

Ключ вставлен с ошибкой, обрезан, содержит лишние пробелы или является заполнителем из руководства. Создайте учетные данные n8n заново и вставьте ключ еще раз. Если вчера всё работало, проверьте, не был ли ключ отозван, не истек ли срок его действия в консоли, или не привело ли восстановление тома к возврату к учетным данным, зашифрованным с другим N8N_ENCRYPTION_KEY.

Выполнения завершаются с ошибками 429 rate_limit_error, с сообщением вроде "Number of request tokens has exceeded your per-minute rate limit." Лимиты запросов рассчитываются поминутно и контролируются с помощью постоянно пополняемого «токенового ведра», а n8n позволяет легко запустить пятьдесят вебхуков или RSS-выполнений одновременно. Исправьте это структурно: обрабатывайте элементы последовательно (используя Loop Over Items), а не параллельно, и установите Retry On Fail с параметром Max Tries 3 и Wait Between Tries на максимум в 5000 мс (n8n ограничивает это поле значением 5000 мс). Если требуется более длительная задержка, чтобы ведро успело пополниться до повторной попытки, добавьте узел Wait в путь обработки ошибок или обрабатывайте элементы по одному. Ошибка 429 обычно содержит заголовок retry-after, указывающий, сколько секунд нужно подождать (в документации Anthropic отмечено, что это происходит не всегда). Фиксированная задержка n8n не умеет считывать этот заголовок, поэтому настройте более длительную паузу самостоятельно. Исключение: ошибка 429 без заголовка retry-after и с error_code равным enforced_spend_limit_reached означает, что ваша организация достигла месячного лимита расходов для своего тарифного плана, и повторные попытки не увенчаются успехом до начала следующего месяца или повышения тарифного плана.

Ошибка 404 not_found_error при указании модели. Сообщение содержит ID модели, который вы отправили, например:

{"type": "error", "error": {"type": "not_found_error", "message": "model: claude-haiku-4.5"}}

Использование точек вместо дефисов (4.5 вместо 4-5), опечатка или вымышленный суффикс даты, либо использование устаревшей модели из старой статьи. Сверьте ID с актуальным списком. Эта проблема часто возникает у тех, кто вводит ID модели в поле как выражение, вместо того чтобы выбрать его из выпадающего списка.

Claude отвечает на вопрос, который вы не задавали. Ошибок нет, выполнение завершено успешно. Выражение n8n, ссылающееся на отсутствующее поле, например {{ $json.body.text }}, когда в полезной нагрузке использовалось message, подставляет литеральную строку undefined в ваш промпт, и Claude добросовестно отвечает на промпт «ни о чем». Если ссылочный узел не выполнился вовсе, n8n остановится с ошибкой о том, что выражение ссылается на узел, который «еще не был выполнен», но отсутствие поля происходит без предупреждения. Перед активацией всегда запускайте процесс один раз с реальными данными и читайте фактически сформированный промпт на панели ввода узла. Редактор выражений показывает предварительный просмотр разрешенного значения, и undefined будет виден, если присмотреться.

FAQ

Как подключить Claude к n8n?

Создайте API-ключ в консоли Anthropic на платформе platform.claude.com, затем в n8n добавьте учетные данные (credential) типа Anthropic и вставьте ключ в поле API Key. Каждый узел Claude, приложение Anthropic и под-узел Anthropic Chat Model ссылаются на эти сохраненные учетные данные. n8n шифрует их с помощью N8N_ENCRYPTION_KEY, поэтому создайте резервную копию ключа, иначе при потере тома вы потеряете и учетные данные.

Сколько стоит выполнение одного AI-воркфлоу?

Оцените количество токенов на запуск, затем умножьте на стоимость модели за миллион токенов. По состоянию на октябрь 2026 года, Haiku 4.5 стоит $1/$5 за миллион входных/выходных токенов, а Sonnet 5 — $2/$10. Суммаризация через вебхук на Haiku стоит около четверти цента; запуск агента на Sonnet с несколькими вызовами инструментов обходится ближе к $0.06–$0.10, так как каждая итерация повторно отправляет всю историю переписки в качестве входных данных. Проверяйте фактические расходы на странице использования в консоли, а не полагайтесь на оценки.

Какую модель Claude использовать для автоматизаций в n8n?

Haiku 4.5 — для классификации, извлечения данных, суммаризации и маршрутизации, то есть для задач с большим объемом, где важны скорость и цена. Sonnet 5 — для узлов AI Agent и многошаговых логических задач. Opus 4.8 — только в тех случаях, когда цена ошибки достаточно высока, чтобы оправдать стоимость $5/$25 (в пять раз дороже Haiku и в два с половиной раза дороже Sonnet). Более новые модели Anthropic — Haiku 5.5, Sonnet 5.5 и Opus 5.5 — выполняют те же функции при равных или более низких ценах. Устанавливайте модель для каждого узла отдельно, а не для всего воркфлоу; один воркфлоу может сочетать все три модели.

Как предотвратить перерасход средств на API Claude в воркфлоу n8n?

Используйте многоуровневую защиту: установите низкое значение Max Tokens в каждом узле Claude, ограничьте Max Iterations для агентов, задайте таймаут для воркфлоу и используйте консервативные настройки Retry On Fail, чтобы ошибки не приводили к многократному росту затрат токенов. Добавьте воркфлоу Error Trigger, который будет отправлять уведомления в Slack при сбое любого AI-воркфлоу, и установите ежемесячный лимит расходов в консоли Anthropic в качестве жесткого ограничения, которое нельзя превысить с VPS.

Взимается ли дополнительная плата за вызовы инструментов (tool calls) AI-агентом?

Отдельной комиссии за использование инструментов нет, но инструменты не бесплатны: каждый результат работы инструмента передается модели как входные токены, а каждая итерация агента повторно отправляет всю историю переписки. Объемный ответ API, переданный без фильтрации, может значительно превысить размер вашего исходного промпта. Включите Optimize Response в инструментах HTTP Request и возвращайте только те поля, которые необходимы агенту.