Superpowers 완벽가이드 2편: 설치하기

요약#

참고 자료#

• obra/superpowers - GitHub README
• Superpowers for Codex
• Superpowers for OpenCode
• Installing Superpowers for Codex
• Installing Superpowers for OpenCode
• Superpowers - Claude Plugin
• Claude Code Docs - Plugins

바로 써먹는 설치 명령#

이 글은 2026-03-18 기준 공식 문서를 다시 확인한 뒤 정리한 내용입니다.
가장 짧게 설치만 끝내고 싶다면 아래 다섯 블록만 보면 됩니다.

Claude Code 공식 설치 명령

1
/plugin install superpowers@claude-plugins-official

Cursor 설치 명령

1
/add-plugin superpowers

Codex 빠른 설치 질문

1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

OpenCode 빠른 설치 질문

1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Gemini CLI 설치 명령

1
gemini extensions install https://github.com/obra/superpowers

TIP

README는 가장 빠른 설치 경로를 먼저 보여주고, Codex와 OpenCode는 별도 문서에서 직접 설치 경로도 함께 설명합니다.
그래서 “짧게 설치하고 싶을 때”와 “무슨 일이 일어나는지 직접 알고 싶을 때”의 선택지가 둘 다 있습니다.

문제 상황#

Superpowers를 처음 접하면 이름은 하나인데 설치법은 왜 도구마다 달라지는지부터 헷갈리기 쉽습니다.
특히 여러 코딩 에이전트를 함께 쓰는 사람이라면 더 그렇습니다.

문제는 이 차이가 사소한 UI 차이가 아니라는 점입니다.
어떤 도구는 마켓플레이스에서 바로 설치되고, 어떤 도구는 설치 문서를 읽게 하면 되며, 어떤 도구는 skills 폴더를 직접 연결하거나 설정 파일에 Git 플러그인을 등록해야 합니다.

그래서 설치 글은 한 번 따로 정리해두는 편이 낫습니다.
실행 흐름은 다음 편에서 함께 설명할 수 있지만, 설치 자체는 플랫폼별 차이를 먼저 정확히 잡아야 이후가 편해집니다.

설치 전에 알아둘 점#

다섯 플랫폼은 같은 Superpowers를 쓰지만, skill을 발견하는 방식이 서로 다릅니다.

이 차이만 이해해도 설치 문서를 읽기가 훨씬 쉬워집니다.
Claude Code와 Cursor는 “마켓플레이스형”, Codex와 OpenCode는 “빠른 설치 + 직접 설치형”, Gemini CLI는 “확장 기능형”에 가깝다고 보면 됩니다.

Claude Code에 설치하기#

공식 README 기준으로 Claude Code는 가장 단순합니다.
현재는 공식 플러그인 마켓플레이스 경로가 준비되어 있어서, 명령 하나로 설치하는 방식이 기본입니다.

Claude Code 공식 설치 명령

1
/plugin install superpowers@claude-plugins-official

설치가 끝나면 새 세션에서 plugin이 보이는지 확인합니다.
Claude Code 문서는 설치 후 /help 또는 /plugin에서 새 기능을 확인하라고 안내합니다.

NOTE

Claude Code는 Superpowers를 플러그인으로 다룹니다.
그래서 Codex처럼 심볼릭 링크를 만들 필요가 없습니다.

Cursor에 설치하기#

README 기준으로 Cursor는 Claude Code와 비슷하게 마켓플레이스형 설치를 사용합니다.
가장 짧은 경로는 Agent 채팅에서 아래 명령을 실행하는 것입니다.

Cursor 설치 명령

1
/add-plugin superpowers

또는 플러그인 마켓플레이스에서 superpowers를 직접 검색해도 됩니다.
README는 Cursor에 대해 별도 직접 설치 경로를 안내하지 않습니다.

Codex에 설치하기#

