Como configurar o onboarding de utilizadores com o Claude Code sem programador
Um fluxo completo de primeira sessão com o Claude Code — boas-vindas, primeira ação guiada e lista de primeiros passos — com três itens do Clew que acompanham o utilizador pela app, em vez de um tour comprido no carregamento.
- Tempo
- ● 40 minutos
- Preço
- Tours grátis · resto no teste de 14 dias
- Quem faz
- O Claude Code, sem programador
Exemplo: onboarding de utilizadores com o Claude Code
Um SaaS de faturamento mantido com o Claude Code. Boas-vindas em /invoices, um tour de /invoices/new e um checklist na segunda visita para quem ainda não enviou fatura.
A parte do tour de produto é grátis no plano Free (até 3 publicados). Modal, Checklist e as regras de público fazem parte do Pro: toda conta nova tem 14 dias de teste com tudo incluído, sem cartão. Quando o teste acaba, nada é apagado e o que foi publicado continua a aparecer.
Como configurar o onboarding de utilizadores com o Claude Code, passo a passo
- Passo 01
Copie o seu snippet do Clew
Crie uma conta gratuita (ou entre), adicione o seu site e abra Visão geral no admin. Clique na linha do cartão O widget ainda não deu sinal. para copiar: ela já vem com a chave real do seu site no lugar do marcador.
<!-- Clew: substitua COLE_AQUI_A_SUA_CHAVE pela chave do site em Admin > Visão geral --> <script src="https://tryclew.io/widget/COLE_AQUI_A_SUA_CHAVE.js" async></script>

Passo 1 · ilustração esquemática - Passo 02
Inicie o Claude Code no projeto
Execute
claudena pasta do projeto (ou abra o Claude Code na sua IDE). Ele trabalha no seu repositório real e pede permissão antes de editar ficheiros.
Passo 2 · ilustração esquemática - Passo 03
Envie o prompt com a sua chave
Substitua
COLE_AQUI_A_SUA_CHAVEpela sua chave e envie o prompt.Adicione o widget de onboarding do Clew a esta app. Insira esta tag exata uma única vez, para que carregue em todas as páginas, inclusive depois de mudanças de rota no cliente: <script src="https://tryclew.io/widget/COLE_AQUI_A_SUA_CHAVE.js" async></script> Encontre o ficheiro HTML raiz ou o layout raiz deste projeto (index.html no Vite, app/layout.tsx com next/script no Next.js App Router, app.head.script do nuxt.config.ts no Nuxt, src/app.html no SvelteKit, o template base em apps renderizadas no servidor) e adicione a tag ali. Depois do login, chame Clew.identify() com propriedades não pessoais como strings que diferenciem um utilizador novo de um antigo, por exemplo { signup_source: "web", onboarded: "false", role: "owner" }, e atualize onboarded para "true" quando o utilizador concluir a ação principal. Se o widget ainda puder não ter carregado, defina antes o stub de fila: window.TutorKit = window.TutorKit || { q: [], identify: function (p) { this.q.push(["identify", p]); } }; e chame window.TutorKit.identify(...). Adicione também atributos data-tour à navegação principal e ao botão principal de criar. Nunca envie nomes nem e-mails. Regras: - Use a URL do script exatamente como está. Não transfira, não empacote e não instale um pacote npm. - Se o projeto define uma Content-Security-Policy, permita https://tryclew.io em script-src e connect-src. - Não mude mais nada e me mostre o diff.
Passo 3 · ilustração esquemática - Passo 04
Aprove as edições e publique
Aprove as edições propostas depois de ler, faça commit e deploy como sempre, ou peça ao Claude Code para abrir um pull request.

Passo 4 · ilustração esquemática - Passo 05
Crie os três itens do onboarding
Em Fluxos crie três itens: um Janela modal com uma frase de boas-vindas e um link para o ecrã principal; um tour Tooltips passo a passo de 3–4 passos nesse ecrã, feito com Editar no seu site e Escolher elemento; e um Checklist de onboarding com as tarefas de configuração que faltam.

