가이드

작성자 Matt Connor 2026-10-20

n8n에서 Claude AI 워크플로우 구축 및 연동 가이드

VPS 환경의 n8n에 Claude API를 연동하는 방법을 설명합니다. 자격 증명 설정부터 노드별 모델 선택, 비용 최적화 전략, 그리고 실무에서 자주 발생하는 오류 해결법까지 3가지 핵심 워크플로우 예제를 통해 상세히 안내합니다.

구축할 내용

이미 운영 중인 n8n 인스턴스에서 세 가지 AI 워크플로우를 구현합니다. 전달받은 내용을 요약하는 웹훅, 기사를 읽어 구조화된 스프레드시트 행으로 변환하는 예약된 피드 리더, 그리고 질문에 답하기 위해 스스로 HTTP API를 호출하는 AI 에이전트입니다. 이는 VPS에서 Python으로 Claude API 호출하기의 노코드 버전입니다. 동일한 API, 동일한 토큰, 동일한 비용이 발생하지만, 오케스트레이션은 스크립트가 아닌 n8n 노드에서 수행됩니다.

n8n은 Docker 기반의 n8n 셀프 호스팅 가이드에 따라 이미 HTTPS 환경에서 구동 중이라고 가정합니다. 아직 설정하지 않았다면 먼저 진행하십시오. 웹훅은 실제 TLS 엔드포인트가 필요하며, API 키를 저장할 자격 증명 저장소는 해당 가이드에서 강조하는 암호화 키 백업이 필수입니다.

여기서 중요한 문제는 드래그 앤 드롭 방식이 아닙니다. 노드별 모델 선택, undefined를 자동으로 삽입하는 프롬프트 필드, 그리고 자동화가 무인으로 실행된다는 점이 핵심입니다. 실행당 0.5센트인 워크플로우는 저렴하지만, 재시도 루프가 밤새 4,000번 실행되면 이야기가 달라집니다. 이 가이드의 대부분은 이러한 운영상의 고려 사항을 다룹니다.

백업한 키로 암호화된 자격 증명 하나

platform.claude.com의 Anthropic Console 내 Settings, API Keys 메뉴에서 n8n-vps와 같은 이름으로 API 키를 생성합니다. 키는 생성 시 단 한 번만 표시됩니다. 생성 시 만료일을 설정해야 하므로 해당 날짜를 기록해 두십시오. 만료된 키는 아래 실패 모드에서 설명하는 401 오류를 발생시켜 자동화된 워크플로를 중단시킵니다. 계정에 잔액을 충전하거나 결제 수단을 등록하십시오. API 사용료는 토큰당 과금되며 선불 크레딧에서 차감됩니다. Pro 구독은 API 사용료를 포함하지 않지만, Claude Max 및 Team 플랜은 월간 Claude API 크레딧(Max 5x는 $100, Max 20x는 $200, Team은 최대 $500까지 합산)을 제공합니다. 이 크레딧은 claude.ai 결제 설정에서 Console 조직을 연결하여 사용할 수 있습니다. 이 크레딧은 n8n이 수행하는 것과 같은 API 호출 비용을 지불하는 데 사용되며, Claude Code 비용은 포함하지 않고 매 결제 주기마다 소멸합니다. 비용 지불 없이 세 가지 워크플로를 구축하려 한다면, Anthropic의 가격 정책 FAQ를 참고하십시오. 신규 사용자는 API 테스트를 위한 소량의 무료 크레딧을 받으므로, 결제 수단을 등록하기 전에 새 Console 계정으로 이 워크플로를 시험해 볼 수 있습니다. 크레딧 소진 후에는 모든 Claude 호출이 토큰당 과금됩니다. 토큰 계산 엔드포인트나 조직당 월 최대 1,550시간의 무료 코드 실행 시간 등 토큰 외 비용이 발생하지 않는 항목도 있으나, 이 세 가지 워크플로에서는 코드 실행을 사용하지 않습니다. 무료 API 크레딧의 적용 범위에서 자세한 내용을 확인할 수 있습니다.

