[클로드코드] Claude Code를 Windows 환경에서 설치하기

요새 핫한 클로드 코드 사용해보고 싶은데, 윈도우를 지원하지 않는다구요?!

Linux에서만 클로드 코드가 공식 지원되고 있기 때문에, 어떻게 사용하는지 궁금하신 분들을 위해 이 포스트를 작성하였습니다.

 

커서에 설치하거나 할 수도 있다고 하지만.. 커서 비용은 누가 내주겠습니까..!!

조상님이 내주진 않기 때문에, 클로드만 이용해보실 분은 아래 방법은 어떠실까요.

진짜 어렵지 않게 설명했으니 한 번 따라해보세요. :)

 

1. WSL 설치

터미널을 키고, 아래 명령어를 입력합니다.

터미널 켜는 법은 윈도우 버튼 누르시고, 나오는 검색창에 터미널(Terminal) 입력하셔도 나옵니다.

wsl --install

 

혹시, 윈도우 환경인데 위의 명령어가 통하지 않고 이상한 오류가 떴다면, 저처럼 설정을 확인해보세요.

HCS_E_SERVICE_NOT_AVAILABLE이 에러 코드일 때 해결 방법입니다.

 

[제어판] - [Windows 기능 켜기/끄기] 로 들어가주세요.

제어판에 기능이 많기 때문에, 찾기 어려우시면 저처럼 Windows 기능 까지만 쳐도 기능 확인이 가능합니다.

여기 들어가셔서 아래 세 가지 항목을 체크해주세요.

• Linux 용 Windows 하위 시스템
• Virtual Machine Platform
• Windows 하이퍼바이저 플랫폼

세 개의 체크를 저장하시고, 컴퓨터를 재부팅 하셔야 합니다.

그리고 다시 터미널로 들어가서 위의 명령어로 WSL 설치를 진행하시면 문제 없이 설치 됩니다.

 

2. WSL 내에 필요한 환경 조성하기

WSL 은 가상 우분투 환경이기 때문에 Node 등 필요하신 환경을 새로 세팅해야 합니다.

설치된 wsl 을 켜서 wsl의 터미널에 아래의 명령어를 입력해주세요.

 

1) 먼저 nvm 을 설치합니다. (Node Version Manager 라는 뜻입니다.)

아래의 내용을 한꺼번에 복사하셔도 좋고, 한 줄씩 따로 복사하셔도 무관합니다.

sudo apt-get update  
sudo apt-get install curl  
curl -o- [https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh](https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh) | bash  

 

2) 다 설치되셨으면, 아래 명령어로 설치를 확인합니다.

command -v nvm

 

3) Node를 설치합니다.

nvm install --lts

 

4) 설치 되셨으면, 아래 명령어로 설치를 확인합니다.
Node와 npm의 버전이 리턴되었다면, 제대로 설치가 완료되었습니다.

node --version
npm --version

 

3. VS Code에서 wsl 연동하기

코딩 하시는 분들이라면 VS Code를 모르시는 분들은 없으실 거 같아요.

제가 할 작업은 조금 더 코딩을 눈에 보면서 하기 위해 에디터에 wsl 을 연동하는 작업을 할 거예요.

혹시 VS Code가 없으신 분이라면 설치 부탁드립니다.

 

https://code.visualstudio.com/download

Download Visual Studio Code - Mac, Linux, Windows

 

설치 후에, VS Code Extension 에서 아래의 WSL 설치를 해주세요.

 

그러고 나서, 설치된 WSL 을 실행하시면 저희의 가상 머신에 연결된 VS Code를 확인하실 수 있습니다.

wsl 실행은 왼쪽의 extension 에서 누르시면 쉽게 하실 수 있어요.

 

4. Cladue Code 설치하기

아래의 명령어로 Cladue Code를 설치하면 다 왔습니다.

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

 

 

5. Claude 계정 연결하기

wsl 터미널에 claude code 까지 설치가 완료 되었다면, 계정 연결을 해주어야겠죠?
명령어에 claude를 입력하여 사용하실 모드를 선택하고 노출되는 링크를 클릭하면 계정 로그인을 진행해 연결할 수 있습니다.

 

승인 눌러주시고, 보이는 코드 복사해서 wsl 에 붙여넣기까지 완료 해주시면 됩니다.

나오는 설명 읽어주시면서 엔터 눌러주시다가, 이 화면이 뜨면 잘 진행하신 겁니다.

저기 > 모양이 있는 곳에 프롬프트를 입력하시면 클로드 코드를 이용하실 수 있게 되었습니다 !

 

※주의사항 ※

cwd 가 현재 작업 위치이므로, 꼭! claude가 필요한 폴더로 이동하셔서 클로드를 실행해주셔야 한답니다.

그래야 원치 않는 파일이 수정되는 것을 막을 수 있어요.

 

6. 사용할 모델 설정하기

claude --model opus

 

특정 모델을 선택하고 싶은 경우, claude를 켤 때 위처럼 --model 뒤에 특정 모델을 기입하면 됩니다.

모델을 켤 때 마다 치기 번거로우신 분들은 환경변수로 지정하실 수도 있다고 합니다.

아래와 같이 특정 모델을 선택하시면, 원하는 모델로 시작하실 수 있어요.

export ANTHROPIC_MODEL='claude-opus-4-20250514'

 

하지만, 예시처럼 현재는 Opus 모델을 이용하려면 100$ 이상의 Max Plan을 이용해야 합니다.

기본 20$ 모델을 사용 중이신 경우에는, Sonnet 밖에 이용할 수 없어요. ㅠㅠ

실제로 제가 받은 안내

 

7. CLAUDE.md로 필요한 지시 남겨놓기

Rule같은 경우는 CLAUDE.md로 파일 생성하셔서 추가해놓으면 프로젝트 룰을 설정할 수 있답니다!

---

이렇게 따라 하시면, Windows 환경에서 VS Code를 이용해 Claude Code를 사용하실 수 있게 되셨을 거예요.

어렵지 않죠?

모두 즐거운 코딩 하세요!