🚀

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.

Treinamento ACG · Encontro 1 · MacBook

Como usar esta página: siga na ordem e marque ✓ cada passo. O progresso fica salvo neste navegador.

Etiqueta VOCÊ = você faz à mão · Etiqueta CLAUDE = você cola o pedido e o Claude faz.

0 de 0
Fase 1 Ativar o VS Code com Claude Code

A única parte manual. Uns 15 minutos.

1. Conta Claude com assinatura Você

  1. Entre em claude.ai e crie a conta (ou entre na sua).
  2. Assine o plano Pro (dá pra começar) ou Max (se for usar todo dia, pesado).
O Claude Code não funciona no plano grátis.

2. Instalar o VS Code Você

  1. Baixe em code.visualstudio.com/download → botão Mac (versão Universal serve para qualquer Mac).
  2. Abra o arquivo baixado (em Downloads) e arraste o Visual Studio Code para a pasta Aplicativos.
  3. Abra o VS Code pela pasta Aplicativos (ou ⌘ Espaço → "Visual Studio Code").
Se aparecer "app baixado da internet", clique em Abrir.

3. Instalar a extensão Claude Code Você

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

4. Baixar o kit do treinamento Você

⬇ Baixar kit-willian-mac.zip

Deixe na pasta Downloads, sem abrir. O Claude abre no passo 7.

5. Criar e abrir a pasta de trabalho Você

  1. No Finder, aperte ⌘ ⇧ H (vai para a sua pasta pessoal, a da casinha 🏠).
  2. Crie uma pasta nova (⌘ ⇧ N) chamada ClaudeCode, junto e sem espaço.
  3. No VS Code: menu File → Open Folder… (Arquivo → Abrir Pasta) → escolha ClaudeCode → Open.
  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.

6. Abrir o Claude Code e fazer login Você

  1. Clique no ícone do Claude (✳︎).
  2. Escolha entrar com a conta Claude (assinatura). O navegador abre: autorize e volte para o VS Code.
  3. Pronto: vai aparecer a caixa de conversa do Claude.
Quando o Claude pedir permissão para rodar um comando ou editar um arquivo, leia e clique em permitir. No começo deixe assim, pedindo confirmação. É a sua trava de segurança.
Fase 2 O Claude monta o resto

A partir daqui, você copia o pedido, cola na conversa do Claude e acompanha.

7. Montar a pasta de trabalho Claude

Pedido para colar 
Estou num MacBook e esta é a minha pasta de trabalho (~/ClaudeCode).
1. Descompacte ~/Downloads/kit-willian-mac.zip 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.

8. Recarregar para o Claude enxergar as skills Você

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

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

9. Conferir e instalar as ferramentas Claude

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 pedindo para instalar as "ferramentas de linha de comando", clique em Instalar e espere.

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

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 "Ctrl+Z" do projeto inteiro: dá para voltar qualquer arquivo para como estava antes.

11. Teste final: o Claude entendeu o projeto? Claude

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

Saímos do encontro de hoje com o kit de respostas do salão pronto.

12. Preencher o perfil do salão Claude

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].
Ideal: a esposa do lado para responder preços, agenda e as frases que as clientes mais falam.

13. Gerar o kit de respostas rápidas Claude

Pedido para colar 
Usa a /atendimento-whats-salao e monta o kit completo de respostas rápidas do salão com base em salao/perfil.md, adaptando os atalhos aos nossos serviços. Marque com [confirmar] o que não estiver no perfil. Salve em entregas/ e inclua a rotina diária da recepção.

Depois, salve as respostas no WhatsApp Business: Ferramentas comerciais → Respostas rápidas → um atalho por mensagem (/valor, /lembrete…).

14. Analisar conversas reais Claude

Exportar do WhatsApp: abra a conversa → toque no nome do contato → Exportar conversa → Sem mídia → mande para o Mac (AirDrop) → salve em ClaudeCode/salao/conversas/.

Pedido para colar 
Usa a /atendimento-whats-salao e analisa cada conversa em salao/conversas/ no formato de 4 linhas (etapa, objeção real com as palavras da cliente, o que travou, próxima mensagem pronta). No final, me diga o padrão: o que a gente fez nas que agendaram e nas que não agendaram.
Comece com 3 conversas de quem não agendou. É onde aparece o que está travando.
Depois Próximos encontros

Encontro 2: VPS própria + WhatsApp do salão conectado em modo só leitura (Evolution API), painel de conversas (Chatwoot) e alertas no Telegram.

Encontro 3: o agente SDR, montado com as respostas que já provaram que fecham. Primeiro em modo teste, depois em produção, com passagem para a recepção.

Encontro 4 (opcional): anúncios no Meta e medição de qual anúncio virou agendamento.

Lição de casa: usar o kit por 1 semana e juntar 10 conversas (agendou e não agendou) em salao/conversas/.

Regras de segurança desde o 1º dia

1. Senha e token nunca no chat: só em arquivos dentro de credentials/.
2. Nada é enviado para cliente sem você ler e dizer "pode enviar".
3. Antes de mudar algo importante: "me mostra o que vai mudar antes de fazer".
4. Conversas das clientes são dados pessoais: não compartilhe a pasta salao/conversas/.

Ajuda 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 a extensão

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

O Claude não encontrou o kit-willian-mac.zip

Confira se ele está em Downloads com esse nome exato. Se o Safari descompactou sozinho, diga ao Claude: "o kit já está descompactado em ~/Downloads/kit-willian-mac".

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

Faça o passo 8 (Reload Window + conversa nova). Depois, confira se a pasta oculta .claude/skills existe: no Finder, ⌘ ⇧ . mostra os arquivos ocultos.

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

Faltou rodar as 2 linhas de "Next steps" que o instalador mostrou no final. 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". Por isso o passo 10 é importante.