AI가 업무 자동화 시스템을 만들어준다? n8n과 Claude Code 조합의 실전 활용법

왜 업무 자동화가 어렵게 느껴질까?

매일 반복되는 업무를 자동화하고 싶은 마음은 굴뚝같지만, 막상 시작하려면 벽에 부딪히곤 합니다. "어디서부터 시작해야 하지?", "코딩을 몰라도 가능할까?", "만들어놓고 나중에 수정할 수 있을까?" 같은 의문들이 발목을 잡습니다.

실제로 업무 자동화의 가장 큰 걸림돌은 기술적 진입장벽입니다. 프로그래밍 언어를 배우기에는 시간이 부족하고, 그렇다고 외주를 맡기자니 비용도 만만치 않습니다. 더 큰 문제는 한번 만들어놓은 자동화 시스템이 "블랙박스"처럼 느껴져서, 나중에 뭔가 잘못되었을 때 어디를 고쳐야 할지 막막하다는 점입니다.

최근 AI 코딩 도구들이 등장하면서 상황이 달라지고 있습니다. 하지만 AI가 만들어준 코드를 그대로 쓰는 것도 문제가 있습니다. 작동 원리를 이해하지 못하면 유지보수가 불가능하고, 작은 수정 하나에도 다시 AI에게 의존해야 하죠.

두 가지 도구의 장점만 합치면?

이 문제를 해결하는 똑똑한 방법이 있습니다. AI 코딩 도구의 빠른 제작 능력과 시각적 워크플로우 도구의 명확한 관리 능력을 결합하는 것입니다.

n8n이란? (워크플로우 자동화 플랫폼)

n8n은 마치 레고 블록을 조립하듯 업무 프로세스를 만들 수 있는 도구입니다. 각각의 작업(이메일 보내기, 데이터 저장하기, 메시지 전송하기 등)을 "노드(Node)"라는 블록으로 표현하고, 이것들을 연결해서 자동화 흐름을 만듭니다.

왜 n8n을 쓰면 좋을까?

• 시각적 구조: 업무 흐름이 눈에 보여서 이해하기 쉽습니다
• 유지보수 용이: 에러가 발생하면 어느 단계에서 문제가 생겼는지 바로 확인 가능합니다
• 재사용 가능: 한번 만든 워크플로우를 복사해서 다른 프로젝트에 활용할 수 있습니다

예를 들어 "고객 문의 메일이 오면 → 내용을 분석하고 → 적절한 담당자에게 알림 보내기" 같은 프로세스를 세 개의 노드로 표현할 수 있습니다.

Claude Code란? (AI 기반 코딩 어시스턴트)

Claude Code는 Anthropic이 개발한 AI 코딩 도구로, 자연어로 요청하면 실제 작동하는 코드를 생성해주는 도구입니다. Visual Studio Code(개발자들이 사용하는 코드 편집기)에서 확장 프로그램 형태로 작동합니다.

Claude Code의 강점

• 빠른 프로토타입: 복잡한 시스템도 몇 분 안에 초안을 만들 수 있습니다
• 다양한 기술 지원: 웹사이트, 데이터 처리, API 연동 등 폭넓은 작업이 가능합니다
• 대화형 개선: 결과물을 보고 수정 요청을 반복하며 완성도를 높일 수 있습니다

두 도구를 함께 쓰면 생기는 시너지

비유하자면 이렇습니다:

• Claude Code만 쓰기: 전문 셰프에게 요리를 맡기는 것. 맛있지만 레시피를 모르면 다음에 똑같이 만들기 어렵습니다.
• n8n만 쓰기: 요리 매뉴얼을 보고 직접 만드는 것. 시간은 걸리지만 과정을 완전히 이해할 수 있습니다.
• 두 도구 결합: 셰프가 매뉴얼을 만들어주는 것. 빠르게 완성하면서도 나중에 내가 직접 수정할 수 있습니다.

실전 준비: 필요한 도구 설치하기

1단계: Visual Studio Code 설치

VS Code는 코드 파일을 편집하고 관리하는 무료 도구입니다. 마이크로소프트에서 제공하며, 개발자가 아니어도 쉽게 사용할 수 있습니다.

설치 방법

• code.visualstudio.com 접속
• 운영체제에 맞는 다운로드 버튼 클릭 (Windows/Mac 자동 인식)
• 다운로드된 파일 실행 후 기본 설정으로 설치

2단계: Node.js 설치

