Gemini CLI + SuperGemini 조합 : SuperGemini 설치 방법 (/sg: 커맨드로 개발 효율성 올리기)

안녕하세요! 갓대희 입니다. :- )

오늘은 슈퍼 제미나이에 대해 쓰려고 한다.

 

 

다들 슈퍼 클로드(SuperClaude)에 대해서는 아시는 분들이 많을 것 같다. ( 하기 슈퍼 클로드랑 비교해서 보는것도 좋을 것 같다. )

2025.08.11 - [AI/Claude] - Claude Code + SuperClaude 조합 : SuperClaude 설치 방법 (/sc: 커맨드로 개발 효율성 올리기)

 

그런데 클로드 코드가 출시되고 Gemini CLI가 나온것 처럼 슈퍼 제미나이(SuperGemini)도 출시가 되었다. 
( 공식 문서 캡쳐)

 

컨셉은 슈퍼 클로드랑 똑같을 것이다. 

Gemini CLI를 그냥 사용하다보면 뭔가 범용적이고, 매번 같은 설명을 반복해야 하고, 프로젝트 컨텍스트를 잃어버리는 일이 잦았을 것이다. 이런 고민을 해결해줄 프레임워크가 SuperClaude였고, 그 컨셉을 그대로 이어 받은듯 하다.

 

공식문서를 꼭 확인해보자.

 - 슈퍼 제미나이

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

SuperGemini Framework로 Gemini CLI 업그레이드하기
Gemini CLI를 전문 개발 도구로 탈바꿈시키는 설정 프레임워크.
Claude Code의 SuperClaude Framework에서 영감을 받아 Gemini 전용으로 개발된 강력한 개발 어시스턴트 도구입이.

 

SuperGemini Framework란? 🤔

SuperGemini 핵심 구성 요소 

1. 17개 전문 커맨드 : `/sg:` 접두사로 개발 전 영역 커버
2. 6개 페르소나 시스템 : 역할별 자동 전환으로 전문성 극대화
3. MCP 서버 통합 : Context7, Sequential, Playwright 자동 연동
4. 자동 프레임워크 감지 : 프로젝트 환경 자동 인식

 

슈퍼 제미나이 (SuperGemini) 설치 해보기 

 - 파이썬3.8이상, Nodejs 18+ 이상은 요구 한다. (하기 이미지 참고 / 2025.08.10 캡쳐본)

// 1단계 : SuperGemini 설치

pip install SuperGemini

ex) 정상 설치완료 예시

 

ex) 비정상 설치 예시 

 - 나의 경우 상기 경고가 떴다. 그리고 버전 확인도 안되는 현상.
   > 권장 설치 방식으로 설치 시 SuperGemini의 콘솔 스크립트가 /Users/dedur/Library/Python/3.9/bin에 설치되는데, 이 경로가 PATH에 등록되어있지 않아 생긴 경고 이다. .

 - 즉 SuperGemini 명령이 터미널에서 바로 인식되지 못하는 상황이다. 

 - 환경 변수에 추가 해 주자.

ex) 현재 쉘이 셸이 zsh인 경우

echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

 

ex) bash인 경우

echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

  

 

 - 이후 다시 확인 시 정상적으로 version 확인이 되는것을 볼 수 있다.

# 설치 확인
SuperGemini --version
# 출력예시 : SuperGemini v3.1.4

 

// 2단계: 컴포넌트 설치

# 빠른 설치 (모든 컴포넌트)
SuperGemini install --quick --yes

# 대화형 설치 (권장)
SuperGemini install

# 특정 컴포넌트만 설치
SuperGemini install --components commands mcp

 - SuperGemini install --quick --yes 명령어를 통해 Quick 설치 완료 하였다. 

 

17개 핵심 커맨드

 - 카테고리커맨드 주요 기능

구분	커맨드	주요기능	문법(패턴)
개발	/sg:implement	기능 구현 및 컴포넌트 개발	/sg:implement "feature or module" [--flag]
	/sg:build	프로젝트 빌드 및 배포 준비	/sg:build [--flag]
	/sg:design	시스템 아키텍처 및 UI/UX 설계	/sg:design "concept or spec" [--flag]
분석	/sg:analyze	코드 분석 및 성능 진단	/sg:analyze "target" [--seq] [--c7] [--flag]
	/sg:troubleshoot	문제 해결·디버깅	/sg:troubleshoot "symptoms or logs" [--seq] [--flag]
	/sg:explain	코드·개념 설명	/sg:explain "topic or code ref" [--flag]
품질	/sg:improve	코드 개선·최적화	/sg:improve "area" [--focus performance|security|readability]
	/sg:test	테스트 코드 작성·실행	/sg:test "scope" [--flag]
	/sg:cleanup	코드 정리·불필요 파일 제거	/sg:cleanup "scope" [--flag]