n8n에서 Credentials, Create credential을 선택하고 Anthropic을 고른 뒤, API Key 필드에 키를 붙여넣고 저장합니다. 모든 워크플로의 모든 Claude 노드는 저장된 이 자격 증명을 참조하므로, 노드에 직접 키를 붙여넣을 필요는 없습니다.

운영 관련 참고 사항 두 가지입니다. 첫째, n8n은 저장된 자격 증명을 N8N_ENCRYPTION_KEY로 암호화합니다. n8n 가이드에 따라 compose 파일에 해당 환경 변수를 명시적으로 설정하면 컨테이너를 재구축해도 자격 증명이 유지됩니다. 만약 n8n이 자동으로 생성하게 두고 볼륨을 분실하면, 이 키를 포함한 모든 저장된 자격 증명은 복구 불가능한 암호문이 됩니다. 백업을 건너뛰었다면 지금 바로 백업하십시오. 둘째, n8n 자격 증명 저장소를 보안의 핵심 범위로 간주하십시오. Anthropic 자격 증명을 사용할 수 있는 사람은 누구나 귀하의 키로 요청을 보낼 수 있습니다. Community 에디션에서는 귀하와 인스턴스 소유자에게 해당하며, n8n 문서에 따르면 "인스턴스 소유자와 자격 증명을 생성한 사용자만 워크플로와 자격 증명에 접근할 수 있으므로" 다른 Member 계정은 접근할 수 없습니다. 워크플로와 자격 증명 공유는 self-hosted n8n의 유료 기능(Business 또는 Enterprise)이며, 워크플로를 공유하면 편집 권한이 있는 사용자는 해당 워크플로가 사용하는 모든 자격 증명을 사용할 수 있습니다. 따라서 다른 사용자가 이 인스턴스에 로그인한다면, 계정을 부여하기 전에 유료 n8n 라이선스에 포함된 접근 제어를 먼저 읽어보십시오. 인스턴스가 침해되거나 오작동할 경우를 대비해 Console의 Settings에서 지출 한도를 설정하십시오.

모델 선택은 노드별로 결정합니다

n8n의 Claude 노드에 있는 모델 드롭다운은 API에서 실시간으로 정보를 가져오므로, 사용자의 키로 접근 가능한 모델이 표시됩니다. 이 가이드에서 사용하는 모델과 2026년 10월 기준 백만 입력/출력 토큰당 API 가격은 다음과 같습니다. Claude Haiku 4.5(claude-haiku-4-5)는 200K 컨텍스트 윈도우를 지원하며 $1/$5입니다. Claude Sonnet 5(claude-sonnet-5)와 Claude Opus 4.8(claude-opus-4-8)은 1M 토큰 컨텍스트 윈도우를 지원하며 각각 $2/$10, $5/$25입니다. 가장 복잡한 추론 작업을 위한 Claude Fable 5(claude-fable-5)는 $10/$50이며, 이 가이드의 어떤 작업도 이 모델을 필요로 하지 않습니다. 정확한 ID를 사용하십시오. claude-haiku-4-5은 고정된 스냅샷 claude-haiku-4-5-20251001의 별칭이며 이 또한 작동하지만, 오래된 튜토리얼에서 복사한 날짜가 지난 ID는 이미 서비스가 종료된 모델을 가리켜 실패할 수 있습니다. 가격은 변동되므로, 이곳을 포함한 어떤 문서의 숫자도 맹신하지 말고 platform.claude.com을 먼저 확인하십시오.

