Cómo instalar Superpowers en Claude Code paso a paso

Guía paso a paso para instalar Superpowers en Claude Code: vía marketplace oficial o GitHub, cómo verificar que quedó activo y los errores comunes al instalarlo.

Tabla de Contenidos

Qué vas a lograr en los próximos 5 minutos
Requisitos previos
Opción A: instalar desde el marketplace oficial (recomendada)
Opción B: instalar desde GitHub
Cómo verificar que quedó instalado
Troubleshooting: errores comunes al instalar
Primer uso rápido
Preguntas frecuentes

Qué vas a lograr en los próximos 5 minutos

Al terminar esta guía tendrás Superpowers (obra/superpowers) instalado y activo en tu cliente de Claude Code o Claude Cowork, vas a poder confirmar que quedó bien instalado sin adivinar, y vas a ejecutar tu primer comando (/brainstorm) para comprobar que el plugin responde.

Requisitos previos

Antes de empezar, confirma esto:

Tener Claude Code o Claude Cowork instalado y con sesión iniciada.
Acceso a una terminal (para la opción por GitHub) o a la interfaz de chat con soporte de comandos de plugin (/plugin) para la opción por marketplace.
Si vas a usar la opción por GitHub, tener git instalado en tu máquina.
Ninguna cuenta de pago adicional: Superpowers es un proyecto open source y se instala gratis por cualquiera de las dos vías.

Opción A: instalar desde el marketplace oficial (recomendada)

Es la vía más rápida y la más fácil de mantener actualizada, porque no dependes de hacer git pull manualmente.

Paso 1. Abre la interfaz de chat de Claude Code o Claude Cowork.

Paso 2. Ejecuta el comando de instalación directa:

/plugin install superpowers

Con esto ya tienes el plugin base instalado.

Paso 3 (opcional). Si quieres además los plugins complementarios del ecosistema Superpowers, agrega primero el marketplace de terceros y luego instala desde ahí:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Este segundo paso no es necesario para tener Superpowers funcionando; solo lo necesitas si quieres skills adicionales que no vienen en el paquete base.

Opción B: instalar desde GitHub

Úsala si prefieres tener el código en tu máquina, seguir la rama de desarrollo, o revisar el repositorio antes de confiar en él.

Paso 1. Abre tu terminal.

Paso 2. Clona el repositorio directamente en la carpeta de plugins de Claude:

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

Paso 3. Reinicia tu sesión de Claude Cowork o Claude Code para que detecte el plugin nuevo. Este reinicio es el paso que más gente se salta y por el que luego cree que la instalación falló.

Cómo verificar que quedó instalado

No asumas que funcionó solo porque el comando no mostró error. Verifica con cualquiera de estas dos formas:

Listar los plugins activos. Según tu cliente, el comando para listar plugins instalados te debe mostrar superpowers en la lista. Si no aparece, la instalación no terminó de aplicarse.
Probar un comando de la skill. Ejecuta /brainstorm seguido de una idea corta, por ejemplo /brainstorm agregar autenticación a mi API. Si Superpowers está activo, el agente responde con preguntas de exploración en vez de saltar directo a escribir código.

Si el comando /brainstorm responde con normalidad, la instalación fue exitosa.

Troubleshooting: errores comunes al instalar

"Comando no encontrado" al ejecutar `/plugin install superpowers`

Suele significar que tu versión de Claude Code o Claude Cowork no tiene soporte de plugins habilitado o está desactualizada. Actualiza el cliente a la última versión y vuelve a intentar.

El plugin no aparece después de instalar desde GitHub

Casi siempre es el paso que falta: reiniciar la sesión. Clonar el repositorio no basta; el cliente carga los plugins al iniciar, no en caliente. Cierra la sesión por completo y vuelve a abrirla.

Error de permisos al clonar en `~/.claude/plugins/`

Verifica que la carpeta ~/.claude/plugins/ exista y que tu usuario tenga permisos de escritura sobre ella. Si no existe, créala manualmente antes de clonar (mkdir -p ~/.claude/plugins).

"Marketplace no encontrado" al instalar plugins complementarios

Este error aparece cuando saltas directo a /plugin install superpowers@superpowers-marketplace sin haber agregado antes el marketplace. El orden importa: primero /plugin marketplace add obra/superpowers-marketplace, y solo después el install.

Primer uso rápido

Con Superpowers instalado, prueba este flujo mínimo para confirmar que todo quedó conectado:

/brainstorm mejorar el onboarding de mi app

El agente debería devolverte preguntas para entender el alcance antes de proponer una solución, en vez de escribir código de inmediato. Ese cambio de comportamiento —preguntar y planificar antes de ejecutar— es la señal de que Superpowers está corriendo, no solo instalado.

Preguntas frecuentes

¿Necesito pagar algo para instalar Superpowers?

No. Es un proyecto open source (obra/superpowers) y ambas rutas de instalación —marketplace oficial y GitHub— son gratuitas.

¿Cuál opción debo usar, marketplace o GitHub?

El marketplace oficial, salvo que tengas una razón concreta para usar GitHub, como querer revisar el código antes de instalarlo o seguir una rama de desarrollo específica. El marketplace se actualiza solo; el clon de GitHub no.

¿Por qué instalé el plugin y no pasa nada?

Lo más probable es que falte reiniciar la sesión del cliente. Si ya reiniciaste y sigue sin aparecer, confirma con el listado de plugins que la instalación se completó.

¿Esta guía sirve para Claude Cowork y para Claude Code?

Sí. Los comandos de instalación son los mismos porque ambos usan el mismo sistema de plugins de Anthropic. Si quieres entender el framework completo detrás de Superpowers —el porqué, no solo el cómo instalarlo— revisa la reseña completa de Superpowers.