Molayo

© 2026 Molayo

Dev.to헤드라인2026. 06. 15. 06:31

WSL2에 대해 모른 채 2개월 동안 Claude Code를 사용했다

요약

Claude Code를 Windows 네이티브 환경에서 사용하며 겪었던 다양한 기술적 문제와 성능 저하의 원인이 WSL2 미사용에 있었음을 깨닫는 과정을 다룹니다. Claude Code가 Linux/POSIX 환경에 최적화되어 설계되었음을 설명합니다.

핵심 포인트

  • Claude Code는 Linux/macOS 환경에 최적화된 도구임
  • Windows 네이티브 실행 시 성능이 약 70% 수준으로 제한될 수 있음
  • bash 기반 명령어, MCP 서버, Hook 기능은 WSL2 환경에서 가장 안정적임
  • Windows 사용자라면 WSL2 사용을 강력히 권장함

서론

나의 첫 번째 글에서 나는 "Claude Code가 제공하는 기능의 절반도 모르고 있었다"라고 썼습니다. /init이나 CLAUDE.md를 모른다는 뜻이었습니다.

그로부터 한 달 반이 지났습니다. 그리고 똑같은 일이 다시 일어났습니다.

어느 날, 세션 도중 명령어를 실행하려는데 Claude가 이렇게 말했습니다:

"이 작업은 WSL2에서 실행하는 것을 권장합니다."

어라.

WSL... 2?

"Windows에서 실제 Linux를 실행합니다"

그게 무슨 뜻인지 묻자, Claude는 다음과 같이 설명했습니다:

  • Linux 커널이 Windows 내부에서 실제로 실행되는 메커니즘
  • VirtualBox나 VMware 같은 가상 머신 (Virtual Machines)과는 다름
  • Windows와 Linux 간의 파일 접근 허용
  • VS Code를 통해 Linux 측의 폴더를 개발을 위해 직접 열 수 있음

그렇군요. 이름은 전에 들어본 적이 있는 것 같습니다. 웹 기사에서 잠깐 본 적이 있을지도 모릅니다.

하지만 저는 Claude Code를 Windows에서 네이티브 (Natively)로 실행하고 있었기에, 그것이 필요 없다고 생각했습니다.

그때, Claude가 또 다른 폭탄 발언을 했습니다.

"Claude Code는 Windows에서 네이티브로 실행될 때 잠재 성능의 약 70%만 발휘합니다."

뭐라고요.

진심인가요? Claude Code의 본거지는 Linux입니다

질문을 하면 할수록, Claude Code가 Linux/macOS를 염두에 두고 만들어졌다는 사실을 깨닫게 되었습니다.

  • 내부에서 실행되는 도구들이 거의 모두 POSIX/bash를 기반으로 함
  • 훅 (Hooks) 및 MCP 서버 관련 기능들이 Linux 환경에서 가장 안정적으로 작동함
  • 공식 문서와 샘플들이 대부분 bash용임
  • Windows에서 네이티브로 실행하면 명령어 차이를 메우기 위한 추상화 계층 (Abstraction layer)이 필요하며, 이는 마찰을 일으킴

다시 말해, 저는 지난 두 달 동안 Linux를 위해 설계된 도구를 Windows에서 억지로 작동시키고 있었던 것입니다.

작동이 안 된 것은 아니었습니다. 작동은 했습니다. 하지만 아마도 최대 속도로 실행되고 있지는 않았을 것입니다.

잠깐, 이제야 모든 게 설명되네요

이 말을 듣고 나니 모든 것이 갑자기 이해되었습니다.

저는 Claude Code를 사용하면서 계속해서 막히곤 했습니다:

  • 공식 샘플 절차들이 bash로 되어 있어서, 매번 머릿속으로 PowerShell로 변환해야 했습니다.
  • npm 패키지 설치가 Windows에서만 실패하곤 했습니다.
  • 설치하려는 Hook (훅)들이 "local variable expansion is invalid"와 같은 오류를 내며 실행되지 않았습니다.
  • MCP 서버 설정 예시들은 ~/.config/...를 가정하고 있었는데, 경로 구조 자체가 처음부터 완전히 달랐습니다.
  • 확장을 설치한 후 응답이 없어서 VS Code를 반복해서 재시작해야 했습니다.