계획	/sg:workflow	워크플로 설계·관리	/sg:workflow "prd or steps" [--flag]
	/sg:task	작업 관리·스케줄링	/sg:task "operation or item" [--priority high|med|low]
	/sg:estimate	작업 시간·비용 추정	/sg:estimate "task" [--flag]
관리/ 기타	/sg:document	문서 작성·자동 생성	/sg:document "content" [--flag]
	/sg:git	Git 작업·버전관리	/sg:git "operation" [--flag]
	/sg:index	프로젝트 인덱싱·검색	/sg:index "scope" [--flag]
	/sg:load	설정·프로젝트 데이터 로드	/sg:load "source" [--flag]
	/sg:spawn	서브 프로세스 생성·관리	/sg:spawn "process" [--flag]

 

flag 요약 

계획 및 분석

Flag	설명	참고
--plan	작업 전 실행 계획을 표시합니다.	도구, 출력 및 단계 순서를 보여줍니다.

 

압축 및 효율성

Flag	설명	참고
--uc, --ultracompressed	기호와 구조화된 출력을 사용하여 토큰을 30–50% 줄입니다.	컨텍스트 사용량 >75% 또는 대규모 작업 시 자동 활성화
--answer-only	작업 생성/자동화 없이 직접 답변만 제공합니다.	명시적으로만 사용(자동 미활성화)
--validate	작업 전 유효성 검사 및 위험 평가	위험 점수 >0.7 또는 리소스 사용량 >75% 시 자동
--safe-mode	보수적 실행 + 최대 유효성 검사	리소스 >85% 또는 프로덕션 환경에서 자동
--verbose	최대 수준의 세부 정보와 설명	토큰 사용량 증가

 

하위 에이전트 위임

Flag	설명	참고
--delegate [files|folders|auto]	병렬 처리를 위해 하위 에이전트 위임	7개+ 디렉토리 또는 50개+ 파일 시 자동
--concurrency [n]	최대 동시 작업 수 제어(기본 7)	리소스/복잡도 기반 동적 할당

 

범위 및 초점

Flag	설명
--scope [level]	분석 범위: file, module, project, system
--focus [domain]	예: performance, security, quality, architecture, accessibility, testing

 

반복적 개선

Flag	설명	참고
--loop	반복적 개선 모드	품질 개선/구체화 요청 시 자동
--iterations [n]	개선 주기 수(기본 3)	작업 복잡성 기반 기본값 재정의
--interactive	각 반복 전 사용자 확인을 요구	주기별 일시 정지/승인

 

페르소나 활성화

Flag	설명
--persona-[name]	특정 페르소나를 활성화 (예: --persona-architect, --persona-frontend)

 

자기 성찰 및 투명성

Flag	설명	참고
--introspect, --introspection	사고 과정을 노출하는 깊은 투명성 모드	SuperGemini 작업/복잡한 디버깅 시 자동

 

페르소나 시스템 제공

6개 전문 페르소나

• architect : 시스템 설계 및 아키텍처
• frontend : UI/UX 개발 및 접근성
• backend : 서버 개발 및 인프라
• analyzer : 디버깅 및 문제 조사
• security : 보안 분석 및 취약점 검토
• scribe : 문서화 및 기술 문서 작성

 

자동 vs 수동 페르소나 전환

// 자동 페르소나 활성화 (권장)

# API 설계 → backend 자동 활성화
/sg:design user-api --type api

# 보안 검토 → security 자동 활성화  
/sg:analyze --focus security

# UI 컴포넌트 → frontend 자동 활성화
/sg:implement button-component --react

// 수동 페르소나 지정 (특별한 관점 필요시)

# 프론트엔드 관점에서 API 설계 검토
/sg:design api-design --persona frontend

# 보안 관점에서 UI 컴포넌트 분석
/sg:analyze component --persona security

 

프로젝트 적용 예시

대시 보드 페이지(React) 개발 워크플로우

간단하게 super claude에서 했듯이 대시보드를 개발해보자. 결과도 비교해볼 수 있을 것 같다. 

 

** 슈퍼 클로드나 슈퍼 제미나이의 동작 방식을 비교 하고 싶다면 하기글을 같이 확인해보시는것도 재밌을 것 같다. **

2025.08.11 - [AI/Claude] - Claude Code + SuperClaude 조합 : SuperClaude 설치 방법 (/sc: 커맨드로 개발 효율성 올리기)

 

1단계 : 전체 구조 계획

// 전체 구조 계획

/sg:design --plan로 전체 구조 계획

 

 

2단계 : 시스템 설계

2. /sc:design : /sc:design [대상] --type [타입] --format [출력형식] [추가옵션]

1) --type 옵션 (설계 유형)

