Aula ao vivo · 08/10

Kit · Teu link na bio com Claude Code

No fim você sai com uma página de link na bio tua, no ar, com etiqueta (UTM) em cada link e contador de clique por botão.

1O que você precisa

Único custo obrigatório: a assinatura do Claude. Domínio próprio é opcional (seção 6).

2Terminal ou app?

Na aula eu usei o terminal porque mostra cada passo e o que a IA está fazendo, e funciona igual no Mac e no Windows. Se preferir, o app do Claude pra computador, na aba Code, faz a mesma coisa sem terminal: escolhe a pasta do projeto e cola os mesmos prompts.

Guia oficial do app: code.claude.com/docs/en/desktop-quickstart

Pelo terminal

Mac (Terminal):

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

Fecha o terminal, abre outro e confere. Tem que aparecer um número. Se aparecer "not found", veja "Fix your PATH" em code.claude.com/docs/en/troubleshoot-install.

claude --version

Depois, entra na pasta do projeto e abre o Claude Code com claude. No primeiro uso ele pede login no navegador.

3Modelo de brief

Cria uma pasta pro projeto, salva este texto nela como brief.md e preenche. Quinze minutos aqui economizam uma hora de "não era bem isso" depois. Vale pra tua página ou pra de cliente (aí troca "eu" por "a marca").

# Brief do link na bio

## 1. Quem é
- Nome:
- O que faz, em uma frase:
- Cidade/região (se importar pro negócio):
- @ do Instagram:

## 2. Objetivo da página (UM só)
- O objetivo nº 1:            (ex.: pedir orçamento no WhatsApp, comprar o curso, agendar, entrar no grupo)
- Como eu sei que deu certo:  (ex.: cliques no botão de orçamento por semana)

## 3. Pra quem é
- Quem chega aqui, de onde vem e o que quer resolver:
- Em que aparelho (quase sempre celular):

## 4. Voz da marca
- 3 adjetivos:
- Palavras que a marca usa:
- Palavras que a marca NUNCA usa:
- Tratamento (você / vocês / a gente):

## 5. Visual
- O clima em uma frase:       (ex.: revista de praia, fundo areia, títulos serifados, detalhes em azul-petróleo)
- Cores (código ou nome):
- Fonte: (se não souber, "fontes do sistema", carrega mais rápido)
- Uma referência que eu gosto: (site ou perfil, opcional)
- Logo ou foto: (nome do arquivo na pasta, ou "sem foto por enquanto")

## 6. Links (na ordem do objetivo)
Os textos de botão escritos aqui são os que vão pro ar. A IA não troca.
DESTAQUE (um só):
- Texto do botão | link

Seção "________":
- Texto do botão | link
- Texto do botão | link

Seção "________":
- Texto do botão | link

Redes (rodapé, sem UTM):
- Instagram | link
- TikTok | link

## 7. Métricas
- Campanha: bio
- ID do Google Analytics (se for usar): G-

Três perguntas antes de fechar o brief

  1. Se a pessoa só clicar em UM botão, qual é? Esse é o destaque. Se você respondeu dois, ainda não decidiu o objetivo.
  2. Tem link aqui que existe só porque "sempre teve"? Tira. Cada botão a mais divide a atenção do destaque.
  3. O texto do botão diz o que acontece ao clicar? "Clique aqui" não diz. "Pedir orçamento no WhatsApp" diz.

4O atalho: prompt único

A página inteira num pedido só. Com o brief.md na pasta (sem brief, ele te entrevista), abre o Claude Code nessa pasta e cola o texto abaixo. Troca só a linha do VISUAL pelo jeito que você quer, ou deixa em branco pra ele te propor 3 direções.

Você vai criar a minha página de link na bio do começo ao fim, num pedido só.

1. BRIEF: leia o brief.md desta pasta. Se ele não existir, me entreviste antes, uma pergunta por vez (o negócio em uma frase, o objetivo número 1, quem chega na página, a voz da marca, o link de destaque, os outros links com o texto de cada botão, as redes sociais) e salve as respostas em brief.md.

2. VISUAL (quem escolhe sou eu): estilo revista de praia, fundo areia, títulos com fonte serifada elegante, detalhes em azul-petróleo, botões com cantos arredondados.
Se eu deixar o visual em branco, me proponha 3 direções visuais, uma linha cada, e espere eu escolher.

3. CONSTRUA a página em site/index.html, um arquivo só, com o CSS dentro, sem biblioteca externa, pensada pra celular (390 px de largura, no máximo 480 px no computador). No topo, o nome e uma frase na voz da marca; logo abaixo, UM destaque maior; depois as seções do brief; redes discretas no rodapé. Use exatamente os textos de botão do brief.

