Treinamento ACG · Encontro 1 · MacBook

Claude Code no Mac, passo a passo

Você só instala o VS Code e o Claude Code. Depois disso, o Claude faz o resto: monta a pasta de trabalho, confere as ferramentas e começa o projeto do salão.

12 passos · cerca de 1h15 · sem precisar saber comandos
⚠️ Regras de segurança desde o 1º dia Senha e token nunca vão no chat, só em arquivos dentro de credentials/. Nada é enviado para cliente sem você ler e dizer "pode enviar". Antes de mudar algo importante, peça: "me mostra o que vai mudar antes de fazer".
Como usar
  1. Abra este link no MacBook, ao lado do VS Code.
  2. Você = você faz à mão. Claude = você copia o pedido, cola na conversa do Claude e acompanha.
  3. Siga na ordem e marque Feito em cada passo. O progresso fica salvo neste navegador.
  4. Quando o Claude pedir permissão para rodar um comando, leia e permita. É a sua trava de segurança.

📚 Dicionário rápido

Os termos que vão aparecer hoje, sem tecniquês. Na dúvida, pergunte ao próprio Claude: "me explica o que é X como se eu fosse leigo".

ClaudeA inteligência artificial que faz o trabalho junto com vocês.
VS CodeO programa "mesa de trabalho" onde ficam os arquivos e a conversa com o Claude.
Claude CodeO Claude instalado dentro do VS Code, que mexe nos arquivos com a sua permissão.
ExtensãoUm "app dentro do app" que dá uma função nova ao VS Code.
Pasta de trabalhoA "gaveta" do projeto. O Claude só mexe dentro dela.
.zipUma pasta compactada, como uma caixa fechada.
TerminalUma janela de texto para dar ordens ao computador. Quem escreve é o Claude.
ComandoUma ordem escrita para o computador. Vocês não precisam decorar nenhum.
SkillUma "receita pronta" que o Claude segue, como /atendimento-whats-salao.
CLAUDE.mdA ficha do projeto, que o Claude lê toda vez que uma conversa começa.
Git / commitHistórico de versões. Cada commit é uma "foto" da pasta para poder voltar atrás.
CredenciaisSenhas e chaves de acesso. Ficam só na pasta credentials, nunca no chat.
Agente SDRO robô que atende o lead no WhatsApp: passa o preço, oferece horários e chama a recepção quando precisa.
Pasta ocultaPasta escondida no Finder (o nome começa com ponto). Para ver, use ⌘ ⇧ .
0 de 12 feitos

🔌 Fase 1 · Ativar o VS Code com Claude Code

uns 15 min

A única parte manual. Depois dela, o Claude assume.

1

Conta Claude com assinatura

Você

📖 Em palavras simples

O Claude é a inteligência artificial que vai trabalhar com vocês. A conta é o seu login, e a assinatura é o que libera o uso dentro do computador.

💡 Pense numa assinatura de Netflix: sem ela, o aplicativo abre, mas não funciona.

👀 O que você vai ver: Um cartão de crédito em mãos. Pode cancelar quando quiser.

  1. Entre em claude.ai e crie a conta (ou entre na sua).
  2. Assine o plano Pro (dá pra começar) ou Max (para uso pesado, todo dia).

O Claude Code não funciona no plano grátis.

2

Instalar o VS Code

Você

📖 Em palavras simples

O VS Code é um programa gratuito da Microsoft. É a "mesa de trabalho": nele você vê as pastas e os arquivos do projeto e conversa com o Claude, tudo na mesma tela.

💡 É como o Word, mas feito para organizar arquivos de projeto. Você não precisa saber programar para usar.

👀 O que você vai ver: Uma janela com uma barra de ícones na esquerda. Não precisa mexer em nada além do que este passo a passo pede.

  1. Baixe em code.visualstudio.com/download → botão Mac (a versão Universal serve para qualquer Mac).
  2. Abra o arquivo baixado e arraste o Visual Studio Code para a pasta Aplicativos.
  3. Abra o VS Code: ⌘ Espaço → "Visual Studio Code".

Se aparecer "app baixado da internet", clique em Abrir.

3

Instalar a extensão Claude Code

Você

📖 Em palavras simples

