현재 Claude code는 윈도우 운영체제를 지원하지 않아서 WSL 을 먼저 설치 해야 합니다.
여기서는 WSL을 설치하고 WSL 의 ubuntu에서 실행하는 것을 기본 전제로 하겠습니다.
소프트 웨어 준비
- Node.js 18+
- git 2.23+ (optional)
- GitHub or GitLab CLI for PR workflows (optional)
위 세가지가 준비 되어야 하는데, 여기서 Node.js 설치하는 법을 안내하겠습니다.
1. NodeSource를 이용한 Node.js 설치 (추천)
(만약 최신 버전인 "Current" 릴리스로 설치 하고싶을 경우 1-1 따라하기)
원하는 Node.js 버전에 따라 아래 명령어를 입력하세요.
(예시: 20.x 버전 설치)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
설치 확인:
node -v
npm -v
1-1. Node.js "Current" 릴리스로 설치
curl -fsSL https://deb.nodesource.com/setup_current.x | sudo -E bash -
sudo apt-get install -y nodejs
1-2. Node.js 22.x (LTS 버전)
- Node.js 22.x (LTS 버전)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
1-3. Ubuntu 공식 패키지로 설치 (버전이 낮을 수 있음)
- 터미널에서 아래 명령어 입력:
sudo apt update sudo apt install -y nodejs npm`
- 버전 확인:
node -v
npm -v
3. npm의 전역(global) 패키지 설치 위치 변경
기본적으로 npm에서 전역 패키지를 설치하려면 시스템 전체에 영향을 미치기 때문에 root(관리자) 권한이 필요합니다.
그래서 보통 sudo npm install -g 패키지명처럼 sudo를 붙여야 했죠.
그런데 sudo 없이 패키지를 설치하고 싶거나, 시스템 파일을 건드리지 않고 내 사용자 환경에서만 쓰고 싶을 때 이 방법을 씁니다.
또한, 전역 설치를 위해 sudo를 남발하면, npm이 의도치 않게 시스템 파일까지 수정할 위험이 있습니다.
내 홈 폴더(~/.npm-global)에서만 전역 설치가 이뤄지도록 하면, 시스템 파일을 건드릴 일이 없어서 훨씬 안전하겠죠?
npm list -g --depth=0 > ~/npm-global-packages.txt
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
여기까지 했으면 이제 Claude code 설치 준비는 끝난겁니다.
마지막 단계
npm install -g @anthropic-ai/claude-code
위 명령어를 입력했을 때 아래와 같이 떴다면 성공한겁니다.
이제 claude
명령어를 입력해 실행해봅니다.
claude
아래와 같이 초기 설정이 진행됩니다. 원하는 화면 모드를 선택한 후 다음으로 넘어갑니다.
Claude 구독을 하고 있다면 1번,
API 사용 기반 과금 형식으로 사용하고자 한다면 2번을 선택합니다. (저는 구독이 있어 1번을 선택합니다.)
그 다음에는 사용자 인증 절차를 거쳐야 합니다. claude 로그인 url이 나타나는데 컨트롤 + 클릭 하거나, 해당 주소를 브라우저에 복사 + 붙여넣기 하여 접속해줍니다.
그러면 아래와 같이 연결 승인 절차가 진행됩니다.
승인을 하면 길다란 코드가 발급이 되고요, Copy Code 를 클릭해서 복사해줍니다.
복사해준 코드를 다시 WSL 화면으로 돌아와 붙여주고 엔터를 입력합니다.
Login Successful 이라고 뜨면서 인증 절차가 잘 진행되었습니다. 엔터 쳐줍니다.
보안 관련 안내사항이 있습니다. 자세한 사항은 링크를 클릭해 읽어보라는 군요. 엔터 치면 다음으로 넘어갑니다.
여기서부터는 claude code를 실행할 때마다 뜨는 화면입니다. 현재 경로에서 작업할게 아니면 2번을 입력해 나갑니다.
이제 claude 명령어를 입력해 WSL 내 어디서든 claude code를 활용해 개발할 수 있습니다. 즐코딩!
'Tech' 카테고리의 다른 글
[ser8-8845] PC에 모니터가 2대 이상 연결이 안될 때 (0) | 2025.05.10 |
---|---|
[proxmox] 하위 서버에 접속이 안될 때 - 방화벽 설정 확인 (0) | 2025.04.28 |
[ELK stack]Elasticsearch에서 logstash_internal 비밀번호 등 오류 해결 (0) | 2025.04.17 |
ubuntu에 다른 스토리지를 SMB로 마운트 하기 (0) | 2025.04.10 |
[proxmox] 노트북의 CPU의 core 수가 계속 1로만 뜨는 오류 (0) | 2025.04.10 |