4. REGRAS que não podem falhar:
- botões com pelo menos 48 px de altura;
- em todo link que vai pra um site, acrescente utm_source=instagram&utm_medium=social&utm_campaign=bio&utm_content=nome-do-botao (minúsculas, sem acento, com hífen); NÃO coloque UTM em WhatsApp, telefone, e-mail nem rede social;
- cada botão com id igual ao nome-do-botao;
- contraste de pelo menos 4,5 para 1 em todo texto, sem transparência em texto; se a cor que eu escolhi não passar, ajuste e me avise;
- nada inventado: link, telefone ou preço que não está no brief vira um aviso pra mim, não vira texto na página.

5. REVISE como se fosse outra pessoa (links, https, UTM, ids, contraste com o número calculado, voz da marca) e corrija sozinho tudo que for grave, sem mudar os textos dos botões.

6. NO FIM, abra a página no navegador e me mostre: a lista final de links, a tabela de contraste e o que você corrigiu na revisão.

A IA é estagiária, não redatora: ela monta rápido, quem confere é você. Nos testes ela errou a própria conta de contraste, então confere os números numa calculadora de contraste.

5Passo a passo (um prompt por vez)

Se preferir ir por partes: cola um prompt, espera terminar, lê o que ele fez e só então cola o próximo.

Prompt 0 · A entrevista (se chegou sem brief)

Faz a IA te entrevistar e escrever o brief.md por você.

Eu quero criar a página de link na bio do meu negócio (ou de um cliente meu). Antes de criar qualquer coisa, me entrevista.

Faz UMA pergunta por vez, espera a minha resposta e só então faz a próxima. Pergunta, nesta ordem:
1. O nome do negócio e o que ele faz, em uma frase.
2. O objetivo número 1 da página (um só: vender, pedir orçamento, agendar, entrar num grupo, baixar um material...).
3. Quem chega nessa página, de onde vem e o que quer resolver.
4. Três adjetivos da voz da marca, palavras que a marca usa e palavras que ela nunca usa.
5. As cores (código ou nome) e se tem logo ou foto.
6. O link de DESTAQUE (um só) e o texto do botão.
7. Os outros links, com o texto de cada botão. Se forem mais de 6, me pergunta como agrupar em seções.
8. As redes sociais que vão no rodapé.

No fim, escreve tudo num arquivo brief.md nesta pasta, no formato do modelo de brief da aula, e me mostra o arquivo pra eu conferir. Não crie a página ainda.

Prompt 1 · Construir a página

Gera a pasta site com o index.html.

Você vai criar a minha página de link na bio. Leia o arquivo brief.md nesta pasta antes de qualquer coisa.

Crie uma pasta chamada site e, dentro dela, um arquivo só, chamado index.html. Só isso vai pra internet, então nada de rascunho, brief ou anotação dentro da pasta site.

Regras da página:
1. Um arquivo só, com o CSS dentro dele. Sem framework, sem biblioteca externa, sem JavaScript de terceiros. Fontes do sistema.
2. Mobile primeiro: pensada pra tela de 390 pixels de largura, centralizada e com largura máxima de 480 pixels no computador.
3. No topo: o nome e uma frase curta na voz da marca descrita no brief. Depois o link DESTAQUE, maior e com a cor de destaque. Depois as seções na ordem do brief, cada uma com um título pequeno. Redes sociais no rodapé, discretas.
4. Botões grandes, fáceis de tocar com o dedo (pelo menos 48 pixels de altura), com texto que diz o que acontece ao clicar.
5. UTM: em todo link que leva pra um site, acrescente utm_source=instagram&utm_medium=social&utm_campaign=bio&utm_content=NOME-CURTO, onde NOME-CURTO é o nome do botão em minúsculas, sem acento, palavras separadas por hífen. Se o link já tiver "?", use "&" pra juntar. NÃO coloque UTM em link de WhatsApp (wa.me), de telefone, de e-mail nem de rede social.
6. Em cada botão, coloque id igual ao NOME-CURTO (é com ele que a gente vai contar clique depois).
7. Acessibilidade: lang="pt-BR"; contraste de pelo menos 4,5 para 1 entre o texto e o fundo de CADA botão, inclusive o destaque (se a cor da marca não passar com texto branco, use texto escuro ou escureça a cor e me avise); sem transparência (opacity) em texto, porque ela derruba o contraste; foco visível quando navega pelo teclado; texto alternativo se tiver imagem.
8. No head: title com o nome do negócio, meta description com a frase da marca e meta viewport.
9. Não invente link, telefone, preço nem informação que não está no brief. Se faltar algo, deixe um comentário no HTML dizendo o que falta.

Quando terminar, me mostre: (a) a lista de todos os links finais, um por linha; (b) o contraste calculado de cada combinação de cor de texto e fundo que você usou.

Prompt 2 · Revisar antes de publicar

