GUIA / PRIMEIROS PASSOS

Configure seu Mupli.

Ligue na tomada, aponte a câmera do celular para o QR code da tela e conecte ao Claude Code. Cada passo diz o que aparece na tela do Mupli.

Antes de começar

Claude Code no computador
No terminal, na aba Code do app Claude ou nas extensões para VS Code, Cursor e JetBrains. Funciona em macOS, Linux e Windows, inclusive no WSL.
O plugin do Mupli no Claude Code
É ele que traz os comandos /mupli e conversa com o aparelho. Ainda não tem? Fale com a equipe antes de começar.
Uma fonte USB de 5 V / 1 A
Carregador de celular, porta de notebook ou hub USB sem fonte própria podem ser fracos demais.
Wi-Fi de 2,4 GHz com WPA2
Com a senha em mãos. O computador precisa estar nessa mesma rede.
Um celular com câmera
Para ler o QR code da tela e escolher o Wi-Fi do Mupli.

Sessões do Claude na nuvem, como as do claude.ai/code, não alcançam o Mupli: elas rodam longe do seu computador e da sua rede.

Você não precisa de conta neste site para configurar ou usar o Mupli.

Passo 1: Ligue e escaneie

Conecte o Mupli à fonte USB e ligue na tomada. A tela mostra “Olá!”, um QR code e, embaixo, o nome da rede de configuração, como Mupli-Setup-4F2A.

Aponte a câmera do celular para o QR code e aceite entrar na rede. A página “Configurar o Wi-Fi do Mupli” abre no celular.

A câmera não abriu a página? Nas configurações de Wi-Fi do celular, entre na rede Mupli-Setup que aparece na tela.

Mupli laranja mostrando QR code para iniciar a configuração pelo celular.

Passo 2: Escolha seu Wi-Fi

Na página que abriu no celular, escolha sua rede, digite a senha e toque em “Conectar”.

Use a mesma rede do computador: é por ela que o Claude Code encontra o Mupli. A rede precisa ser de 2,4 GHz e usar WPA2. Se o roteador estiver no modo “WPA2/WPA3” e recusar a conexão, mude para WPA2.

Quando conectar, a tela do Mupli mostra “Wi-Fi conectado”, o código de pareamento de 4 dígitos e o endereço do aparelho na rede (IP). Deixe essa tela à vista: o código é usado no próximo passo.

No celular (ilustração)

Configurar o Wi-Fi do Mupli

Escolha sua rede: A mesma do computador.
Senha: A senha do seu Wi-Fi.
Fuso horário e Idioma: Já vêm do celular.
Conectar: Depois, olhe a tela do Mupli.

Passo 3: Conecte ao Claude Code

No computador, abra o Claude Code e digite /mupli:pair.

Ele procura o Mupli na sua rede e pede o código de 4 dígitos da tela. Se houver mais de um Mupli, você escolhe qual. Digite o código: a tela mostra “Pareado com” e o nome do seu computador.

Em seguida, vêm duas perguntas opcionais: como chamar o aparelho (até 20 caracteres) e seu primeiro nome e aniversário, para o Mupli te dar bom-dia e os parabéns no dia. Pulou? Use /mupli:rename e /mupli:owner quando quiser.

Pronto. Na próxima atividade do Claude Code, suas sessões aparecem no Mupli. Não encontrou o aparelho? Veja os problemas comuns.

O comando /mupli:pair não aparece no Claude Code? Fale com a equipe.

Mupli laranja mostrando confirmação de conexão com o computador.

Passo 4: Veja seus limites

Ainda no /mupli:pair, o Claude Code pergunta se pode ligar a linha de status. É dela que vêm os limites, o contexto e o custo. Para ver seus limites, aceite.

Sua linha de status continua exatamente igual. Se preferir pular, você ainda vê as sessões e os alertas, só não vê os limites.

Mudou de ideia? Ligue depois com /mupli:link-statusline e desfaça quando quiser com /mupli:unlink-statusline. Vai remover o plugin do Mupli? Rode antes o /mupli:unlink-statusline.

Nos planos Pro e Max, o Mupli mostra o limite de 5 horas e o da semana. Com chave de API, mostra o custo do dia.

Esses dados vêm só da linha de status oficial do Claude Code e ficam na sua rede: sem nuvem e sem cadastro.

Mupli laranja mostrando consumo e horário de renovação dos limites.

Depois de conectar

Deixe o Mupli do seu jeito

Abra a página de configurações

