bkit 설치
이 페이지의 목표 — Claude Code에 bkit 플러그인을 설치합니다.
/plugin명령어 두 줄이면 끝나요.bkit은 Claude Code 위에 얹는 개발 방법론 플러그인이에요.
/pdca plan,/pdca analyze같은 명령어로 "계획 → 구현 → 점검" 흐름을 잡아줘서 큰 프로젝트도 체계적으로 만들 수 있게 해줍니다.
시작 전 준비물
- Claude Code 설치 완료 (아직이면 Claude Code 설치 페이지부터)
- Claude Code v2.1.78 이상 — bkit이 요구하는 최소 버전 (권장: v2.1.123+)
- Node.js v18 이상 (필수) — bkit의 자동화 기능(hook)이 Node.js로 동작해요. 아직 안 깔았으면 Node.js 설치 페이지부터 진행하세요
bkit이 뭔지 더 알고 싶다면? 튜토리얼 부록 H. bkit 심화에서 스킬 목록과 PDCA 파이프라인을 자세히 다뤄요. 지금은 설치만 끝내고 넘어가도 됩니다.
STEP 1. Claude Code 실행
VS Code 터미널(Ctrl + `)을 열고 아래를 입력하면 Claude Code 채팅창이 켜져요.
터미널에 입력
claude"Welcome to Claude Code" 화면이 뜨고 채팅창이 활성화되면 준비 완료예요.
아직 작업할 폴더가 없거나 다른 폴더에서 시작하고 싶다면
VS Code 메뉴에서 파일 → 폴더 열기로 작업 폴더를 먼저 열어두면 가장 편해요. 새로 폴더를 만들면서 시작하고 싶다면 터미널에서 이렇게도 됩니다.
새 폴더 만들고 이동 (PowerShell) — 경로는 예시
mkdir C:\dev\my-project
cd C:\dev\my-projectC:\dev\my-project는 예시 경로예요. 본인이 원하는 위치·이름으로 바꿔서 쓰세요 (예: C:\study\life-wiki). 한글·공백 없는 영문 경로를 추천해요. 일부 도구가 한글 경로에서 오류 날 수 있어요.
STEP 2. 버전 확인 · 업데이트
bkit은 Claude Code v2.1.78 이상에서 동작해요. 방금 켠 채팅창에 이렇게 말해보세요.
복사용 프롬프트 (Claude Code 채팅창)
내 Claude Code 버전 확인해줘. 2.1.78 이상인지 봐줘. 낮으면 업데이트도 해줘.처음 설치했다면 보통 최신 버전이라 업데이트가 필요 없어요. 이전에 설치해두고 한참 안 썼다면 한 번 시켜두는 게 좋습니다.
터미널 명령어로 직접 하고 싶다면
Claude Code 채팅창 대신 VS Code 터미널에서 직접 입력할 수도 있어요.
버전 확인 (터미널)
claude --version업데이트 (터미널)
claude updateSTEP 3. bkit 설치
Claude Code 채팅창에 아래 두 줄을 순서대로 입력해요. 슬래시(/)로 시작하는 게 핵심이에요.
1번 (Claude Code 채팅창)
/plugin marketplace add popup-studio-ai/bkit-claude-code2번 (Claude Code 채팅창)
/plugin install bkit몇 초 안에 끝나요.
STEP 4. 설치 확인
채팅창에 입력해보세요.
설치 확인 (Claude Code 채팅창)
/bkit명령어 목록이 쭉 뜨면 성공이에요. /pdca, /code-review 같은 게 보이면 OK.
실제로 쓰는 법은 튜토리얼 7장부터 익히게 됩니다.
"Failed to load hooks" 에러가 뜬다면? Claude Code 채팅창에서 "Claude Code 최신 버전으로 업데이트해줘"라고 말한 다음 다시 시도하세요.
STEP 5. (보너스) Agent Teams 활성화 — 시간이 남으면
여러 AI 에이전트가 팀으로 협업하는 기능이에요. 지금 안 켜도 튜토리얼 진행에 문제없어요. 나중에 /pdca team을 쓰고 싶을 때 설정하면 됩니다.
AI에게 물어보세요
복사용 프롬프트 (VS Code 에이전트 패널)
bkit의 Agent Teams 기능을 켜고 싶어요.
환경변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 을 설정해야 한다고 하는데,
Windows에서 영구적으로 설정하는 방법을 단계별로 알려주세요.
설정 후에 잘 적용됐는지 확인하는 방법도 함께 알려주세요.모범답안 (잘 안 되면 참고)
VS Code 터미널이 PowerShell이라면:
PowerShell — 영구 설정
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS', '1', 'User')설정 후 VS Code를 한 번 종료했다가 다시 열면 적용됩니다. 확인:
PowerShell — 확인
echo $env:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1이 출력되면 성공이에요.
Agent Teams가 뭔지 더 궁금하면? 튜토리얼 부록 H의 "CTO 에이전트와 멀티 에이전트 팀" 섹션에서 다룹니다.
다음 단계
축하해요! 이제 VS Code + Claude Code + bkit까지, 우리 스터디에서 쓸 개발 환경이 모두 갖춰졌어요.
다음 시간부터는 실제로 "나만의 라이프 위키"를 만들면서 이 도구들을 활용하는 법을 익혀나갈 거예요. bkit의 /pdca 명령어는 튜토리얼 7장부터 본격적으로 등장합니다.