Sua Central de Tarefas,
construída com o Claude Code
Uma página com login pra você e pra sua equipe, mais um robô que lê o seu WhatsApp, texto e áudio, e lança as tarefas sozinho. Mas o projeto é desculpa: o que você leva é o processo.
Os blocos de hoje
Preparação guiada
Tudo isto a gente faz junto, na aula, uma coisa de cada vez. O único pedido antes do dia era conferir a aba Code no app. O resto está aqui por escrito, pra você ter.
1. Conferir o app
Abra o aplicativo do Claude no computador (o mesmo que você já usa). No topo, ao lado de Chat e Cowork, precisa aparecer a aba Code. Se não aparecer, seu plano ainda não tem o Claude Code: acompanhe a aula e faça depois.
2. Criar a pasta-mãe dos seus projetos
Projetos Claude3. Abrir a pasta no Claude e pedir o Node e o Git
Você nem precisa saber instalar: quem instala é o próprio Claude. Você pede, e ele instala. É assim o dia inteiro hoje.
Projetos Claude.22.x, o Git tipo 2.55.x).Se aparecer a palavra Homebrew na resposta: é uma "loja de programas" do Mac que funciona por texto, sem vitrine. O Claude usa ela pra instalar coisas. Você não vai mexer nela.
4. Criar a conta grátis na Cloudflare
É o lugar na internet onde a sua Central vai ficar publicada, de graça.
5. Conferir o Node, o Git e ter em mãos
Volte ao Code: ele já deve ter respondido as duas versões. Se não respondeu, pergunte:
Pro resto do dia, deixe por perto:
O Claude não conseguiu instalar o Git, e você está no Mac? Peça a ele:
Rode o comando de instalar as ferramentas de linha de comando pra mim. Vai abrir a janelinha da Apple acima. Clique em Instalar. Não vá no site do Git: a página do Mac lá não tem botão de baixar, só instruções de terminal.O Claude não conseguiu instalar o Git, e você está no Windows? Aí sim tem botão: git-scm.com/install/windows → o link grande Click here to download no topo → abrir o arquivo baixado → Next até o fim, sem mudar nada → Install. Depois volte no Claude:
Confira o Git de novo.O Claude pediu a senha do computador e não tem onde digitar? Plano B pelo site: nodejs.org → botão grande LTS → abrir o arquivo → Continuar até o fim → senha do computador na janelinha → "Instalação concluída". Depois volte no Claude e peça:
Confira o Node de novo. Se ele não achar, feche e reabra o app do Claude.O instalador do site não abre (Mac: "desenvolvedor não identificado")? Botão direito → Abrir → Abrir.
A instalação está demorando muito? Pode levar uns 10 min. Segue com a Cloudflare; o Node só é usado de verdade no Bloco 3.
O e-mail da Cloudflare não chega? Olha o spam, reenvia, confere no intervalo. Só trava o Bloco 4.
O Windows pergunta "permitir alterações?" Sim. É normal.
Checklist do Bloco 0
O Claude Code
no app
Você abre a pasta-mãe no Code, entende o que o Claude enxerga e faz a primeira pergunta.
Chat × Code
No Chat, o Claude conversa com você. No Code, o Claude trabalha dentro de uma pasta do seu computador: ele lê os arquivos, cria arquivos, roda programas. É a diferença entre um consultor e um funcionário sentado na sua mesa.
A regra da pasta
É a regra mais importante do dia.
Projetos Claude.
Dentro da pasta-mãe: uma pasta por projeto, com nomes curtos, sem acento e sem espaço (bio-link, ignis-central, central-tarefas). Eu tenho uns 40 projetos assim. Em todo projeto novo, o caminho é o mesmo: Select folder → Local → a pasta do projeto.
Os três modos
Na tela do Code você tem: onde se escreve, a barra lateral de sessões e, ao lado do botão de enviar, o seletor de modo. São três modos, e você escolhe ali, no botão, nunca dentro do texto.
| Modo | O que faz | Quando usar |
|---|---|---|
| Manual | Ele pede antes de mexer em qualquer arquivo. | É o que vamos usar hoje. |
| Plan | Ele só lê e propõe. Não mexe em nada. | Pra começar qualquer coisa grande. |
| Auto | Ele decide sozinho o que é seguro. | Pra quando você já confia no que ele faz naquele projeto. |
A primeira conversa
Com a pasta Projetos Claude aberta, cole:
Ele lista o que tem na pasta e descreve. Na sua, ainda vazia, ele diz isso, e pode comentar o Node que acabou de instalar. Manda um print da resposta no chat da turma.
Projetos Claude.O Mac pede pra instalar "ferramentas de linha de comando"? Clique em Instalar e espere (5 a 10 min). É a Apple instalando o Git, igual no Bloco 0. Enquanto isso, acompanha pela minha tela.
Checklist do Bloco 1
Memória:
o CLAUDE.md
Você cria o seu arquivo de regras globais ("Quem sou eu / Como trabalho / Regras minhas") e entende que todo projeto vai ter o seu.
O que é o CLAUDE.md
O Claude tem amnésia. Toda conversa nova, ele nasce de novo. O CLAUDE.md é o briefing que ele lê antes de começar qualquer conversa. É onde você diz quem você é, como gosta de trabalhar e quais são as suas regras. Quem tem um bom CLAUDE.md não precisa repetir as mesmas coisas todo dia.
E ele descreve a pessoa, não só o projeto. No meu tem, por exemplo: "Não é técnica. Precisa de passo a passo claro."
Dois níveis
~/.claude/CLAUDE.mdVale pra todos os projetos: "quem sou eu", minhas regras.
Projetos Claude/central-tarefas/CLAUDE.mdVale só pra este projeto: o que é, como roda, decisões.
O que entra e o que não entra
A história do Pixel
Toda vez que você sofrer por alguma coisa, a pergunta é: como eu transformo isso numa linha do CLAUDE.md?
Criando o seu CLAUDE.md global
Com a pasta Projetos Claude aberta, preencha os colchetes em laranja e cole. Ele vai pedir permissão pra escrever fora da pasta (você está em Manual): aprove. Ele pediu porque é fora da pasta aberta. Depois, digite /memory e veja o arquivo aparecer lá.
Como ele se mantém vivo sozinho
Repara no que você acabou de escrever ali em cima, na seção "Memória do projeto (faça sozinho, sem eu pedir)": você mandou ele anotar sozinho no fim de cada etapa, sem você precisar pedir. Essa é uma regra que você escreve uma vez na vida e vale pra todos os projetos que você fizer daqui pra frente. É esse arquivo que transforma o Claude de "assistente com amnésia" em "sócio que lembra".
Ainda assim, guarde duas frases pra quando você quiser garantir:
Quando você abrir um projeto que já existe e não tem CLAUDE.md, digite /init: o Claude lê tudo e escreve o primeiro rascunho. Você só revisa.
Como a informação chega na conversa nova
Você não precisa "carregar" nada. Toda conversa nova com a pasta aberta, o Claude lê sozinho, antes da sua primeira mensagem: o seu CLAUDE.md global, o CLAUDE.md daquela pasta e as anotações que ele mesmo guarda do projeto. O trabalho está antes de fechar: o que não foi registrado, morreu com a conversa. Por isso a regra que você acabou de escrever é a coisa mais valiosa do dia.
A regra de bolso pra amanhã
Tarefa nova = conversa nova. Ela nasce mais limpa, ele fica mais esperto, e o CLAUDE.md ele já lê sozinho. Tarefa pela metade = volta na conversa antiga, pela barra lateral, porque é ela que tem o histórico do que ficou no meio.
E na conversa nova, a primeira frase é sempre esta (não precisa explicar nada do projeto, ele lê e te conta):
O Claude não pediu permissão e escreveu direto? Você estava em Auto. Volta pra Manual no seletor.
Já existia um CLAUDE.md global? Ele mostra e pergunta. Você decide.
Checklist do Bloco 2
Construindo
a sua Central
A Central rodando no seu computador, com tarefas de demonstração, login com dois papéis e a porta de entrada do robô. E o Claude anotando tudo sozinho no CLAUDE.md do projeto.
O processo ideal, do começo ao fim
Agora vamos fazer o processo inteiro: criar a pasta → abrir no Code → planejar no modo Plan → descrever o que eu quero → ler o plano → construir em etapas pequenas → ver no navegador → registrar no CLAUDE.md. Esse é o processo. Decora ele, não o projeto.
Hoje de manhã a Central existe só no seu computador. No Bloco 4 a gente publica na Cloudflare, de graça, pra sua equipe ver.
1. Criar a pasta do projeto
Com a Projetos Claude aberta:
Depois, Select folder → Projetos Claude/central-tarefas. Cada projeto, sua pasta, aberta sozinha. A pasta-mãe é só pra organizar.
2. Ligar o modo Plan
No seletor de modo, escolha Plan. Briefing novo = Plan ligado. Ele não pode mexer em nada; só pensar. Isso é escolhido aqui, no botão, nunca pedido dentro do texto.
3. Colar o briefing
Preencha os colchetes em laranja (nomes da equipe, nome da Central, cores) e cole:
4. Lendo o plano
Ele lê, talvez faça uma ou duas perguntas, e apresenta o plano. Leia o plano inteiro. Você não precisa entender os nomes técnicos; precisa conferir se o plano cobre tudo que você pediu, inclusive o robô. São três conversas que você vai ter pro resto da vida com qualquer plano:
Outras que valem a pena:
Corrigir o rumo, com linguagem de dona
Se o plano propuser algo diferente do que você quer, uma frase resolve:
Antes de aprovar, confira se o plano tem:
5. Construir em etapas
http://localhost:8810), abra no preview do app. A Central existe, com tarefas, com as suas cores.+12 −1 da edição: é ali que você vê o que ele mudou. Não precisa entender o código; precisa ver que ele só mexeu onde disse.
/clear limpa a conversa. Ele não esquece o projeto: o projeto está nos arquivos e no CLAUDE.md. Ele esquece só o blá-blá-blá, e fica mais esperto. Só use entre etapas, depois de "Registra isso no CLAUDE.md."
Instale o Node.js pra mim, versão LTS, e me explique o que está fazendo. Pode levar 5 a 10 min.O endereço local não abre?
Não abriu. Use outra porta e me dê o endereço novo.O preview do app não abre? Abra o endereço no navegador normal. Mesmo resultado.
O login fica voltando pra tela de login?
O login fica voltando pra própria tela de login, em loop. Descubra por que e conserte.Ele travou ou fez besteira grande? Esc Esc, volte pra antes da etapa, e mande de novo:
Refaz esta etapa.
Checklist do Bloco 3
Colocar no ar
Sua Central publicada numa URL própria, com login funcionando e os segredos no lugar certo.
O que é "colocar no ar"
Até agora a Central só existe no seu computador: só você vê. Pra sua equipe ver, precisa de um "computador na internet" que sirva a página. "Colocar no ar" é copiar a Central pra um computador da Cloudflare que fica ligado o dia inteiro e tem um endereço. A Cloudflare vai dar um endereço tipo sua-central.pages.dev, de graça. Depois você pode pendurar o seu domínio, mas hoje não.
Segredos: a regra de ouro
.dev.vars, e no cofre da Cloudflare. Se um segredo aparecer dentro de um arquivo de código ou no chat, algo está errado. O Claude sabe disso porque está no seu CLAUDE.md global.
No projeto você vai ver dois arquivos parecidos: o .dev.vars.example é o molde, sem valores. O .dev.vars é o de verdade, com valores, e está no .gitignore: a lista do que nunca sai daqui.
1. Conectar à Cloudflare
O navegador abre, você clica em Allow e volta pro app.
2. Publicar
sua-central.pages.dev.3. Cadastrar a equipe
Na tela de equipe da sua Central no ar (/admin/pessoas), cadastre a sua assistente com uma senha temporária. Manda pra ela por WhatsApp: link + e-mail + senha temporária. Se ela estiver online, pede pra entrar ao vivo.
4. Fechar
A frase que você vai usar pelo resto da vida do projeto, toda vez que mudar alguma coisa:
"Nome do projeto já existe"? Usa outro nome (
-2).A conexão não abre o navegador? Ele mostra um link; copia e cola no navegador.
A página no ar abre em branco?
A página no ar abre em branco, mas no meu computador funciona. Descubra por que, conserte e publique de novo.Fechou a sessão e "perdeu tudo"? Não perdeu: tudo está nos arquivos e no CLAUDE.md. Abre a pasta de novo e pergunta:
O que é este projeto e como eu rodo ele?
Checklist do Bloco 4
O robô no
seu computador
O robô rodando no seu computador, conectado ao seu WhatsApp por QR, lançando na Central publicada uma tarefa real mandada ao vivo.
Como o robô funciona
O cérebro do robô é um texto em português, dentro do projeto, que diz o que é tarefa e o que não é. Não tem mágica nem programação aí. E como é texto, você ajusta conversando, igual a tudo que a gente fez hoje.
Três verdades antes de começar
1. Próxima etapa: o robô
O robô estava no briefing desde a primeira linha. Ele entra agora como a etapa que faltava do mesmo projeto. Na mesma conversa da Central (ou numa sessão nova na mesma pasta, começando com "Leia o CLAUDE.md e me diga onde paramos."), cole:
2. Ele pede o Docker, e instala sozinho
Em algum ponto ele vai dizer que precisa de um programa chamado Docker e se oferecer pra instalar. Você só responde que sim.
Você não baixa nada, não arrasta nada, não escolhe versão, exatamente igual ao Node no começo da manhã. Se ele pedir a senha do computador, é a mesma de ligar a máquina. Se precisar que você aceite alguma janela, ele diz onde clicar.
3. A chave: uma só, e grátis
Faça este passo enquanto o Docker baixa. Lembra que no plano do Bloco 3 apareceu, sem ninguém pedir, que o robô precisa de um "cérebro" pra decidir o que é tarefa e de um jeito de transcrever os seus áudios? As duas coisas vêm do mesmo lugar: o Groq, que é grátis e não pede pagamento nenhum. É uma chave só. Agora que chegou a hora, a gente cria: você não precisava saber disso antes, o plano contou.
Pra você não se perder em menu, peça pro Claude abrir a página certa:
robo-tarefas e clique em criar.gsk_. Ela aparece só uma vez. Se perder, é só criar outra.4. Subir a Evolution
Ele cria o robô numa subpasta (normalmente robo/), escreve o arquivo que descreve as caixas (docker-compose.yml) e sobe três: a Evolution, um banco de dados e um guardador de memória. É agora que as caixas são baixadas (uns 500 MB): na primeira vez pode levar alguns minutos.
docker-compose.yml e olhe
Isso aqui é uma lista de compras. "Quero a Evolution nesta versão, um banco de dados e um Redis." O Docker lê a lista e providencia. Você nunca vai escrever isso na mão, mas é bom saber o que é quando aparecer.
Quando terminar, ele te dá um endereço: http://localhost:8080. Abra: é o painel da Evolution. Esse painel não é a sua Central. É a salinha de máquinas do WhatsApp: você entra aqui uma vez pra escanear o QR e nunca mais. Repara também que o CLAUDE.md do projeto ganhou a seção do robô.
5. A chave entra no arquivo, sem passar pelo chat
Ele vai criar o arquivo de segredos do robô (um .env) a partir de um molde e dizer: "clique no .env aqui na conversa pra abrir no editor do app, cole a sua chave no lugar indicado e salve." Você cola a sua chave, a que começa com gsk_, na linha certa. A chave vai num arquivo que fica só no seu computador. Nunca no chat, nunca num grupo.
O endereço da Central no ar e a chave da porta ele mesmo preenche. Se não preencher:
6. Conectar o WhatsApp
localhost:8080) ou como imagem na pasta. Nas duas formas serve: abra grande e escaneie.open e o Claude confirma. A sessão fica guardada dentro da caixa: da próxima vez não precisa de QR.Se ele tentar desenhar o QR em texto, peça:
7. Escolher as conversas, na sua Central
O robô começa surdo: escuta tudo, não lança nada, e só avisa a sua Central quais conversas viu passar. Quem decide é você, na tela, e não no arquivo.
Grupo da equipe). "Se não disser de quem é": numa conversa individual, a pessoa daquele chat.8. Teste real
Do celular, no grupo. Primeiro em texto, depois em áudio. O robô responde no próprio chat "✅ Tarefa registrada pra [Nome]" e a tarefa aparece na Central publicada, com o prazo. Do jeito que você já delega.
A tarefa aparece na Central com prazo de sexta.
O robô transcreve, entende e lança. Abra o cartão e clique em 💬 Mensagem original: está lá o que você falou, transcrito. Ele não inventou. Ele ouviu.
9. Ensinar o SEU critério: a entrevista opcional
O robô já funciona sem isto. Ele nasce com um critério geral de tarefa, que acerta na maioria dos casos. Este passo é a camada de refino, o que faz o robô virar seu, porque o que vira tarefa na sua Central é decisão sua, não dele.
Se não der tempo na aula, guarde o prompt e faça em casa no dia em que o robô errar pela primeira vez, e ele vai errar. É aí que isso faz mais sentido.
Ele vai perguntando caso a caso, e você responde como dona: "essa eu quero", "essa não". No fim, abra o arquivo de regras e leia. Está tudo em português. Isso aqui é o cérebro do seu robô, escrito por você.
Teste na hora: mande no grupo uma mensagem do tipo que você acabou de dizer que não é tarefa, e veja o robô ignorar. Depois mande a mesma coisa com "anota aí" no fim, e veja virar tarefa.
10. Como consertar quando ele errar
Os dois prompts que você leva pra vida:
E quando você quiser revisar o que já está combinado:
11. Ligar amanhã, sem o Claude
Agora que funciona, o último pedido:
Ele cria um Ligar Central.command (Mac) ou Ligar Central.bat (Windows) que sobe as caixas e o robô. Dois cliques, sem abrir o Claude. O Claude construiu; o robô é seu.
"Pareamento não permitido / tente mais tarde"? É o anti-spam do WhatsApp. Mesma resposta: esperar.
O Claude não consegue instalar o Docker? Deixa ele tentar outro caminho:
Não deu certo. Tenta de outro jeito e me explica o que você vai fazer. Se travar de novo, faz a aula sem o robô e termina em casa: a sua Central continua funcionando.Ele instalou, mas diz que o Docker "não está rodando"?
O Docker não está rodando. Liga ele pra mim.O download está muito lento? Não trava a turma: você segue acompanhando e refaz em casa com o mesmo prompt do passo 1.
Windows: "WSL 2 não está instalado"? O próprio Docker mostra um link e pede pra reiniciar o computador. Reinicia (3 a 5 min), e por isso a gente pediu pra você estar na chamada pelo celular também.
"Porta 8080 já está em uso"?
A porta 8080 já está em uso. Sobe a Evolution em outra porta e me diz qual.Não conseguiu criar a chave do Groq? Tenta com outro e-mail ou outra conta do Google. Se não sair, você faz em casa, com o mesmo prompt.
Conectou mas não lança? Quase sempre é conversa não ligada na Central (aba Conversas do robô) ou chave errada. Cole:
O robô não está lançando. Verifique se o chat está ligado na Central e teste a porta com a chave do .env. Me explique o que achou.Tudo lento? O Docker come memória. Feche o navegador com 40 abas.
Lançou na Central do computador em vez da que está no ar?
O robô está lançando na Central do meu computador. Aponta ele pra que está no ar.Não deu tempo na aula? Em casa, abre a pasta da Central no Code, diz "Próxima etapa: o robô do WhatsApp" e ele te conduz igualzinho. Quem travar manda print no grupo.
Checklist do Bloco 5
O processo
completo
O projeto muda; o ciclo não. Aqui está o que você leva pra qualquer projeto, e o que fazer quando dá ruim.
O ciclo
Isso serve pra página de vendas, área de membros, painel de métricas, o que for.
Quando dá ruim
| Sintoma | O que fazer |
|---|---|
| Ele fez besteira agora | Esc (para) → Esc Esc (volta no tempo) |
| Corrigi 2 vezes e continua errado | /clear e reescreva o pedido com o que você aprendeu. Insistir só piora. |
| Conversa gigante, ele ficou "burro" | /compact (ele resume e continua) ou /clear (entre tarefas diferentes) |
| Pedido vago → resultado vago | Seja específica: o quê, onde, como vou saber que deu certo |
| Fechei o app, "perdi tudo" | Não perdeu. Abre a pasta, pergunta Leia o CLAUDE.md e me diga onde paramos. |
| Quero continuar o projeto amanhã | Tarefa nova = conversa nova na mesma pasta; tarefa pela metade = volta na conversa antiga pela barra lateral. Antes de sair, sempre: Vou sair, registra no CLAUDE.md. |
| Voltei e ele não sabia de nada | O CLAUDE.md não foi atualizado. Peça agora e, se repetir, reforce a regra: Você não está atualizando o CLAUDE.md ao fim das etapas como eu pedi nas minhas regras globais. Atualiza agora. |
| A sessão morreu no meio de algo grande | Peça na sessão nova: Leia o CLAUDE.md e me diga onde paramos. Se o CLAUDE.md não der conta, peça pra ele escrever um arquivo de recuperação com tudo que estava no meio. |
| O robô anota o que não é tarefa (ou deixa passar) | Faltou critério. O robô anotou isto e não devia: "[cole a mensagem]". Ajusta as minhas regras. |
| Ele quer mexer em algo que não pedi | Diga não. Você manda. Anota no CLAUDE.md se for recorrente. |
O que você leva daqui
- Central no ar, com a sua equipe dentro.
- O robô no computador, lendo o seu WhatsApp (texto e áudio) e lançando na Central.
- As suas regras do que é tarefa, escritas em português, que você ajusta conversando.
- O
CLAUDE.mdglobal: a coisa mais valiosa do dia. - O ciclo de 7 passos.
- Próximo projeto sugerido: abre uma pasta nova chamada
pagina-vendas, liga o Plan e descreve a página dos seus sonhos. Lembra da regra do Pixel.
Prompts de bolso
As frases que você vai usar pelo resto da vida com o Claude Code.
Perguntas frequentes
Preciso do terminal?
E se eu quiser o robô 24/7?
O Claude vê minhas senhas?
.env / .dev.vars e nunca no chat.Posso usar em outro computador?
auth/) também.