bkit + Cline + LM Studio + Gemma 4 VS Code 터미널 중심 단계별 설치·실행 가이드

작성자:

준비물

  • VS Code 최신 버전
  • LM Studio (Gemma 4 실행용)
  • 충분한 VRAM (Gemma 4 26B 기준 16~24GB 이상 권장)

Step 1: LM Studio에서 Gemma 4 서버 실행 (터미널 불필요, GUI)

  1. LM Studio 실행
  2. Discover 탭에서 검색 → gemma-4 또는 google/gemma-4-26b-a4b (또는 E4B) 다운로드 (4-bit 또는 Q4_K_M 추천)
  3. 모델 다운로드 완료 후 모델 선택 → Load
  4. Developer 탭으로 이동
  5. Local Server 시작
    • Base URL: http://localhost:1234 (기본값)
    • Start Server 버튼 클릭 (항상 켜두세요)

LM Studio 서버가 실행 중인지 확인: 브라우저에서 http://localhost:1234/v1/models 접속해서 모델이 보이면 성공

Step 2: Cline 확장 설치 (VS Code)

VS Code에서 Extensions (Ctrl+Shift+X) 열고 아래 검색 후 설치:

  • Cline (saoudrizwan.claude-dev)

Step 3: bkit 다운로드 및 프로젝트 적용 (터미널 명령어)

VS Code 터미널을 열고 (`Ctrl + “) 아래 순서대로 실행하세요.

Bash

# 1. 프로젝트 폴더 만들기 또는 기존 프로젝트 열기
mkdir my-bkit-project && cd my-bkit-project
code .   # VS Code로 열기

# 2. bkit-claude-code 저장소 클론 (Cline에서도 대부분 호환)
git clone https://github.com/popup-studio-ai/bkit-claude-code.git bkit
cd bkit

# 3. bkit 시스템 파일 복사 (프로젝트 루트로)
cp -r bkit-system/* ../
cp CLAUDE.md ../CLAUDE.md 2>/dev/null || true
cp -r .bkit ../ 2>/dev/null || true

cd ..

bkit 핵심 파일들이 프로젝트 루트에 있어야 합니다:

  • CLAUDE.md
  • .bkit/ 폴더
  • bkit-system/ 폴더 등

Step 4: Cline 설정 (LM Studio 연결)

  1. VS Code 좌측 사이드바에서 Cline 아이콘 클릭

  2. Cline Settings (톱니바퀴 ⚙️) 열기

  3. 아래처럼 설정:

    • Provider: LM Studio
    • Base URL: http://localhost:1234/v1 (또는 http://127.0.0.1:1234/v1)
    • Model: gemma-4-26b-a4b 또는 LM Studio에 로드된 정확한 모델 이름
    • Use Compact Prompt: On (로컬 모델 추천)
    • Temperature: 0.4 ~ 0.6
    • Max Tokens: 8000~16000 (Gemma 4 컨텍스트가 크니 적당히)

Step 5: bkit 모드로 Cline 사용하기 (실제 명령어)

Cline 채팅창에서 아래처럼 시작하세요:

text

bkit PDCA 모드로 시작해줘.
프로젝트는 [간단한 설명]이야.

주요 bkit 명령어 (Cline에서도 대부분 작동):

  • /sprint start → 새로운 스프린트 시작
  • /plan → 기획 단계
  • /design → 아키텍처 설계
  • /do 또는 /implement → 코드 구현
  • /check → 코드 검증 + 테스트
  • /pdca → 전체 PDCA 사이클 한 번에 실행
  • /memory → 장기 기억 확인

전체 워크플로 한 번에 실행 (터미널 + Cline)

Bash

# 1. LM Studio 서버 실행 (이미 실행 중이어야 함)

# 2. VS Code에서 Cline 열고 첫 메시지
bkit을 로드하고 Gemma 4와 함께 PDCA Vibecoding Kit 모드로 작업 시작해.
새로운 [원하는 기능]을 만들어줘.

자주 발생하는 문제 해결 (터미널 명령)

Bash

# LM Studio 서버 재시작 필요 시
# LM Studio GUI에서 Stop → Start

# Cline 연결 테스트
curl http://localhost:1234/v1/models

CORS 문제 발생 시:

  • LM Studio Developer → Server Settings → Enable CORS 체크