Instalação do plugin
Compatível com ww1.14.0
Instalação do plugin /ww
Seção intitulada “Instalação do plugin /ww”O plugin /ww é instalado pelo wisework, o instalador de linha de comando da plataforma WiseWork. Um único comando conecta a máquina à sua conta, instala o plugin da sua instância, registra a conexão com o WiseWork e ajusta as preferências do Claude Code. Quem decide qual plugin a sua instância recebe é a plataforma; nas instâncias que usam o /ww, é ele que o instalador traz. Se algum passo travar, veja a tabela de erros e remediação.
Pré-requisitos
Seção intitulada “Pré-requisitos”- Node.js 18 ou mais recente (o instalador roda com
npx). - Claude Code 2.1.238 ou mais recente, instalado e no PATH.
- Acesso à sua conta na plataforma WiseWork pelo navegador, para gerar o código de pareamento.
python33.7 ou mais recente egit. O instalador confere esses dois e o Node, mas não os instala.
Não é preciso conta no GitHub nem token no ~/.npmrc: a credencial vem da própria plataforma.
1. Instalar
Seção intitulada “1. Instalar”npx -y wisework@latest install --slug=<slug>O <slug> é o identificador da sua instância WiseWork: acme para acme.wisework.ia.br. O -y é do próprio npx e só dispensa a confirmação de download do pacote; o @latest garante que o npx use a versão mais recente do instalador, e não uma cópia antiga guardada no cache.
Na primeira vez, o instalador conecta a máquina à sua conta:
- Pressione Enter: o navegador abre a página de pareamento da sua instância (faça login se for pedido).
- Copie o código exibido na página e digite-o no terminal.
A conexão fica salva na máquina, e as próximas execuções não pedem o código de novo. Nenhum token precisa ser copiado ou colado.
O que o instalador faz
Seção intitulada “O que o instalador faz”Depois do pareamento, o instalador:
- Instala o plugin. Adiciona ao Claude Code o marketplace servido pela plataforma (
wiseworkno canal estável,wisework-betacom--channel=beta), com a atualização automática ligada, e instala por ele o plugin da sua instância. - Configura o acesso ao WiseWork. Registra o servidor MCP
workforceno escopo de usuário, já com o endereço da sua instância e o seu token, e ajusta no~/.npmrca credencial que ele usa para baixar o pacote. Se o MCPworkforcejá foi registrado pelo instalador, ele é mantido quando o token é o mesmo e trocado quando muda; um registro feito por fora só é substituído depois de perguntar.--skip-mcppula esta etapa. - Copia os arquivos de configuração que o plugin declara para
~/.claude/(CLAUDE.md,RULES.md,MCP.mde os demais). Se você editou um desses arquivos, o instalador pergunta se sobrescreve (com backup em~/.claude/backups/<data>/) ou mantém o seu. - Faz perguntas de preferência, todas com um valor sugerido que o Enter aceita: instalação do RTK, dos servidores LSP de TypeScript e Python e de ferramentas de apoio (como
jq,gh,uveplaywright); nome, idioma, fuso horário, idioma e verbosidade de commits, PRs e reviews, e backup da transcrição antes de cada compactação.
No fim, aparece um resumo com o que foi feito e o comando sugerido para começar. Rodar o instalador de novo completa o que faltou: plugin e conexão já configurados são mantidos, e as perguntas são refeitas. Para automação, --yes aceita os valores sugeridos sem perguntar; as flags de cada pergunta estão em npx -y wisework@latest --help.
2. Reiniciar o Claude Code
Seção intitulada “2. Reiniciar o Claude Code”O plugin e o servidor MCP só carregam no início da sessão. Saia e reabra o Claude Code (Ctrl+C no terminal e reabrir; ou fechar e abrir o app desktop).
3. Verificar
Seção intitulada “3. Verificar”# Num novo Claude Code (após reiniciar):/ww:initVocê deve ver:
- O nome do seu membro
- O projeto fixado
- Suas tasks abertas
No terminal, npx -y wisework@latest status mostra o que está instalado, divergente ou pendente.
4. Configurar preferências do projeto (opcional)
Seção intitulada “4. Configurar preferências do projeto (opcional)”/ww:config:preferencesConfigura .claude/settings.local.json com defaults sensatos. Opcional, mas recomendado.
Atualizar
Seção intitulada “Atualizar”Versões novas do plugin chegam sozinhas, pela atualização automática em segundo plano do Claude Code. Essa atualização não toca nos arquivos que o instalador copiou para ~/.claude/. Para atualizar na hora, incluindo esses arquivos:
npx -y wisework@latest updateO update usa a conexão salva, atualiza o marketplace e o plugin pelo Claude Code e copia de novo os arquivos de configuração quando a versão do plugin muda. Reinicie as sessões do Claude Code depois. Para refazer só as perguntas de preferência, sem tocar no plugin, use npx -y wisework@latest setup.
Quando usar o /ww:config:mcp
Seção intitulada “Quando usar o /ww:config:mcp”Com o instalador, o MCP já sai configurado e o /ww:config:mcp não é necessário. Ele continua disponível para registrar o servidor à mão — por exemplo, se você instalou com --skip-mcp.
Migrar de uma instalação antiga
Seção intitulada “Migrar de uma instalação antiga”Instalado com npx -y wisework@latest install ww <slug>. Esse fluxo continua funcionando: para seguir nele, atualize com npx -y wisework@latest update ww. Para passar ao fluxo novo, remova antes o marketplace local anterior e rode o install:
claude plugin marketplace remove wiseworknpx -y wisework@latest install --slug=<slug>Sem essa remoção, o install --slug para com um aviso: o marketplace wisework já está registrado com outra origem.
Instalado pelo marketplace dr-marketplace (ww@dr-marketplace). O instalador não remove essa cópia. Desinstale-a antes de rodar o install, para não ficar com dois /ww ativos:
claude plugin uninstall ww@dr-marketplacenpx -y wisework@latest install --slug=<slug>Desinstalar
Seção intitulada “Desinstalar”npx -y wisework@latest uninstall --allRemove o plugin, o marketplace, o MCP que o instalador registrou e os arquivos de configuração que você não editou, além de desconectar a máquina da conta (os tokens do pareamento são revogados na plataforma). Arquivos editados por você, os backups em ~/.claude/backups/ e as ferramentas de apoio instaladas ficam.