NHN × CLAUDE CODE · 사전 준비

수업 전 설치 가이드
Node.js와 Claude Code, 20분이면 끝납니다

설치할 것은 두 개뿐입니다. 두레이 연결 도구는 수업 당일 받는 실습 폴더에 들어 있어 따로 설치하지 않습니다. 각 단계는 Mac | Windows를 나란히 보여 줍니다 - 내 컴퓨터 쪽만 따라 하고, 마지막 확인 3줄의 결과를 제출해 주세요. 명령은 전부 복사 버튼으로 붙여넣으면 됩니다.

Node.js 다운로드 (공식) Claude Code 설치 문서 (공식) 터미널이 처음이라면

터미널 열기

모든 명령은 여기에 붙여넣습니다

Mac 터미널

Cmd + Space → "터미널" 입력 → Enter. 검은(또는 흰) 창이 뜨면 준비 끝.

Windows PowerShell 권장 · CMD도 가능

시작 버튼 → "PowerShell" 입력 → Windows PowerShell 클릭. (관리자 권한 불필요)

지금 열린 창이 무엇인지는 프롬프트 앞글자로 구분합니다.
PowerShell PS C:\Users\이름> - 앞에 PS가 있음
CMD C:\Users\이름> - PS가 없음
아래 명령 옆에 PowerShell / CMD 표시가 있으면 그 창에서만 동작합니다. 공통은 어느 창이든 됩니다.

Node.js 설치

실습 폴더의 두레이 연결 스크립트가 Node로 실행됩니다 · 5분

1다운로드 → 설치 (LTS 버전, 설치 화면은 계속 "다음")

Mac

macOS 설치 파일 받기 (.pkg · v24 LTS)

Apple Silicon(M1~M4)과 Intel 모두 이 파일 하나로 설치됩니다. 받은 파일 더블클릭 → "계속" → 설치 (Mac 비밀번호 1회).
링크가 안 열리면 공식 다운로드 페이지 또는 v24.20.0 파일 목록에서 macOS Installer (.pkg).

Windows

Windows 설치 파일 받기 (.msi · 64-bit · v24 LTS)

거의 모든 Windows PC는 64-bit(x64)입니다. 받은 파일 더블클릭 → "Next" 계속 → 설치. 중간의 "Tools for Native Modules" 체크는 필요 없습니다.
ARM 노트북(Surface Pro X 등)만 ARM64용 .msi. 링크가 안 열리면 공식 다운로드 페이지 또는 v24.20.0 파일 목록에서 Windows Installer (.msi).

2터미널을 새로 열고 확인

Mac

node -v

Windows 공통

PowerShell · CMD 공통

node -v

v24.x.x 처럼 버전이 나오면 성공. (이미 v22 이상이 깔려 있으면 그대로 써도 됩니다)

"command not found" / "인식되지 않습니다" → 설치 후 터미널을 닫았다가 다시 열지 않은 것이 대부분입니다. 새 창에서 다시 실행.

Claude Code 설치

공식 설치 명령 한 줄 · 3분 · 공식 문서

1아래 한 줄을 터미널에 붙여넣고 Enter

Mac 터미널

curl -fsSL https://claude.ai/install.sh | bash

중간에 비밀번호를 묻지 않습니다. 1~2분 뒤 "installed" 문구가 나오면 완료.

Windows 창에 맞는 것 하나만

PowerShell (프롬프트가 PS C:\로 시작)

irm https://claude.ai/install.ps1 | iex

CMD (프롬프트가 C:\로 시작)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

"irm은 인식되지 않습니다" → 지금 창은 CMD. / "&&는 유효한 문 구분 기호가 아닙니다" → 지금 창은 PowerShell. 다른 쪽 명령을 쓰세요.

2터미널을 새로 열고 확인

Mac

claude --version

Windows 공통

PowerShell · CMD 공통

claude --version

2.x.x (Claude Code) 처럼 버전이 나오면 성공.

대안 (사내망에서 위 명령이 막힐 때) - 1단계에서 Node를 설치했으니 npm으로도 설치됩니다. Mac 터미널 · Windows PowerShell · CMD 모두 같은 명령입니다.

npm install -g @anthropic-ai/claude-code

Mac에서 권한 오류(EACCES)가 나면 sudo를 붙이지 말고 손 들어 주세요. EBADENGINE 경고는 무시해도 됩니다.

로그인

Claude 계정 연결 · 2분

1실행 - Mac 터미널 · Windows PowerShell · CMD 공통

claude

브라우저가 열리면 안내받은 계정으로 로그인 → "Authorize" → 터미널로 돌아옵니다. 첫 실행 시 테마·폴더 신뢰 질문은 Enter로 넘기면 됩니다.

2한 줄 대화 → 나가기

입력창에 안녕, 한 줄로 인사해줘 → 답이 오면 성공. /exit 로 종료.

무료(Free) 계정으로는 Claude Code를 쓸 수 없습니다. 로그인 후 "plan" 관련 오류가 나면 안내받은 계정이 맞는지 확인하고 손 들어 주세요.

✓

확인 3줄 - 결과 제출

아래 3개를 체크하고 "결과 복사"를 눌러 안내받은 곳에 붙여넣어 주세요

node -v 가 버전을 표시한다예: v24.20.0

claude --version 이 버전을 표시한다예: 2.1.211 (Claude Code)

claude 로그인 후 한 줄 대화가 된다답이 오면 성공, /exit 로 종료

막힌 단계가 있어도 괜찮습니다. 체크 못 한 항목 그대로 제출하면 수업 시작 전 보조강사가 도와드립니다.

안 될 때

대부분 1~2번에서 끝납니다 · 공식 문제 해결 문서

#	OS	증상	조치
1	공통	설치 후 `node -v` / `claude --version` 이 "찾을 수 없음"	터미널 창을 닫고 새로 연다. 설치 전에 열어둔 창은 새 명령을 모릅니다
2	Win	"irm은 인식되지 않습니다"	지금 창은 CMD. CMD용 명령을 쓰거나 PowerShell을 연다
3	Win	"&&는 유효한 문 구분 기호가 아닙니다"	지금 창은 PowerShell. PowerShell용 명령(`irm …`)을 쓴다
4	Mac	"개발자를 확인할 수 없음" 경고	시스템 설정 → 개인정보 보호 및 보안 → 아래쪽 그래도 열기
5	공통	`curl` / `irm` 이 403 또는 연결 실패	사내 프록시가 막는 경우. 2단계의 npm 대안으로 설치. 그래도 안 되면 IT에 `claude.ai`, `downloads.claude.ai`, `registry.npmjs.org` 허용 요청
6	공통	로그인 브라우저가 안 열린다	터미널에 표시된 URL을 복사해 브라우저에 직접 붙여넣기 → 로그인 후 코드가 나오면 터미널에 붙여넣기
7	공통	npm 설치 시 EACCES / 권한 오류	`sudo`를 붙이지 말고 손 들기. 공식 설치 명령(2단계 ①)으로 다시 시도하는 것이 가장 빠름