본문 바로가기
카테고리 없음

윈도우에서 클로드코드 설치 tmux로 설치하기

by 엔돌슨 2026. 3. 30.
반응형

[How-to] 윈도우(WSL)에서 Claude Code + tmux 완벽 설치 및 활용 가이드

윈도우 환경에서 AI 기반 코딩 에이전트인 Claude Code를 가장 효율적으로 사용하는 방법은 무엇일까요? 바로 WSL(Windows Subsystem for Linux) 위에 tmux를 얹어 사용하는 것입니다.

 

터미널이 끊겨도 작업이 유지되고, 화면을 자유자재로 분할하며 클로드와 대화하는 '최강의 개발 환경' 구축법을 단계별로 소개합니다.

 

visual studio + 클로드코드 터미널

안티그래비티 + 클로드코드 터미널

여기에 wsl + tmux 조합도 나쁘지 않다고 봅니다.

 

클로드 코드 설치 방법, 처음부터 쉽게 따라하기

AI 코딩 도구에 관심 있는 분들이라면 한 번쯤 Claude Code를 들어보셨을 겁니다. Claude Code는 Anthropic이 제공하는 터미널 기반 코딩 도우미로, 개발자가 프로젝트 폴더에서 자연어로 작업을 지시하면 코드 작성, 수정, 탐색 같은 작업을 돕는 도구입니다. Anthropic 공식 안내에서는 Claude Code를 개발 도구 중 하나로 소개하고 있으며, 시작 예시로 npm install -g @anthropic-ai/claude-code 명령을 제시하고 있습니다.  

이번 글에서는 Claude Code 설치 방법을 아주 쉽게 정리해보겠습니다.

Claude Code란?

Claude Code는 IDE 플러그인보다는 터미널 중심으로 사용하는 AI 코딩 도구에 가깝습니다. Anthropic 공식 자료에서도 Claude Code를 “터미널에서 사용하는 코딩 도구”로 소개하고 있습니다. 

쉽게 말해 이런 느낌입니다.

  • 프로젝트 폴더에서 Claude Code 실행
  • “이 함수 리팩터링해줘”
  • “버그 원인 찾아줘”
  • “테스트 코드 만들어줘”

이런 요청을 자연어로 입력하면, Claude가 코드베이스를 바탕으로 도와주는 방식입니다.

설치 전에 준비할 것

Claude Code는 공식 시작 안내 기준으로 npm을 이용해 전역 설치합니다. 따라서 먼저 Node.js와 npm이 설치된 환경이 있으면 진행이 수월합니다. 공식 문서의 시작 예시가 npm 설치 명령을 사용하고 있기 때문입니다.  

준비 항목은 아래 정도면 됩니다.

  • Node.js / npm 설치
  • 인터넷 연결
  • 터미널 사용 가능 환경
    • Windows: PowerShell, Windows Terminal
    • macOS: Terminal
    • Linux: bash, zsh 등

Claude Code 설치 명령어

가장 기본 설치 방법은 아래 명령어입니다.

 

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

이 명령은 Anthropic 공식 가이드에서 Claude Code 시작 예시로 안내되는 설치 방식입니다.  

설치가 끝난 뒤에는 보통 아래처럼 실행해 확인합니다.

claude

환경에 따라 처음 실행 시 로그인이나 인증 안내가 나올 수 있습니다.

운영체제별 설치 방법

1) Windows에서 설치하기

Windows에서는 PowerShell 또는 Windows Terminal을 열고 아래 명령어를 입력하면 됩니다.

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

설치가 끝나면:

claude

만약 명령어가 인식되지 않는다면, 다음을 확인해보세요.

  • Node.js가 정상 설치되었는지
  • npm 전역 설치 경로가 PATH에 잡혀 있는지
  • 터미널을 재실행했는지

2) macOS에서 설치하기

macOS 터미널에서 아래 명령어를 실행합니다.

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

권한 문제로 에러가 발생하면, Node 설치 방식이나 npm 전역 권한 설정을 확인해야 합니다.
설치 후 실행:

claude

3) Linux에서 설치하기

Linux도 동일하게 터미널에서 설치할 수 있습니다.

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

실행 확인:

claude

설치 확인 방법

정상 설치 여부는 보통 아래 순서로 확인하면 됩니다.

claude

실행이 되면 설치가 완료된 것입니다.

 

 

 

 

 

 

 

 

 

Dark mode가 기본이라 이게 좋습니다.

 

 

 

 

그리고 클로드코드 인증은 api는 비싸니깐 

1번해서 구독형으로 선택합니다.

 

 

 

인증링크를 복사해서 브라우저에 넣어주면 됩니다.

 

 

 

수락해주면 또 복사할 값을 줍니다.

 

 

다시 클로드 코드에넣어주면 끝납니다. 

 

 

 

 

 

 

 

1번 눌러서 신뢰하는 폴더라고 해주면 됩니다.

 

 

 

 

 

 

 

버전에 따라 첫 실행 화면이나 로그인 흐름은 조금 달라질 수 있습니다. Claude Code는 이후 기능이 계속 업데이트되고 있으며, Anthropic은 2025년 이후 Claude Code의 터미널 경험과 IDE 연동 기능도 확장했다고 소개했습니다.  

설치가 안 될 때 체크할 점

Claude Code 설치가 안 될 때는 대부분 아래 원인 중 하나입니다.

1) npm이 없는 경우

명령어 실행 시 npm 자체가 없다고 나오면 Node.js 설치가 먼저 필요합니다. 공식 설치 예시가 npm 기반이므로 npm 사용 환경이 전제됩니다.  

