n8n + Claude API 연동해서 AI 자동화 워크플로우 만들기 — 설치부터 실전 노드 구성까지

들어가며: n8n과 Claude API로 자동화의 미래를 만나다

안녕하세요. 오늘은 최근 개발자와 비개발자 모두에게 큰 주목을 받고 있는 두 가지 도구를 연결하는 방법을 소개합니다. 바로 n8n과 Claude API</strong의 조합입니다.

n8n은 노드 기반의 오픈소스 워크플로우 자동화 플랫폼이고, Claude는 Anthropic에서 만든 대형언어모델(LLM)입니다. 둘을 합치면 이메일 분류, 고객 지원 자동화, 데이터 처리, 콘텐츠 생성 등 다양한 지능형 자동화를 구축할 수 있습니다.

이 글에서는 n8n 설치부터 Claude API 키 연동, 실전 워크플로우 구성까지 단계별로 설명하겠습니다. 기술 경험이 없어도 따라할 수 있도록 정리했으니, 끝까지 함께해보세요.

1단계: n8n 설치하기 (Docker & npm 방법)

1-1. Docker를 이용한 설치 (추천)

Docker가 설치되어 있다면 가장 빠르고 깔끔합니다.

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -e N8N_HOST=localhost \
  -e N8N_PORT=5678 \
  -e DB_TYPE=sqlite \
  -e DB_SQLITE_FILE=/home/node/.n8n/database.sqlite \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

실행 후 http://localhost:5678에 접속하면 n8n 초기 화면이 나타납니다.

1-2. npm을 이용한 설치

Node.js가 설치되어 있다면 npm으로도 설치할 수 있습니다.

npm install -g n8n
n8n start

마찬가지로 http://localhost:5678로 접속하세요.

1-3. 클라우드 호스팅 이용

자체 서버 관리가 불편하다면 n8n Cloud를 사용할 수 있습니다. https://www.n8n.cloud에서 가입하면 별도 설치 없이 바로 시작할 수 있습니다. 무료 플랜도 있으므로 학습용으로는 충분합니다.

2단계: Claude API 키 발급 및 설정

2-1. Anthropic 플랫폼에서 API 키 생성

먼저 Anthropic 공식 사이트(https://www.anthropic.com)에서 API 키를 발급받아야 합니다.

Anthropic 웹사이트의 "Console"으로 이동
계정 로그인 (없으면 가입)
좌측 메뉴 "API Keys" 선택
"Create Key" 버튼 클릭
생성된 키를 안전한 곳에 복사해서 저장 (다시 볼 수 없음)

중요: API 키는 절대 공개 저장소나 코드에 직접 넣으면 안 됩니다. 항상 환경 변수나 보안 저장소를 사용하세요.

2-2. 요금 체계 확인

Claude API는 사용량 기반 과금입니다. 2024년 기준 Claude 3.5 Sonnet은:

Input: $3/1M tokens
Output: $15/1M tokens

무료 크레딧을 받을 수 있으니, 처음부터 요금을 걱정하지 않아도 됩니다. 단, 과다 사용 방지를 위해 월간 한도를 설정하는 것을 권장합니다.

3단계: n8n에서 Claude API 연동하기

3-1. HTTP Request 노드로 Claude 연결

n8n의 가장 유연한 방법은 HTTP Request 노드를 사용하는 것입니다. 다음과 같이 구성합니다.

노드 설정:

n8n 대시보드에서 "New Workflow" 클릭
"+" 버튼으로 노드 추가 → "HTTP Request" 선택

HTTP Request 노드 설정값:

Method: POST
URL: https://api.anthropic.com/v1/messages
Authentication: Generic Credential Type

Headers 설정:

{
  "x-api-key": "YOUR_ANTHROPIC_API_KEY",
  "anthropic-version": "2023-06-01",
  "content-type": "application/json"
}

Body (JSON):

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "여기에 사용자 메시지를 입력하세요"
    }
  ]
}

3-2. n8n Credential으로 API 키 관리

보안상 API 키를 직접 노드에 넣지 말고, n8n의 Credential 기능을 사용합니다.

n8n 좌측 메뉴 → "Credentials"
"New" 버튼 → "Generic Credential Type" 선택
이름: Anthropic API Key
Username: ignored (또는 비워둔 후)
Password: sk-ant-xxxxx (발급받은 API 키)
"Save" 클릭

이제 HTTP Request 노드에서 이 Credential을 선택하면 API 키가 안전하게 관리됩니다.

4단계: 실전 워크플로우 예시

예시 1: 이메일 텍스트 자동 분류 및 요약

수신된 이메일을 Claude에게 분류하고 요약하는 워크플로우입니다.

노드 구성:

Trigger: "Webhook" 또는 "Gmail" 노드 (이메일 수신 감지)
Processing: "HTTP Request" 노드 (Claude 호출)
Output: "Google Sheets" 또는 "Send Email" 노드 (결과 저장/전송)

Claude 호출 Body 예시:

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 500,
  "messages": [
    {
      "role": "user",
      "content": "다음 이메일을 분석하고 (1) 카테고리 (2) 중요도 (3) 핵심 요약을 3줄 이내로 제시하세요.\n\n이메일 제목: {{$node[\"Email Trigger\"].json.subject}}\n이메일 본문: {{$node[\"Email Trigger\"].json.body}}"
    }
  ]
}

활용 시나리오:

수신 이메일 자동 분류 (긴급, 일반, 스팸)
고객 서비스 요청 우선순위 지정
뉴스레터 자동 요약

예시 2: Slack 메시지 자동 응답 및 알림

Slack에 특정 키워드가 포함된 메시지가 오면 Claude가 분석한 결과를 알림으로 보냅니다.

노드 구성:

Trigger: "Slack" 노드 (메시지 감지)
Condition: "If" 노드 (특정 키워드 필터)
Processing: "HTTP Request" 노드 (Claude 호출)
Output: "Slack" 노드 (응답 메시지 전송)

Claude 호출 설정:

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 300,
  "messages": [
    {
      "role": "user",
      "content": "다음 Slack 메시지에 대해 간단한 답변을 제시하세요: {{$node[\"Slack\"].json.text}}"
    }
  ]
}

실제 Slack 응답 예시:

// Slack 노드의 "Text" 필드
"Claude의 분석 결과: {{$node[\"HTTP Request\"].json.content[0].text}}"

예시 3: 데이터 처리 및 레포팅

CSV 파일이나 데이터베이스의 데이터를 Claude에게 분석하게 하고, 결과를 자동 레포트로 생성합니다.

플로우:

"Google Sheets" 노드: 데이터 읽기
"Code" 노드: 데이터 정제 및 포맷팅
"HTTP Request" 노드: Claude API 호출
"Create Document" 노드: 레포트 생성

Claude 호출 예시 (데이터 분석):

{
  "model": "claude-3-5-sonnet-20241022",
  "max_tokens": 1000,
  "messages": [
    {
      "role": "user",
      "content": "다음 판매 데이터를 분석하고 인사이트를 제시하세요:\n{{$node[\"Google Sheets\"].json.data}}\n\n포맷: 1. 주요 지표 2. 트렌드 분석 3. 개선 제안"
    }
  ]
}

5단계: 주요 설정과 팁

5-1. 모델 선택 기준

Claude에는 여러 모델이 있으며, 각각의 장단점이 있습니다:

claude-3-5-sonnet-20241022: 속도와 성능의 균형 (자동화에 최적)
claude-3-opus-20250219: 가장 강력한 모델 (복잡한 분석용)
claude-3-haiku-20250307: 가장 빠르고 저렴 (간단한 작업용)

자동화 워크플로우에서는 Sonnet이 가성비가 가장 좋습니다.

5-2. 토큰 수 제한 설정

비용 관리를 위해 max_tokens을 적절히 설정하세요.

간단한 분류: 300~500 tokens
중간 분석: 500~1000 tokens
복잡한 작업: 1000~2000 tokens

5-3. Error Handling 설정

n8n에서 API 호출 실패 시 처리 방식을 설정합니다:

HTTP Request 노드 → "Advanced options"
"Continue on fail" 활성화
이후 노드에서 에러 조건 확인

에러 처리 조건식:

{{$node["HTTP Request"].json.error !== undefined}}

5-4. Rate Limiting 고려

Claude API는 분당 요청 제한이 있습니다. 대량의 요청이 필요하면:

"Delay" 노드를 추가해 요청 간 지연 추가
배치 처리로 한 번에 여러 건을 묶어서 처리
n8n의 "Loop" 기능 사용

6단계: 트러블슈팅 및 자주 묻는 질문

Q1: 401 Unauthorized 에러가 나옵니다

원인: API 키가 잘못되었거나 헤더가 올바르지 않습니다.

해결:

API 키가 정확하게 복사됐는지 확인
x-api-key 헤더가 정확한지 재확인
API 키의 유효 기간 확인 (필요시 재발급)

Q2: n8n이 실행되지 않습니다

Docker 사용 시:

docker logs n8n

위 명령으로 로그를 확인해 에러 메시지를 찾으세요.

npm 사용 시: Node.js 버전이 14 이상인지 확인하세요.

node --version

Q3: Claude API 응답이 너무 느립니다

원인: 모델이 너무 크거나 max_tokens이 과다하게 설정됐을 가능성입니다.