DevClaude CodeAI

Claude Code Superpowers 완벽 가이드: 설치부터 실전 활용까지

2026.04.06

Claude Code, 그냥 쓰면 아쉬운 이유

Claude Code는 강력한 AI 코딩 에이전트다. 하지만 그냥 쓰면 한 가지 문제가 있다. 바로 코딩부터 시작한다.

"로그인 기능 만들어줘"라고 하면 요구사항을 확인하지도 않고 코드를 쏟아낸다. 테스트도 없고, 계획도 없다. 시니어 개발자라면 절대 이렇게 일하지 않는다. 요구사항을 정리하고, 설계하고, 테스트를 먼저 작성하고, 그 다음에 코드를 쓴다.

Superpowers는 Claude Code에 이 "엔지니어링 규율"을 심어주는 스킬 프레임워크다.

Superpowers가 뭔가

Jesse Vincent(obra)이 만든 오픈소스 프로젝트로, Claude Code에 구조화된 워크플로우 스킬을 추가해준다. GitHub에서 42,000개 이상의 스타를 받았고, 2026년 1월에 Anthropic 공식 마켓플레이스에도 등록됐다.

핵심 아이디어는 단순하다. Claude Code가 코드를 작성하기 전에 생각하게 만드는 것이다.

Superpowers 워크플로우
1
브레인스토밍뭘 만들지 정리
↓
2
계획 수립어떻게 만들지 설계
↓
3
TDD 구현테스트 먼저, 코드는 그 다음
↓
4
코드 리뷰변경 사항 검증
↓
5
완료 검증증거 기반으로 확인

이 워크플로우가 스킬 형태로 Claude Code에 내장되어서, 대화할 때마다 자동으로 적용된다.

설치 방법

방법 1: Claude Code 안에서 설치 (추천)

Claude Code를 실행한 상태에서 아래 명령어를 입력한다.

/install-plugin superpowers

끝이다. 플러그인이 자동으로 다운로드되고 활성화된다.

방법 2: 수동 설치

직접 클론해서 설치할 수도 있다.

git clone https://github.com/obra/superpowers ~/.claude/plugins/superpowers

설치 후 Claude Code를 재시작하면 스킬이 활성화된다.

설치 확인

Claude Code에서 이렇게 물어보면 된다.

superpowers 스킬 목록 보여줘

스킬 리스트가 출력되면 설치가 된 거다.

핵심 스킬 소개

Superpowers는 여러 스킬을 제공하는데, 실전에서 가장 많이 쓰는 것들을 정리했다.

Superpowers 핵심 스킬
/brainstorm
브레인스토밍요구사항 정제, 설계 탐색
/write-plan
계획 수립구현 계획을 단계별로 작성
/tdd
테스트 주도 개발Red → Green → Refactor 사이클
/debug
체계적 디버깅가설 → 검증 → 수정 루프
/review
코드 리뷰변경 사항 검증, 품질 체크
/verify
완료 검증작업 완료 전 증거 기반 확인

브레인스토밍

새로운 기능을 만들 때 가장 먼저 쓰는 스킬이다. "댓글 기능 만들어줘"라고 하면 바로 코딩하는 대신 이런 질문들을 던진다.

  • 댓글에 대댓글이 필요한가?
  • 익명 댓글을 허용할 건가?
  • 수정/삭제 권한은 어떻게 할 건가?
  • 알림 기능이 필요한가?

요구사항이 명확해진 다음에야 구현으로 넘어간다. 처음엔 번거롭게 느껴질 수 있는데, 나중에 "아 이것도 필요했는데" 하면서 코드를 뜯어고치는 일이 줄어든다.

계획 수립 (Write Plan)

브레인스토밍이 끝나면 구현 계획을 세운다. 단순히 "이거 하고 저거 하고"가 아니라 체크포인트가 있는 단계별 계획을 만든다.

## 구현 계획
 
### Step 1: 데이터 모델 정의
- Comment 스키마 작성
- 검증: 마이그레이션 실행 확인
 
### Step 2: API 엔드포인트
- POST /api/comments — 댓글 생성
- GET /api/comments?postId=xxx — 목록 조회
- 검증: API 테스트 통과
 
### Step 3: UI 컴포넌트
- CommentList, CommentForm 구현
- 검증: 브라우저에서 동작 확인

각 단계마다 검증 기준이 있어서, 완료 여부를 객관적으로 확인할 수 있다.

TDD (테스트 주도 개발)

내가 Superpowers에서 가장 좋다고 느낀 스킬이다. Red-Green-Refactor 사이클을 강제한다.

  1. Red — 실패하는 테스트를 먼저 작성한다
  2. Green — 테스트가 통과하는 최소한의 코드를 작성한다
  3. Refactor — 코드를 정리한다

AI가 TDD를 한다는 게 처음엔 신기했는데, 실제로 써보면 결과물의 품질이 확실히 다르다. 테스트 없이 작성된 코드는 나중에 뭘 고치면 다른 게 깨지는 경우가 많은데, TDD로 만든 코드는 그런 문제가 거의 없다.

체계적 디버깅