Passo 5 · ilustração esquemática - Passo 06
Escolha onde, quando e para quem aparece
No mesmo editor, preencha Onde mostrar (URL da página), Quando mostrar, Segmentação de público e Frequência. Estas são as configurações do exemplo acima:
Configuração Valor Pop-up de boas-vindas Formato Janela modal Onde mostrar (URL da página) Caminho exato /invoicesQuando mostrar Logo ao carregar a página Segmentação de público Sem regras: toda nós que abre a página Frequência Uma vez por visitante Tour do produto Formato Tooltips passo a passo Onde mostrar (URL da página) Secção por prefixo /invoices/newQuando mostrar Logo ao carregar a página Segmentação de público Sem regras: toda nós que abre a página Frequência Uma vez por visitante Checklist Formato Checklist de onboarding Onde mostrar (URL da página) Secção por prefixo /invoicesQuando mostrar Na N.ª visita: 2 Segmentação de público Propriedade first_invoice_senté diferente detrueFrequência Uma vez por visitante 
Passo 6 · ilustração esquemática - Passo 07
Publique e verifique no site real
Mude Estado para Publicado e guarde. Abra a página numa janela anónima: o Clew lembra quem já viu um item de “uma vez”, por isso o seu navegador de sempre pode saltar. Visualizações, conclusões e abandonos aparecem nas estatísticas.

Passo 7 · ilustração esquemática
Armadilhas: onboarding de utilizadores com o Claude Code
Artefatos do Claude.ai não são a sua app
Código num chat ou artefato do Claude.ai é executado num sandbox e não é publicado para os seus utilizadores. Instale o Clew no projeto real com o Claude Code, de onde a mudança chega à produção.
Não coloque a chave no CLAUDE.md
A chave do site é pública, mas o lugar dela é a página, não as instruções do projeto que são reaproveitadas em outros repositórios.
As boas-vindas não podem aparecer para utilizadores antigos
“Uma vez por visitante” vale por navegador: um cliente antigo num notebook novo é um visitante novo. Se a sua app conhece o utilizador, adicione uma regra sobre uma propriedade como onboarded para os antigos saltarem as boas-vindas.
Não dispare tudo na mesma página
Se o pop-up, o tour e o checklist coincidem com a mesma URL, só um começa e os outros esperam. Dê a cada um a sua página ou acionador, como na tabela acima.
Perguntas e respostas
O Claude Code consegue cuidar do indicador onboarded?
Sim, faz parte do prompt: ele muda a propriedade quando a primeira fatura é enviada.
Preciso de um plano pago do Claude?
O Claude Code está disponível com as assinaturas do Claude e com acesso à API; para o Clew é indiferente qual usa.
Quais partes são grátis?
Tours são grátis no plano Free. O pop-up de boas-vindas, o checklist e as regras de público estão no Pro; o teste de 14 dias inclui tudo, sem cartão.
Quanto tempo leva?
Uns quarenta minutos para a primeira versão: dez para o pop-up, vinte para o tour e dez para o checklist. Depois, melhore pelo funil.
O que mais é possível adicionar com o Claude Code
- Como criar um tour do produto com o Claude Code sem programador
- Como adicionar um checklist de onboarding com o Claude Code sem programador
- Como criar um aviso de paywall com o Claude Code sem programador
Onboarding de utilizadores em outras plataformas
- Google Tag ManagerComo configurar o onboarding de utilizadores com o Google Tag Manager sem programador
- LovableComo configurar o onboarding de utilizadores numa app do Lovable sem programador
- Bolt.newComo configurar o onboarding de utilizadores numa app do Bolt.new sem programador
- v0Como configurar o onboarding de utilizadores numa app do v0 sem programador
- ReplitComo configurar o onboarding de utilizadores numa app do Replit sem programador
- CursorComo configurar o onboarding de utilizadores numa app feita no Cursor sem programador
- ChatGPT CodexComo configurar o onboarding de utilizadores com o ChatGPT Codex sem programador
- Qwen CodeComo configurar o onboarding de utilizadores com o Qwen Code sem programador