본문으로 건너뛰기

Windows에서 n8n 설치부터 Claude 연동까지 직접 해본 과정

바로바로

2026.10.08

최근 업무 자동화를 공부하면서 Claude와 n8n을 연결하는 실습을 진행했습니다.

개념만 보면 단순해 보였습니다.

n8n을 설치하고 → Claude API를 연결하고 → 자동화 워크플로를 만든다.

그런데 실제 Windows PC에서 처음 설치해보니 npm, PowerShell, API, Docker, Sandbox 같은 용어가 한꺼번에 등장하면서 생각보다 헷갈리는 부분이 많았습니다.

이번 글에서는 제가 실제로 설치하면서 겪었던 오류와 해결 과정을 순서대로 정리해봅니다.


1. 먼저 Node.js가 설치되어 있는지 확인

PowerShell을 열고 다음 명령을 실행했습니다.

node -v

결과는 다음과 같았습니다.

v22.22.3

Node.js는 이미 정상적으로 설치되어 있었습니다.

그래서 바로 n8n 설치를 진행했습니다.

npm install n8n -g

그런데 여기서 첫 번째 문제가 발생했습니다.


2. PowerShell에서 npm 실행이 막혔다

다음과 같은 오류가 나왔습니다.

이 시스템에서 스크립트를 실행할 수 없으므로
npm.ps1 파일을 로드할 수 없습니다.

PSSecurityException
UnauthorizedAccess

처음에는 Node.js나 npm 설치가 잘못된 줄 알았습니다.

하지만 원인은 n8n이 아니라 Windows PowerShell의 스크립트 실행 정책이었습니다.

PowerShell에서는 npm을 실행할 때 npm.ps1을 호출하는데, 현재 보안 설정에서 PowerShell 스크립트 실행을 막고 있었던 것입니다.

실행 정책 자체를 변경하는 방법도 있지만, 굳이 보안 설정을 건드리지 않고 다음과 같이 실행했습니다.

npm.cmd install n8n -g

핵심은 npm 대신 **npm.cmd**를 사용하는 것이었습니다.


3. n8n 설치에는 생각보다 시간이 걸렸다

설치를 시작하니 화면에 다음과 같은 메시지가 계속 나타났습니다.

npm warn deprecated ...

처음에는 오류인 줄 알았지만 warn은 오류가 아니라 경고였습니다.

n8n이 여러 개의 Node 패키지를 사용하고 있고, 그중 일부 패키지에 오래된 버전이 있다는 안내였습니다.

설치는 약 15분 정도 걸렸습니다.

최종적으로 다음 메시지가 나왔습니다.

added 2193 packages in 15m

설치가 끝난 뒤 버전을 확인했습니다.

n8n.cmd --version

결과:

2.35.7

여기까지 오면 n8n 설치 자체는 성공한 것입니다.


4. n8n 실행

이제 다음 명령으로 n8n을 실행했습니다.

n8n.cmd

잠시 기다리자 다음 메시지가 나타났습니다.

Editor is now accessible via:
http://localhost:5678

브라우저에서 다음 주소를 열었습니다.

http://localhost:5678

드디어 n8n 화면이 나타났습니다.

여기서 중요한 점이 하나 있습니다.

PowerShell에서 실행한 n8n.cmd가 바로 n8n 서버입니다.

따라서 n8n을 사용하는 동안에는 이 PowerShell 창을 닫으면 안 됩니다.

창을 닫거나 Ctrl + C를 누르면 로컬 n8n 서버도 종료됩니다.


5. n8n 관리자 계정 만들기

처음 접속하면 Set up owner account 화면이 나옵니다.

여기서 이메일, 이름, 비밀번호를 입력해 n8n의 관리자 계정을 만들었습니다.

이 계정은 Claude 계정과는 관계가 없습니다.

제가 PC에 설치한 로컬 n8n에 로그인하기 위한 관리자 계정입니다.


6. Claude를 연결하려니 API가 필요했다

n8n의 AI Assistant 설정으로 들어가니 다음과 같은 화면이 나타났습니다.

Connect a model
Provider: Anthropic
API key:
Model: Claude Opus

여기서 한 가지를 처음 알게 됐습니다.

제가 Claude Pro를 사용하고 있어도 Claude Pro 구독과 Claude API는 별도였습니다.

즉,

Claude 웹/앱 구독
≠
Anthropic API 사용

입니다.

n8n에서 Claude를 사용하려면 Anthropic Console에서 API Key를 별도로 만들어야 했습니다.


7. Anthropic API Key 만들기

Claude Platform의 API Key 메뉴에 들어가 새 키를 만들었습니다.

키 이름은 구분하기 쉽게 예를 들어 다음처럼 정할 수 있습니다.

n8n-local

키를 만들면 다음과 같이 시작하는 긴 문자열이 생성됩니다.

sk-ant-...

이 키는 비밀번호와 같기 때문에 공개하면 안 됩니다.

생성한 키를 복사해서 n8n의 API key 입력란에 붙여넣었습니다.

이후 n8n 화면에는 다음처럼 Claude 모델이 표시되었습니다.

anthropic/claude-opus-5

여기까지 오면 n8n이 사용할 Claude 모델 설정은 된 상태입니다.


8. 그런데 갑자기 Sandbox와 Docker가 등장했다

Claude 연결이 끝난 줄 알았는데 다음 단계에서 이런 화면이 나타났습니다.

Add a code sandbox

선택지는 다음과 같았습니다.

n8n Sandbox
Daytona