버그를 만나면 무작정 코드를 고치는 대신 4단계 프로세스를 따른다.

  1. 현상 파악 — 정확히 무엇이 잘못됐는지 확인
  2. 가설 수립 — 원인이 될 수 있는 후보를 나열
  3. 가설 검증 — 하나씩 테스트해서 원인 특정
  4. 수정 및 검증 — 고치고, 재발 방지 테스트 추가

"아마 이거겠지" 하고 바로 고치는 게 아니라 증거 기반으로 접근하는 거다. 특히 재현이 어려운 버그에서 효과적이다.

코드 리뷰 요청

작업이 끝나면 스스로 코드 리뷰를 수행한다. 변경된 파일을 분석해서 이런 것들을 체크한다.

  • 원래 요구사항을 충족하는가
  • 엣지 케이스를 놓치지 않았는가
  • 보안 취약점은 없는가
  • 테스트 커버리지가 충분한가

완료 검증

"다 됐습니다"라고 말하기 전에 실제로 동작하는지 검증하는 스킬이다. 빌드를 돌리고, 테스트를 실행하고, 결과를 확인한 다음에야 완료를 선언한다. "제가 확인해봤는데 잘 됩니다"가 아니라 증거를 보여준다.

실전에서 어떻게 달라지는가

Superpowers 없이 Claude Code를 쓰면 이런 흐름이 된다.

나: "사용자 프로필 페이지 만들어줘"
Claude: (바로 코드 200줄 작성)
나: "아 이메일 수정 기능도 필요한데"
Claude: (코드 수정)
나: "비밀번호 변경도..."
Claude: (또 수정)

Superpowers가 있으면 이렇게 바뀐다.

나: "사용자 프로필 페이지 만들어줘"
Claude: "프로필 페이지에 어떤 정보를 표시할 건가요?
        수정 가능한 항목은 뭔가요?
        비밀번호 변경도 이 페이지에서 할 건가요?"
나: "이름, 이메일, 비밀번호 변경 다 필요해"
Claude: (계획 수립 → 테스트 작성 → 구현 → 검증)

한 번에 깔끔하게 끝난다. 되돌아가서 고치는 시간이 없으니까 오히려 전체 작업 시간이 줄어든다.

다른 플러그인과 함께 쓰기

Superpowers는 단독으로도 좋지만, oh-my-claudecode와 같이 쓰면 더 강력해진다. oh-my-claudecode는 서브에이전트 병렬 실행, 팀 모드, autopilot 등의 기능을 제공하는 플러그인인데, Superpowers의 워크플로우와 잘 맞물린다.

예를 들어 oh-my-claudecode의 /team 모드로 여러 에이전트가 협업할 때, 각 에이전트가 Superpowers의 TDD 스킬을 적용하면서 작업하는 식이다.

커스텀 스킬 만들기

Superpowers의 기본 스킬만 써도 충분하지만, 프로젝트에 맞는 커스텀 스킬을 만들 수도 있다. .claude/skills/ 폴더에 마크다운 파일을 추가하면 된다.

---
name: my-convention
description: 우리 팀 코딩 컨벤션 체크
user_invocable: true
---
 
# 코딩 컨벤션 체커
 
코드를 작성하거나 수정할 때 아래 규칙을 따릅니다:
 
- 함수명은 camelCase
- 컴포넌트는 PascalCase
- CSS는 Tailwind만 사용
- API 응답은 반드시 타입 정의

이렇게 만들면 /my-convention으로 호출할 수 있다. 팀 컨벤션, PR 체크리스트, 특정 프레임워크 규칙 등을 스킬로 만들어두면 매번 설명할 필요가 없다.

주의할 점

토큰 소비가 늘어난다

Superpowers는 코딩 전에 생각하는 과정을 추가하기 때문에 토큰을 더 쓴다. 브레인스토밍, 계획 수립, 테스트 작성 등이 전부 토큰이다. Pro 플랜의 레이트 리밋에 더 빨리 도달할 수 있으니 참고하자.

간단한 작업에는 과할 수 있다

"버튼 색상 바꿔줘" 같은 한 줄짜리 수정에 5단계 워크플로우를 적용하면 오히려 비효율적이다. Superpowers는 규모가 있는 기능 개발이나 복잡한 버그 수정에서 빛난다.

기존 습관과 충돌할 수 있다

"빨리 코드부터 보고 싶은데" 하는 마음이 들 수 있다. 하지만 한두 번 전체 사이클을 경험해보면 왜 이 과정이 필요한지 이해하게 된다.

정리

Superpowers는 Claude Code를 "코드 생성기"에서 "엔지니어링 파트너"로 바꿔주는 플러그인이다. 설치는 한 줄이면 끝나고, 설치하는 순간부터 브레인스토밍, TDD, 체계적 디버깅 같은 워크플로우가 자동으로 적용된다.

처음에는 AI에게 이런 규율을 부여하는 게 과하다고 느낄 수 있다. 하지만 프로젝트 규모가 커질수록, 그리고 작업이 복잡해질수록 이 구조의 가치를 체감하게 된다. 시니어 개발자가 옆에서 "테스트부터 짜" "계획 먼저 세워" 하고 코칭해주는 느낌이다.

이전 글에서 Claude Code 설치법을 다뤘는데, 설치했다면 Superpowers는 반드시 같이 쓰길 추천한다.