Claude API + n8n 자동화 가이드: 30분 안에 AI 워크플로우 (2026)

Q: n8n에서 Claude tool use를 실행할 수 있나요?

네 — JSON body에 tools 배열 전달, Function 노드에서 tool_use 콘텐츠 블록 처리, 다른 n8n 노드로 디스패치, 후속 Claude 호출에 tool_result 피드백. 다단계지만 가능. 심층 패턴은 Claude API Tool Use 한국어 참고.

n8n은 Claude API를 Postgres·Slack·Gmail·Notion·Stripe 등 400개 이상 통합과 연결하는 가장 유연한 워크플로우 자동화 도구입니다. HTTP Request 노드 3개 필드면 Claude를 호출하고, 이메일 분류·콘텐츠 생성·리드 스코어링·RAG 파이프라인을 코드 없이 만들 수 있습니다. 셀프호스트 n8n은 $0(Docker), 클라우드는 월 $20부터. Claude Haiku($1/M 입력 토큰)와 결합하면 SMB 사용량 기준 월 $5-50로 전체 워크플로우 운영 가능. 이 가이드는 연결 설정, 5개 프로덕션 템플릿, 에러 처리, 비용 최적화를 다룹니다.

Claude API 기본은 Claude API Python 한국어, 영어 풀버전은 Claude API + n8n Automation 참고.

n8n vs Zapier vs Make 비교

항목	n8n	Zapier	Make
무료 티어	셀프호스트 무제한	100 task/월	1,000 ops/월
가격 (1만 실행)	$20/월 클라우드	~$70/월	~$25/월
AI 통합	HTTP + 커뮤니티 노드	OpenAI 네이티브, Claude는 webhook	OpenAI 네이티브
셀프호스트	가능	불가	불가
JavaScript 코드	Function 노드 내장	제한적	제한적
적합 사용자	개발자, 복잡 흐름	마케터, 단순 흐름	시각적 + JSON

Claude 중심 워크플로우는 n8n이 승리: 무료 셀프호스트, 완전한 HTTP 제어, JavaScript 탈출구.

설정: Claude API를 n8n에 연결 (3분)

옵션 A: HTTP Request 노드 (보편)

n8n → 새 워크플로우 → HTTP Request 노드 추가
Method: POST
URL: https://api.anthropic.com/v1/messages
Authentication: Header Auth → Name: x-api-key, Value: {Claude 키}
Headers: anthropic-version: 2023-06-01, content-type: application/json 추가
Body Content Type: JSON
JSON body:

{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [{"role": "user", "content": "{{ $json.prompt }}"}]
}

테스트 → $json.content[0].text에서 Claude 응답을 다음 노드로 전달.

옵션 B: Anthropic 커뮤니티 노드

n8n-nodes-anthropic이 문법을 단순화. 셀프호스트에서:

npm install n8n-nodes-anthropic

드래그앤드롭, API 키 한 번 입력, 드롭다운으로 모델 선택.

템플릿 1: 이메일 분류 파이프라인

트리거: Gmail 새 이메일 → Claude 분류 → Slack 라우팅

Gmail Trigger → HTTP (Claude) → Switch → Slack (카테고리별)

Claude 프롬프트:

이 이메일을 다음 카테고리 하나로 분류:
- urgent_customer
- sales_lead
- billing_question
- spam
- other

카테고리 이름만 응답.

이메일 제목: {{ $json.subject }}
이메일 본문: {{ $json.body }}

Switch 노드가 Claude 출력으로 라우팅. 긴급 → #support-urgent, 리드 → #sales. 8개 노드로 끝.

비용: 일 500개 이메일 × Haiku ($1/M 토큰) = 일 ~$0.15 = 월 $4.50.

템플릿 2: Notion → 블로그 포스트 생성기

트리거: Notion DB 행 생성 (status="Draft") → Claude가 글 작성 → Notion 행 업데이트

Notion Trigger → HTTP (Claude 작성) → HTTP (Claude SEO 검증) → Notion 업데이트

Claude 작성 프롬프트:

이 주제로 1500단어 블로그 포스트 작성.

주제: {{ $json.title }}
키워드: {{ $json.keywords }}
타겟: {{ $json.audience }}

마크다운만 출력. H2 섹션 포함, 하단에 FAQ.

두 번째 Claude 호출이 구조 검증(H1+FAQ+데이터포인트). 통과 시 Notion에 "Ready"로, 실패 시 피드백과 함께 "Needs revision"로 저장.

비용: 일 1편 × Sonnet ($3/$15) 4K 토큰 = 편당 ~$0.15 = 월 $4.50.