No Claude Code, digite /mupli:settings ou peça ao Claude para abrir as configurações do Mupli. A página abre no navegador. O próprio /mupli:pair oferece abri-la no fim do pareamento.

Quer abrir pelo celular? No computador, digite /mupli:find no Claude Code e aponte a câmera do celular para o QR code que aparece na tela do Mupli por 10 segundos. Em aparelhos da mesma rede, o endereço http://mupli.local também lista os Muplis por perto (nem todo Android abre esse endereço).

Para mudar qualquer configuração, a página pede o código de 4 dígitos que aparece na tela do Mupli. Assim, só quem está na frente dele muda alguma coisa.

Lá você ajusta brilho, alertas, modo discreto (esconde comandos e arquivos), modo noturno, filtro de luz azul, lembretes de pausa, de água e de descanso dos olhos, um segundo relógio, o idioma da tela, o nome do aparelho, e seu nome e aniversário.

Escolha seu bichinho

No cartão “Bichinho”, escolha um dos 15 companheiros que ficam na tela:

Gato
Patinho de borracha
Bug (besouro)
Daemon (fantasminha)
Robô
Caneca de café
Pinguim
Caranguejo
Coruja
Cachorro
Alienígena
Riff
Dev
Dino
Dev-chan

Cores: uma paleta pronta (pêssego, laranja, preto ou cinza) ou uma cor para cada parte, como corpo, contorno, olhos e nariz ou bico. Cada parte também pode ficar em “Automático”.
Olhos: redondos, grandes e brilhantes ou sonolentos.
Acessórios: um na cabeça, um no rosto e um no pescoço, como boné, coroa, óculos de sol, headset gamer, gravata-borboleta ou a medalha “Subiu pra produção”.
Datas especiais: no Natal, no Halloween e no Ano-Novo, ele usa o chapéu do dia. Para manter só as suas escolhas, desligue “Datas especiais vestem o pet”.

Antes de salvar, toque em “Ver no Mupli”: o resultado aparece na tela do aparelho por 15 segundos.

Mupli laranja mostrando relógio, limites e mascote entre tarefas.

Comandos do dia a dia

Digite estes comandos no Claude Code.

/mupli:status: Mostra se está tudo conectado: seus Muplis, as sessões ativas, os limites e o resumo do dia.
/mupli:today: Resumo do dia no terminal: respostas concluídas, tempo com o Claude trabalhando e custo.
/mupli:limits: Limites de 5 horas e da semana, quando renovam e, no ritmo atual, a que horas acabam.
/mupli:mode: Escolhe a tela principal do Mupli: visão geral (overview), limites (limits) ou sessões (sessions).Ex.: /mupli:mode limits
/mupli:rotate: Na visão geral, mostra a tela de limites por alguns segundos, de tempos em tempos. Sem nada depois do comando, ele mostra opções prontas.Ex.: /mupli:rotate on 60 10 · /mupli:rotate off
/mupli:focus: Foco no estilo Pomodoro, contado no próprio Mupli: 25 min de foco e 5 de pausa, em 4 rodadas.Ex.: /mupli:focus 50 · /mupli:focus stop
/mupli:meeting: Modo reunião por 60 min: a tela esconde nomes de projetos e comandos, mas continua avisando quando uma sessão precisa de você.Ex.: /mupli:meeting 30 · /mupli:meeting off
/mupli:say: Um recado de até 40 caracteres para quem passa pela sua mesa. Fica 30 min na tela.Ex.: /mupli:say volto em 10 min · /mupli:say off
/mupli:remind: Lembrete daqui a alguns minutos ou num horário. Também cria alarmes para todo dia ou para dias úteis.Ex.: /mupli:remind 15:30 reunião · /mupli:remind 20 alongar
/mupli:timer: Contagem regressiva grande na tela, de 1 a 180 min.Ex.: /mupli:timer 25
/mupli:countdown: Conta os dias até uma data e mostra na tela, como “férias em 3 dias”.Ex.: /mupli:countdown férias 20/12
/mupli:find: O Mupli pisca, acena e mostra o QR code da página de configurações por 10 segundos.
/mupli:rename: Dá outro nome ao aparelho, com até 20 caracteres: o Claude pergunta o novo nome. O nome aparece na tela.
/mupli:owner: Conta ao Mupli seu primeiro nome e seu aniversário (dia/mês), para o bom-dia e os parabéns. Os dois ficam só no aparelho.Ex.: /mupli:owner --name Ana --birthday 14/03
/mupli:night: Modo noturno: diminui o brilho entre dois horários. Sem nada depois do comando, ele mostra opções prontas.Ex.: /mupli:night on 22:00 07:00 10%
/mupli:blue: Filtro de luz azul: deixa as cores mais quentes, sempre ou num horário, de 1% a 100%.Ex.: /mupli:blue 40% · /mupli:blue 21:00 07:00