매번 저는 그저 "뭐, Windows니까 어쩔 수 없지..."라며 체념하곤 했습니다.

저는 무언가를 제대로 실행하기 위해 'Windows 전용 해결책'을 검색하고, StackOverflow의 끝없는 파란색 링크들을 클릭하며, 몇 시간씩 허비하며 시간을 보냈습니다.

이 모든 것이 단지 제가 WSL2를 사용하지 않았기 때문이었나요?

지금 장난하세요?!!

진심으로, 장난하시는 건가요?

그날 밤 포기했던 그 플러그인, 작동시키려고 애썼던 그 Hook (훅)—만약 처음부터 Linux (리눅스)에서 실행했다면, 즉시 해결되었을까요?

내 주말을 돌려내세요.

Claude, 또 너구나...

강한 데자뷔 (déjà vu)가 느껴집니다.

/init에 대해 몰랐을 때도 마찬가지였습니다.

CLAUDE.md에 대해 몰랐을 때도 마찬가지였습니다.

Plan mode (플랜 모드)를 사용하지 않았을 때도 마찬가지였습니다.

그리고 이제, WSL2입니다.

Claude가 가장 중요한 것들을 자발적으로 말해주지 않는 문제—이것은 업계 전반에 걸친 함정이라고 생각합니다.

신규 사용자들은 공식 문서를 처음부터 끝까지 읽지 않고, Claude는 시작할 때 "환경이 최적의 성능을 내지 못하고 있습니다"라는 메시지를 띄워주지도 않습니다. 충분히 잘 작동하니까, 몇 달 동안 그대로 사용할 수도 있는 것이죠.

다른 Windows 네이티브 Claude Code 사용자분들, 여러분도 지금 이 순간 열심히 사용하고 계시겠죠.

사용은 하고 있겠지만, Claude의 진정한 잠재력의 70%만 사용하고 있을 겁니다.

Claude, 좀 더 빨리 말해줘!!

이사했습니다

그래서, 저는 WSL2로 이사했습니다. 과정은 놀라울 정도로 쉬웠습니다.

PowerShell을 관리자 권한으로 열고 다음 명령어를 실행하세요:

wsl --install

이렇게 하면 기본 Ubuntu가 다운로드되며, 재부팅 후 사용자를 생성하고 나면 끝입니다. 그 후 VS Code에서 **WSL 확장 프로그램 (WSL extension)**을 설치하고, 왼쪽 하단의 초록색 버튼에서 "WSL에 연결 (Connect to WSL)"을 선택하면 VS Code가 Linux 환경에 매끄럽게 연결됩니다.

Linux 터미널에서 Claude Code를 재설치하는 과정은 매우 간단했습니다. 사실, 공식 문서의 단계를 그대로 사용할 수 있었습니다. Windows 전용 주의 사항을 읽을 필요가 없었습니다. 이것은 매우 강력합니다.

단 한 가지 함정이 있었습니다: Windows 폴더에 위치한 프로젝트에 Linux 측에서 직접 접근해서는 안 됩니다. /mnt/c/...를 통해 접근하면 파일 액세스 속도가 극도로 느려져 WSL2의 이점을 망치게 됩니다. 올바른 방법은 프로젝트를 Linux 측(예: ~/projects/)에 git clone 하는 것입니다.

이사의 결과

더 빨라진 느낌입니다.

  • 터미널 작업 응답이 빠릿빠릿합니다.
  • npm install이나 hugo build 같은 명령어들이 눈에 띄게 빨라졌습니다.
  • 공식 튜토리얼을 문제없이 따라갈 수 있어, 막히는 일이 줄어들었습니다.
  • bash로 작성된 훅 (Hooks)이나 작은 스크립트들이 변환 없이 그대로 작동합니다.

수치로 증명하기는 어렵고,

공식 문서는 영어로 되어 있으며, 시작할 때 이 내용을 알려주지 않기 때문에 사람들이 이를 깨닫지 못하는 것은 당연합니다.

제가 이 글을 쓰는 이유가 바로 이것입니다. 적어도 한 명이라도 제가 빠졌던 것과 같은 함정에 빠져 두 달이라는 시간을 허비하는 일을 막기 위해서입니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0