README는 Codex에 대해 가장 먼저 “설치 문서를 읽고 그대로 따라 하라”는 빠른 설치 경로를 보여줍니다.
이 방식은 Codex가 공식 설치 문서를 직접 읽고 필요한 단계를 수행하게 만드는 경로입니다.

Codex 빠른 설치 질문

1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

또는 아래와 같이 Codex 직접 설치 명령을 사용할 수 있습니다.

Codex 직접 설치 명령

1
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers
2
mkdir -p ~/.agents/skills
3
ln -s ~/.codex/superpowers/skills ~/.agents/skills/superpowers

그 다음 Codex를 완전히 종료하고 다시 실행합니다.
공식 문서는 Codex가 시작 시점에 ~/.agents/skills/를 스캔한다고 설명합니다.

1
ls -la ~/.agents/skills/superpowers

1
[features]
2
multi_agent = true

OpenCode에 설치하기#

README는 OpenCode도 Codex와 비슷하게 빠른 설치 경로를 먼저 제시합니다.
즉, OpenCode에게 설치 문서를 읽고 그대로 수행하게 하는 방식입니다.

OpenCode 빠른 설치 질문

1
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

상세 문서는 그 다음 단계로 직접 설치 방식을 설명합니다.
즉, opencode.json의 plugin 배열에 Git 기반 플러그인을 등록하는 방식입니다.

OpenCode 설정 예시

1
{
2
  "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
3
}

이 설정은 전역 또는 프로젝트 단위로 둘 수 있습니다.
설정을 저장한 뒤 OpenCode를 다시 시작하면 플러그인이 자동 설치되고 skills도 함께 등록됩니다.

1
Tell me about your superpowers

1
use skill tool to list skills

Gemini CLI에 설치하기#

README는 Gemini CLI도 지원 플랫폼에 포함합니다.
이 경우에는 플러그인보다는 확장 기능 설치 명령에 가깝습니다.

Gemini CLI 설치 명령

1
gemini extensions install https://github.com/obra/superpowers

업데이트는 아래 명령을 사용합니다.

Gemini CLI 업데이트 명령

1
gemini extensions update superpowers

설치 뒤 바로 확인할 것#

어느 플랫폼이든 설치만 끝났다고 바로 안심하면 안 됩니다.
실제로는 “등록이 되었는가”와 “세션이 새로 시작되었는가”를 함께 확인해야 합니다.

확인 체크리스트

• 설치 명령이나 설정이 오류 없이 끝났는지 확인합니다
• 도구를 완전히 재시작합니다
• skill 목록이나 plugin 목록에 Superpowers가 보이는지 확인합니다
• 간단한 요청으로 skill 발동 여부를 테스트합니다

테스트 질문 예시

1
help me plan this feature

README는 새 세션에서 이런 요청을 던졌을 때 관련 skill이 자동으로 호출되어야 한다고 설명합니다.
다음 편에서는 바로 이 지점부터, 설치 이후 대화가 어떻게 달라지는지 이어서 설명할 예정입니다.

자주 막히는 지점#

1
ls ~/.codex/superpowers/skills
2
ls -la ~/.agents/skills/superpowers

마무리#

Superpowers 설치는 이름은 하나지만 실제 과정은 플랫폼마다 꽤 다릅니다.
Claude Code와 Cursor는 마켓플레이스 설치, Codex와 OpenCode는 빠른 설치 또는 직접 설치, Gemini CLI는 확장 기능 설치로 이해하면 정리가 쉽습니다.

중요한 것은 플랫폼마다 설치 UI가 다른 것이 아니라, 각 도구가 자기 방식으로 Superpowers skills를 발견하게 만든다는 점입니다.
이 차이만 이해하면 이후 사용법은 훨씬 자연스럽게 따라옵니다.

다음 글에서는 설치가 끝난 뒤 실제 대화 흐름이 어떻게 달라지는지, 왜 에이전트가 예전보다 더 많이 묻고 더 늦게 코딩을 시작하는지를 설명하겠습니다.