템플릿 3: 리드 스코어링 + 인리치먼트

트리거: Webhook (폼에서) → Claude 스코어링 → Postgres 저장 → 고점수 시 Slack 알람

Webhook → HTTP (Claude 스코어링) → Postgres Insert → IF (score>80) → Slack

Claude 프롬프트:

이 B2B 리드를 0-100점으로 평가. 요소:
- 회사 규모 ({{ $json.company_size }})
- 직책 의사결정 가중치
- 이메일 도메인 품질
- 활용 사례 적합도 ({{ $json.use_case }})

JSON 출력: {"score": N, "reason": "...", "next_action": "..."}

response_format으로 Body Content Type 설정 또는 프롬프트 기반 JSON. 안정성은 Claude API JSON 모드 참고.

템플릿 4: 사내 문서 RAG

트리거: Slack 슬래시 명령 → 벡터 DB 조회 → Claude 답변 → Slack 응답

Slack Trigger → Postgres (pgvector 쿼리) → HTTP (Claude + 컨텍스트) → Slack Reply

임베딩 단계 필요(OpenAI 임베딩 또는 Voyage AI 사용), Claude는 최종 답변. 프롬프트 인젝션 방어 패턴 1에 따라 검색된 청크를 <untrusted_documents> 마커로 감싸기.

비용: 일 50 쿼리 × Sonnet + 8K 컨텍스트 = 일 ~$1 = 월 $30. cache_control로 검색된 청크 캐싱하면 90% 절감.

템플릿 5: 고객 지원 자동 답변

트리거: Zendesk 새 티켓 → Claude 답변 초안 → 사람 승인 → Zendesk 전송

Zendesk Trigger → HTTP (Claude 초안) → Wait (webhook으로 사람 검토) → Zendesk Update

핵심: 초안만, 자동 전송 금지. 사람 승인 게이트가 프롬프트 인젝션 방어 패턴 7 — 되돌릴 수 없는 행동은 명시적 사람 승인 필요.

에러 처리

n8n 기본 에러 모드는 "워크플로우 중단". Claude API용으로 추가:

HTTP 노드의 에러 시 계속 활성화 (Settings 탭)
{{ $json.error }} 체크용 IF 노드
429/529용 Wait + Retry (Function 노드의 지수 백오프)
지속 실패용 Slack 알람

프로덕션 패턴은 Claude API 에러 처리 한국어 참고.

비용 최적화

분류·추출에 Haiku ($1/M vs Sonnet $3/M) — 67% 절감
긴 시스템 프롬프트 캐싱 — cache_control: {"type": "ephemeral"} 반복 컨텍스트 90% 절감
저우선 요청 배치 처리 — Batch API로 50% 할인
max_tokens 현실적으로 — 분류는 200으로 충분
n8n 셀프호스트 — $0 vs $20/월 클라우드

조합 시: 단순 Sonnet 흐름 대비 80% 절감.

Frequently Asked Questions

n8n에 공식 Claude 노드가 있나요?

2026년 5월 현재 없음 — 커뮤니티 노드만. HTTP Request 노드가 공식 지원 경로이며 동일하게 작동.

n8n에서 Claude 응답을 스트리밍할 수 있나요?

네, HTTP Request 노드의 SSE 기능으로 가능. 하지만 워크플로우에서는 거의 유용하지 않음(라우팅 전 전체 응답이 필요). 스트리밍은 챗 UI에만 사용.

n8n에서 Claude API 키를 어떻게 안전하게 보관하나요?

n8n Credentials에 저장(저장 시 암호화), 워크플로우 JSON에 절대 넣지 말 것. 셀프호스트: env 변수 N8N_ENCRYPTION_KEY가 암호화 키 회전.

n8n에서 Claude tool use를 실행할 수 있나요?

네 — JSON body에 tools 배열 전달, Function 노드에서 tool_use 콘텐츠 블록 처리, 다른 n8n 노드로 디스패치, 후속 Claude 호출에 tool_result 피드백. 다단계지만 가능. 심층 패턴은 Claude API Tool Use 한국어 참고.

n8n 경유 Claude의 지연시간은?

직접 API 호출 대비 ~50ms 추가. 총: Sonnet 4.5 짧은 응답 800ms-2s, Haiku는 더 빠름.

Claude API 프로덕션 패턴 마스터하기

Claude Agent SDK Cookbook ($79) — 에러 처리, tool use, 비용 가드가 포함된 n8n 워크플로우 템플릿 8개를 포함한 40개 프로덕션 에이전트 레시피.