# ???? SuperGemini (Super Claude + Gemini CLI) 완벽 가이드

## ???? 프로젝트 개요

### 핵심 컨셉

**문제점**: Super Claude의 과도한 토큰 소비 (컨텍스트의 20% 소모)

**해결책**: Gemini CLI의 방대한 무료 컨텍스트 활용

**결과물**: 무료로 사용 가능한 고품질 AI 코딩 도구

### 주요 특징

Super Claude의 26개 마크다운 지침서 완벽 이식

컨텍스트 엔지니어링 기법으로 작성된 시스템 프롬프트

MCP(Model Context Protocol) 연동 지원

17개 커스텀 커맨드 제공

## ????️ 설치 방법

### 전제 조건

Python 3.7+ 설치

Google 계정 (Gemini API 사용)

VS Code 또는 텍스트 에디터

Super Claude 파일들 (.claude 폴더)

### 방법 1: 수동 설치 (영상 방식)

#### 1단계: Gemini CLI 설치

```bash

# 명령 프롬프트에서 실행

pip install google-generativeai

gemini  # 실행 확인 (구글 로그인 필요)

```

#### 2단계: 파일 복사

```bash

# 사용자 디렉토리 이동

cd %USERPROFILE%

# .claude 폴더의 9개 파일을 .gemini 폴더로 복사

# claude.md 내용을 gemini.md로 복사 후 claude.md 삭제

```

#### 3단계: 커스텀 커맨드 설정

```bash

# .claude/commands/sc 폴더를 통째로 복사

# .gemini 폴더에 commands 폴더 생성

# sc 폴더를 .gemini/commands/에 붙여넣기

```

#### 4단계: 오류 수정

```markdown

# orchestrator.md 파일에서 @ 표시 제거

# 모노레포(@monorepo) → 모노레포(monorepo)

```

#### 5단계: MD → TOML 자동 변환

```javascript

// Gemini CLI에서 실행할 변환 스크립트

// (영상 댓글에 제공된 내용)

const fs = require('fs');

const path = require('path');

// .gemini/commands/sc 폴더의 모든 .md 파일을

// .toml 형식으로 자동 변환

// 약 5분 소요, 변환 후 /sc 커맨드 사용 가능

```

**확인 방법**:

```bash

gemini

/sc  # 모든 Super Claude 명령어 표시되면 성공

```

### 방법 2: 자동 설치 (공식 SuperGemini)

```bash

# SuperGemini Framework 설치 (같은 개발자 제작)

pip install SuperGemini

SuperGemini install --quick --yes

```

**⚠️ 주의**: 자동 설치 후에도 추가 설정 필요

Google API 키 설정

환경 변수 구성

커스텀 커맨드 TOML 변환 확인

실제로는 수동 설치가 더 확실할 수 있음

GitHub: https://github.com/SuperClaude-Org/SuperGemini_Framework

## ???? 주요 명령어 (17개)

### 분석 및 설계

`/sc:analyze` : 프로젝트 환경 분석

`/sc:design` : 아키텍처 설계

`/sc:task` : 작업 분할 및 실행

### 코딩 및 빌드

`/sc:build` : 프로젝트 빌드

`/sc:troubleshoot` : 에러 해결

`/sc:cleanup` : 데드 코드 제거

### 메모리 기능

Shrimp MCP 연동으로 작업 기록 유지

다음날에도 작업 이어가기 가능

## ???? 실전 활용 예시: 세계 시계 앱

### 작업 흐름

1. **분석**: `/sc:analyze` → React 기반 환경 체크

2. **설계**: `/sc:design` → 컴포넌트 구조 설계

3. **작업**: `/sc:task` → 코딩 진행

4. **빌드**: `/sc:build` → 컴파일 및 실행

5. **디버그**: `/sc:troubleshoot` → 에러 해결

6. **정리**: `/sc:cleanup` → 불필요한 코드 제거

7. **수정**: 아날로그 → 디지털 시계 변경

### 결과물

세계 주요 도시의 실시간 시계

아날로그/디지털 전환 가능

각 나라별 정확한 시간 표시

## ???? MCP 자동 설치 (말로 하는 설치)

### Claude Code 활용 방법

```bash

# 1. VS Code에서 claude.md 파일 생성 (댓글 내용 복사)

# 2. 작업 폴더로 이동

cd [작업폴더]

# 3. Claude Code 실행

claude

# 4. MCP 설치 요청

"Gemini CLI에 Sequential MCP 설치해줘"

"Context7 MCP도 설치해줘"

# 5. 확인

gemini

/mcp  # 설치된 MCP 목록 확인

```