이 가이드가 처음 발행된 이후 Anthropic은 더 새로운 모델을 출시했으며, 현재 문서에서는 Haiku 4.5, Sonnet 5, Opus 4.8, Fable 5를 레거시로 분류합니다. 이 모델들은 여전히 작동합니다. 서비스 종료 페이지에 따르면 Haiku 4.5의 종료 시점은 2026년 10월 15일 이전이 아니었습니다. 해당 날짜는 지났으며, 2026년 10월 20일 기준으로 해당 페이지에는 여전히 Haiku 4.5가 종료 공지 없이 활성 상태로 표시됩니다. Sonnet 5, Opus 4.8, Fable 5는 2027년 중반 이전에는 종료되지 않습니다. Anthropic은 공개 출시된 모델을 종료할 때 최소 60일 전에 공지하므로, 워크플로우에서 Haiku 4.5를 고정하여 사용 중이라면 서비스 종료 페이지를 주시하십시오. 현재 라인업은 2026년 10월 7일에 출시된 Claude Haiku 5.5(claude-haiku-5-5, 100,000 토큰까지 $0.10/$0.50, 그 이상은 $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의 토크나이저는 동일한 텍스트를 Haiku 4.5보다 약 30% 더 많은 토큰으로 계산하므로, 단순히 정가만 비교하지 말고 콘솔의 사용량 페이지에서 실제 실행당 비용을 비교하십시오.

습관을 들여야 할 점은 플랫폼 단위가 아닌 노드 단위로 모델을 선택하는 것입니다. 자동화의 핵심인 분류, 추출, 요약, 라우팅 작업은 Sonnet 정가의 절반, Opus의 5분의 1 가격인 Haiku에서도 훌륭하게 수행됩니다. Sonnet은 에이전트와 다단계 추론에 사용하고, Opus는 잘못된 답변이 토큰 비용보다 더 큰 손실을 초래하는 드문 워크플로우에만 사용하십시오. 5개의 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 문서에서 기억해 두어야 할 주의 사항이 하나 있습니다. 서브 노드 내부의 표현식은 항상 각 항목이 아닌 첫 번째 입력 항목을 기준으로 해석됩니다. 따라서 항목별 표현식은 서브 노드가 아닌 루트 노드의 프롬프트 필드에 작성해야 합니다. 또한 Anthropic 측의 주의 사항도 있습니다. Haiku 4.5를 제외한 이 가이드의 모든 모델인 Claude 4.7 이상 모델에서는 temperature, top_p 또는 top_k를 기본값이 아닌 다른 값으로 설정하면 400 오류가 발생합니다. 따라서 해당 모델을 사용할 때는 Sampling Temperature, Top K, Top P를 설정하지 마십시오.

워크플로우 1: 웹훅 수신 및 요약 발송

AI 자동화의 입문 단계입니다. 특정 URL로 POST 요청을 보내면 내용을 요약하여 Slack이나 이메일로 전달합니다.

Webhook 노드에서 HTTP Method를 POST로 설정하고 경로를 summarize으로 지정합니다. n8n은 테스트 URL과 프로덕션 URL을 제공하며, 프로덕션 URL은 워크플로우를 게시해야만 수신 대기 상태가 됩니다.
Anthropic 노드에서 Message a Model을 선택하고 모델을 claude-haiku-4-5로 설정한 뒤, Max Tokens를 300 정도로 맞춥니다.
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 }}

역할과 형식 지침은 사용자 메시지가 아닌 노드의 시스템 프롬프트 필드에 작성하십시오. 시스템 프롬프트는 고정되어 있고 페이로드는 변하기 때문에, 이렇게 구성하면 동작이 안정적으로 유지되며 6개월 뒤에도 프롬프트를 쉽게 읽을 수 있습니다. 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 모델의 실행당 비용은 다음과 같습니다. 1,200 토큰의 페이로드와 프롬프트를 합치면 입력 비용은 약 $0.0012이며, 300 토큰 출력 비용은 $0.0015로, 총 0.25센트 정도입니다. 한 달에 1,000번 실행해도 $3 미만입니다. 동일한 노드를 Opus 4.8로 설정하면 비용은 약 5배가 됩니다. 구축하는 모든 워크플로우에서 이러한 비용 비율을 고려하는 것이 노드별 모델 선택 습관이 중요한 이유입니다.

