Superpowers(슈퍼파워스)는 Anthropic이 만든 공식 기능이 아니라, 개발자 obra가 만들어 GitHub에 공개한 서드파티(third-party — Anthropic이 아닌 외부 개발자가 만든) 오픈소스 플러그인(plugin — 프로그램에 새 기능을 더해주는 확장 도구)입니다. Claude Code에 설치하면 무엇을 만들지 정리하는 단계부터 구현 계획 수립, 실제 코드 작업까지 이어지는 개발 방법론 하나가 통째로 얹어집니다. 이 글은 GitHub 저장소 obra/superpowers의 README 안내와 Claude Code 공식 문서(code.claude.com/docs)를 근거로 정체와 설치 방법, 주의할 점을 정리합니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
Superpowers는 정확히 무엇인가요?
Superpowers는 스킬(skill — Claude가 특정 상황에서 자동으로 불러와 참고하는 지침 모음) 여러 개와, 그 스킬들을 실제로 쓰게 만드는 초기 지시문을 조합한 '소프트웨어 개발 방법론'입니다. 저장소 설명에 따르면 작동 방식은 이렇습니다. 여러분이 뭔가를 만들려는 걸 감지하면 Claude는 바로 코드를 작성하지 않고, 먼저 무엇을 만들고 싶은지 되묻습니다. 대화를 통해 스펙(spec — 무엇을 만들지 정리한 명세)이 정리되면, 한 번에 읽기 부담스럽지 않은 분량으로 나눠 보여주고 사용자의 승인을 받습니다. 승인이 끝나면 구현 계획을 세우는데, 저장소는 이 계획이 "프로젝트 맥락도 모르고 테스트도 싫어하는, 그러나 열정만은 넘치는 신입 개발자"도 그대로 따라 할 수 있을 만큼 구체적이어야 한다고 설명합니다. 이후 사용자가 진행을 승인하면 서브에이전트(subagent — 특정 작업을 맡아 독립적으로 처리하는 보조 에이전트)들이 계획을 하나씩 실행하고, 서로의 결과물을 점검하며 다음 작업으로 넘어가는 '서브에이전트 기반 개발' 과정이 시작됩니다. 저장소는 이 과정에서 Claude가 계획을 벗어나지 않고 몇 시간씩 자율적으로 작업을 이어가는 경우도 드물지 않다고 밝히고 있습니다.
이 방법론은 TDD(Test-Driven Development, 테스트 주도 개발 — 테스트를 먼저 작성해 실패시킨 뒤, 그 테스트를 통과시키는 코드를 작성하는 방식. 저장소는 'red/green TDD'라는 표현을 씁니다), YAGNI(You Aren't Gonna Need It — 지금 당장 필요하지 않은 기능은 미리 만들지 않는다는 원칙), DRY(Don't Repeat Yourself — 같은 코드나 로직을 반복해서 작성하지 않는다는 원칙)를 강조한다고 저장소는 설명합니다. 참고로 Superpowers는 Claude Code 전용이 아니라 Antigravity, Codex, Cursor, Devin CLI, Gemini CLI 등 여러 코딩 에이전트용 설치 방법도 함께 안내하고 있습니다. 이 글은 그중 Claude Code에서 설치하는 방법만 다룹니다.
시작하기 전에 준비할 것
- Claude Code 설치와 인증(로그인) 완료 — Claude Code 공식 문서가 플러그인 사용의 유일한 전제 조건으로 명시하는 항목입니다.
- 터미널에서 Claude Code를 실행할 수 있는 환경 — 아래 설치 명령어는 셸(터미널)이 아니라 Claude Code를 실행한 뒤 나오는 대화창에 입력합니다.
- 인터넷 연결 — 마켓플레이스 등록·설치 과정에서 GitHub 저장소 정보를 내려받습니다.
요금제(Free·Pro·Max 등)에 대한 별도 제한은 저장소나 공식 문서 어디에도 명시되어 있지 않으므로, 이 글에서는 특정 플랜이 필요하다고 단정하지 않습니다.
용어 빠른 풀이
- 플러그인(plugin) — Claude Code에 스킬·에이전트·훅(hook, 특정 시점에 자동 실행되는 동작)·MCP 서버 등을 묶어서 추가하는 확장 패키지입니다.
- 마켓플레이스(marketplace) — 플러그인 목록을 모아 둔 카탈로그입니다. Claude Code 공식 문서에 따르면 플러그인을 설치하려면 먼저 그 플러그인이 속한 마켓플레이스를 등록해야 합니다.
- 스킬(skill) — Claude가 특정 작업 맥락에서 자동으로 불러와 참고하는 지침 문서입니다.
- 서브에이전트(subagent) — 메인 대화와 별도로 특정 작업을 맡아 처리하는 보조 에이전트입니다.
설치 방법 — 두 가지 경로 중 하나를 고르세요
저장소 안내에 따르면 Superpowers는 두 가지 경로로 설치할 수 있고, 최종적으로 설치되는 플러그인은 같습니다. 하나는 Anthropic의 공식 마켓플레이스(claude-plugins-official)를 통하는 경로, 다른 하나는 Superpowers가 직접 운영하는 마켓플레이스를 등록해서 설치하는 경로입니다. 아래 명령어는 모두 Claude Code를 실행한 뒤 나오는 대화창에 입력합니다.
경로 A. 공식 마켓플레이스에서 설치
- Claude Code를 실행합니다.
- 대화창에 아래 명령어를 입력합니다.
/plugin install superpowers@claude-plugins-official - Claude Code 공식 문서에 따르면 이 시점에 사용자(User)·프로젝트(Project)·로컬(Local) 중 설치 범위를 고르는 화면이 나타납니다. 개인적으로만 쓸 계획이면 사용자 범위를 고르면 됩니다.
- 이렇게 보이면 성공입니다. 설치 요약에 "Plugin is now active."라고 뜨면 바로 사용할 수 있고, "Run /reload-plugins to activate."라고 뜨면 안내대로
/reload-plugins를 입력해야 활성화됩니다.
경로 B. Superpowers 마켓플레이스에서 설치
- 먼저 마켓플레이스를 등록합니다.
/plugin marketplace add obra/superpowers-marketplace - 등록이 끝나면 이 마켓플레이스에서 플러그인을 설치합니다.
/plugin install superpowers@superpowers-marketplace - 설치 범위 선택과 성공 신호는 경로 A와 동일합니다.
주의: 명령어 형식이나 화면에 뜨는 메뉴 이름은 Claude Code 버전에 따라 조금씩 달라질 수 있습니다. 이 글의 내용과 실제 화면이 다르면, 화면에 표시되는 문구를 우선하세요.
설치 후 자주 막히는 문제와 해결
- "알 수 없는 명령어"라고 뜨거나 /plugin 자체가 안 보일 때
Claude Code 버전이 오래되었을 가능성이 큽니다.claude --version으로 버전을 확인하고, npm으로 설치했다면npm install -g @anthropic-ai/claude-code@latest로 업데이트한 뒤 터미널을 재시작하세요. 공식 문서가 안내하는 해결 순서입니다. - 설치는 됐는데 스킬이 안 보일 때
공식 문서는rm -rf ~/.claude/plugins/cache로 캐시를 지우고 Claude Code를 재시작한 뒤 다시 설치하라고 안내합니다. - 클라우드 세션 등 일부 환경에서 /plugin이 지원되지 않는다는 안내가 뜰 때
공식 문서에 따르면 이런 환경에서는 Claude 데스크톱 앱의 플러그인 브라우저를 쓰거나, 프로젝트의.claude/settings.json파일에 있는enabledPlugins항목으로 등록하는 방법이 있습니다. - 설치했는데 바로 동작하지 않을 때
설치 요약에 "Run /reload-plugins to activate."라고 나왔는지 다시 확인하고, 그렇다면/reload-plugins를 실행하세요.
설치 전 주의할 점
- 공식 지원 대상이 아닙니다. obra/superpowers는 Anthropic이 아니라 개인 개발자가 만들고 배포하는 프로젝트입니다. 사용 중 문제가 생기면 Claude Code 자체가 아니라 저장소 쪽 이슈 트래커에 문의하는 것이 맞습니다.
- 플러그인은 신뢰가 필요한 구성요소입니다. Claude Code 공식 문서는 "플러그인과 마켓플레이스는 사용자 권한으로 임의 코드를 실행할 수 있는, 높은 신뢰가 필요한 구성요소"라며 신뢰할 수 있는 출처의 것만 설치하라고 안내합니다.
- 경로 B는 별도의 검수를 거치지 않습니다. Anthropic의 커뮤니티 마켓플레이스(claude-community)에 등록되는 플러그인은 자동 검증과 안전 심사를 거치지만, 저장소를 직접 등록하는 방식(경로 B, obra/superpowers-marketplace)은 이런 절차와는 별개의 경로입니다.
- 자율 작업 시간이 길 수 있습니다. 저장소는 서브에이전트들이 계획을 벗어나지 않고 몇 시간씩 자율적으로 작업을 이어가는 경우도 드물지 않다고 설명합니다. 처음 써 볼 때는 자리를 비우기보다 결과를 지켜보면서 진행하는 편이 안전합니다.
자주 묻는 질문
Q. Superpowers는 Anthropic 공식 플러그인인가요?
아닙니다. 개발자 obra가 만들어 GitHub(obra/superpowers)에 공개한 서드파티 오픈소스 프로젝트입니다. 저장소 안내에 따르면 Anthropic의 공식 마켓플레이스에서도 설치할 수 있지만, 만든 주체와 유지보수 책임은 Anthropic이 아닙니다.
Q. 두 설치 경로(공식 마켓플레이스 vs Superpowers 마켓플레이스) 중 뭘 써야 하나요?
저장소는 두 경로 모두 안내하고 있고 최종적으로 설치되는 플러그인은 같습니다. 다만 Superpowers 마켓플레이스 쪽은 저장소가 직접 운영하는 마켓플레이스를 등록하는 방식이라, Anthropic 커뮤니티 마켓플레이스가 거치는 검수 절차와는 별개라는 차이가 있습니다.
Q. 설치했는데 명령어가 실행되지 않아요.
먼저 Claude Code 버전이 최신인지 확인하세요. 공식 문서는 claude --version으로 버전을 확인하고 오래됐다면 업데이트하라고 안내합니다. 그래도 안 되면 캐시를 지우고(rm -rf ~/.claude/plugins/cache) 재설치하는 방법이 공식 문서에 나와 있습니다.
Q. Claude Code 말고 다른 도구에서도 쓸 수 있나요?
네. 저장소 안내에 따르면 Antigravity, Codex, Cursor, Devin CLI, Gemini CLI 등 여러 코딩 에이전트용 설치 방법을 함께 제공하고 있어, Claude Code 전용 도구는 아닙니다.
Superpowers는 Claude Code 자체 기능이 아니라 저장소가 직접 관리하는 서드파티 플러그인이므로, 설치 전에는 항상 신뢰할 수 있는 출처인지부터 확인하는 것이 먼저입니다. 설치 자체는 두 명령어만으로 끝나지만, 이후 서브에이전트가 오랫동안 자율적으로 작업할 수 있다는 점을 염두에 두고 처음에는 결과를 지켜보면서 익혀 가시길 권합니다.