--type architecture    # 시스템 아키텍처
--type api            # API 설계
--type component      # UI 컴포넌트
--type database       # 데이터베이스
--type workflow       # 워크플로우
--type ui             # 사용자 인터페이스
--type microservice   # 마이크로서비스

 

2) --format 옵션 (출력 형식)

 

--format diagram      # 다이어그램/차트
--format spec         # 스펙 문서
--format code         # 실제 코드
--format markdown     # 마크다운 문서
--format json         # JSON 형태
--format yaml         # YAML 형태

 

3) 추가 유용한 옵션들

 

 

--plan               # 실행 전 계획 수립
--iterative          # 반복적 개선 모드
--detailed           # 상세한 설명 포함
--minimal            # 최소한의 구조만
--scalable           # 확장성 고려
--secure             # 보안 요소 포함

 - SuperClaude때와 동일하게 진행해보자. ( design 만으로도 개발 진행하는지도 체크 해보자. / 실제는 3단계 implement 단계에서 구현 하는 컨셉)

 

ex) 대시 보드 시스템 전체 아키텍처를 설계 해 보자.

/sg:design dashboard-component --type component --format code

 

 

ex) gemini또한 design만으로도 바로 개발까지 진행해 버린다. 결과물을 살펴보자.

 - 라우팅도 추가해줘서 /dashboard 로 접속하면 바로 확인 가능한 상황이다. 

 

ex) 재미나이가 생성해준 대시 보드 샘플

 - 블랙/화이트 테마를 못맞춰주고 내용이 매우 간단 하다.

 

ex) 클로드가 생성해준 대시 보드 샘플과 비교하면 사실 조금 아쉽긴 하다. (아직까진 코딩 쪽은 클로드가 확실히 퀄리티와 생산성이 좋긴 한것 같다. 문제는 비싼 가격... ) 

 

3단계 : 핵심 기능 구현

// 사용자 인증 및 상품 관리 구현

# 사용자 인증 시스템
/sg:implement user-auth --jwt --bcrypt

# 상품 관리 API
/sg:implement product-api --crud --validation

# 주문 처리 시스템
/sg:implement order-system --payment-integration

 

고급 기능 활용 예시 

// 여러가지 플래그 조합들

# 순차 분석
/sg:analyze --seq --verbose --c7

# 압축된 빠른 구현
/sg:implement --quiet --fast

# 보안 중심 설계
/sg:design --focus security --seq --verbose

플래그 활용 팁 ( 아직 mcp를 다루진 않았지만.. )
• `--seq`: 복잡한 문제일 때 반드시 사용
• `--c7`: Context7 강제 활성화로 최신 문서 참조
• `--verbose`: 학습 목적이거나 상세한 설명이 필요할 때
• `--quiet`: 반복 작업이나 빠른 결과가 필요할 때

 

자주 묻는 질문 ❓

Q: SuperClaude Framework와 어떤 차이가 있나요?

A: SuperGemini는 Gemini CLI 전용이며, SuperClaude는 Claude Code 전용입니다. 기본 개념은 동일하지만 각 AI 도구의 특성에 맞게 최적화되어 있습니다.

Q: 무료로 모든 기능을 사용할 수 있나요?

A: 네, SuperGemini Framework는 완전 무료 오픈소스입니다. 다만 Gemini CLI 자체의 API 사용량에 따른 비용은 별도입니다.

Q: 기존 Gemini CLI 설정에 영향을 주나요?

A: 기존 설정은 유지되며, SuperGemini는 추가 기능만 제공합니다. 언제든지 제거할 수 있습니다.

참고 자료

• SuperGemini Framework 공식 리포지토리 - 최신 업데이트 및 설치 가이드
• PyPI SuperGemini 페이지 - pip 설치 및 버전 정보
• SuperClaude Framework - Claude Code 버전 프레임워크
• Gemini CLI 공식 문서 - 기본 사용법 및 설정

 

마무리 정리

SuperGemini의 핵심 가치

• 개발 시간 60-80% 단축 : 설계부터 배포까지 전 과정 최적화
• 코드 품질 일관성 : 페르소나별 전문 지식 자동 적용
• 학습 효과 : 모범 사례 자동 제시로 개발 실력 향상
• 무료 오픈소스 : 비용 부담 없이 전문 도구 활용
• 확장성 : 커뮤니티 기반 지속 발전

SuperGemini Framework는 단순한 도구를 넘어서 개발 방식 자체를 바꾸는 혁신적인 프레임워크이다.

Gemini CLI의 강력한 AI 능력을 개발자 친화적인 워크플로우로 체계화한 것이 가장 큰 장점이라고 생각한다.

Gemini CLI를 사용하고 있다면 SuperGemini Framework를 적극 추천한다.