워크플로 2: RSS 피드를 정기적으로 읽어 구조화된 행으로 저장

이제 주기적으로 실행되며 구조화된 결과를 출력하는 작업을 구성합니다. 매시간 RSS 피드를 읽고, 각 항목을 분류한 뒤, 시트에 행을 추가하는 방식입니다.

Schedule Trigger: 매시간 실행되도록 설정합니다.
RSS Read: 피드 URL을 입력합니다. 기사당 하나의 항목을 출력합니다.
Basic LLM Chain: claude-haiku-4-5으로 설정된 Anthropic Chat Model 하위 노드와 JSON 스키마를 포함한 Structured Output Parser 하위 노드를 사용합니다.
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 }}

여기서는 비용 산정 방식이 달라집니다. 실행 단위가 아닌 항목 단위로 비용이 발생하기 때문입니다. 시간당 50개의 기사를 하루 24시간 처리하면 한 달에 36,000번의 Claude 호출이 발생합니다. Haiku 모델 사용 시 기사 길이에 따라 약 40–90달러가 소요되며, Opus 모델은 그보다 5배가량 더 듭니다. LLM 노드 이전에 중복 제거(이전에 확인한 링크와 비교하는 간단한 IF 조건문이나 n8n의 Remove Duplicates 노드 사용)를 수행하면 호출 횟수가 급격히 줄어듭니다. 매시간 확인하는 피드 대부분에는 새로운 내용이 없기 때문입니다. 가장 저렴한 토큰은 호출하지 않는 호출입니다.

워크플로 3: 도구를 사용하는 AI 에이전트

앞선 두 워크플로는 단계별로 직접 구성하는 파이프라인입니다. 반면 AI Agent 노드는 방식이 다릅니다. Claude에게 목표와 도구를 제공하면, 에이전트가 작업을 완료할 때까지 어떤 도구를 어떤 순서로 호출할지 스스로 결정합니다. n8n에서는 채팅 모델 하위 노드와 최소 하나 이상의 도구 하위 노드를 연결해야 합니다.

구체적인 예시로, 모니터링 시스템에서 "현재 무엇이 중단되었고 그 이유는 무엇인가"를 답변하는 운영 보조 에이전트를 구성해 보겠습니다.

Chat Trigger(또는 webhook): 질문이 입력됩니다.
AI Agent: claude-sonnet-5로 설정된 Anthropic Chat Model 하위 노드를 포함합니다. 에이전트는 도구 호출을 계획하고 연결합니다. Haiku는 단순한 단일 도구 에이전트를 구동할 수 있지만, 도구가 많아지면 Sonnet을 사용하는 것이 합리적인 최소 사양입니다.
HTTP Request 노드: 도구로 연결하여 Uptime Kuma 상태 API 또는 Zabbix 엔드포인트를 가리킵니다. 두 번째 HTTP 도구를 추가하면 REST API를 가진 다른 모든 서비스와 통신할 수 있습니다.

두 가지 설정이 핵심적인 역할을 합니다. 에이전트의 System Message는 역할을 정의합니다: "당신은 운영 보조원입니다. 답변하기 전에 상태 도구를 사용하여 현재 모니터링 상태를 확인하십시오. 중단된 모니터링 항목과 지속 시간만 보고하십시오." 또한 각 도구의 설명(description)은 사람이 읽는 문서가 아니라, Claude가 도구 호출 시점을 결정하는 기준이 됩니다. "모든 모니터링 서비스의 현재 상태(up/down)를 JSON으로 반환"이라고 적으면 적절한 시점에 호출되지만, 단순히 "상태 API"라고 적으면 무시되거나 잘못 사용될 수 있습니다. HTTP Request 노드를 도구로 연결할 때는 Optimize Response 옵션을 활성화하고 필요한 JSON 필드만 선택하십시오. 그렇지 않으면 장황한 API 응답 전체가 모델의 컨텍스트로 입력되어 토큰 비용이 낭비됩니다.

