Claude Code 설치 가이드
— 명령어·윈도우 권한·Node 경로 함정까지
요즘 Claude Code는 명령어 한 줄로 설치돼요(Node.js도 필요 없어요). 진짜 막히는 건 설치 자체가 아니라 — 윈도우 권한, 그리고 항상 말썽인 Node.js 경로 문제예요. 아래 명령어를 그대로 복사해 쓰고, 막히는 두 곳만 미리 알아두면 돼요.
그래서 뭐가 좋아지나 — '어디서 여느냐'가 절반
설치만큼 중요한 게 '여는 위치'예요. 로그 데이터를 분석한다고 할 때, 같은 도구도 어디서 여느냐로 갈려요.
바탕화면이나 홈 폴더에서 그냥 claude를 켜면, 정작 내 로그 파일은 다른 폴더에 있어요. "그 파일 어디 있어?"부터 헤매고, 매번 경로를 길게 불러줘야 해요.
로그 파일이 든 폴더로 먼저 이동(cd)한 뒤 claude를 켜면, 그 폴더가 곧 작업 공간이 돼요. "이 폴더 로그 정리해줘" 한마디로 통해요.
가장 쉬운 길 — 네이티브 설치 (Node.js 불필요)
예전엔 Node.js부터 깔아야 했지만, 지금은 설치 스크립트 한 줄이면 끝나요. Node.js도, 별도 준비물도 필요 없어요. 본인 OS에 맞는 걸 복사해서 붙여넣으세요.
맥(macOS)
Cmd + Space → "터미널" 입력 → Enter로 터미널을 연 뒤, 아래를 붙여넣고 Enter:
curl -fsSL https://claude.ai/install.sh | bash윈도우 — PowerShell
시작 메뉴에서 "PowerShell" 검색 → 열고, 아래를 붙여넣고 Enter:
irm https://claude.ai/install.ps1 | iex혹시 명령 프롬프트(CMD)를 쓴다면 이걸로:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd출처: Claude Code 공식 설치 문서 — code.claude.com/docs/en/setup (2026년 6월 확인)
네이티브 설치는 보통 일반 권한으로 돼요. 그런데 회사 PC처럼 보안이 빡빡한 환경에선 설치가 조용히 막히는 경우가 있어요. 그럴 땐 PowerShell을 '관리자 권한으로 실행'(아이콘 우클릭 → "관리자 권한으로 실행")한 뒤 같은 명령어를 다시 돌리세요. 특히 뒤에 나오는 npm 방식은 관리자 권한이 필요할 때가 많아요.
설치 확인 — 두 줄이면 끝
설치가 됐는지 확인하고, 문제가 있으면 진단까지 받을 수 있어요.
# 버전이 찍히면 설치 성공
claude --version
# 경로·권한 등 문제를 자동 진단
claude doctorclaude doctor는 설치·경로·권한에 문제가 없는지 스스로 점검해줘요. 뭔가 이상하면 가장 먼저 돌려볼 명령어예요.
작업 폴더에서 열기 — 가장 중요한 습관
설치가 끝났으면, 이제 작업할 폴더로 이동한 뒤 켜요. 이 습관 하나가 첫 장면의 차이를 만들어요.
# 작업할 폴더로 이동 (예시 경로)
cd ~/work/my-project
# 그 폴더를 작업 공간 삼아 실행
claude처음 켜면 브라우저로 로그인 창이 떠요(Claude 구독 계정으로 로그인). 로그인하면 터미널로 돌아오고, 바로 첫 명령을 시킬 수 있어요.
터미널이 불편하면 — VS Code로 (강력 추천)
여기까지 터미널에서 cd로 폴더를 옮겼는데, 솔직히 폴더 열고 닫고 파일 보는 건 VS Code가 훨씬 편해요. 마이크로소프트가 만든 무료 편집기인데, 여기에 Claude Code를 붙이면 파일을 마우스로 클릭하고, 뭐가 바뀌었는지 색으로 보면서 일할 수 있어요. 비개발자라면 터미널만 쓰기보다 이 방식을 더 권해요.
1. VS Code 설치
공식 사이트 code.visualstudio.com에 접속해 내 OS 버튼을 눌러요. 맥은 받은 파일을 열어 'Visual Studio Code'를 응용 프로그램 폴더로 드래그하고, 윈도우는 설치 파일을 그냥 실행하면 끝이에요.
2. Claude Code 확장 붙이기
- VS Code 왼쪽의 네모 4개 아이콘(확장)을 눌러요. 단축키는 맥
Cmd+Shift+X/ 윈도우Ctrl+Shift+X. - 검색창에 Claude Code를 입력해요.
- Anthropic이 만든 "Claude Code"를 찾아 Install(설치)을 눌러요.
- 왼쪽에 별 모양 아이콘이 생기면 끝이에요. 그 아이콘을 눌러 처음 한 번만 로그인하면 돼요.
출처: VS Code 다운로드 — code.visualstudio.com · 확장 설치 — code.claude.com/docs
3. 폴더 열고 바로 쓰기
메뉴에서 File > Open Folder(맥 Cmd+O)로 작업 폴더를 열면, 왼쪽에 그 폴더의 파일들이 트리로 쭉 펼쳐져요. 별 아이콘을 누르거나 VS Code 안의 터미널(맥 Cmd+`)에서 claude를 켜면 — 터미널에서 cd 하던 것과 똑같이 작동하는데, 파일은 마우스로 클릭하면 되니 훨씬 편해요.
· 파일을 마우스로 클릭해서 열어요 — cd·ls 같은 명령을 안 쳐도 돼요.
· AI가 고친 부분이 색으로 보여요 — 지운 곳은 빨강, 더한 곳은 초록이라 뭐가 바뀌었는지 한눈에.
· 여러 폴더·파일 사이를 클릭 한 번으로 오가요.
npm으로 설치한다면 — Node.js 경로 함정 주의
이미 개발 환경이 있거나 회사 규정상 npm으로 깔아야 한다면 이 방법도 있어요. 단, 여기서 항상 사람을 잡는 게 Node.js 경로 문제예요.
npm install -g @anthropic-ai/claude-code출처: 공식 설치 문서 — code.claude.com/docs/en/setup
Node.js를 nvm(버전 관리 도구)으로 설치하면, Claude Code의 자동화 기능(훅 등)이 node를 못 찾는 일이 생겨요. nvm으로 깐 Node는 '대화형 터미널'에서만 보이고, 자동 실행되는 비대화형 환경에선 경로에 안 잡히거든요. 증상은 "분명 깔았는데 자동화가 작동을 안 함"이에요.
해결: Node.js를 공식 인스톨러(.pkg)나 Homebrew로 깔아서 표준 위치(예: /usr/local/bin)에 두세요. 그러면 어디서든 경로에 잡혀요. 이미 nvm으로 깔았다면, 공식 인스톨러로 다시 까는 게 제일 빨라요.
참고로 권한 에러(EACCES, "Permission denied")가 뜨면 sudo로 강제하지 마세요(나중에 더 꼬여요). 대신 npm 설치 폴더를 내 홈으로 바꿔주면 돼요. 이 설정조차 막막하면, 에러 메시지를 그대로 복사해 Claude Code(또는 설치되기 전이라면 챗봇)에 붙여넣고 "이 에러 해결법 알려줘"라고 물어보면 단계별로 짚어줘요.
안 될 때 — 흔한 막힘 3가지
- "command not found: claude" — 설치는 됐는데 경로에 아직 안 잡힌 경우예요. 터미널을 완전히 껐다 새로 열면 대부분 풀려요. 그래도 안 되면
claude doctor로 진단. - 윈도우에서 설치가 조용히 멈춤 — 권한 문제일 때가 많아요. PowerShell을 관리자 권한으로 실행해 다시 시도.
- "깔았는데 자동화가 작동 안 함" — 위의 Node 경로 함정(nvm)일 확률이 커요. 공식 인스톨러로 Node를 다시 깔면 해결돼요.
설치 문제 해결 공식 문서: code.claude.com/docs/en/troubleshoot-install
설치 글을 많이 봤다면 "공식 안내를 따르세요" 같은 말에 질렸을 거예요. 그게 막막한 이유는, 정작 사람이 막히는 지점(윈도우 권한, Node 경로)을 건너뛰기 때문이에요. 이 두 곳만 미리 알면 설치는 정말 5분이에요.
그리고 설치보다 백 배 중요한 건 '작업 폴더에서 여는 습관'이에요. 이거 하나가 안 잡히면 아무리 잘 깔아도 매번 헤매거든요. 다음 편에서는 그 폴더 안에 둘 가장 중요한 파일, CLAUDE.md를 만들어요.
자주 묻는 것
Claude Code 설치에 Node.js를 꼭 설치해야 하나요?
install.sh, 윈도우 install.ps1)는 Node.js 없이 한 줄로 돼요. Node.js는 npm 방식으로 깔 때만 필요하고, 그땐 경로 함정을 조심하면 됩니다.윈도우는 꼭 관리자 권한으로 실행해야 하나요?
'command not found: claude'가 떠요.
claude doctor로 원인을 진단할 수 있어요.