Dica: você também pode pedir ao Claude com suas palavras, como “deixa o Mupli em modo reunião por uma hora”.

Problemas comuns

O /mupli:pair não encontra o Mupli

Confira se o Mupli está ligado, mostrando o código de pareamento, e na mesma rede do computador. VPN, rede de empresa e WSL2 costumam bloquear a busca. Nesse caso, coloque depois do comando o IP que aparece embaixo na tela do Mupli, por exemplo /mupli:pair 192.168.0.42.

A tela mostra “Senha incorreta”

Aponte a câmera para o QR code de novo e digite a senha outra vez.

A tela mostra “Rede não encontrada”

O Mupli só enxerga redes de 2,4 GHz. Ligue a faixa de 2,4 GHz no roteador ou use uma rede separada de 2,4 GHz. Se der, aproxime o Mupli do roteador.

A tela mostra “Conexão recusada”

Confira a senha. Se o roteador usa WPA3 ou o modo “WPA2/WPA3”, mude para WPA2: o Mupli não funciona com WPA3.

A tela mostra “Não foi possível conectar”

Houve outra falha de conexão, e a tela mostra o código do erro. Confira a rede e tente de novo pelo QR code de configuração.

Os limites não aparecem

Rode /mupli:status para ver se a linha de status está ligada. Se não estiver, rode /mupli:link-statusline. Os limites aparecem depois da próxima resposta do Claude. Os limites de 5 horas e da semana só existem nos planos Pro e Max; com chave de API, o Mupli mostra o custo do dia.

A tela mostra “Desconectado”

O Mupli ficou 30 segundos sem notícias do computador. A conexão volta sozinha na próxima atividade do Claude Code. Para conferir, rode /mupli:status.

A linha de status ficou em branco

Acontece quando o plugin do Mupli sai do Claude Code antes de desfazer a ligação com a linha de status. Antes de remover o plugin, rode /mupli:unlink-statusline: ele devolve a sua linha de status original. Se já removeu, fale com a equipe.

O Claude Code diz que o Mupli não aceita mais este computador

O Mupli foi resetado ou perdeu o pareamento com este computador. Rode /mupli:pair de novo.

O Wi-Fi caiu ou você trocou de roteador

Desligar da tomada não apaga nada. Depois de 5 minutos fora da rede, o Mupli volta a mostrar o QR code de configuração, sem deixar de tentar a rede salva. Para trocar de rede, aponte a câmera para o QR code e escolha a nova. Como ele já foi configurado, a página pede o código da tela: toque em “Código na tela” e digite os 4 dígitos. Não precisa resetar.

O Mupli reinicia sozinho

Use uma fonte USB de 5 V / 1 A. Carregador de celular, porta de notebook ou hub sem fonte própria podem falhar nos picos do Wi-Fi. Quedas seguidas contam como ligadas rápidas, e seis delas apagam tudo (veja Recomeçar do zero).

Tenho mais de um Mupli. Qual é qual?

Dê um nome para cada um com /mupli:rename: o nome aparece na tela. E /mupli:find faz o Mupli piscar e acenar por 10 segundos.

Recomeçar do zero

O reset de fábrica apaga Wi-Fi, pareamentos e configurações. O Mupli volta a mostrar o QR code de configuração, e você repete os passos 1 a 3. Desligar da tomada não apaga nada.

No Claude Code: /mupli:reset seguido do id do aparelho, que o /mupli:status mostra. Ele pede confirmação antes.
Na página de configurações: “Reset de fábrica”, confirmado com o código da tela.

Sem computador

Use quando não conseguir mais chegar ao Mupli, por exemplo depois de mudar de rede ou perder o pareamento. Você só precisa do cabo de energia.

Ligue o Mupli, espere uns 2 segundos até a tela acender e desligue. Cada vez precisa durar menos de 10 segundos.
Repita até ligar 6 vezes seguidas.
A partir da 3ª vez, a tela mostra uma contagem em âmbar: “Reinícios rápidos restantes para resetar”.
Na 6ª, o Mupli apaga tudo e reinicia no QR code de configuração.

Para cancelar, deixe o Mupli ligado por 10 segundos em qualquer momento: a contagem volta a zero.