에이전트의 Max Iterations(기본값 10)를 작동 가능한 최소 숫자로 설정하십시오. 이는 "에이전트가 4번의 도구 호출 후 포기함"과 "수십 번의 모델 왕복 루프"를 결정짓는 차이가 됩니다. 또한 비용 구조를 이해해야 합니다. 각 반복마다 지금까지의 전체 대화, 시스템 메시지, 질문, 이전 도구 결과가 모두 입력 토큰으로 다시 전송됩니다. 6번 반복하는 에이전트 실행은 누적 입력 토큰 20,000개와 출력 토큰 2,000개에 달할 수 있습니다. Sonnet 5 기준($2/$10)으로 약 $0.06이며, 이는 단순 요약 작업보다 20배가량 높은 비용입니다. 하나의 에이전트에 너무 많은 도구를 연결하게 된다면, VPS에서 MCP 서버를 실행하는 것이 더 깔끔한 아키텍처가 됩니다.

비용 가드레일: 아무도 지켜보지 않을 때를 대비하여

자동화된 워크플로우에는 사람이 키보드 앞에서 직접 제어할 때 암묵적으로 수행하는 통제 장치가 필요합니다. 비용이 저렴한 순서대로 4가지 계층의 방어책을 적용하십시오.

모든 Claude 노드에 Max Tokens 설정. 이는 출력에 대한 강제 제한입니다. 요약 노드에는 300, 분류 노드에는 100 정도가 적당합니다. 이 설정은 비용 발생의 상한선을 정하며(본 가이드의 모델 기준, 출력 토큰 100만 개당 $5–$50, 입력 토큰은 $1–$10이며 출력 비용은 입력의 5배입니다), 프롬프트 오류로 인해 Claude가 불필요하게 긴 답변을 생성할 때 8,000 토큰이 아닌 300 토큰에서 멈추게 하는 브레이크 역할을 합니다.

노드별 모델 설정. 위에서 언급했듯이 Haiku 4.5와 Opus 4.8 사이에는 5배의 가격 차이가 있으며, Fable 5까지는 10배에 달합니다. 현재 라인업 전체를 기준으로 Haiku 5.5에서 Fable 5.1까지는 100,000 토큰 프롬프트 기준 최대 100배까지 차이가 납니다. 설정하는 데 10초면 충분합니다.

루프 제한. 에이전트의 Max Iterations를 설정하십시오. 워크플로우 설정에서 타임아웃을 지정하여 실행이 멈췄을 때 무한 루프를 돌지 않고 종료되도록 하십시오. 노드별 Retry On Fail 설정은 신중해야 합니다. 일시적인 오류에는 유용하지만, 재시도는 비용을 곱절로 늘립니다. Max Tries를 3으로, Wait Between Tries를 5000 ms로 설정하면, 지속적인 실패 시 항목당 최대 3번까지 비용이 청구됩니다. 이미 성공적으로 완료된 노드에 재시도 설정을 추가하지 마십시오.

최후의 수단으로 오류 워크플로우 활용. Error Trigger 노드로 시작하는 워크플로우를 생성하여 실패한 워크플로우의 이름과 오류 내용을 Slack으로 전송하도록 하십시오. 그런 다음 각 AI 워크플로우 설정에서 이 워크플로우를 Error Workflow로 지정하십시오. 이 방식은 매시간 실행되는 스케줄 기반 워크플로우가 일주일 내내 오류를 일으키며 매번 토큰을 소모하는 최악의 상황을 방지합니다. Anthropic Console에서 월별 지출 한도를 설정하고, 스케줄 기반 작업을 활성화한 후 며칠 동안은 Console의 사용량 페이지를 확인하십시오. 청구 내역을 정확히 이해하려면 토큰 사용량 가이드를 참조하십시오.

