superpowers 설치법: 클로드 코드가 설계부터 테스트까지 순서대로
깃허브 별이 30만 개를 넘은 클로드 코드 플러그인이 있어요. 앤트로픽 공식 플러그인 페이지에 찍힌 설치 수는 1,009,371. 이름은 superpowers(슈퍼파워즈)입니다.
AI 코딩 에이전트에 “이거 만들어 줘” 하면 바로 코드부터 쏟아내는 경우가 많잖아요. superpowers는 그 순서를 바꿉니다. 먼저 뭘 원하는지 묻고, 설계를 같이 정하고, 계획을 쪼개고, 테스트를 먼저 쓰고, 리뷰까지 거친 다음에 끝내게 만드는 스킬 모음이에요. 공식 README와 최근 릴리스 노트를 읽고 설치법과 쓸 때 알아 둘 점을 정리해 봤습니다.

superpowers, 한 줄로 말하면?
제작자는 이걸 “코딩 에이전트를 위한 소프트웨어 개발 방법론”이라고 소개해요. 플러그인 안에는 스킬(에이전트가 상황에 맞춰 꺼내 쓰는 작업 설명서) 15개가 들어 있고, 사용자가 따로 불러내지 않아도 상황에 맞는 스킬이 자동으로 켜지는 구조입니다.
만든 사람은 제시 빈센트(Jesse Vincent)이고, 지금은 그가 속한 Prime Radiant라는 회사가 관리해요. 라이선스는 MIT라서 무료입니다. 2026년 10월 30일 확인 기준으로 별 30.8만 개, 포크 2.7만 개, 참여 개발자 60명, 커밋 686개예요.

눈에 띄는 건 앤트로픽 공식 마켓(claude-plugins-official)에 정식으로 올라가 있다는 점이에요. claude.com 플러그인 페이지에는 “테스트 주도 개발(TDD), 체계적 디버깅, 브레인스토밍, 코드 리뷰가 포함된 서브에이전트 기반 개발”을 가르치는 스킬 프레임워크라고 한국어 설명까지 붙어 있습니다. 공식 플러그인 모음은 예전에 클로드 코드 공식 플러그인 설치법에서 한 번 다뤘어요.
superpowers 설치법 — 클로드 코드는 한 줄
클로드 코드를 켜고 아래 명령 하나만 입력하면 됩니다. 앤트로픽 공식 마켓에서 바로 받아 오는 방식이에요.
/plugin install superpowers@claude-plugins-official
제작자가 따로 운영하는 마켓을 쓰는 방법도 있어요. 이쪽엔 superpowers 말고 관련 플러그인도 같이 들어 있다고 합니다.
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

설치가 됐는지 보는 법도 README에 예시가 있어요. 새 세션을 열고 “Let’s make a react todo list”처럼 뭔가 만들어 달라고 해 보면, 제대로 깔렸을 땐 코드를 쓰기 전에 brainstorming 스킬이 먼저 켜진다고 합니다.
설치 전에 이 라즈베리파이에서 버전부터 확인해 봤어요. 여기 깔린 클로드 코드는 2.1.312이고, 저장소의 plugin.json 을 직접 받아 보니 버전 7.0.1, 라이선스 MIT로 나옵니다. 스킬 폴더도 정확히 15개였어요. 다만 이 기기는 블로그 자동 발행이 돌아가는 곳이라 플러그인 자체는 아직 설치하지 않았습니다.