Node.js는 JavaScript를 컴퓨터에서 실행할 수 있게 해주는 환경입니다. Claude Code가 작동하려면 필수적입니다.

설치 방법

• nodejs.org 접속
• "Download" 섹션에서 LTS(Long Term Support) 버전 선택
• 설치 후 VS Code의 터미널(상단 메뉴 → Terminal → New Terminal)에서 node -v 입력
• 버전 번호가 표시되면 설치 성공

터미널이 뭔가요?
터미널은 컴퓨터에게 텍스트로 명령을 내리는 창입니다. 마우스 클릭 대신 글자를 입력해서 작업하는 방식이라고 생각하면 됩니다. 처음엔 낯설지만, 몇 가지 명령어만 익히면 훨씬 빠르게 작업할 수 있습니다.

3단계: Claude Code 설치 (두 가지 방법)

방법 1: VS Code 확장 프로그램으로 설치 (초보자 추천)

• VS Code 왼쪽 사이드바에서 네 번째 아이콘(Extensions) 클릭
• 검색창에 "Claude Code" 입력
• "Claude Code for VS Code" 선택 후 Install
• Anthropic 계정으로 로그인 (Pro 이상 유료 플랜 필요)

방법 2: 터미널에서 직접 설치 (고급 기능 사용 가능)

• claude.ai/code 접속
• Quickstart 섹션에서 운영체제별 설치 명령어 복사
• VS Code 터미널에 붙여넣기 후 실행
• claude 명령어로 실행 가능

터미널 버전의 장점

• 권한 설정을 세밀하게 조정 가능
• 대량 작업 시 더 빠른 실행
• 고급 옵션(플랜 모드, 권한 바이패스 등) 활용 가능

Claude Code를 n8n 전문가로 만들기

Claude Code는 범용 AI 코딩 도구이기 때문에, n8n 워크플로우 제작에 특화되어 있지 않습니다. 마치 만능 요리사에게 "한식 전문가가 되어줘"라고 요청하는 것과 같습니다. 이를 위해 두 가지 도구를 추가로 설정해야 합니다.

MCP (Model Context Protocol)란?

MCP는 AI가 외부 애플리케이션과 소통할 수 있게 해주는 표준 연결 규약입니다. 쉽게 말해, Claude Code가 n8n과 "대화"할 수 있게 해주는 통역사 역할을 합니다.

실제 작동 방식

• Claude Code: "n8n에 새 워크플로우를 만들어줘"
• MCP: n8n API를 호출해서 실제로 워크플로우 생성
• 결과를 다시 Claude Code에게 전달

Skills란?

Skills는 특정 작업을 전문가처럼 수행할 수 있게 해주는 지식 패키지입니다. n8n Skills에는 "워크플로우를 어떻게 구성해야 효율적인가", "각 노드는 어떤 설정이 필요한가" 같은 실무 노하우가 담겨 있습니다.

설치 방법 (Claude Code에게 시키기)

복잡한 설치 과정도 Claude Code에게 맡길 수 있습니다. 다음과 같이 요청하면 됩니다:

프롬프트 예시

n8n MCP와 n8n Skills를 이 프로젝트에서 활용할 수 있게 프로젝트 단위로 설치해줘.

참고 링크:
- n8n MCP: [GitHub 링크]
- n8n Skills: [GitHub 링크]

설치 후 추가 설정

• .env 파일에 n8n 연결 정보 입력:

- N8N_API_URL: n8n 인스턴스 주소 (예: https://your-instance.n8n.cloud)
- N8N_API_KEY: n8n 설정에서 생성한 API 키

• n8n에서 API 키 생성하기:

- n8n 로그인 → Settings → n8n API
- "Create API Key" 클릭
- 유효 기간 설정 후 저장
- 생성된 키를 복사해서 .env 파일에 붙여넣기

• Claude Code 재시작:

- 터미널에서 exit 입력
- claude --skip-permissions 명령어로 재실행

권한 설정 옵션

• 기본 모드: 모든 작업마다 승인 요청
• --skip-permissions: 모든 권한 자동 승인 (빠른 작업에 유용)
• 주의: 중요한 파일 작업 시에는 기본 모드 권장

워크플로우 제작 전 핵심 단계: SOP 문서 작성

바로 "워크플로우 만들어줘"라고 요청할 수도 있지만, 그러면 AI가 임의로 판단한 방식으로 만들어집니다. SOP(Standard Operating Procedure) 문서를 먼저 작성하면 훨씬 정확한 결과를 얻을 수 있습니다.

SOP 문서가 왜 필요한가?

음식 배달 앱을 생각해보세요. "치킨 주문"이라는 간단한 요청 뒤에는 실제로 이런 과정이 숨어 있습니다:

• 주문 접수 → 2. 결제 처리 → 3. 가게 전달 → 4. 조리 시작 → 5. 배달 기사 배정 → 6. 픽업 → 7. 배달 → 8. 완료 알림

각 단계마다 "결제 실패하면?", "가게가 주문을 거부하면?" 같은 예외 상황 처리가 필요합니다. SOP 문서는 이런 모든 시나리오를 미리 정의하는 설계도입니다.

SOP 문서 구조 (실전 예시)

고객 문의 자동 응대 시스템 사례

# 고객 문의 자동 응대 워크플로우 SOP

## 1. 목적

고객 문의를 자동으로 분류하고, 단순 문의는 즉시 답변하며, 복잡한 문의는 담당자에게 전달

## 2. 트리거 (시작점)

- Google Forms로 문의 접수 시
- 접수 내용이 Google Sheets에 자동 추가됨

## 3. 처리 로직

### 3-1. 문의 분류 (AI 활용)
- 카테고리: 제품 문의 / 배송 문의 / 환불 요청 / 기타
- 복잡도: 단순 문의 / 확인 필요

### 3-2. 단순 문의 처리
- AI가 답변 초안 생성
- 자동으로 고객 이메일 발송
- Google Sheets에 "자동 응답 완료" 기록

### 3-3. 확인 필요 문의 처리
- AI가 답변 초안 생성
- Slack으로 담당자에게 알림 (초안 포함)
- 담당자 확인 후 수동 발송
- Google Sheets에 "담당자 확인 중" 기록

## 4. 에러 처리

- AI 분류 실패 시: 자동으로 "확인 필요" 카테고리로 분류
- 이메일 발송 실패 시: Slack으로 에러 알림 + 재시도 3회

## 5. 로깅

- 모든 처리 내역을 Google Sheets "로그" 탭에 기록
- 기록 항목: 접수 시간, 분류 결과, 응답 시간, 처리 담당자

Claude Code로 SOP 문서 생성하기

직접 작성하기 부담스럽다면 Claude Code에게 초안을 만들어달라고 요청할 수 있습니다.

프롬프트 예시

SOP.md 파일을 만들어줘. 고객 문의 자동 응대 시스템 워크플로우를 위한 업무 프로세스 문서야.

포함할 내용:
- 목적: 고객 문의 자동 분류 및 응답
- 트리거: Google Forms 제출 시
- 처리 로직: AI 분류 → 단순 문의는 자동 응답, 복잡한 문의는 Slack 알림
- 로깅: Google Sheets에 모든 처리 내역 기록
- 에러 처리: 실패 시 재시도 및 담당자 알림
- 사용 서비스: Google Forms, Google Sheets, Gmail, Slack, Gemini API

플랜 모드 활용하기

바로 생성하지 말고, 먼저 "어떻게 만들 건지" 계획을 세워달라고 할 수 있습니다.

• Shift + Tab을 눌러 "Plan Mode"로 전환
• 위 프롬프트 입력
• Claude가 제작 계획을 먼저 보여줌
• 계획을 검토하고 수정 요청 가능
• 최종 승인 후 생성

이렇게 하면 결과물의 품질이 크게 향상됩니다.

프로젝트 가이드 문서 설정하기

Claude Code는 프로젝트 폴더 안에 claude.md 파일이 있으면, 작업할 때마다 이 파일을 참고합니다. 이는 마치 프로젝트 헌법과 같습니다.

claude.md 파일의 역할

• 일관성 유지: 여러 번 작업해도 같은 스타일과 규칙 적용
• 자동 참조: 매번 긴 설명을 반복하지 않아도 됨
• 팀 협업: 다른 사람이 프로젝트를 이어받아도 맥락 파악 가능

생성 방법

프롬프트 예시

@claude 이 프로젝트는 n8n 워크플로우를 제작하는 프로젝트야.
반드시 @SOP.md 파일을 참고해서 제작해줘.

추가 컨텍스트:
- n8n MCP를 사용해서 워크플로우를 직접 생성할 것
- n8n Skills의 베스트 프랙티스를 따를 것
- 모든 노드에 명확한 이름과 설명 추가
- 에러 핸들링 노드를 반드시 포함

골뱅이(@) 기호의 의미

@ 뒤에 파일명을 쓰면, Claude가 해당 파일의 내용을 자동으로 읽어서 참고합니다. 긴 내용을 복사-붙여넣기 하지 않아도 되는 편리한 기능입니다.

생성된 claude.md 파일 안에 @SOP.md를 추가하면, 앞으로 모든 작업에서 SOP 문서를 자동으로 참조하게 됩니다.

실전: 워크플로우 제작 요청하기

이제 모든 준비가 끝났습니다. 실제로 워크플로우를 만들어달라고 요청해봅시다.

효과적인 요청 방법

나쁜 예

고객 문의 시스템 만들어줘

→ 너무 추상적이어서 AI가 임의로 판단해야 함

좋은 예

@SOP.md 파일의 사양대로 n8n 워크플로우를 제작해줘.

추가 요구사항:
1. Google Forms 트리거는 "새 응답 시" 이벤트 사용
2. Gemini API는 gemini-1.5-pro 모델 사용
3. Slack 알림은 #customer-support 채널로 전송
4. 이메일 제목 형식: "[자동응답] {문의 카테고리} 관련 답변"

워크플로우 JSON 파일을 생성하고, n8n에 직접 import할 수 있게 해줘.

→ 구체적인 설정값까지 명시

작업 모니터링하기

Claude Code가 작업하는 동안 터미널에서 진행 상황을 실시간으로 볼 수 있습니다:

• 파일 읽기: SOP.md 파일 분석 중...
• MCP 호출: n8n API로 워크플로우 구조 생성 중...
• Skills 적용: 베스트 프랙티스에 따라 노드 설정 중...
• 파일 생성: customer_inquiry_workflow.json 생성 완료

각 단계마다 승인을 요청받을 수 있습니다. --skip-permissions 옵션을 사용했다면 자동으로 진행됩니다.

결과물 확인하기

생성된 워크플로우 JSON 파일을 n8n에 import하는 방법:

• n8n 대시보드 접속
• 상단 메뉴에서 "Import from File" 선택
• 생성된 JSON 파일 업로드
• 각 노드의 인증 정보(API 키 등) 입력
• "Activate" 버튼으로 워크플로우 활성화

디버깅과 수정: 실전 시나리오

완벽한 워크플로우는 한 번에 만들어지지 않습니다. 테스트하면서 개선하는 과정이 필요합니다.

시나리오 1: 이메일이 발송되지 않음

문제 확인

• n8n에서 워크플로우 실행 이력 확인
• Gmail 노드에서 에러 발생 확인

Claude Code에게 수정 요청

워크플로우에서 Gmail 노드가 "Authentication failed" 에러를 발생시켜.
Gmail API 인증 방식을 OAuth2로 변경하고, 재시도 로직을 추가해줘.

시나리오 2: AI 분류 정확도가 낮음

개선 방법

SOP.md 파일을 수정해서 분류 기준을 더 명확히 합니다:

## 문의 분류 기준 (상세)

### 제품 문의
- 키워드: 사용법, 기능, 스펙, 호환성
- 예시: "이 제품은 iPhone과 호환되나요?"

### 배송 문의
- 키워드: 배송, 도착, 언제, 추적
- 예시: "주문한 상품이 언제 도착하나요?"

### 환불 요청
- 키워드: 환불, 반품, 취소, 돌려받고
- 예시: "구매를 취소하고 싶습니다"

그 다음 Claude Code에게:

@SOP.md 파일의 업데이트된 분류 기준을 반영해서 
Gemini API 프롬프트를 개선해줘.

시나리오 3: 처리 속도가 느림

병렬 처리 요청

현재 워크플로우는 순차적으로 실행돼서 느려.
다음 부분들을 병렬로 처리하도록 수정해줘:
- AI 분류와 로그 기록을 동시에 진행
- 이메일 발송과 Slack 알림을 동시에 진행

n8n에서는 "Split in Batches" 노드나 여러 브랜치를 사용해서 병렬 처리가 가능합니다.

컨텍스트 관리: 토큰 한도 주의하기

Claude Code는 한 번에 처리할 수 있는 정보량(컨텍스트 윈도우)이 제한되어 있습니다. 복잡한 워크플로우를 만들다 보면 이 한도에 도달할 수 있습니다.

컨텍스트 사용량 확인하기

터미널에서 /context 명령어를 입력하면 현재 사용량을 볼 수 있습니다:

Context Usage: 45%
- Messages: 30%
- Files: 10%
- Skills: 5%

70% 이상 사용 시 주의사항

• AI 응답 품질이 저하될 수 있음
• 중요한 정보를 놓칠 가능성 증가
• 새로운 대화를 시작하는 것이 좋음

컨텍스트 절약 전략

• 대화 초기화: /exit 후 새로 시작
• 파일 참조 최소화: 꼭 필요한 파일만 @ 로 참조
• 단계별 작업: 큰 워크플로우를 여러 개로 분할해서 제작

고급 활용: 템플릿화하기

한 번 만든 워크플로우를 다른 프로젝트에도 쉽게 적용할 수 있습니다.

재사용 가능한 SOP 템플릿 만들기

범용 고객 문의 시스템 템플릿

# 고객 문의 자동 응대 워크플로우 (템플릿)

## 커스터마이징 포인트

- [FORM_URL]: 문의 접수 폼 주소
- [SHEET_ID]: 데이터 저장 시트 ID
- [AI_MODEL]: 사용할 AI 모델명
- [SLACK_CHANNEL]: 알림 받을 Slack 채널
- [EMAIL_FROM]: 발신 이메일 주소

## 처리 로직

(나머지는 동일)

새 프로젝트에서는 커스터마이징 포인트만 수정하고 Claude Code에게 요청하면 됩니다.

워크플로우 라이브러리 구축하기

프로젝트 폴더 구조:

/n8n-workflows/
  /templates/
    - customer_inquiry_template.json
    - data_sync_template.json
    - report_automation_template.json
  /active/
    - project_a_workflow.json
    - project_b_workflow.json
  /docs/
    - SOP_template.md
    - best_practices.md

이렇게 정리해두면 새 프로젝트 시작 시 템플릿을 복사해서 빠르게 시작할 수 있습니다.

실무 팁: 이것만은 꼭 기억하세요

1. 작은 단위로 테스트하기

전체 워크플로우를 한 번에 만들지 말고, 각 부분을 단계별로 테스트하세요.

추천 순서

• 트리거만 먼저 테스트 (데이터가 제대로 들어오는가?)
• 첫 번째 처리 로직 추가 (AI 분류가 정확한가?)
• 조건 분기 테스트 (올바른 경로로 진행되는가?)
• 최종 액션 추가 (이메일/알림이 제대로 가는가?)

2. 에러 핸들링은 필수

모든 중요한 노드 뒤에 에러 처리 로직을 추가하세요.

기본 패턴

• 주요 노드 → Error Trigger 노드 연결
• 에러 발생 시 → Slack 알림 + 로그 기록
• 가능하면 재시도 로직 추가 (최대 3회)

3. 로그는 상세하게

나중에 문제를 추적하려면 상세한 로그가 필수입니다.

기록할 정보

• 실행 시작 시간
• 각 단계별 처리 시간
• 입력 데이터 샘플
• 처리 결과 (성공/실패)
• 에러 메시지 (실패 시)

4. 문서화를 게을리하지 마세요

6개월 후에 다시 봤을 때도 이해할 수 있도록 문서를 남기세요.

필수 문서

• SOP.md: 업무 프로세스 정의
• README.md: 워크플로우 개요 및 설정 방법
• CHANGELOG.md: 수정 이력

핵심 정리

✅ Claude Code와 n8n을 함께 쓰면: AI의 빠른 제작 능력 + 시각적 워크플로우의 명확한 관리를 동시에 얻을 수 있습니다

✅ SOP 문서가 핵심: 워크플로우를 만들기 전에 업무 프로세스를 명확히 정의하면 정확도가 크게 향상됩니다

✅ MCP와 Skills 설정 필수: Claude Code가 n8n 전문가처럼 작동하려면 이 두 가지를 반드시 설치해야 합니다

✅ 단계별 테스트와 개선: 완벽한 워크플로우는 한 번에 나오지 않습니다. 작은 단위로 만들고 테스트하며 개선하세요

✅ 템플릿화로 재사용: 한 번 잘 만든 워크플로우는 템플릿으로 저장해서 다른 프로젝트에 활용하세요

이제 여러분도 코딩 지식 없이 강력한 업무 자동화 시스템을 구축할 수 있습니다. 작은 프로젝트부터 시작해서 점진적으로 확장해나가세요!