Extensão é um "aplicativo dentro do aplicativo". A extensão Claude Code coloca o Claude dentro do VS Code, para ele poder ler, criar e organizar os arquivos com você.

💡 É como instalar o WhatsApp no celular: o celular já existia, e o app traz a função nova.

👀 O que você vai ver: Uma lojinha de extensões dentro do VS Code. Instale só a que é da Anthropic, a empresa que faz o Claude.

  1. No VS Code, abra as Extensões: ⌘ ⇧ X.
  2. Pesquise Claude Code e instale a da Anthropic (com selo de verificado).
  3. Vai aparecer o ícone do Claude (✳︎) na barra lateral ou no canto de cima à direita.
4

Criar e abrir a pasta de trabalho

Você

📖 Em palavras simples

A pasta de trabalho é onde vai ficar tudo do projeto do salão. O Claude só mexe dentro da pasta que estiver aberta no VS Code, e isso protege o resto do seu computador.

💡 É a "gaveta" do projeto. Tudo do salão fica nela, organizado.

👀 O que você vai ver: A pasta ClaudeCode aparecendo na barra da esquerda do VS Code, ainda vazia.

  1. No Finder, aperte ⌘ ⇧ H para ir à sua pasta pessoal (a da casinha 🏠).
  2. Crie uma pasta nova (⌘ ⇧ N) chamada ClaudeCode, junto e sem espaço.
  3. No VS Code, aperte ⌘ O → escolha ClaudeCode → Open. (Ou pelo menu File → Open Folder…: no Mac o menu fica na barra do topo da tela, ao lado da maçã , e não dentro da janela. Em tela cheia, leve o mouse até o topo para ele aparecer.)
  4. Se perguntar "Do you trust the authors?", clique em Yes, I trust.

Por que fora de Documentos e Mesa? O macOS fica pedindo permissão para essas pastas, e espaço no nome atrapalha os comandos.

5

Abrir o Claude Code e fazer login

Você

📖 Em palavras simples

Aqui você liga o Claude à sua conta. A partir de agora, você conversa com ele escrevendo em português normal, como no WhatsApp.

💡 Você pede o que quer com as suas palavras. Ele faz e mostra o que fez.

👀 O que você vai ver: Uma caixa de conversa. Antes de mexer em arquivos ou rodar algo, o Claude pede licença. Leia e clique em permitir.

  1. Clique no ícone do Claude (✳︎).
  2. Entre com a conta Claude (assinatura). O navegador abre: autorize e volte para o VS Code.
  3. Pronto: aparece a caixa de conversa do Claude.

🤖 Fase 2 · O Claude monta o resto

uns 30 min

Copie o pedido, cole na conversa do Claude e acompanhe o que ele faz.

6

Montar a pasta de trabalho

Claude

📖 Em palavras simples

O kit é o material do treinamento: a ficha do projeto, a ficha do salão em branco e as duas "receitas" (de atendimento e de anúncio) que a ACG já usa em outros salões. Ele vem numa "caixa" (arquivo .zip). Você pede, e o Claude baixa a caixa, abre e arruma tudo na gaveta do projeto. Você não digita comando nenhum.

💡 Comando é uma ordem escrita para o computador. Quem escreve é o Claude. Você só confere e aprova.

👀 O que você vai ver: O Claude mostrando o que vai fazer e pedindo permissão algumas vezes. No final, uma "árvore" com a lista das pastas criadas.

Pedido para colar
Estou num MacBook e esta é a minha pasta de trabalho (~/ClaudeCode).
1. Baixe o kit deste endereço: https://treino-claude-code-acg.pages.dev/kit-willian-mac.zip e descompacte numa pasta temporária.
2. Copie TODO o conteúdo de kit-willian-mac/ClaudeCode para esta pasta, incluindo os itens ocultos (.claude e .gitignore). Não sobrescreva nada que já exista sem me perguntar.
3. Copie também os arquivos 00-LEIA-PRIMEIRO.md, 01-ROTEIRO-ENCONTROS.md e 02-PEDIDOS-PRONTOS.md para uma pasta "treinamento" aqui dentro.
4. Proteja a pasta de credenciais com chmod 700.
5. No fim, me mostre a árvore de pastas que ficou.
7

