코딩을 위한 Windows에서 gatekit 설치기 (WSL + Claude Code

소개: 시도하고자 했던 것과 그 이유

이번 24기 클로서비스 스터디에서는 gatekit이라는 Claude Code 플러그인을 사용합니다. gatekit은 AI가 코딩할 때 "설계서 먼저 → 승인 → 제작 → 검사" 순서를 건너뛰지 못하게 막아주는 도구예요.

처음에는 평소 쓰던 Claude 데스크톱 앱에서 명령어 두 줄만 치면 끝날 줄 알았습니다. 그런데 스터디장님 안내 문서를 읽어보니 Windows에서는 그 방법으로 gatekit이 동작하지 않는다는 걸 알게 됐어요.

이유는 생각보다 단순했습니다. gatekit은 파이썬을 python3라는 이름으로 부르는데, Windows에 파이썬을 깔면 이름이 python이라 관문이 전부 실패한다고 해요. 그래서 Windows 안에 리눅스(우분투)를 띄우는 WSL을 설치하였습니다.

진행 방법

1. 내 PC 확인
Windows키 + R → winver 입력으로 버전을 확인했습니다. [제 PC는 Windows 11이라 통과!]

2. WSL과 우분투 설치
시작 버튼을 오른쪽 클릭해서 터미널(관리자)를 열고 한 줄 입력했습니다.

wsl --install

설치 후 재부팅하니 우분투 창이 자동으로 열렸고, 사용자 이름과 비밀번호를 만들었어요. 비밀번호를 칠 때 화면에 아무것도 안 보여서 고장인 줄 알았는데, 리눅스는 원래 그렇다고 합니다. 😅

3. 우분투 안에서 도구 설치
여기부터는 PowerShell이 아니라 우분투 창에 입력했습니다.

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl python3
curl -fsSL https://claude.ai/install.sh | bash

창을 닫았다 다시 열고 claude를 입력하니 브라우저가 열리면서 로그인이 됐어요.

4. gatekit 설치
작업 폴더를 만들고 Claude Code를 실행한 뒤, 안에서 두 줄을 입력했습니다.

/plugin marketplace add https://github.com/LovelyPaul/gatekit
/plugin install gatekit@gatekit

Claude Code를 껐다 다시 켜고 /gatekit:doctor를 실행하니 점검 결과가 나왔습니다. [결과: 모두 ok / 일부 warn 등]

막혔던 부분
[예: claude: command not found가 떠서 당황했는데, 창을 새로 여니 해결됐어요. / 설치가 0.0%에서 멈춰서 wsl --install --web-download -d Ubuntu로 다시 시도했어요.]

결과와 배운 점

• 총 소요 시간은 [약 40분]이었고, 대부분은 다운로드 기다리는 시간이었어요. 스터디 당일이 아니라 미리 해두길 정말 잘했습니다.

• 가장 헷갈렸던 건 "지금 PowerShell에 치는 건지, 우분투 창에 치는 건지"였어요. 창 제목을 꼭 확인하세요.

• 데스크톱 앱은 지우지 않고 그대로 둡니다. 평소 작업은 앱으로, 스터디 프로젝트만 우분투 터미널에서 하면 돼요.

• 터미널이 무서웠는데, 대부분 복사해서 붙여넣기라 생각보다 할 만했습니다. 코딩 초보인 저도 했으니 다른 분들도 충분히 하실 수 있어요!

스터디장 로미오님의 Windows 사전 준비 문서 덕분에 순조롭게 설치할 수 있었습니다. 감사합니다