코덱스·커서·제미나이 CLI에서도 되나요?
됩니다. README에 적힌 지원 도구만 16가지예요. 코덱스 앱·코덱스 CLI(/plugins 에서 superpowers 검색 후 설치), 커서(/add-plugin superpowers), 제미나이 CLI(gemini extensions install https://github.com/obra/superpowers), 깃허브 코파일럿 CLI, 오픈코드, Grok Build, Kimi Code 등이 들어 있어요. 단, 도구마다 따로 설치해야 합니다. 클로드 코드에 깔았다고 코덱스에서 자동으로 켜지지 않아요.

깔고 나면 뭐가 달라지나: 기본 작업 순서 7단계
README의 “기본 작업 흐름”을 우리말로 옮기면 이런 순서예요.
- brainstorming — 뭘 만들지 묻고, 이해한 내용을 되짚어 보여 줘요. 작은 수정은 대화로 합의하고, 큰 작업은 설계 문서를 씁니다.
- using-git-worktrees — 설계가 승인되면 새 브랜치에 따로 작업 공간을 만들고 테스트가 깨끗한지 확인해요.
- writing-plans — 작업을 2~5분짜리 작은 단위로 쪼갠 계획을 씁니다. 파일 경로와 확인 방법까지 적어요.
- subagent-driven-development / executing-plans — 작업마다 새 서브에이전트를 붙여 하나씩 리뷰하거나(꼼꼼한 쪽), 한 세션에서 쭉 하고 마지막에 한 번 리뷰해요(싼 쪽).
- test-driven-development — 실패하는 테스트를 먼저 쓰고 통과시키는 순서를 강제해요. 테스트보다 먼저 쓴 코드는 지웁니다.
- requesting-code-review — 작업 사이사이 계획과 비교해 리뷰하고, 심각한 문제가 있으면 진행을 막아요.
- finishing-a-development-branch — 테스트를 확인하고 합치기·PR·보관·버리기 중 고르게 한 뒤 정리합니다.

제작자 설명으로는 계획까지 승인한 뒤 “시작” 하면 에이전트가 계획에서 벗어나지 않고 두어 시간씩 혼자 일하는 일도 드물지 않다고 해요. README에는 이 순서가 “제안이 아니라 의무”라고 적혀 있습니다. 에이전트가 무슨 일을 하든 먼저 맞는 스킬이 있는지부터 확인하게 돼 있어요.
스킬 15개, 어떻게 나뉘어 있나
공식 목록은 네 묶음이에요. 위 7단계에 나온 것 말고 따로 알아 둘 만한 것만 표로 추렸습니다.
| 묶음 | 스킬 | 하는 일 |
|---|---|---|
| 디버깅 | systematic-debugging | 근본 원인을 찾는 4단계 절차 |
| 디버깅 | verification-before-completion | “고쳤다”고 하기 전에 정말 고쳐졌는지 확인 |
| 디버깅 | diagnosing-superpowers | 세션이 이상하게 굴 때 원인을 기록 근거로 찾아 줌 |
| 협업 | dispatching-parallel-agents | 서브에이전트 여러 개를 동시에 돌림 |
| 협업 | receiving-code-review | 리뷰 지적을 받았을 때 대응하는 법 |
| 메타 | writing-skills | 새 스킬을 만들고 테스트하는 법 |
| 메타 | using-superpowers | 스킬 시스템 소개(세션 시작 때 불러옴) |

diagnosing-superpowers는 쓸 만해 보여요. 스킬이 엉뚱한 때 켜지거나, 계획을 무시하거나, 토큰을 너무 많이 먹는 것 같으면 “figure out what went wrong with superpowers in this session”이라고 시키면 된다고 합니다. 세션 기록을 읽고 줄 단위 근거를 붙여 무슨 일이 있었는지 알려 준대요.
최근 v7.0.1, 뭐가 바뀌었나
최신판은 10월 21일 나온 v7.0.1이에요. 10월 10일 v7.0.0에서 brainstorming을 처음부터 다시 만들었는데, 질문이 금방 귀찮아지고 틀에 박혔다는 의견이 많았다고 제작진이 직접 인정했어요. 그래서 이번엔 질문하기 전에 프로젝트 파일과 문서를 먼저 읽고, 이미 답이 나와 있는 건 묻지 않게 바꿨습니다.
설계 문서를 건너뛰고 바로 만들기 시작하던 문제도 손봤어요. 릴리스 노트에 따르면 한 테스트 상황에서 바꾸기 전엔 24번 중 24번 모두 묻지도 않고 문서를 건너뛰었는데, 바꾼 뒤엔 24번 중 3번으로 줄었다고 합니다. 긴 스킬 세 개도 줄여서 클로드 코드가 대화를 압축(compaction)할 때 내용이 덜 날아가게 했고요.

9월 25일 v6.4.2에서는 계획 단계가 가벼워졌어요. 오퍼스 5.5 같은 최신 모델이 계획을 쓰다가 프로젝트 전체를 구현해 버리는 일이 있었는데, 계획에 코드를 다 옮겨 적지 말고 결정 사항만 적게 바꾸니 계획 작성 시간이 4분의 1, 토큰은 약 3분의 1로 줄었다고 릴리스 노트에 적혀 있습니다.
깔기 전에 알아 둘 것
플러그인은 무료지만 에이전트 사용량은 그대로 듭니다. 서브에이전트를 작업마다 새로 붙이는 방식은 README에서도 “가장 꼼꼼한” 쪽이라고 했고, 한 세션에서 처리하는 executing-plans를 “가장 싼” 쪽이라고 따로 적어 뒀어요. 요금제 한도가 빠듯하다면 이 차이를 알고 고르는 게 좋겠습니다.
사용 집계도 하나 있어요. brainstorming의 선택 기능인 비주얼 컴패니언(visual companion)을 열면 Prime Radiant 로고를 제작사 사이트에서 불러오는데, 이때 쓰는 superpowers 버전이 함께 전달된다고 합니다. 프로젝트 내용이나 프롬프트는 보내지 않는다고 적혀 있고, 싫으면 환경 변수 SUPERPOWERS_DISABLE_TELEMETRY 를 켜면 꺼져요. 클로드 코드의 DISABLE_TELEMETRY 설정도 따른다고 합니다.

개인적으로는 오타 하나 고치는 데까지 설계 질문이 붙으면 오히려 번거로울 것 같아요. 제작진도 그걸 알아서 v7부터는 작은 일은 바로 하고, 작은 수정은 대화로 합의하고, 큰 프로젝트만 설계 문서를 쓰도록 크기를 나눈다고 했습니다. 이미 ECC 같은 다른 스킬 묶음을 깔아 둔 분이라면 비슷한 역할의 스킬끼리 겹치지 않는지도 한번 보세요.
1년 만에 별 30만, 왜 이렇게 컸을까
superpowers가 처음 세상에 나온 건 2025년 10월 9일이에요. 제작자가 블로그에 “요즘 코딩 에이전트를 이렇게 쓴다”는 글을 쓰려던 차에, 마침 그날 아침 앤트로픽이 클로드 코드 플러그인 기능을 내놓아서 바로 플러그인으로 묶어 공개했다고 합니다. 당시엔 클로드 코드 2.0.13 정도가 필요했어요.

제 생각엔 인기 비결이 “AI한테 일 시키는 순서”를 대신 정해 준다는 데 있는 것 같아요. 에이전트가 똑똑해질수록 사람이 할 일은 뭘 원하는지 분명히 말하고 결과를 확인하는 쪽으로 옮겨 가는데, superpowers는 그 과정을 에이전트 쪽에서 먼저 물어봐 주거든요. 저도 이 블로그 자동화 스크립트를 손볼 때 별도 테스트 폴더에서 한번 켜 보고, 설계 질문이 실제로 얼마나 쓸모 있는지 후기로 정리해 볼 생각입니다. 여러분은 AI 코딩 도구가 바로 코드부터 짜는 쪽이 편하세요, 아니면 먼저 물어봐 주는 쪽이 편하세요?
출처
· obra/superpowers 깃허브 저장소·README
· superpowers v7.0.1 릴리스 노트
· superpowers v6.4.2 릴리스 노트
· Claude 공식 플러그인 페이지 — Superpowers
· 제시 빈센트 블로그 — Superpowers 첫 공개 글
(2026년 10월 30일 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