Não muda nada: só lista o que está errado. Depois você escolhe o que corrigir.

Agora revisa a página site/index.html como se fosse outra pessoa. Não mude nada ainda: só me entrega uma lista do que está errado ou arriscado, em ordem de gravidade, olhando:
1. Algum link quebrado, sem https ou diferente do brief.md?
2. Algum link de site sem UTM, ou algum link de WhatsApp, telefone, e-mail ou rede social COM UTM?
3. Algum botão sem id, ou dois botões com o mesmo id?
4. Contraste de cada botão e de cada texto, inclusive títulos pequenos e texto com transparência (calcula e me diz o número). Só conta como texto grande, com mínimo de 3 para 1, o que tiver pelo menos 24 pixels, ou 18,66 pixels em negrito.
5. Algum texto que não soa como a voz da marca do brief, ou alguma palavra da lista do "nunca usa"?
6. Tamanho do arquivo em KB.
7. Alguma informação inventada que não está no brief?
Depois da lista, me pergunta quais itens eu quero que você corrija.

Prompt 3 · Ligar o Google Analytics 4

Antes: no Google Analytics, cria a conta, a propriedade e o fluxo Web com a medição otimizada ligada, e copia o ID de medição (começa com G-). Troca G-COLE-O-SEU-AQUI pelo teu. Passo a passo oficial: support.google.com/analytics/answer/9304153

Coloque a tag do Google Analytics 4 na página site/index.html, com o ID de medição G-COLE-O-SEU-AQUI, logo depois da abertura do <head>, no formato padrão do gtag.js do Google. Não coloque mais nenhum script.

Depois, no rodapé, acrescente uma linha pequena: "Este site usa cookies do Google Analytics pra contar visitas e cliques." Essa linha também precisa ter contraste de pelo menos 4,5 para 1 com o fundo (calcula e me diz o número). Não mexa no id de nenhum botão.

Me mostre o trecho que você acrescentou.

Prompt 4 · Trocar o destaque (manutenção)

Troca o que está entre colchetes.

Na página site/index.html, troque o link de DESTAQUE por este: [texto do botão] | [link]. O destaque antigo desce pra seção [nome da seção] como botão normal (ou sai da página, se eu disser "remove"). Mantém a regra de UTM e de id dos outros botões. Me mostre o antes e o depois do trecho alterado.

Prompt 5 · Muitos links (hotel, loja, agenda cheia)

Pra quando a página passa de 6 a 8 links.

Minha página tem muitos links. Reorganiza a site/index.html assim:
1. Um destaque só no topo (o do objetivo nº 1 do brief).
2. No máximo 3 seções, cada uma com no máximo 4 botões. Se não couber, me diz quais links você tiraria e por quê (não tira sem eu aprovar).
3. Uma faixa "da temporada" logo abaixo do destaque, pra um link sazonal que eu troco quando acabar (feriado, alta temporada, promoção). Deixa um comentário no HTML marcando onde trocar.
Me mostra a nova ordem antes de aplicar.

Publicar: GitHub + Cloudflare

A. Subir no GitHub (pelo navegador)

  1. Abre github.com/new?visibility=private (já cria privado). Nome com hífen, marca pra criar um README, cria.
  2. Add file > Upload files.
  3. Arrasta só a pasta site (nunca a pasta de fora, que leva o brief junto). Mensagem curta, branch main, confirma.

B. Publicar na Cloudflare Pages

  1. Workers & Pages > Create application > Pages > Connect to Git.
  2. GitHub > Install & Authorize > escolhe o repositório > Begin setup.
  3. Project name vira o endereço (nome.pages.dev). Production branch: main.
  4. Framework: nenhum. Build command em branco (se falhar, usa exit 0). Build output directory: site.
  5. Save and Deploy.

Fonte: developers.cloudflare.com, Git integration. Deu 404? O index.html tem que estar dentro da pasta site e o campo tem que dizer site.

Sem GitHub (caminho curto): Create application > Get started > Drag and drop your files, arrasta a pasta site, Deploy (direct upload). Atenção: projeto criado pelo Git não troca pra upload direto depois.

Pra atualizar: no GitHub, entra na pasta site > Add file > Upload files > arrasta o index.html novo. A Cloudflare publica sozinha.

C. Métricas

  1. Visitas: no projeto da Cloudflare, Metrics > Enable (Web Analytics). Entra na próxima publicação. Não conta clique por botão.
  2. Clique por botão: GA4 com o Prompt 3. A medição otimizada registra clique em link que sai do teu site, com o id do botão ("Link ID").
  3. Testar: abre a página no celular, clica em 3 botões e vê no GA4 em Reports > Realtime: tem que aparecer o evento click. A coleta pode levar até 30 minutos pra começar.