여기서 가장 많이 헷갈렸습니다.

n8n Sandbox를 선택하니 Service URL, API key 등을 다시 요구했습니다.

처음에는 Service URL에 Anthropic을 넣고 Claude API Key도 다시 입력했습니다.

하지만 이것은 잘못된 설정이었습니다.

Claude API 설정과 Sandbox 설정은 서로 완전히 다른 것이었습니다.


9. npm과 Docker의 차이를 여기서 이해했다

설치 과정에서 npm과 Docker가 계속 나오니 처음에는 둘 다 n8n을 설치하는 프로그램인 줄 알았습니다.

실제로는 역할이 다릅니다.

제가 이해한 방식으로 가장 간단하게 정리하면 다음과 같습니다.

npm은 프로그램을 내 컴퓨터에 직접 설치하는 도구입니다.

npm → n8n 프로그램 설치

Docker는 프로그램을 격리된 별도의 실행환경 안에서 돌리는 도구입니다.

Docker → 프로그램마다 독립된 실행 공간을 만들어 실행

그래서 제가 사용한

npm.cmd install n8n -g

명령은 Windows PC에 n8n 본체를 설치한 것입니다.

반면 n8n의 AI Assistant Code Sandbox는 생성한 코드를 안전하게 실행하기 위한 별도의 환경이라 Docker를 요구했습니다.

즉,

n8n 설치
→ npm으로 가능

Claude API 연결
→ Anthropic API Key 필요

AI Assistant Code Sandbox
→ Docker 등이 추가로 필요할 수 있음

이라는 구조였습니다.

이 구분을 이해하고 나니 전체 구조가 훨씬 명확해졌습니다.


10. Docker가 없다는 것도 확인

PowerShell에서 다음 명령을 실행했습니다.

docker compose version

결과는 다음과 같았습니다.

'docker' 용어가 cmdlet, 함수, 스크립트 파일 또는
실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

즉, 현재 PC에는 Docker가 설치되어 있지 않았습니다.

하지만 이번 수업에서 필요한 핵심은 n8n 본체 설치와 Claude 연동이었기 때문에 Docker 설치는 일단 보류했습니다.


11. 최종적으로 확인된 상태

현재까지 확인된 상태는 다음과 같습니다.

Node.js
   ↓
npm
   ↓
n8n 설치
   ↓
n8n 로컬 서버 실행
   ↓
http://localhost:5678
   ↓
Anthropic API Key 연결
   ↓
Claude 모델 설정

n8n 실행 화면에서도 다음 내용을 확인했습니다.

Editor is now accessible via:
http://localhost:5678

그리고 AI Assistant 설정에서는:

Model
anthropic/claude-opus-5

가 표시되었습니다.

따라서 n8n 자체 설치와 Anthropic Claude 모델 연결 설정까지는 정상적으로 진행된 상태라고 볼 수 있습니다.

Code Sandbox와 Web Search는 별도 추가 기능이기 때문에 아직 설정하지 않았습니다.


설치하면서 가장 헷갈렸던 세 가지

이번 설치를 직접 해보니 초보자 입장에서 가장 헷갈리는 부분은 세 가지였습니다.

첫째, npm 오류와 n8n 오류를 구분해야 한다는 점입니다.

처음 npm install n8n -g가 실패했지만 n8n 자체의 문제가 아니었습니다. PowerShell이 npm.ps1 실행을 막은 것이었고 npm.cmd를 사용해서 해결했습니다.

둘째, Claude Pro와 Claude API는 별개라는 점입니다.

Claude를 이미 유료로 사용하고 있어도 n8n에서 Claude를 호출하려면 Anthropic API Key가 따로 필요했습니다.

셋째, n8n 설치와 Sandbox 설치는 다른 문제라는 점입니다.

n8n 본체는 npm으로 설치할 수 있습니다. Docker가 등장한 것은 n8n 자체를 실행하기 위해서가 아니라 AI Assistant의 Code Sandbox 기능을 구성하는 과정이었습니다.


이번 과정에서 얻은 가장 큰 이해

설치 전에는 n8n, npm, API, Docker라는 단어가 모두 비슷하게 느껴졌습니다.

지금은 다음처럼 구분됩니다.

Node.js
= n8n이 실행될 기반

npm
= n8n을 설치하는 도구

n8n
= 자동화를 만드는 프로그램

Anthropic API
= n8n이 Claude를 호출하는 통로

Claude
= 판단·요약·분류·문장 생성 등을 담당하는 AI

Docker
= 프로그램을 독립된 환경에서 실행하는 방식

Sandbox
= AI가 만든 코드를 안전하게 실행하는 별도 공간

이 구조를 이해하니 앞으로 자동화를 만들 때도 어떤 부분에서 문제가 생겼는지 구분하기가 훨씬 쉬울 것 같습니다.

궁극적으로 제가 원하는 것은 단순히 n8n을 설치하는 것이 아닙니다.

발주나 업무 데이터를 받아 Claude가 내용을 해석하고, n8n이 이후 작업을 자동으로 연결하는 구조를 만드는 것입니다.

예를 들면 앞으로는 다음과 같은 자동화도 생각해볼 수 있습니다.

발주 접수
 ↓
Claude가 품종·평량·규격·수량 분석
 ↓
n8n이 데이터 저장
 ↓
작업계획서 생성
 ↓
현장 전달
 ↓
납기·출하 정보 관리

이번 설치는 그 자동화를 만들기 위한 첫 번째 단계였습니다.

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기