실패 유형 및 확인 가능한 메시지

노드가 "Authorization failed - please check your credentials." 메시지와 함께 즉시 실패합니다. API가 401 코드를 반환한 경우입니다. 응답 본문은 다음과 같은 형태를 띱니다(현재 응답에는 request_id 필드도 포함됩니다).

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

키를 잘못 붙여넣었거나, 잘렸거나, 공백이 포함되었거나, 튜토리얼의 플레이스홀더가 남아있는 경우입니다. n8n 자격 증명을 새로 생성하여 다시 붙여넣으십시오. 어제까지 정상 작동했다면 Console에서 키가 취소되었거나 만료되었는지, 혹은 볼륨 복구 과정에서 다른 N8N_ENCRYPTION_KEY로 암호화된 자격 증명으로 되돌아갔는지 확인하십시오.

실행이 429 rate_limit_error 오류와 함께 간헐적으로 실패하며, "Number of request tokens has exceeded your per-minute rate limit."와 유사한 메시지가 나타납니다. 속도 제한은 분 단위로 측정되며 지속적으로 충전되는 토큰 버킷 방식으로 적용됩니다. n8n은 50개의 웹훅이나 RSS 실행을 동시에 처리하기 매우 쉽습니다. 이를 구조적으로 해결하려면 병렬 처리가 아닌 순차 처리(Loop Over Items)를 사용하고, Retry On Fail 설정에서 Max Tries를 3으로, Wait Between Tries를 최대치인 5000 ms로 설정하십시오. n8n은 해당 필드를 5000 ms로 제한합니다. 재시도 전 버킷이 충전될 시간을 확보하기 위해 더 긴 대기 시간이 필요하다면, 오류 경로에 Wait 노드를 추가하거나 항목을 하나씩 처리하십시오. 429 속도 제한 오류에는 보통 대기 시간을 초 단위로 알려주는 retry-after 헤더가 포함되지만(Anthropic 문서에 따르면 모든 429 오류에 포함되지는 않습니다), n8n의 고정 대기 설정은 이를 읽을 수 없으므로 더 긴 대기 시간을 직접 구현해야 합니다. 한 가지 예외로, retry-after 헤더가 없고 error_code가 enforced_spend_limit_reached인 429 오류는 조직의 월간 사용량 한도에 도달했음을 의미합니다. 이 경우 다음 달이 되거나 등급을 상향하기 전까지는 재시도가 성공하지 않습니다.

모델 이름을 지정하는 404 not_found_error 오류가 발생합니다. 메시지에는 다음과 같이 전송한 모델 ID가 포함됩니다.

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

하이픈 대신 점을 사용했거나(4-5 대신 4.5), 날짜 접미사를 잘못 입력했거나 지어냈거나, 오래된 블로그 게시물에 나온 은퇴한 모델을 사용하는 경우입니다. 현재 목록을 확인하여 ID를 수정하십시오. 드롭다운에서 선택하지 않고 모델 필드에 표현식(expression)으로 직접 입력하는 사용자에게 자주 발생하는 문제입니다.

Claude가 질문하지 않은 내용에 대해 답변합니다. 오류는 없으며 실행 결과는 녹색으로 표시됩니다. 페이로드는 message를 사용했는데 {{ $json.body.text }}와 같이 존재하지 않는 필드를 참조하는 n8n 표현식은 프롬프트에 undefined이라는 문자열을 그대로 삽입하며, Claude는 이에 대해 성실하게 답변합니다. 참조된 노드가 전혀 실행되지 않았다면 n8n은 "hasn't been executed yet"이라는 오류와 함께 중단되지만, 필드가 누락된 경우에는 아무런 경고 없이 넘어갑니다. 활성화하기 전에 항상 실제 데이터로 한 번 실행하고 노드의 입력 패널에서 실제로 렌더링된 프롬프트를 확인하십시오. 표현식 편집기는 해석된 값을 미리 보여주며, 확인해 보면 undefined이 바로 그곳에 있습니다.

