🔄 Carregar, recarregar e instalar

O --plugin-dir é o jeito de desenvolver. Ele carrega o mod direto da pasta, só nesta sessão. Nada fica instalado: fechou a sessão, o mod some.

Para vários mods, repita a flag, uma vez por pasta. O scripts/try.sh do Starter Kit faz exatamente isso: monta uma lista de --plugin-dir, uma por mod escolhido, e abre o claude numa pasta de demonstração temporária.

claude --plugin-dir templates/starter-mod

bash scripts/try.sh terminal-pet

Quando a pasta muda, o módulo recarrega: register roda de novo num ambiente novo, e os timers do ambiente anterior caem. Variáveis de módulo também recomeçam do zero.

O momento depende de quem salvou. Se foi o próprio Claude, no meio do turno, recarrega uma vez quando o turno acaba (ou antes, quando uma ferramenta ou comando do mod está para rodar). Se foi você, no editor, recarrega quando a pasta fica quieta.

Como ler o desenho: os pontos azuis são gravações; os verdes, recargas. Em cima, uma gravação solta recarrega logo. Embaixo, três gravações do Claude viram uma recarga só, no fim do turno, para o turno poder experimentar o que escreveu.

No app desktop, ou numa sessão aberta por SDK, não há onde digitar uma flag. Para esses casos existe CLAUDE_CODE_PLUGIN_DIRS: cada pasta listada carrega exatamente como um --plugin-dir.

Use caminhos absolutos (o ~ é aceito), separados pelo separador de listas do sistema: : no Linux e no macOS, ; no Windows. O valor vem do ambiente do processo ou do bloco env do ~/.claude/settings.json. Nunca do settings de um projeto.

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "/home/rafa/mods/meu-contador"
  }
}

Instalar é para o mod ficar ligado em toda sessão. Primeiro você adiciona um marketplace, depois instala um plugin dele pelo nome plugin@marketplace.

O que muda tudo é de onde o marketplace vem. Se é uma pasta e a entrada do plugin é um caminho relativo, o mod é lido da própria pasta. Se vem de um repositório, roda a cópia feita na instalação.

claude plugin marketplace add . --scope user
claude plugin install terminal-pet@claude-mods-kit --scope user
claude plugin list

Como ler o desenho: a linha de cima tem dois passos; a de baixo, quatro. Quem desenvolve quer a de cima. Quem distribui para outras pessoas vive na de baixo (módulo 4.4). Para adicionar um marketplace de repositório, o comando é o mesmo, com <dono/repo> no lugar do ..

O --scope diz onde a instalação fica gravada e, portanto, quem recebe o mod. São três opções: user, project e local.

O conselho do Starter Kit é simples: escolha o escopo que você quer de fato. Não instale nos três "por garantia". Depois, para desligar, você vai ter de lembrar de cada um.

O que olhar na tabela: project é o único que sai da sua máquina. As configurações do projeto podem ir para o repositório com o próximo commit. Revise antes de commitar.

claude plugin marketplace add <pasta-do-kit> --scope project
claude plugin install changes-receipt@claude-mods-kit --scope project

Desligar (disable) tira o mod das próximas sessões e mantém a instalação. Desinstalar (uninstall) remove a instalação no escopo escolhido. Os dois valem por escopo: repita em cada um onde instalou.

O scripts/manage.sh do Starter Kit faz isso para os dez mods de uma vez. Ele aceita install, enable, disable e uninstall, e no uninstall passa --keep-data para não apagar preferências sem avisar.

O que olhar na tabela: a última linha engana. Esconder um painel não para o mod de observar. Para parar de vez, use uma das três primeiras.

claude plugin disable terminal-pet@claude-mods-kit --scope user

bash scripts/manage.sh disable user all