Recarregar para o Claude enxergar as skills

Você

📖 Em palavras simples

O Claude lê as "receitas" (as skills) só quando a conversa começa. Como elas acabaram de chegar na pasta, é preciso reabrir a janela e começar uma conversa nova.

💡 É como fechar e abrir de novo um aplicativo do celular depois de atualizar.

👀 O que você vai ver: A janela do VS Code piscando e voltando igual. Depois, clique em "nova conversa" no Claude.

⌘ ⇧ P → digite Developer: Reload Window → Enter. Depois, abra uma conversa nova no Claude.

O Claude só carrega as skills (/atendimento-whats-salao e /copy-salao) quando a conversa começa.

8

Conferir e instalar as ferramentas

Claude + Você no Terminal, se pedir senha

📖 Em palavras simples

O Claude confere se o Mac tem os "programas de apoio" que ele usa por baixo dos panos. Você não vai usar nenhum deles diretamente.

💡 Terminal: uma janela de texto onde se dão ordens ao computador. Homebrew: um instalador de programas. Git: guarda o histórico (veja o passo 9). Python e Node: linguagens que alguns robôs usam. Algumas instalações pedem a senha do Mac: o Claude não tem essa senha, então ele mostra o texto exato para você colar no Terminal.

👀 O que você vai ver: No final, uma tabelinha mostrando o que está ok. É normal levar uns minutos.

Pedido para colar
Confira o que já está instalado neste Mac: Git, Homebrew, Python 3.11+ e Node.
- O que você conseguir instalar sozinho, instale (me pedindo permissão).
- Se algum comando precisar da senha do Mac (como a instalação do Homebrew), NÃO tente rodar: me passe o comando exato para eu colar no Terminal e me diga o que fazer com as linhas de "Next steps" que aparecerem no final.
- No fim, me mostre uma tabela: ferramenta | versão | ok?

Abrir o Terminal: ⌘ Espaço → "Terminal". Quando ele pedir a senha do Mac, nada aparece enquanto você digita. É normal: digite e aperte Enter. Se abrir uma janela para instalar as "ferramentas de linha de comando", clique em Instalar e espere.

9

Ligar o histórico de versões (Git)

Claude

📖 Em palavras simples

Git é um "histórico de versões": cada vez que algo importante muda, ele tira uma "foto" da pasta. Cada foto se chama commit.

💡 É como o histórico de versões do Google Docs. Se algo der errado, dá para voltar no tempo.

👀 O que você vai ver: O Claude pedindo licença e dizendo que fez o primeiro commit. Daqui pra frente, você só pede: "salva no Git" ou "volta como estava ontem".

Pedido para colar
Inicie o Git nesta pasta, configure meu nome como "Willian" se ainda não houver nome configurado, confira se o .gitignore está bloqueando credentials/ e salao/conversas/, e faça o primeiro commit "Início do workspace".

O Git é o "desfazer" do projeto inteiro: dá para voltar qualquer arquivo para como estava antes.

10

Teste final: o Claude entendeu o projeto?

Claude

📖 Em palavras simples

Um teste rápido para ver se o Claude achou as instruções do projeto. O arquivo CLAUDE.md é a "ficha" do projeto: quem é você, qual é o salão e quais são as regras. O Claude lê esse arquivo toda vez que uma conversa começa.

💡 É como o manual que se entrega para um funcionário novo no primeiro dia.

👀 O que você vai ver: Um resumo em 5 linhas citando o salão, as duas receitas e as regras de segurança.

Pedido para colar
Leia o CLAUDE.md e me diga em 5 linhas o que você sabe sobre este projeto, quais skills estão disponíveis e quais são as regras de segurança.

✅ Se ele citar o salão, as skills /atendimento-whats-salao e /copy-salao e a regra "nada é enviado sem o seu OK", a Fase 2 está concluída. 🎉

💇 Fase 3 · Primeira vitória: o salão

uns 30 min

Saímos de hoje com o kit de respostas do salão pronto para usar no WhatsApp.

11

Preencher o perfil do salão

Claude entrevista vocês

📖 Em palavras simples

O perfil é a ficha do salão: serviços, preços, duração, agenda e as palavras que as clientes usam. Tudo o que o Claude escrever depois vai sair dessa ficha. Por isso ela vem antes de tudo.