FAQ

Claude를 n8n에 어떻게 연결합니까?

platform.claude.com의 Anthropic Console에서 API 키를 생성한 뒤, n8n에서 Anthropic 유형의 자격 증명을 추가하고 API Key 필드에 붙여넣으십시오. 모든 Claude 노드, Anthropic 앱 노드, Anthropic Chat Model 하위 노드는 저장된 이 자격 증명을 참조합니다. n8n은 이를 N8N_ENCRYPTION_KEY로 암호화하므로, 볼륨 데이터가 손실될 경우를 대비해 키를 반드시 백업하십시오.

AI 워크플로우 실행당 비용은 얼마입니까?

실행당 예상 토큰 수를 계산한 뒤 모델별 100만 토큰당 가격을 곱하십시오. 2026년 10월 기준, Haiku 4.5는 입력/출력 토큰당 $1/$5이며 Sonnet 5는 $2/$10입니다. Haiku를 사용한 웹훅 요약은 약 0.25센트가 소요됩니다. 반면 여러 도구를 호출하는 Sonnet 기반 에이전트 실행은 매 반복마다 전체 대화 내용을 입력으로 다시 전송하므로 $0.06–$0.10에 가까운 비용이 발생합니다. 추정치에 의존하지 말고 Console의 사용량 페이지에서 실제 실행 비용을 확인하십시오.

n8n 자동화에는 어떤 Claude 모델을 사용해야 합니까?

분류, 추출, 요약, 라우팅 등 속도와 가격이 중요한 대량 작업에는 Haiku 4.5를 사용하십시오. AI 에이전트 노드와 다단계 추론에는 Sonnet 5가 적합합니다. Opus 4.8은 오답으로 인한 비용이 $5/$25라는 정가를 정당화할 만큼 큰 경우에만 사용하십시오. 이는 Haiku의 5배, Sonnet의 2.5배 가격입니다. Anthropic의 최신 모델인 Haiku 5.5, Sonnet 5.5, Opus 5.5는 동일하거나 더 낮은 정가로 같은 역할을 수행합니다. 모델은 워크플로우 단위가 아닌 노드 단위로 설정하십시오. 하나의 워크플로우에서 세 모델을 혼합하여 사용할 수 있습니다.

n8n 워크플로우가 Claude API에서 과도한 비용을 지출하지 않게 하려면 어떻게 합니까?

가드레일을 계층적으로 적용하십시오. 모든 Claude 노드에 낮은 Max Tokens를 설정하고, 에이전트의 Max Iterations, 워크플로우 타임아웃, 그리고 비용이 곱절로 늘어나지 않도록 보수적인 Retry On Fail 설정을 적용하십시오. 또한 AI 워크플로우 실패 시 Slack으로 알림을 보내는 Error Trigger 워크플로우를 추가하고, VPS의 어떤 작업도 우회할 수 없는 강제 상한선으로 Anthropic Console에서 월별 지출 한도를 설정하십시오.

AI 에이전트 도구 호출 시 추가 비용이 발생합니까?

별도의 도구 사용료는 없지만 도구 사용도 무료는 아닙니다. 모든 도구 결과는 입력 토큰으로 모델에 다시 전달되며, 각 에이전트 반복마다 지금까지의 전체 대화 내용이 다시 전송됩니다. API 응답을 필터링 없이 그대로 전달하면 실제 프롬프트보다 훨씬 큰 비용이 발생할 수 있습니다. HTTP Request 도구에서 Optimize Response를 활성화하여 에이전트가 필요한 필드만 반환하도록 하십시오.

#n8n #claude #ai #automation #workflows