2) 권한 문제

전역 설치(-g)에서 권한 오류가 발생할 수 있습니다.
이 경우 Node.js 설치 방식 또는 npm 권한 설정을 점검하는 것이 좋습니다.

3) PATH 문제

설치는 되었는데 claude 명령이 인식되지 않으면, npm 전역 설치 경로가 시스템 PATH에 반영되지 않았을 수 있습니다.

4) 회사 보안 환경

사내 PC나 보안이 강한 개발 환경에서는 전역 패키지 설치가 제한될 수 있습니다.

Claude Code를 처음 실행한 뒤 해보면 좋은 것

설치 후에는 바로 프로젝트 폴더에서 사용해보는 것이 좋습니다.

예를 들어:

cd 내프로젝트폴더
claude

그 다음 자연어로 이런 요청을 해볼 수 있습니다.

  • “이 프로젝트 구조 설명해줘”
  • “에러 나는 부분 찾아줘”
  • “테스트 코드 추가해줘”
  • “리팩터링 포인트 추천해줘”

Claude Code는 Anthropic이 개발용 도구와 학습 자료에서 별도 영역으로 다루고 있는 제품군입니다.  

 

Claude Code 설치는 생각보다 간단합니다.
핵심은 아래 한 줄입니다.

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

정리하면,

  1. Node.js / npm 준비
  2. Claude Code 설치
  3. claude 실행
  4. 프로젝트 폴더에서 AI 코딩 도우미처럼 활용

이 순서로 진행하면 됩니다.

AI 코딩 도구를 처음 써보는 분이라도, Claude Code는 터미널만 익숙하다면 비교적 빠르게 시작할 수 있는 편입니다. 공식 Anthropic 개발 문서도 Claude Code를 개발 시작 경로 중 하나로 안내하고 있습니다.   

 

 

0. 시작 전: C드라이브 용량이 부족하다면? (D드라이브 이전)

WSL은 기본적으로 C드라이브에 설치되어 용량을 많이 차지합니다. 용량이 부족하다면 먼저 WSL 저장 위치를 D드라이브로 옮기는 것이 좋습니다.

  1. WSL 내보내기: wsl --export Ubuntu D:\WSL_Storage\ubuntu.tar
  2. 기존 WSL 해제: wsl --unregister Ubuntu
  3. D드라이브에 가져오기: wsl --import Ubuntu D:\WSL_Ubuntu D:\WSL_Storage\ubuntu.tar
    • 이렇게 하면 ext4.vhdx 파일이 D드라이브에 생성되어 C드라이브 용량 압박에서 벗어날 수 있습니다.

1단계: tmux 설치 (세션 관리의 시작)

터미널 작업 중 창이 닫혀도 클로드가 하던 작업을 유지하려면 tmux가 필수입니다.

# 패키지 목록 업데이트
sudo apt update

# tmux 설치
sudo apt install tmux -y

# 설치 확인 (버전이 나오면 성공)
tmux -V

2단계: Node.js 및 npm 설치

Claude Code는 Node.js 기반의 도구입니다. 최신 버전을 설치해 줍니다.

# Node.js 및 npm 설치
sudo apt install nodejs npm -y

# 설치 확인
node -v
npm -v

3단계: Claude Code 설치

드디어 오늘의 주인공인 Claude Code를 설치할 차례입니다.

# 글로벌 모드로 클로드 코드 설치
sudo npm install -g @anthropic-ai/claude-code

 

4단계: tmux에서 클로드 실행 및 인증하기

이제 tmux 세션을 열고 클로드를 실행합니다.

  1. 새로운 tmux 세션 만들기:
  2. tmux new -s claude-session
  3. 클로드 실행:
  4. claude
  5. 최초 인증:
    • 터미널에 표시되는 URL을 복사하여 윈도우 브라우저에 붙여넣습니다.
    • Anthropic 계정으로 로그인 후 코드를 터미널에 입력하면 "Welcome back!" 메시지와 함께 클로드가 활성화됩니다.

5단계: 생산성을 200% 올리는 tmux 활용 팁

Claude Code와 소통할 때 화면을 분할하면 한쪽에는 코드, 한쪽에는 클로드 창을 띄울 수 있어 매우 편리합니다.

 

 

 

자신의 윈도우 컴퓨터에서 경로로 찾을 수 있다.

\\wsl$\Ubuntu\home\{계정명}

 

 

⌨️ 반드시 외워야 할 핵심 단축키 (Prefix: Ctrl + b)

  • 화면 가로 분할: Ctrl + b 누른 후 %
  • 화면 세로 분할: Ctrl + b 누른 후 "
  • 창 간 이동: Ctrl + b 누른 후 방향키
  • 창 최대화/최소화: Ctrl + b 누른 후 z (답변이 길 때 유용!)
  • 세션 유지하며 나가기 (Detach): Ctrl + b 누른 후 d
  • 다시 돌아오기 (Attach): tmux attach -t claude-session

마치며

이제 윈도우에서도 리눅스의 강력함과 클로드의 지능을 동시에 누릴 수 있게 되었습니다. 윈도우 시스템 폴더(system32)가 아닌, 리눅스 홈 디렉토리(cd ~)에서 프로젝트를 관리하는 것을 잊지 마세요!

이제 클로드에게 이렇게 물어보며 시작해 보세요:

"안녕! 현재 폴더의 구조를 분석하고 리팩토링할 부분을 찾아줘."

 

 

 

티스토리툴바