Como Instalar Superpowers no Claude Code Passo a Passo

Índice

• O que você vai conseguir nos próximos 5 minutos
• Pré-requisitos
• Opção A: instalar pelo marketplace oficial (recomendada)
• Opção B: instalar pelo GitHub
• Como verificar que ficou instalado
• Troubleshooting: erros comuns na instalação

  • "Comando não encontrado" ao executar /plugin install superpowers
  • O plugin não aparece depois de instalar pelo GitHub
  • Erro de permissão ao clonar em ~/.claude/plugins/
  • "Marketplace não encontrado" ao instalar plugins complementares
• Primeiro uso rápido
• Perguntas frequentes

  • Preciso pagar alguma coisa para instalar Superpowers?
  • Qual opção eu devo usar, marketplace ou GitHub?
  • Por que instalei o plugin e não acontece nada?
  • Este guia serve para Claude Cowork e para Claude Code?

O que você vai conseguir nos próximos 5 minutos

Ao terminar este guia você terá Superpowers (obra/superpowers) instalado e ativo no seu cliente de Claude Code ou Claude Cowork, vai conseguir confirmar que a instalação deu certo sem ficar no chute, e vai executar o primeiro comando (/brainstorm) para checar se o plugin responde.

Pré-requisitos

Antes de começar, confirme isto:

• Ter Claude Code ou Claude Cowork instalado e com a sessão iniciada.
• Acesso a um terminal (para a opção pelo GitHub) ou à interface de chat com suporte a comandos de plugin (/plugin) para a opção pelo marketplace.
• Se for usar a opção pelo GitHub, ter git instalado na sua máquina.
• Nenhuma conta paga extra: Superpowers é um projeto open source e se instala de graça por qualquer uma das duas vias.

Opção A: instalar pelo marketplace oficial (recomendada)

É a via mais rápida e a mais fácil de manter atualizada, porque você não depende de fazer git pull na mão.

Passo 1. Abra a interface de chat do Claude Code ou do Claude Cowork.

Passo 2. Execute o comando de instalação direta:

/plugin install superpowers

Com isso você já tem o plugin base instalado.

Passo 3 (opcional). Se quiser também os plugins complementares do ecossistema Superpowers, adicione primeiro o marketplace de terceiros e depois instale a partir dele:

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

Este segundo passo não é necessário para ter Superpowers funcionando; você só precisa dele se quiser skills extras que não vêm no pacote base.

Opção B: instalar pelo GitHub

Use esta se preferir ter o código na sua máquina, acompanhar a branch de desenvolvimento ou revisar o repositório antes de confiar nele.

Passo 1. Abra o terminal.

Passo 2. Clone o repositório direto na pasta de plugins do Claude:

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

Passo 3. Reinicie a sessão do Claude Cowork ou do Claude Code para que ele detecte o plugin novo. Esse reinício é o passo que mais gente pula e por isso depois acha que a instalação falhou.

Como verificar que ficou instalado

Não assuma que funcionou só porque o comando não mostrou erro. Verifique de uma destas duas formas:

1. Listar os plugins ativos. Conforme o seu cliente, o comando para listar plugins instalados deve mostrar superpowers na lista. Se não aparecer, a instalação não terminou de ser aplicada.
2. Testar um comando da skill. Execute /brainstorm seguido de uma ideia curta, por exemplo /brainstorm agregar autenticación a mi API. Se Superpowers estiver ativo, o agente responde com perguntas de exploração em vez de pular direto para escrever código.

Se o comando /brainstorm responder normalmente, a instalação foi bem-sucedida.

Troubleshooting: erros comuns na instalação

"Comando não encontrado" ao executar /plugin install superpowers

Em geral significa que a sua versão do Claude Code ou do Claude Cowork não tem suporte a plugins habilitado ou está desatualizada. Atualize o cliente para a última versão e tente de novo.

O plugin não aparece depois de instalar pelo GitHub

Quase sempre é o passo que falta: reiniciar a sessão. Clonar o repositório não basta; o cliente carrega os plugins na inicialização, não a quente. Feche a sessão por completo e abra de novo.

Erro de permissão ao clonar em ~/.claude/plugins/

Verifique se a pasta ~/.claude/plugins/ existe e se o seu usuário tem permissão de escrita nela. Se não existir, crie na mão antes de clonar (mkdir -p ~/.claude/plugins).

"Marketplace não encontrado" ao instalar plugins complementares

Este erro aparece quando você pula direto para /plugin install superpowers@superpowers-marketplace sem ter adicionado o marketplace antes. A ordem importa: primeiro /plugin marketplace add obra/superpowers-marketplace, e só depois o install.

Primeiro uso rápido

Com Superpowers instalado, teste este fluxo mínimo para confirmar que tudo ficou conectado:

/brainstorm mejorar el onboarding de mi app

O agente deve devolver perguntas para entender o alcance antes de propor uma solução, em vez de escrever código na hora. Essa mudança de comportamento — perguntar e planejar antes de executar — é o sinal de que Superpowers está rodando, não só instalado.

Perguntas frequentes

Preciso pagar alguma coisa para instalar Superpowers?

Não. É um projeto open source (obra/superpowers) e as duas rotas de instalação — marketplace oficial e GitHub — são gratuitas.

Qual opção eu devo usar, marketplace ou GitHub?

O marketplace oficial, a menos que você tenha um motivo concreto para usar o GitHub, como querer revisar o código antes de instalar ou acompanhar uma branch de desenvolvimento específica. O marketplace se atualiza sozinho; o clone do GitHub, não.

Por que instalei o plugin e não acontece nada?

O mais provável é que falte reiniciar a sessão do cliente. Se você já reiniciou e continua sem aparecer, confirme na listagem de plugins que a instalação foi concluída.

Este guia serve para Claude Cowork e para Claude Code?

Sim. Os comandos de instalação são os mesmos porque os dois usam o mesmo sistema de plugins da Anthropic. Se quiser entender o framework completo por trás da Superpowers — o porquê, não só o como instalar — veja a análise completa da Superpowers.