n8n과 Claude Code로 자동화를 처음 설정하는 방법

자동화를 한번 붙여보고 싶은데 어디서 시작해야 할지 막막한 적 없나요? 저도 그랬어요. 그래서 이 글에 n8n Claude 자동화 초보 설정을 처음부터 따라 할 수 있게 정리했어요. 거창한 SaaS 없이, 맥미니 한 대와 무료 도구로 시작한 기록이에요.

자랑하려는 글이 아니라 직접 부딪힌 메모예요. 똑같이 혼자 만드시는 분이 시행착오를 조금이라도 줄이셨으면 해서요.

왜 클라우드 대신 셀프호스팅이었나

처음엔 클라우드 자동화 서비스를 봤어요. 그런데 실행 횟수 제한과 월 구독이 부담이었어요. 결국 n8n을 직접 띄우기로 했어요.

• n8n을 Docker로 맥미니에 올리고, 데이터는 PostgreSQL에 저장
• 외부에서 들어오는 웹훅은 ngrok 터널로 연결
• 실행 횟수 제한 없이, 비용은 사실상 0

처음 입문이라면 클라우드로 가볍게 시작해도 괜찮아요. 다만 매일 돌릴 작업이 늘어날 것 같으면 셀프호스팅이 마음 편하더라고요.

0단계: 무엇을 준비하나

설치 전에 준비물부터요. 세 가지면 충분했어요.

• Docker: n8n과 PostgreSQL을 컨테이너로 띄우는 그릇이에요.
• ngrok: 내 컴퓨터를 외부 웹훅과 연결해주는 터널이에요.
• Claude Code: 워크플로우를 손으로 클릭하지 않고 설계·배포하는 도구예요.

설치와 연결: Docker + PostgreSQL + ngrok

먼저 Docker로 n8n과 PostgreSQL을 같이 올려요. 데이터베이스를 PostgreSQL로 잡는 이유는 단순해요. 오래 돌릴수록 가벼운 SQLite보다 안정적이었거든요.

n8n이 뜨면 브라우저로 접속해서 첫 계정을 만들어요. 그다음 ngrok 터널을 붙여요. 정적 도메인을 하나 받아두면 컴퓨터를 재시작해도 주소가 그대로라 편했어요. 웹훅 주소가 바뀌면 연결한 서비스를 매번 고쳐야 하는데, 그 번거로움이 없어지더라고요.

마지막으로 n8n 설정에서 API 키를 발급받아요. 이 키가 있어야 다음 단계에서 워크플로우를 코드처럼 올릴 수 있어요.

Claude Code로 워크플로우를 코드처럼 배포하기

여기가 이 방식의 핵심이에요. 보통은 n8n 화면에서 노드를 하나씩 끌어다 연결하죠. 저는 그 대신 Claude Code에게 워크플로우를 JSON으로 설계하게 하고, n8n API로 한 번에 올렸어요.

흐름은 이래요.

1. Claude Code로 워크플로우 구조를 설계 (어떤 노드가 어떤 순서로 도는지)
2. n8n Public API로 배포 (PUT 요청으로 워크플로우 등록·수정)
3. 배포한 워크플로우를 Codex에게 다시 검토시켜 교차 검증

손으로 만들 때보다 수정과 재배포가 빨라졌어요. 같은 워크플로우를 조금씩 고쳐가며 실험하기에도 좋았고요.

직접 깨진 부분들 (이게 제일 도움될 거예요)

문서엔 잘 안 나오는, 처음에 제가 당한 것들이에요. 입문자라면 미리 알면 시간을 아낄 수 있어요.

• API로 워크플로우를 수정하면 cron 등록이 풀려요. 분명 활성 상태인데 정해진 시간에 안 돌더라고요. 배포 후 컨테이너를 재시작한 다음, 로그에서 "Activated workflow"가 찍히는지 확인하는 걸 절차로 고정했어요.
• 노드를 병렬로 모으면(fan-in) 실행이 안 돼요. "hasn't been executed" 에러가 났어요. 여러 갈래를 한 노드로 합치는 대신, 순차 체인으로 설계를 바꿨더니 풀렸어요.
• AI 호출에서 토큰 상한을 추론과 같이 걸면 빈 응답이 와요. 모델이 생각하는 데 토큰을 다 써버려서 정작 결과가 비어 있었어요. 해당 파라미터를 빼니 정상으로 돌아왔어요.
• 품질 검사를 너무 빡세게 잡으면 매일 다른 항목에서 막혀요. 모든 규칙을 치명 오류로 묶었더니 두더지잡기처럼 매일 다른 곳이 터졌어요. 게시를 멈출 규칙과 경고만 할 규칙을 나눴어요.

처음에 지키면 좋은 원칙

마지막으로, 자동화라고 다 맡기진 않았어요. 입문 단계일수록 이 세 가지가 도움이 됐어요.

• 실제로 무언가를 올리거나 보내는 건 사람이 승인한 뒤에만
• 수치나 사실은 지어내지 않고 검증된 것만
• 손으로 충분히 해본 작업만 자동화 (이해 못 한 걸 자동화하면 고장 났을 때 손도 못 대요)

작은 도구라도 매일 쓰이면 의미가 생기더라고요. 처음엔 워크플로우 하나로 시작해보세요. 익숙해지면 그다음은 훨씬 수월해요.