💡 O Claude nunca inventa preço nem horário. O que não estiver na ficha, ele pergunta.

👀 O que você vai ver: O Claude fazendo uma pergunta por vez, como numa entrevista, e salvando as respostas.

Pedido para colar
Abra salao/perfil.md e me entreviste para preencher o que está em branco. Faça UMA pergunta por vez, comece pelo nome do salão e pelos 3 serviços que mais vendem (preço, o que inclui, duração), e vá salvando as respostas no arquivo. O que eu não souber, marque como [confirmar].

O ideal é ter a esposa do lado para responder preços, agenda e as frases que as clientes mais falam.

12

Gerar o kit de respostas rápidas

Claude

📖 Em palavras simples

O kit é um primeiro rascunho das mensagens do atendimento (primeira resposta, dúvidas e objeções, lembrete, retomada), feito com o que funcionou em outros salões.

💡 É um ponto de partida, não a regra final: cada negócio funciona diferente. No Encontro 2 o Claude estuda o WhatsApp do salão e a gente adapta o kit ao que funciona para vocês.

👀 O que você vai ver: Um documento com cerca de 15 mensagens. O que estiver marcado [confirmar] precisa da resposta da sua esposa antes de usar.

Pedido para colar
Usa a /atendimento-whats-salao e monta um primeiro rascunho do kit de mensagens do salão com base em salao/perfil.md, adaptando aos nossos serviços (sem atalhos de WhatsApp Business). Deixe claro que é versão inicial, para ajustar depois de estudar as nossas conversas. Marque com [confirmar] o que não estiver no perfil. Salve em entregas/ e inclua a rotina diária da recepção.

Leiam juntos e marquem o que não tem a cara do salão. É um rascunho: a versão final sai depois de estudar as conversas reais no Encontro 2.

Próximos encontros

Encontro 2 · Infraestrutura do WhatsApp + leitura das conversas

Na mesma VPS da Marmoraria (os dois negócios são seus, sem custo extra de servidor). O WhatsApp do salão é conectado em modo só leitura (Evolution API), com conta própria no painel de conversas (Chatwoot) e alertas no Telegram. Tudo do salão começa com "Salão" e fica separado da Carol, que tem prioridade. Com o WhatsApp conectado, o Claude lê as conversas direto (sem exportar nem enviar arquivo) e mostra onde as clientes esfriam e o que faz agendar.

Encontro 3 · O agente SDR

Montado com as respostas que já provaram que fecham. Primeiro em modo teste, só com os números de vocês. Depois em produção, passando para a recepção quando precisar.

Encontro 4 · Anúncios e medição (opcional)

Anúncios no Meta e saber qual anúncio virou agendamento.

Lição de casa

Ler o rascunho do kit e anotar o que não combina com o salão. Não precisa guardar nem exportar conversas: no Encontro 2 o Claude lê tudo direto do WhatsApp e a gente descobre o que funciona para vocês.

Se travar

O Mac diz que o VS Code "não pode ser aberto"

Ajustes do Sistema → Privacidade e Segurança → role até o fim → Abrir Mesmo Assim.

Não aparece o ícone do Claude depois de instalar

⌘ ⇧ P → Developer: Reload Window. Se ainda não aparecer, ⌘ ⇧ P → digite "Claude Code" e escolha Open.

O Claude não conseguiu baixar o kit

Baixe à mão: clique aqui (vai para Downloads). Depois diga ao Claude: "o kit está em ~/Downloads/kit-willian-mac.zip, use esse arquivo". Se o Safari descompactou sozinho, diga: "o kit já está descompactado em ~/Downloads/kit-willian-mac".

O Claude não reconhece /atendimento-whats-salao

Faça o passo 7 (Reload Window + conversa nova). Para ver a pasta oculta .claude no Finder, aperte ⌘ ⇧ .

"command not found: brew" depois de instalar o Homebrew

Faltou rodar as linhas de "Next steps" do final da instalação. Cole a mensagem do Terminal no Claude e peça: "me diga o que rodar para o brew funcionar".

O Claude fez algo que eu não queria

Peça: "desfaça a última mudança usando o Git". É para isso que serve o passo 9.