LeanX

왜 Claude Code로 n8n을 만들까? — 셰프와 프랜차이즈 매뉴얼

Claude Code는 자동화를 순식간에 만들어 주지만 비개발자에게는 내부가 안 보이는 블랙박스이고 n8n은 모든 단계가 눈에 보여 고치기 쉬우므로, Claude Code로 뼈대를 빠르게 생성한 뒤 n8n의 시각적 유지보수성을 그대로 누리는 '두 도구 결합'이 비개발자에게 가장 좋은 전략입니다.

여러분은 이미 앞 강의들에서 n8n 캔버스에 노드를 하나씩 손으로 이어 붙여 워크플로우를 만들어 봤습니다. 정직하고 확실한 방법이지만, 노드 30개짜리 자동화를 처음부터 끝까지 마우스로 조립하려면 꽤 지칩니다. 그래서 이번 섹션에서는 'AI 코딩 에이전트'인 Claude Code에게 그 조립을 대신 시키는 법을 배웁니다.

그런데 여기서 한 가지 오해를 먼저 풀어야 합니다. '그럼 Claude Code 하나면 n8n은 필요 없는 것 아닌가?' 아닙니다. 두 도구는 경쟁 관계가 아니라 짝꿍입니다. 왜 그런지, 아주 익숙한 비유로 설명하겠습니다.

개인 셰프 vs 프랜차이즈 매뉴얼

Claude Code에게 '고객 문의 자동화 만들어줘'라고 하면, 몇 분 만에 완성된 워크플로우가 뚝딱 나옵니다. 마치 실력 좋은 개인 셰프가 근사한 요리를 내주는 것과 같죠. 그런데 비개발자 입장에서 문제는, 그 셰프가 '레시피'를 알려 주지 않는다는 점입니다. 맛은 훌륭한데 어떻게 만들었는지, 어디를 바꾸면 되는지, 왜 짜졌는지를 알 수가 없습니다.

블랙박스(셰프) vs 보이는 단계(프랜차이즈)

개인 셰프 = Claude Code 단독

  • 주문을 넣으면 완성된 요리가 뚝딱 나옴 (맛있지만 레시피를 모름)
  • 내부가 블랙박스 — 무엇을 어떻게 바꿀지 알 수 없음
  • 어디서 틀어졌는지 확인할 방법이 없음

결과는 훌륭하나 통제하기 어려움

프랜차이즈 매뉴얼 = n8n 워크플로우

  • 반죽 → 굽기 → 소스 → 포장까지 단계 하나하나가 보임
  • 누구나 같은 품질로 재현 가능
  • 고장 나면 어느 단계(어느 노드가 빨간불)인지 즉시 확인

보이는 매뉴얼이라 재현·수정이 쉬움

셰프의 결과물은 훌륭하지만 통제하기 어렵고, 매뉴얼은 단계가 보여 누구나 재현하고 고칠 수 있습니다. n8n은 그 '보이는 매뉴얼'입니다.

반대로 n8n은 프랜차이즈 매장의 조리 매뉴얼과 같습니다. 신입 아르바이트생도 매뉴얼의 단계를 그대로 따라 하면 본점과 똑같은 품질을 냅니다. 그리고 결정적으로, 어느 단계에서 문제가 생기면 그 단계만 펼쳐 보면 됩니다. n8n에서는 실패한 노드에 빨간불이 켜지므로 '어디서 무엇이 잘못됐는지'가 눈에 보입니다.

그래서 결론은 '둘 다 쓴다'

정답은 하나를 버리는 게 아니라 장점만 합치는 것입니다. 요리를 빠르게 내는 셰프의 속도(Claude Code)와, 누구나 유지보수할 수 있는 매뉴얼의 투명함(n8n)을 동시에 가져가는 것이죠.

  • Claude Code로 워크플로우 '뼈대'를 몇 분 만에 생성한다 → 손으로 노드 30개 놓는 노가다를 건너뜀.
  • 그 결과물은 여전히 n8n 캔버스 위의 '보이는 워크플로우'다 → 나중에 클릭 몇 번으로 직접 수정 가능.
  • 고장 나면 n8n에서 실패 노드를 눈으로 찾고, 필요하면 다시 Claude Code에게 고쳐 달라고 한다.
  • 즉, 만들기는 AI에게 위임하고 소유·유지보수는 내가 한다 → 비개발자에게 가장 안전한 조합.
관점Claude Code 단독손으로 n8n둘을 결합
만드는 속도매우 빠름느림(수작업)매우 빠름
결과의 투명성낮음(블랙박스)높음높음
수정·유지보수어렵게 느껴짐쉬움쉬움
비개발자 적합성△○◎ (추천)

AI에게 n8n을 맡기는 전체 파이프라인

Claude Code를 'n8n 전문가'로 만들려면 지식을 층층이 쌓아 줘야 합니다. 이번 섹션 전체가 아래 그림 한 장으로 요약됩니다. 지금 다 이해할 필요는 없고, 각 층이 무엇인지 이름만 눈에 익혀 두세요. 다음 강의부터 아래에서 위로 하나씩 채워 나갑니다.

전체 지식 파이프라인 — 최종 빌드는 위에서 아래로 읽힌다

  • 당신의 요청 "이 자동화 만들어줘"
  • CLAUDE.md (지휘 지침서) "@SOP.md 따르고 MCP+스킬 써라"
  • SOP.md (업무 명세서) 트리거 → 처리 → 분기 → 로깅 → 에러
  • n8n-MCP + n8n 스킬 연결·직접쓰기 손발 + 잘 짓는 노하우
  • n8n 캔버스에 워크플로우 생성 눈으로 보고 직접 고칠 수 있음

CLAUDE.md가 SOP.md를 가리키고, SOP가 MCP와 스킬을 부려서 최종적으로 n8n 캔버스에 워크플로우가 그려집니다. 이 네 조각을 다음 강의들에서 하나씩 붙입니다.

이 섹션에서 만들 결과물 미리보기

말로만 하면 감이 안 오니, 우리가 4강에서 실제로 생성할 '고객 문의 자동화'의 축약판을 미리 보여 드립니다. 이런 워크플로우를 노드 하나 손으로 안 놓고 Claude Code가 그려 줄 것입니다.

미리보기 — Claude Code가 그려 줄 고객 문의 자동화(축약)

접수 → 분류 → 응대

  • 구글 폼 제출 Form Trigger
  • 새 행 구글 시트 기록
  • 문의 내용 Gemini 분류 카테고리+난이도 Chat Model 🧠 Gemini
  • 분류 결과 자동 회신 / 사람 검토

지금은 '이런 게 나오는구나' 정도만 느끼면 충분합니다. 이 그림은 4강에서 SOP만 잘 써 주면 AI가 통째로 만들어 냅니다.

정리하면, Claude Code는 속도, n8n은 투명함을 담당하고 우리는 둘을 합칩니다. 다음 강의에서는 파이프라인의 첫 벽돌, 즉 Claude Code가 내 n8n에 손을 뻗을 수 있게 해 주는 'n8n-MCP' 연결부터 만들어 보겠습니다.