## ???? 실제 설치 과정의 이슈들

### 자동 설치 시 발생하는 문제

1. **API 키 설정**: Google Cloud Console에서 별도 설정 필요

2. **환경 변수**: PATH, GEMINI_API_KEY 등 수동 구성

3. **권한 문제**: Windows의 경우 관리자 권한 필요할 수 있음

4. **의존성 충돌**: 기존 Python 패키지와 충돌 가능

### 권장 설치 순서

```bash

# 1. 수동으로 Gemini CLI 먼저 설치 및 테스트

pip install google-generativeai

gemini  # 정상 작동 확인

# 2. Super Claude 파일들 수동 복사 (영상 방식)

# 3. MD → TOML 변환 스크립트 실행

# 4. 작동 확인 후 필요시 SuperGemini 추가 설치

```

### 트러블슈팅

```bash

# Gemini가 안 될 때

pip install --upgrade google-generativeai

pip install --upgrade google-auth google-auth-oauthlib google-auth-httplib2

# 권한 문제 시 (Windows)

# 관리자 권한으로 cmd 실행 후 재시도

# 파일 변환이 안 될 때

# 영상의 수동 변환 스크립트 사용

```

## ⚠️ 사용 시 주의사항

### Gemini CLI 특성

1. **구체적 명령 필수**: 프롬프트 실력이 그대로 반영됨

2. **무료 서비스 한계**: 

   간헐적 에러 발생 (재시작으로 해결)

   터미널 작업 서툴러 수작업이 빠를 수 있음

3. **외부 도구 연동**: MCP 자동화가 쉽지 않음

### Super Claude vs Gemini CLI 비교

| 구분 | Super Claude | Gemini CLI |

|======|=============|============|

| 토큰 소비 | 매우 많음 (컨텍스트 20%) | 무료 |

| 컨텍스트 크기 | 제한적 | 방대함 |

| 성능 | 우수 | 보통 |

| 안정성 | 높음 | 간헐적 에러 |

| MCP 연동 | 원활함 | 제한적 |

## ???? 활용 시나리오

### 1. 로컬 IDE 작업

Playwright 테스트 자동화

블로그 콘텐츠 생성

코드 리팩토링

### 2. MaoCafe AI 시스템 연동

```python

# STEP03_CRAWLING 최적화

/sc:analyze  # 현재 크롤링 시스템 분석

/sc:task     # PostView 방식 개선

/sc:cleanup  # 불필요한 코드 제거

# STEP09_GEMINI 마크다운 생성

/sc:design   # Enhanced v7.0 구조 설계

/sc:build    # 2000자 이상 콘텐츠 생성

```

### 3. 바이브 코딩 워크플로우

초기 설계 → 점진적 개발 → 지속적 클린업

Shrimp MCP로 작업 히스토리 관리

다음날 이어서 작업 가능

## ???? 성능 최적화 팁

### 토큰 절약 전략

1. **컨텍스트 엔지니어링**: 핵심 단어만으로 설명

2. **클린업 자주 실행**: 데드 코드 축적 방지

3. **구체적 명령**: 불필요한 반복 방지

### 에러 대응 방법

```bash

# 에러 발생 시

1. 창 닫고 재시작

2. /sc:troubleshoot 실행

3. 수동으로 명령어 실행

4. /sc:cleanup으로 정리

```

## ???? 결론

### 장점

✅ 무료로 Super Claude 수준의 AI 코딩

✅ 방대한 컨텍스트로 대규모 프로젝트 가능

✅ MCP 연동으로 확장성 확보

✅ 작업 기록 유지로 연속성 보장

### 단점

❌ Claude 대비 성능 부족

❌ 간헐적 에러 및 불안정성

❌ 터미널 작업 미숙함

### 추천 대상

토큰 비용이 부담스러운 개발자

대규모 컨텍스트가 필요한 프로젝트

AI 코딩을 무료로 체험하고 싶은 입문자

재미있는 AI 장난감을 원하는 실험가

## ???? 참고 자료

[SuperGemini Framework GitHub](https://github.com/SuperClaude-Org/SuperGemini_Framework)

[원본 영상: 토큰 폭식러와 토큰 부자가 만나다](https://www.youtube.com/watch?v=whLEc7lO_xY)

MCP 도구: Sequential, Context7, Shrimp

개발 환경: VS Code, Playwright, React

===

*"방대한 컨텍스트의 Gemini와 토큰은 소모되지만 성능 좋은 Super Claude, 서로의 단점을 완벽히 메워주는 환상의 조합!"*