n8n 워크플로우, 이제 직접 안 만듭니다 (Claude Code 초보자 가이드)
📺 원본 영상: n8n 워크플로우, 이제 직접 안 만듭니다 (Claude Code 초보자 가이드)
🎙️ 채널: 시민개발자 구씨
📅 정리 일자: 2026-02-07
⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.
개요
n8n으로 업무 자동화를 시도해보고 싶지만 처음부터 워크플로우를 만드는 것이 막막하게 느껴지는 비개발자들이 많다. n8n 클라우드 버전에서 제공하는 워크플로우 빌더도 있지만, 커스터마이징이 제한적이고 사용량 한도가 있어 현실적인 대안이 되기 어렵다. 이 강연은 AI 코딩의 끝판왕이라 할 수 있는 Claude Code를 활용하여 n8n 워크플로우를 자동으로 생성하는 방법을 다룬다. 업무 자동화에 관심은 있지만 기술적 장벽 때문에 망설였던 이들에게 실질적인 해법을 제시한다.
Claude Code와 n8n, 왜 함께 써야 하는가
블랙박스 vs 프랜차이즈 매뉴얼 - 두 도구의 본질적 차이
Claude Code는 강력한 AI 코딩 툴이다. 웹사이트부터 대시보드, 웹 애플리케이션, 자동화 시스템까지 직접 구축할 수 있는 능력을 갖추고 있다. 하지만 비개발자 입장에서 Claude Code가 만들어준 자동화 시스템은 블랙박스처럼 느껴질 수 있다는 문제가 있다. 강연자는 이를 “전문 셰프를 고용하는 것”에 비유했다. 셰프가 맛있는 요리를 만들어주더라도 정확히 무엇을 넣었는지 알 수 없고, 맛이 아쉬운 부분을 어떻게 수정해야 할지 조언하기 어렵다. 또한 셰프의 조리 프로세스를 모르기 때문에 동일한 품질을 재현하기 위한 품질 관리도 힘들다.
반면 n8n은 프랜차이즈 매뉴얼과 같다. 요리를 잘 몰라도 매뉴얼대로만 따라하면 동일한 품질의 결과물을 만들 수 있다. 코딩에 익숙하지 않더라도 업무 프로세스별로 노드를 매핑만 해주면, 단계별로 어떻게 업무가 진행되는지를 시각적으로 쉽게 확인할 수 있다. 이는 업무 자동화 시스템을 만드는 것뿐만 아니라 유지보수를 손쉽게 할 수 있게 해준다. 예를 들어 에러가 발생했을 때 세 번째 노드에서 문제가 생겼다는 것을 바로 확인하고 수정할 수 있다.
혼합 전략의 이점 - 속도와 투명성을 동시에
강연자는 비개발자라면 Claude Code와 n8n 중 하나를 선택하기보다는 둘 다 학습하여 각자의 장점을 발휘할 수 있는 영역에서 활용하기를 권장한다. 이러한 관점에서 Claude Code로 n8n 워크플로우를 만드는 접근법은 매우 효율적이다. Claude Code의 빠른 제작 능력과 n8n의 시각적 워크플로우 관리 및 유지보수 장점을 모두 가져갈 수 있기 때문이다. 나중에 AGI급 AI가 나오면 n8n조차 필요 없게 될 수도 있겠지만, 현재 단계에서는 두 도구를 용도에 맞게 활용하는 것이 최선이다.
Claude Code 설치 및 환경 설정
VS Code와 Node.js - 기본 인프라 구축
Claude Code를 활용하기 위해서는 먼저 개발 환경을 구축해야 한다. 강연자는 VS Code(Visual Studio Code) 설치를 권장했다. VS Code는 코드 파일들을 한눈에 확인할 수 있는 유용한 개발 툴로, code.visualstudio.com에서 다운로드할 수 있다. 맥과 윈도우 각각의 다운로드 버튼이 제공되며, 운영 체제에 맞게 설치하면 된다.
Claude Code는 JavaScript 기반으로 실행되기 때문에 Node.js 설치가 필수다. nodejs.org의 다운로드 섹션에서 운영 체제에 맞는 설치 프로그램을 다운받아 실행하면 된다. 윈도우는 설치 프로그램 파일을, 맥은 터미널 코드를 복사하여 설치한다. 맥 사용자는 VS Code에서 터미널을 활성화한 후(상단 메뉴의 Terminal > New Terminal), 복사한 코드를 붙여넣어 실행한다. 설치 후 node -v 명령으로 버전 번호가 뜨는지 확인하여 정상 설치를 검증할 수 있다.
터미널 vs 익스텐션 - 어떤 방식으로 사용할 것인가
VS Code에서 Claude Code를 활용하는 방법은 두 가지다. 첫 번째는 익스텐션(확장 프로그램)을 설치하는 방법이다. VS Code 왼쪽 메뉴에서 네 번째 아이콘인 Extensions를 클릭하고 “Claude Code for VS Code”를 검색하여 설치하면 된다. 설치 후 계정 인증을 거치면 ChatGPT와 유사한 채팅창이 나타나며, 여기서 프롬프트를 입력하여 작업을 요청할 수 있다.
하지만 강연자는 터미널에서 Claude Code를 활용하는 방법을 더 권장했다. 익스텐션에서는 활용할 수 없는 몇 가지 기능들이 있고, 슬래시(/) 명령을 통해 다양한 설정을 할 때 어차피 터미널로 들어가야 하기 때문이다. 익스텐션은 터미널 작업을 보기 좋게 정리해주는 추가 레이어에 불과하므로, 터미널에 익숙해지면 모든 설정을 한 번에 처리할 수 있어 더 효율적이다.
터미널 버전 설치는 code.anthropic.com의 Quick Start 섹션에서 제공하는 코드를 복사하여 실행하면 된다. 윈도우는 PowerShell에서, 맥은 터미널에서 해당 코드를 붙여넣으면 Claude Code가 설치된다. 설치 후 작업할 프로젝트 폴더를 생성하고(예: “n8n Workflow Builder”), VS Code에서 해당 폴더를 열어야 한다. 터미널에서 claude라고 입력하면 Claude Code가 실행되며, 처음 사용 시 폴더 권한 승인과 Claude 계정 로그인이 필요하다.
로그인과 권한 설정 - 작업 환경 최적화
로그인이 자동으로 뜨지 않으면 /login 명령을 입력하면 된다. Claude Code는 유료 버전(Pro, Max, Team, Enterprise) 계정이 필요하며, 무료 사용자는 Anthropic Console 계정을 연동하여 API 키를 사용하고 사용량만큼 지불하는 방식으로 테스트해볼 수 있다.
작업 모드 설정도 중요하다. 터미널 하단에 표시되는 모드는 Shift+Tab으로 전환할 수 있다. 기본 모드에서는 모든 작업에 권한 요청이 발생하고, “Accept Edits On” 모드에서는 일반적인 파일 읽기나 생성 작업을 자동 승인한다. “Plan Mode”는 작업 실행 전 상세한 계획을 먼저 수립해주는 모드로, 복잡한 작업에 유용하다.
더 빠른 작업을 위해 강연자는 claude --dangerously-skip-permissions 명령으로 “Bypass Permissions On” 모드를 활성화하는 방법을 소개했다. 이 모드에서는 모든 권한을 자동 승인하여 권한 요청 없이 작업을 진행할 수 있다. 빠른 프로토타이핑이나 테스트 환경에서 유용하지만, 중요한 작업에서는 주의가 필요하다.
MCP와 Skills - n8n 전문가 역량 장착
MCP(Model Context Protocol) - 외부 앱과의 소통 프로토콜
Claude Code가 n8n 워크플로우를 제대로 제작하려면 n8n 전문가 역량을 장착해야 한다. 이를 가능하게 하는 것이 MCP(Model Context Protocol)와 Skills다. MCP는 Claude Code가 외부 앱들과 손쉽게 소통할 수 있게 돕는 프로토콜로, 이 케이스에서는 n8n과의 소통을 담당한다. Skills는 특정 작업을 전문가처럼 수행할 수 있도록 도와주는 스킬셋으로, n8n 워크플로우를 어떻게 잘 만들 수 있는지에 대한 정보가 담겨 있다.
이미 GitHub에는 n8n MCP와 n8n Skills가 준비되어 있으며, 각각의 페이지에서 설치 방법이 상세하게 제공된다. 기술에 익숙한 사람은 직접 문서를 보고 설치할 수 있지만, Claude Code를 활용하면 설치 자체도 AI에게 맡길 수 있다. 강연자는 “n8n MCP와 n8n Skills를 이 프로젝트에서 활용할 수 있게 프로젝트 단위로 설치해줘”라는 프롬프트와 함께 GitHub 링크를 제공하여 설치를 요청했다.
MCP 설정 및 API 키 등록
💡 [영상 참조] 강연자는 이 시점에서 화면의 설치 과정과 파일 생성을 보여줍니다. 상세 내용은 원본 영상을 확인하세요.
Claude Code가 MCP 설정 파일을 생성하고 Skills를 설치한 후, 환경 변수에 n8n API URL과 n8n API Key를 추가해야 한다. 이는 보안과 관련된 정보이므로 직접 입력하는 것이 좋다. n8n API URL은 사용 중인 n8n의 URL 앞부분을 입력하면 된다. 클라우드 버전 사용자는 클라우드 URL을, localhost 사용자는 해당 주소를 지정한다.
n8n API Key는 n8n의 Settings > n8n API 메뉴에서 “Create API”를 클릭하고 유효 기간을 설정한 후 생성하면 된다. 생성된 API 키를 복사하여 MCP 설정 파일에 붙여넣으면 MCP 설정이 완료된다. Skills는 .claude/skills 폴더에 자동으로 설치되며, 활용 가능한 스킬들이 모두 포함된다.
설정을 활성화하려면 Claude Code를 재시작해야 한다. /exit로 나간 후 터미널을 클리어하고, 다시 claude --dangerously-skip-permissions 명령으로 실행한다. 위 화살표 키를 누르면 이전에 입력한 명령이 다시 나타나므로 편리하게 재실행할 수 있다. /mcp 명령으로 n8n MCP가 활성화되었는지, /skills 명령으로 n8n Skills가 로드되었는지 확인할 수 있다.
SOP 문서 작성 - 업무 프로세스의 청사진
Standard Operating Procedure - 왜 필요한가
MCP와 Skills를 설치했다고 해서 바로 워크플로우를 제작하는 것은 권장되지 않는다. 그 전에 SOP(Standard Operating Procedure) 파일, 즉 업무 매뉴얼을 작성해야 한다. SOP는 어떤 순서대로 어떤 작업을 해야 하는지를 명확하게 정의한 문서다. 이를 먼저 작성하고 워크플로우 제작을 요청하면 Claude Code에게 의도를 명확하게 전달할 수 있고, 나중에 수정이 필요할 때도 이 문서를 수정하여 요청하면 된다. 또한 다른 워크플로우를 제작할 때 템플릿으로 활용할 수도 있다.
강연자는 Plan Mode를 활용하여 SOP 문서를 생성하는 과정을 시연했다. “SOP.md 파일을 만들어달라”는 요청과 함께 고객 문의 자동응대 시스템 워크플로우의 목적, 트리거, 처리 로직, 로깅, 에러 처리, 사용 서비스 등의 정보를 제공했다. Plan Mode에서는 바로 문서를 생성하는 것이 아니라 먼저 생성 계획을 수립한다. 이 계획을 검토하고 수정 요청을 할 수 있으며, 만족스러우면 “Bypass Permission” 옵션을 눌러 생성을 진행한다.
SOP 문서의 구조와 내용
💡 [영상 참조] 강연자는 이 시점에서 화면의 SOP 문서 내용을 보여줍니다. 상세 내용은 원본 영상을 확인하세요.
생성된 SOP 문서는 목적, 적용 범위, 용어 정의로 시작하여 시스템 구성도, 사용 서비스, 데이터 스키마, 상세 절차, 예외 처리, 운영 가이드, 슬랙 채널 정보까지 포괄적으로 정리되어 있다. VS Code에서 마크다운 파일의 프리뷰를 보려면 우측 상단의 프리뷰 아이콘을 클릭하면 된다.
강연자가 제시한 워크플로우는 다음과 같은 프로세스를 따른다. 구글 폼으로 고객 문의를 받으면 구글 시트에 추가된다. n8n 워크플로우가 시트의 새 행을 감지하면 AI가 문의를 분류한다. 분류 기준은 제품 관련, 배송, 환불, 기타 등의 카테고리와 함께 복잡도 측면에서 단순 문의인지 확인 필요 문의인지를 판단한다. 단순 문의의 경우 AI가 답변을 생성하여 Gmail로 직접 발송하고, 확인 필요 문의는 답변 초안을 생성한 후 Slack으로 알림을 보내 담당자가 검토 후 발송하도록 한다. 모든 처리 로그는 구글 시트에 기록된다.
claude.md 파일 - AI의 작업 가이드라인
Init 명령과 컨텍스트 제공
SOP 문서를 작성했다면, 이제 Claude Code가 이를 참조하여 워크플로우를 제작할 수 있도록 가이드 문서를 만들어야 한다. Claude Code에서는 이 가이드를 claude.md 파일로 관리한다. 이 파일은 수동으로 생성할 수도 있지만, init 명령을 사용하면 Claude Code가 자동으로 작성해준다.
강연자는 “init 이 프로젝트는 n8n workflow를 제작하는 프로젝트이고, 반드시 @SOP.md 파일을 참고해서 제작해달라”는 프롬프트를 입력했다. @ 기호를 입력하면 참조할 수 있는 문서 목록이 나타나며, 엔터를 눌러 선택할 수 있다. 추가로 프로세스에 대한 컨텍스트를 제공하면 Claude Code가 SOP.md 파일을 읽고 이를 바탕으로 claude.md 가이드 문서를 생성한다.
claude.md의 역할과 지속적 개선
💡 [영상 참조] 강연자는 이 시점에서 생성된 claude.md 파일의 내용을 보여줍니다. 상세 내용은 원본 영상을 확인하세요.
생성된 claude.md 파일에는 제작 프로세스, MCP 도구, 사용 규칙, 사용 순서, 제작 시 필요 사항, n8n Skills 활용 방법 등이 정리되어 있다. 이 파일에 @SOP.md를 추가하면 Claude Code가 작업할 때마다 SOP.md 파일도 함께 참조하게 된다. 결과적으로 claude.md와 SOP.md 두 파일을 참조하면서 MCP와 Skills까지 활용하여 더욱 전문가다운 워크플로우를 제작할 수 있게 된다.
claude.md 파일은 일회성 문서가 아니다. 워크플로우를 여러 번 제작하다 보면 Claude Code가 제대로 작동하지 않는 부분이 발견될 수 있다. 이때 해당 부분을 스크린샷으로 캡처하여 수정 요청을 하고, “이 내용을 claude.md에 반영해달라”고 요청하면 가이드 문서가 지속적으로 업그레이드된다. 자주 만드는 템플릿 패턴이 있다면 그런 템플릿 문서도 추가하여 항상 참고하도록 설정할 수 있다. 이렇게 내 맞춤형 빌더로 고도화시킬 수 있다는 점이 Claude Code의 강력한 장점이다.
워크플로우 생성 및 수정
Context 관리와 생성 요청
본격적인 워크플로우 제작 전 Context 사용량을 확인하는 것이 좋다. /context 명령을 입력하면 현재 사용 중인 컨텍스트 비율이 표시된다. 강연자의 경우 45%를 사용 중이었는데, n8n 워크플로우 제작 시 다양한 Skills와 MCP를 활용하면 컨텍스트가 빠르게 차오를 수 있다. 기본 설정을 완료했다면 이전 작업 내역은 삭제하는 것이 좋다. /clear 명령으로 컨텍스트를 리셋하면 사용량이 크게 줄어든다(강연자의 경우 22%로 감소).
이제 “SOP.md에 정의된 고객 문의 자동응대 시스템 워크플로우를 n8n에 생성해줘. 각 단계별로 n8n Skills를 적극적으로 활용해줘. 생성된 워크플로우 링크를 제공해줘”라는 프롬프트를 입력하면 Claude Code가 작업을 시작한다. 먼저 MCP를 통해 사용할 노드 정보를 확인하고, Skills를 로드한 후, 워크플로우를 생성한다. 생성이 완료되면 어떤 구조를 가지고 있고 어떤 노드를 활용했는지 설명하며, 워크플로우 ID와 접속 링크를 제공한다. JSON 파일 형태로도 별도 저장되어 언제든 다운로드하거나 수정하여 import할 수 있다.
워크플로우 검증 및 수정 요청
생성된 워크플로우를 n8n에서 확인해보면, 대부분의 설정이 잘 되어 있지만 몇 가지 수정이 필요한 부분이 발견될 수 있다. 강연자의 경우 Google Sheets 트리거에서 Sheet ID를 직접 입력하는 대신 리스트에서 선택해야 하는 부분이 있었고, 확인 필요 문의의 경우 Gmail 초안 생성 노드가 누락되어 있었다. 이런 경우 해당 부분을 스크린샷으로 캡처한 후, Claude Code에 이미지를 붙여넣고(Ctrl+V 또는 Command+V) 수정 요청을 하면 된다.
“이 부분에 Gmail 초안 생성 노드가 누락되었어. Slack 알림 전에 Gmail Draft 노드를 추가해줘”라는 요청을 하면 Claude Code가 스크린샷을 분석하고 누락된 부분을 파악하여 워크플로우를 수정한다. 수정이 완료되면 다시 워크플로우 링크를 제공하며, 이번에는 올바른 URL이 포함된다. n8n에서 확인해보면 Gmail Draft 생성 노드가 추가되고, AI 노드의 설정에서 실패 시 3번 재시도하는 옵션도 자동으로 설정되어 있는 것을 볼 수 있다.
버전 관리 및 고도화 전략
JSON 파일 기반 버전 관리
워크플로우를 여러 번 수정하다 보면 버전 관리가 필요해진다. 가장 간단한 방법은 워크플로우 제작 시 JSON 파일로 저장하고 버전 번호를 포함하도록 요청하는 것이다. “워크플로우를 JSON으로 저장할 때 버전 번호를 포함해줘”라고 요청하면 workflow_v1.json, workflow_v2.json처럼 개별 파일로 생성된다. 이렇게 하면 나중에 이전 버전으로 롤백하거나 변경 사항을 비교할 때 유용하다.
좀 더 전문적인 방법은 GitHub와 연동하여 Git 기반 버전 관리를 하는 것이다. GitHub을 학습하여 커밋과 브랜치를 활용하면 더욱 체계적인 버전 관리가 가능하지만, 초보자에게는 단순히 버전별 파일을 생성하는 방식도 충분히 실용적이다.
지속적 개선 - claude.md 업데이트
Claude Code가 완벽하지 않다는 것을 인정하고, 발견되는 문제점들을 체계적으로 개선해나가는 것이 중요하다. 예를 들어 AI 노드 설정에서 특정 옵션을 제대로 적용하지 못하는 경우, 해당 부분을 스크린샷으로 캡처하여 “이 설정이 잘못되었어. 다음부터는 이렇게 설정해줘”라고 요청한 후, “이 내용을 claude.md에 반영해줘”라고 추가 요청하면 된다. 이렇게 하면 다음 워크플로우 제작 시 동일한 실수를 반복하지 않는다.
자주 사용하는 패턴이나 템플릿이 있다면 별도의 템플릿 문서를 만들어 claude.md에서 참조하도록 설정할 수도 있다. “특정 타입의 워크플로우를 만들 때는 항상 이 템플릿을 참고해서 기본 세팅 값으로 활용해라”는 식의 규칙을 추가하면, 시간이 지날수록 나만의 최적화된 워크플로우 빌더가 완성된다.
마무리 - 효율적인 도구 선택 전략
n8n과 Claude Code의 적재적소 활용
이제 정말 n8n 워크플로우를 처음부터 한 땀 한 땀 만들 필요는 없어졌다. Claude Code를 레버리지하여 기본 골격은 빠르게 만들고, 직접 수정하거나 수정 작업마저도 Claude Code를 활용하면 이전보다 훨씬 수월하게 원하는 업무 자동화 시스템을 구축할 수 있다. 물론 Claude Code 같은 툴이 AGI급으로 발전하면 n8n조차 필요 없게 될 수도 있다. 블랙박스라도 코드가 완벽하게 작성된다면 프롬프트로만 제작하는 것이 더 편할 수 있기 때문이다.
하지만 현재는 그 정도 단계가 아니므로 두 도구를 용도에 맞게 활용하는 것이 현명하다. 비개발자 입장에서 100% 이해하고 안정적으로 운영하고 싶은 자동화 시스템은 n8n으로 구축하는 것이 좋다. 반면 n8n으로 제작하기 어려운 복잡한 자동화 시스템이나 시각화된 대시보드, 웹사이트, 웹 애플리케이션 등을 제작해야 할 때는 Claude Code를 활용하는 것이 효율적이다.
핵심 프로세스 요약
강연에서 제시한 전체 프로세스를 정리하면 다음과 같다. 먼저 Claude Code가 n8n을 잘 활용할 수 있도록 MCP와 Skills를 연동한다. 그다음 업무 프로세스를 정리한 SOP 문서를 생성하고, 이 SOP 문서를 참고하여 Claude가 잘 작동할 수 있도록 claude.md 문서를 만든다. 이 상태에서 워크플로우 제작을 요청하면 Claude Code가 MCP와 Skills를 활용하여 초안을 생성한다.
한 번에 완벽한 워크플로우가 나오기는 어렵기 때문에, n8n에 직접 들어가서 오류를 확인하고 직접 수정하거나 스크린샷을 첨부하여 Claude Code에 수정을 요청한다. 작업을 잘 못한 부분이 있다면 다음번에는 어떻게 해야 제대로 만들 수 있을지 고민하고, 그 내용을 claude.md 문서에 추가하여 지속적으로 고도화한다. 이러한 사이클을 반복하면 점점 더 정교하고 강력한 맞춤형 워크플로우 빌더를 갖게 된다.
📚 출처 및 참고
| 구분 | 내용 |
|---|---|
| 원본 영상 | n8n 워크플로우, 이제 직접 안 만듭니다 (Claude Code 초보자 가이드) |
| 채널 | 시민개발자 구씨 |
| 리포트 작성 | 2026-02-07 |
| 작성 방식 | YouTube 영상 STT 변환 후 에디팅 |
💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.