1. Intro
이 가이드는 Claude-Code를 로컬 환경에서 실행하기 위한 설정 방법을 다룹니다. Node.js 22 설치부터 Claude-Code 간단한 사용 방법까지의 과정을 안내합니다.
1.1 Claude-Code?
Claude-Code는 Anthropic의 대규모 언어 모델인 Claude를 활용하여 코드 생성, 디버깅, 코드 리뷰 등 다양한 개발 작업을 지원하는 도구입니다. 개발자들이 더 효율적으로 코드를 작성하고 관리할 수 있도록 돕는 것을 목표로 합니다. 특정 프로그래밍 언어에 국한되지 않고 다양한 언어의 코드를 이해하고 처리할 수 있어 범용성이 높습니다.
활용 용도
•
코드 생성: 특정 요구사항에 맞는 코드 스니펫 또는 전체 함수를 자동으로 생성합니다. 
•
코드 디버깅: 코드에서 오류를 찾아내고 수정 제안을 제공합니다.
•
코드 리뷰: 코드의 가독성, 효율성, 잠재적인 문제점을 분석하고 개선 방안을 제시합니다.
•
문서화: 코드에 대한 설명을 자동으로 생성하거나 기존 문서를 보완합니다.
•
리팩토링: 코드의 구조를 개선하고 중복을 제거하는 데 도움을 줍니다.
1.2 Create account
Claude-Code를 실행하기 위해서는 회사 계정으로 Organization 요청을 받아 이용하거나 Claude에 직접 결제수단을 등록(5$ 선결제 됨)하는 과정을 거친 후 이용이 가능합니다.
2. Claude-Code settings
Claude-Code를 실행하려면 Node.js 18 버전 이상이 필요합니다. 이미 설치되어 있다면 이 단계를 건너뛰셔도 됩니다.
2.1. nvm
•
Terminal 혹은 iTerm을 실행합니다.
•
Terminal에 아래의 command를 입력하여 nvm을 설치합니다.
◦
nvm의 경우 최신 버전으로 설치하는 것을 권장드립니다.
◦
아래의 버전은 v0.39.7 설치 명령어 입니다.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Shell
복사
•
(Optional) 설정 파일 확인을 위해 아래의 내용을 따라해볼 수 있습니다.
nano나 vi 같은 텍스트 편집기로 해당 파일을 열어 NVM 관련 내용이 추가되었는지 확인할 수 있습니다.
# zsh 사용자의 경우:
nano ~/.zshrc
# bash 사용자의 경우:
nano ~/.bashrc
Shell
복사
파일 맨 아래에 다음과 유사한 내용이 추가되어 있을 것입니다.
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
Shell
복사
•
설치된 nvm을 터미널에 반영하기 위해 터미널을 재시작하거나 아래의 명령어를 실행합니다.
# zsh 사용자의 경우:
source ~/.zshrc
# bash 사용자의 경우:
source ~/.bashrc
Shell
복사
2.2. Node.js 22 LTS
LTS(Long Term Support) 버전 다운로드: 일반적으로 안정적인 LTS 버전을 권장합니다. 현재(2025년 7월 기준) Node.js 22 LTS 버전을 다운로드하여 설치합니다. 운영체제에 맞는 설치 파일을 선택하세요 (Windows Installer, macOS Installer, Linux binaries 등)
방법 1. 공식 웹 사이트 접속하여 설치하기
1.
2.
설치 진행: 다운로드한 설치 파일을 실행하고, 설치 마법사의 지시에 따라 설치를 완료합니다. 특별한 설정이 필요하지 않다면 기본 설정을 그대로 사용해도 좋습니다.
3.
설치 확인: 터미널(명령 프롬프트 또는 PowerShell)을 열고 다음 명령어를 입력하여 Node.js와 npm(Node Package Manager)이 제대로 설치되었는지 확인합니다.
방법 2. Terminal 명령어 입력
만약 위의 nvm 설치 과정을 마쳤다면, nvm으로 node.js 22 버전을 설치할 수 있습니다.
# node.js 22 버전 설치
nvm install 22
# node.js 22 버전 사용
nvm use 22
Shell
복사
설치가 완료됐는지 확인하려면 아래의 명령어 둘 중 하나로 확인이 가능합니다.
node -v
npm -v
Shell
복사
3. Claude-Code
3.1. Claude-Code installation
node.js 설치 과정을 모두 마쳤다는 가정하에 아래의 과정을 실행해주어야 합니다.
# Claude Code 어떤 경로에서도 실행 되도록 Global 설치
npm install -g @anthropic-ai/claude-code
Shell
복사
3.2. Claude-Code authorization
Claude 실행
먼저 Claude를 실행합니다. 실행을 위해 터미널에서 원하는 위치(경로)에서 claude 를 입력합니다. 입력 후 아래와 같이 실행한 내용이 나타납니다.
Claude 인증
위의 화면에서 화면 테마를 선택해주고, 아래와 같은 화면이 나오게 됩니다. 여기서 2. Anthropic Console account를 선택해줍니다.
2번을 선택하면 아래와 같이 인증요청에 대한 화면이 웹 페이지에 연동됩니다.
Authorize 버튼을 누르면 정상 연동된 것이며, 콘솔에서 Login successful. Press Enter to continue… 를 확인할 수 있습니다.
이외의 설정의 경우 추천하는 방법을 따라하면 됩니다.
3.3. Claude Code simple usage
Claude Code 내에 내장된 명령어는 아래와 같습니다. 적절한 명령어를 이용하여 원하는 작업을 할 수 있습니다.
파일/경로 선택하여 명령해보기
•
요청 예시
claude-code를 실행한 경로에서 HTMX라는 디렉토리가 있습니다. 이 디렉토리 내에 있는 파일의 구조를 tree 구조로 설명해달라는 명령을 하기 위해 @HTMX 라고 파일 혹은 경로를 지정해주고, 뒤에 명령을 입력합니다.
@HTMX 의 경로에 대해 tree 구조로 설명해줘.
Shell
복사
•
응답 예시
⏺ Bash(tree /Users/0x0w1/Documents/Personals/HTMX)
⎿ /Users/0x0w1/Documents/Personals/HTMX
└── index.html
… +1 line (ctrl+r to expand)
⏺ HTMX 디렉토리는 매우 간단한 구조입니다:
HTMX/
└── index.html
현재 하나의 HTML 파일만 있습니다.
Plain Text
복사
내장된 명령어 목록
•
프로젝트 관리
◦
/add-dir - 작업 디렉토리 추가
◦
/init - 프로젝트 초기화 (CLAUDE.md 가이드)
◦
/memory - 메모리 파일 편집
•
계정 및 설정
◦
/login - 계정 전환
◦
/logout - 계정 로그아웃
◦
/config - 구성 보기/수정
◦
/permissions - 권한 관리
◦
/model - AI 모델 선택
•
상태 및 정보
◦
/status - 계정/시스템 상태
◦
/cost - 토큰 사용 통계
◦
/doctor - 설치 상태 진단
•
작업 도구
◦
/review - 코드 리뷰 요청
◦
/pr_comments - 풀 리퀘스트 댓글 보기
◦
/bug - 버그 보고
◦
/vim - Vim 모드
•
기타
◦
/clear - 대화 기록 지우기
◦
/compact - 대화 압축
◦
/help - 도움말
◦
/mcp - MCP 서버 관리
◦
/terminal-setup - 터미널 설정