GA4 usa cookie: o Prompt 3 já coloca o aviso no rodapé.

D. Trocar o link na bio

No Instagram: Editar perfil > Links > Adicionar link externo. Cola o teu endereço com a etiqueta (no TikTok, troca instagram por tiktok):

https://teu-projeto.pages.dev/?utm_source=instagram&utm_medium=social&utm_campaign=bio

6Domínio próprio com ajuda da IA

Opcional. Troca teu-projeto.pages.dev por algo como links.seunome.com.br. No Registro.br, um .com.br custa R$ 40,00 por 1 ano (tabela oficial).

Domínio
O nome da rua registrado no cartório: seunome.com.br.
Subdomínio
Um número dentro da rua: links.seunome.com.br. Cria quantos quiser, sem pagar de novo.
DNS
A lista telefônica da internet: diz pra onde cada nome aponta.
CNAME
Um apelido nessa lista: "links.seunome.com.br, procure em teu-projeto.pages.dev".
SSL
O cadeado do https. A Cloudflare emite sozinha depois de conferir o apelido.

Por que subdomínio: pra subdomínio não precisa levar o domínio pra Cloudflare, só criar o CNAME. Usar o domínio raiz (sem nada na frente) exige trocar os servidores (nameservers), e isso é outro tutorial. A ordem importa: primeiro adiciona o domínio no projeto da Cloudflare, depois cria o CNAME; ao contrário, dá erro 522 (documentação oficial).

Cola este prompt no Claude (chat ou Claude Code). Ele te guia um passo por vez e espera você confirmar:

Quero colocar a minha página de link na bio, que já está publicada na Cloudflare Pages no endereço [COLE AQUI O SEU ENDEREÇO .pages.dev], num domínio próprio .com.br. Me guie passo a passo.

Como você deve me guiar:
- UM passo por vez. Explique o que vamos fazer e por quê em no máximo 3 linhas, diga exatamente onde clicar, e espere eu responder "feito" antes do próximo passo.
- Não invente nome de menu nem de botão. Se você não tiver certeza de como a tela está hoje, me peça um print e me guie a partir dele.
- Nunca me peça senha, código de verificação, dados de cartão ou documento. Eu digito isso sozinho, direto no site oficial.
- Linguagem simples: eu não sou da área de tecnologia.

O caminho:
1. DOMÍNIO: me ajude a ver se o nome que eu quero está livre no site oficial do Registro.br (https://registro.br) e, se eu decidir comprar, a registrar. Pela tabela oficial (https://registro.br/ajuda/pagamento-de-dominio/), 1 ano custa R$ 40,00. Se eu já tiver o domínio, pule este passo.
2. SUBDOMÍNIO: vamos usar um subdomínio, por exemplo links.[meudominio].com.br. É o caminho mais simples: não precisa mudar os servidores (nameservers) do domínio. Se eu pedir o domínio sem nada na frente (o "raiz"), me avise que isso exige transferir o DNS pra Cloudflare e que é outro tutorial.
3. CLOUDFLARE PRIMEIRO: no painel da Cloudflare, em Workers & Pages, abra o meu projeto, vá em Custom domains, escolha Set up a domain, digite o subdomínio e continue. Isso tem que vir ANTES de mexer no Registro.br: a documentação oficial avisa que criar o CNAME sem associar o domínio no projeto antes faz o endereço falhar (erro 522). Fonte: https://developers.cloudflare.com/pages/configuration/custom-domains/
4. CNAME NO REGISTRO.BR: na área do meu domínio no Registro.br, na parte de DNS, crie um registro do tipo CNAME com o nome "links" (ou o subdomínio que eu escolhi) apontando para o meu endereço .pages.dev, sem https e sem barra no fim. Se a tela pedir alguma opção que você não sabe qual é, me peça um print.
5. ESPERAR E TESTAR: me explique que a verificação e o cadeado (SSL) podem levar um tempo. Depois me peça para abrir https://links.[meudominio].com.br no celular e confirmar que a página abre com o cadeado.
6. INSTAGRAM: me ajude a trocar o link do perfil (Editar perfil > Links) pelo endereço novo com a etiqueta: https://links.[meudominio].com.br/?utm_source=instagram&utm_medium=social&utm_campaign=bio

Se algo der erro, me pergunte a mensagem exata que apareceu antes de sugerir qualquer coisa.

7UTM da casa

Em todo link da página que leva pra um site:

utm_source=instagram&utm_medium=social&utm_campaign=bio&utm_content=nome-do-botao
Como escreverMinúsculas, sem acento, hífen entre palavras. utm_content é o nome do botão (o mesmo do id).
Sem UTMWhatsApp, telefone, e-mail e redes sociais.
Link do perfilTambém leva etiqueta, sem o utm_content (seção 5, item D).