9 aulas em vídeo · ~72 min

Claude Code
no Xperiun OS

Do zero à autonomia

Guia de consulta da equipe. 9 aulas em vídeo cobrem tudo que você precisa pro uso diário: da diferença entre Claude local e ChatGPT, passando por instalação, clone do projeto, skills prontas, squads de especialistas, até criar sua própria skill. Ao final das 9 aulas, você trabalha de forma autônoma no Xperiun OS.

9 aulas em vídeo Windows + Mac Zero conhecimento prévio
Sumário

O que tem aqui

Introdução

Como usar essa apostila

A apostila acompanha os vídeos do treinamento. Cada aula tem o vídeo embedado no topo da seção e o texto abaixo. Serve tanto pra assistir quanto pra consultar depois sem precisar rebobinar.

Como cada aula é organizada

Em cada seção de aula você encontra, nessa ordem:

  1. Título + duração + link direto pro vídeo no YouTube (pra caso queira abrir em outra aba).
  2. Player embedado: dá play sem sair da apostila.
  3. Texto rico cobrindo o que o vídeo ensina, com passos, exemplos e avisos. Serve pra consulta rápida depois (ex: "como era mesmo o caminho pra ativar o bypass?").

Convenções

  • Texto tipo assim é comando, nome de arquivo ou pasta.
  • Tecla tipo Ctrl + C é atalho de teclado.
  • Caixas com borda colorida à esquerda são avisos, dicas ou pontos críticos.

Antes de começar

Você vai precisar do acesso ao e-mail compartilhado acessos@xperiun.com (senha no Drive, com o Jaidson). Esse e-mail é a porta de entrada pra tudo: Claude, GitHub, plano Max. Se ainda não tiver, pede pra ele liberar antes de começar a Aula 1.

Aula 1 · 7 min

Introdução ao Claude Code · diferenças e acessos

⏱ 7 min · ↗ Abrir no YouTube

Abertura do treinamento. Por que o Xperiun OS existe, qual a diferença real entre usar Claude na web e rodar ele local no seu PC, como acessar as ferramentas da Xperiun e quais são os limites do plano Max.

Por que esse treinamento existe

O Xperiun OS é o cérebro que vai permitir a todo mundo do time produzir qualquer tipo de material (carrossel, site, copy, apresentação, carta física, roteiro de vídeo) com ganho real de produtividade. A promessa não é "um chat melhor", é sair de "IA que só responde" pra "IA que coloca a mão na massa e escala o negócio".

A forma como a gente trabalha muda. Hoje não precisa programar site nem mexer em layout. Você atua como gerente, validando o que o Claude entrega, pedindo ajustes, aprovando. É um conhecimento que vale pra Xperiun hoje e pra sua carreira daqui pra frente. O Leo é direto: quem não souber usar IA no próximo ciclo está com os dias contados.

O e-mail compartilhado acessos@xperiun.com

Todos os acessos desse treinamento passam pelo e-mail acessos@xperiun.com. É uma conta compartilhada entre todo mundo do time.

  1. Abre o Gmail → foto do perfil no canto superior direito → Adicionar outra conta.
  2. Coloca acessos@xperiun.com + a senha que tá no Drive.
  3. Se não souber a senha, pede pro Jaidson. Ele libera.

Claude na web vs Claude Code local

Logado no acessos@xperiun.com, dá pra entrar em claude.ai e usar o Claude pelo navegador. A interface é parecida com a do ChatGPT. Vale lembrar: são empresas diferentes. Claude é da Anthropic, ChatGPT é da OpenAI. Na prática, o Claude tende a ser mais direto no raciocínio, bom pra interpretar documentos grandes e particularmente forte em código.

Mas o Claude na web tem um limite crítico: ele não acessa os arquivos do seu computador. Se você pedir "mova o arquivo X pra pasta Y", ele não consegue. É uma limitação real: o Claude web só responde.

O Claude Code local é outra categoria. Ele vive dentro do VSCode, na sua máquina, com acesso aos arquivos reais do projeto. E quando você roda ele dentro do projeto Xperiun OS, ele carrega todo o conhecimento da empresa (posicionamento detalhado, histórico de páginas, depoimentos, código, design system), coisa que o Claude web público nunca vai ver.

A grande virada

Claude web = responde, não mexe em nada. Claude Code local = entende contexto completo da Xperiun, cria arquivos, edita, organiza, rende o trabalho.

Plano Max e limites de uso

Pra rodar o Claude local, a Xperiun paga uma licença do plano Max da Anthropic. Esse plano trabalha com dois limites de uso que você precisa conhecer (pensa em token como a "gasolina" de cada pedido que você faz pro Claude — quanto mais complexo o pedido, mais gasolina consome):

Janela de 5 horas

A cada sessão intensa de uso, o consumo pode chegar a 100%. Quando zera, reseta automaticamente em 5 horas. Dá pra continuar trabalhando depois disso.

Janela semanal

Existe também um teto semanal que reseta toda quinta-feira às 16h. Anote esse horário: é o "virar da semana" do plano.

A ideia é que o time use muito mesmo. Com todo mundo compartilhando esse ambiente, a tendência natural é chegar próximo dos limites. E tudo bem, é pra isso que o plano existe.

Resumo em 20 segundos

E-mail pra tudo: acessos@xperiun.com (senha no Drive, com Jaidson). Claude web é chat e não mexe em arquivos. Claude Code local mexe em arquivos reais e conhece a Xperiun por dentro. Plano Max reseta a cada 5h e toda quinta 16h.

Aula 2 · 3 min

Downloads necessários · VSCode, Git e Node

⏱ 3 min · ↗ Abrir no YouTube

Aula prática. Três programas, nessa ordem: VSCode → Git → Node.js. É next-next-next, sem mexer em nada. Dá pra fazer em menos de 10 minutos. É uma vez só na vida da máquina.

Ordem importa

Instala nessa sequência: 1) VSCode → 2) Git → 3) Node.js. O Leo mostra o passo a passo no Windows, mas os links pra Mac estão abaixo. Quem tiver Mac é só usar o link equivalente.

1. Visual Studio Code

  1. Acessa code.visualstudio.com e clica em Download for Windows.
  2. O instalador baixa um arquivo executável. Dá duplo clique pra abrir.
  3. Aceita os termos → AvançarAvançarInstalar. Sem mexer em nada.
  4. Ao terminar, pode desmarcar "Iniciar Visual Studio Code agora". Vamos abrir ele na próxima aula com tudo certo.

Esse ambiente assusta à primeira vista, parece complexo. Mas é super simples. Na essência, não é muito diferente do Claude na web.

2. Git for Windows

  1. Acessa git-scm.com/download/win. O download começa automático.
  2. Abre o instalador. Next-next-next em todas as telas.
  3. InstallFinish.

No vídeo, o Leo tenta instalar e aparece um erro porque a máquina dele já tem o Git (usuário visitante). Na sua máquina (que é sua) não vai dar erro nenhum.

3. Node.js

  1. Acessa nodejs.org.
  2. Clica no Windows Installer (versão LTS, não a Current).
  3. Abre o .msi baixado. Next-next-next.
  4. Install, Finish.

No vídeo o Leo demonstra no Windows. No Mac, a lógica é a mesma (3 programas na mesma ordem), só muda o instalador.

1. Visual Studio Code

  1. code.visualstudio.comDownload for Mac.
  2. Download vem em .zip, clica pra descompactar.
  3. Arrasta Visual Studio Code.app pra pasta Applications.

2. Git

  1. Abre Terminal (Launchpad → "Terminal").
  2. Cola xcode-select --install e dá Enter.
  3. Janela aparece perguntando se quer instalar. Install.
  4. Aceita termos e espera terminar.

3. Node.js

  1. nodejs.org → LTS → Mac (Universal ou Apple Silicon conforme o processador).
  2. Abre o .pkg. Next-next-next até o fim.
É uma vez só

Esses três programas instalam uma única vez por máquina. Depois nunca mais. Pode esquecer que existem.

Aula 3 · 9 min

Setup do VSCode · extensões, login e primeira pasta

⏱ 9 min · ↗ Abrir no YouTube

Com os programas instalados, essa aula faz o setup do ambiente: abrir o VSCode pela primeira vez, instalar a extensão de português, instalar a extensão do Claude Code, fazer login, criar uma pasta local (fora do Drive) e testar uma primeira edição de arquivo.

Primeira abertura do VSCode

  1. Aperta a tecla Windows e digita VS Code (ou "Visual Studio Code") → Enter.
  2. Nas janelas iniciais (tour, tema, etc), clica em Skip ou pula até chegar na tela padrão.
  3. Na barra lateral esquerda, o último ícone (quadradinhos) é Extensões. É onde a gente começa.

Instalar a extensão de português

  1. Com a aba de Extensões aberta, pesquisa português.
  2. Instala a primeira opção de português (o pacote de idioma oficial).
  3. O VSCode pede pra reiniciar. Aceita.
  4. Ao reabrir, a interface tá toda em português.

Instalar a extensão do Claude Code

  1. Volta em Extensões, pesquisa claude.
  2. Instala a primeira opção, a extensão oficial Claude Code.
  3. Depois de instalada, aparece um ícone novo na barra lateral: o ícone do Claude.

Login no Claude Code

  1. Clica no ícone do Claude. O painel lateral abre pedindo login.
  2. Clica em Login. Abre uma janela do Chrome.
  3. Como você já tá logado no Claude web com acessos@xperiun.com, basta autorizar. Ele linka as duas contas automaticamente.
  4. Volta pro VSCode. Conectado.

A interface do Claude Code

Quando você clica no ícone do Claude, abre um painel do lado direito da tela do VSCode. A parte maior é o chat (mesma lógica do Claude web). A barrinha lateral de dentro desse painel é o histórico de conversas. É bem parecido com o que você já conhece, só que rodando no seu PC.

Dá pra testar: um "oi", uma pergunta qualquer. Se pedir pra ele pesquisar na web (ex: "quem é a Xperiun?"), ele pede permissão. Clica em Sim. Ele vai pesquisar e responder, e, como o e-mail é @xperiun.com, ele até infere que você é do time da Xperiun.

A regra crítica: trabalhar em pasta local (nunca no Drive)

Regra inviolável

O Claude Code não gosta de trabalhar em pasta sincronizada com nuvem (Google Drive, OneDrive, Dropbox). Se você mandar ele mexer num arquivo que tá no Drive, vai dar conflito. Trabalha sempre numa pasta física do seu PC, dentro de Documentos.

  1. Abre o Explorador de Arquivos do Windows → Documentos.
  2. Clica com botão direito → Nova pasta, chama ela de claude (ou qualquer nome que você quiser).
  3. Volta pro VSCode → Explorer (primeiro ícone da barra lateral) → Abrir pasta.
  4. Seleciona a pasta Documentos/claude que você acabou de criar → Confiar nos autores.
  5. Clica em Nova sessão do Claude (a sessão anterior some porque o Claude salva por pasta).

Teste: criar e editar um arquivo pela sessão

  1. No chat do Claude, pede: "crie um txt vazio nesta pasta".
  2. Claude pergunta "Posso criar?" → Sim.
  3. Um arquivo novo.txt aparece na sua pasta. Confere no Explorador do Windows: tá lá de verdade.
  4. Pede: "edite ele e escreva 'quem é você' no conteúdo".
  5. Claude pergunta de novo → Sim (dá pra marcar "sempre nessa sessão" pra ele parar de perguntar).
  6. Abre o arquivo: o conteúdo tá lá, escrito pelo Claude.
O que você acabou de testar

O Claude mexeu em arquivos reais da sua máquina. Diferente do Claude web, ele não ficou só respondendo: criou arquivo, editou conteúdo, salvou. Esse é o ganho concreto de ter o Claude rodando local.

Aula 4 · 6 min

Clonando o projeto · Xperiun OS do GitHub pro seu PC

⏱ 6 min · ↗ Abrir no YouTube

Até agora você usou o Claude Code "cru", sem contexto da Xperiun. Nessa aula, a gente puxa o Xperiun OS (o sistema operacional com todo o conhecimento da empresa) do GitHub pro seu PC. E daí pra frente o Claude vira outra pessoa: um assistente que já conhece a marca por inteiro.

O que é GitHub (analogia rápida)

Todo mundo conhece Google Drive (Google) e OneDrive (Microsoft). São ambientes de versionamento e compartilhamento de arquivos genéricos. GitHub é a mesma ideia, só que focado em código: arquivos menores, trabalho em equipe, versionamento muito mais rigoroso.

Por que não usar Drive pra isso? Se duas pessoas editam o mesmo arquivo no Drive ao mesmo tempo, a sincronia se perde e fica vago quem fez o quê. Num projeto de código, isso não rola: alguém deleta sem querer e o sistema cai. O GitHub existe pra ter esse cuidado maior com versionamento.

Por ora não precisa dominar

A gente não vai entrar a fundo no GitHub nessa apostila. Aqui você só vai logar e puxar o sistema operacional pro seu PC (baixar uma cópia do projeto). A parte de contribuir de volta (mandar alterações suas pra versão oficial do GitHub) fica pra um treinamento futuro, quando o time tiver demanda real de sincronizar trabalhos.

O que vai pro Drive e o que fica no GitHub

Antes de seguir, uma divisão importante pra você entender desde o começo. É a regra do fluxo de trabalho com o sistema:

A regra do jogo

Conteúdo que VOCÊ produz (carrosséis, copy, apresentações, roteiros, cartas, feed): fica salvo na pasta producao/ dentro do projeto, no seu PC. Pra galera da empresa ter acesso a esse material, você copia ou move pro Google Drive, na pasta certa, exatamente como sempre fez. O Drive continua sendo onde os arquivos ficam organizados pra todo mundo consumir.

Arquivos do sistema (skills, CLAUDE.md, pasta contexto/, design system): não vão pro Drive. Ficam só dentro do projeto e sincronizam entre os PCs do time via GitHub. Quando o Leo cria uma skill nova ou ajusta alguma regra, essas mudanças chegam pra você puxando as atualizações do GitHub. Não é automático: você precisa rodar um comando pra puxar. Como fazer isso vai ser tema de um próximo treinamento. Por enquanto, só saiba que esse tipo de arquivo não precisa ir pro Drive.

Login no GitHub

  1. Abre no navegador: github.com.
  2. Clica em Sign in (Entrar) → Sign in with Google.
  3. Usa a conta acessos@xperiun.com (mesma do Claude).
  4. O GitHub vai mandar um código de verificação pro Gmail compartilhado. Volta na caixa, pega o código, cola. Tá logado.

O repositório privado do Xperiun OS

Uma vez logado, o Leo te mostra o repositório do Xperiun OS (no GitHub, cada projeto vive num "repositório" — é a pasta do projeto lá na nuvem). Ele é privado, ou seja, só abre pra contas autorizadas: se você tentar abrir numa janela anônima ou numa conta de fora, dá erro 404. É por isso que o acessos@xperiun.com é obrigatório.

Clonar o projeto pelo próprio Claude

Ao invés de baixar na mão, vamos pedir pro Claude fazer o trabalho. Isso compensa aprender: o Claude pode executar comandos direto no seu computador (não só responder texto), inclusive baixar o projeto.

  1. No GitHub, na página do repositório Xperiun OS, clica no botão verde Code → aba HTTPS → copia a URL.
  2. Volta no VSCode, abre uma nova sessão do Claude (ainda na pasta claude que você criou na Aula 3).
  3. Manda pro Claude: "clone este projeto no meu PC" + cola a URL que você copiou.
  4. Claude pergunta se pode → Sim.
  5. Na primeira vez, ele vai pedir pra conectar sua conta do GitHub ao VSCode (pra ter permissão de baixar o projeto). Aceita, autoriza.
  6. Ele cria uma pasta vazia primeiro e depois preenche ela com todos os arquivos do Xperiun OS. Demora 1-2 minutos (o projeto é grande).

Atalho na área de trabalho

Abre o Explorador → Documentos → claudexperiun-os. Lá dentro tem um arquivo que funciona como botão de abrir o projeto: clicando nele, o VSCode abre já configurado no Xperiun OS. Cria um atalho pra área de trabalho apontando pra esse arquivo. Assim toda vez que você for trabalhar, clica no atalho e já abre tudo certo.

O primeiro "oi" com o cérebro carregado

Com o projeto aberto no VSCode, clica em Nova sessão do Claude e manda um simples "oi". A resposta dessa vez é bem diferente do "oi" genérico que você deu na Aula 3.

O que o Claude responde agora

"Xperiun OS, o sistema operacional dos incomparáveis. Sou um assistente completo da Xperiun, com acesso a squads de especialistas em copy, storytelling, estratégia... Posso demorar um pouquinho mais do que o normal. Isso é proposital, porque ele tem que acessar o cérebro antes de fazer qualquer coisa."

Se ele respondeu com esse onboarding da Xperiun, tá tudo configurado. Você tem, agora, um assistente que já conhece a marca, os produtos, o tom de voz, os cursos, os depoimentos. Tudo. É aqui que o Xperiun OS começa a valer a pena de verdade.

Aula 5 · 16 min

Primeiros passos no Xperiun OS · CLAUDE.md, contexto e a primeira carta

⏱ 16 min · ↗ Abrir no YouTube

Aula central do treinamento. Primeiro o Leo abre o capô do sistema e mostra o que faz o Claude "entender" a Xperiun: o arquivo CLAUDE.md e a pasta contexto/. Depois, faz uma demo completa: pede uma carta física de parabéns pros alunos destacados e acompanha o Claude do briefing ao PNG final, passando por escolha do especialista, design system e iterações criativas.

O cérebro do Xperiun OS

Quando você dá um "oi" numa sessão nova, o Claude não sabe nada. Zero. A memória dele é zerada a cada nova conversa. Então como é que ele sempre "sabe da Xperiun"? Porque, antes de responder, ele lê um conjunto específico de arquivos que formam o cérebro do sistema.

CLAUDE.md · o arquivo mais importante

O arquivo CLAUDE.md fica na raiz do projeto (a pasta principal, aberta de cara quando você entra no Xperiun OS). A extensão .md é Markdown (texto formatado). Esse é o primeiro arquivo lido em toda nova sessão. É ele que dita:

  • A mensagem de onboarding ("Xperiun OS, o sistema operacional dos incomparáveis...")
  • Regras invioláveis (o que o Claude pode e não pode fazer)
  • Estrutura de pastas do projeto
  • Fluxos de trabalho padrão
  • Como salvar, nomear e organizar cada tipo de entrega

Você não precisa ler esse arquivo de ponta a ponta. Mas vale abrir uma vez pra ter noção do que ele contém. Esse é o cérebro inicial, e vai crescendo ao longo do tempo conforme o Leo adiciona novas frentes.

A pasta contexto/ · a segunda camada

Dentro do projeto existe uma pasta contexto/ com arquivos complementares que o Claude lê também. Os dois mais importantes:

contexto/empresa.md

Quem é a Xperiun, produtos, esteira de vendas, funis, audiência, ferramentas. É muito mais inteligente ter essas informações locais do que informações públicas da internet. O Claude web não tem acesso a ofertas, posicionamento interno, dados da pesquisa de alunos.

contexto/posicionamento.md

O trabalho completo de branding: "escola de dados para profissionais de negócio brasileiros que querem usar dados pra crescer na carreira sem virar dev nem largar sua área". Tom de voz, princípios, o que evitar.

Regra mental: cérebro = CLAUDE.md + contexto/. É o que garante que qualquer entrega já saia alinhada com a marca.

Demo 1 · Uma carta física pros alunos destacados

Pra ver o cérebro trabalhando, o Leo pede ao vivo:

O pedido literal

"Quero enviar um brinde para os alunos que se destacaram no mês. Escreva uma carta pequena pra imprimirmos e enviar junto, parabenizando eles."

O Claude faz três coisas automaticamente, sem ele precisar pedir:

  1. Identifica o especialista certo: chama o agente Robert Collier, um copywriter famoso pelo tom íntimo e emocional, o mais adequado pra uma carta de reconhecimento.
  2. Lê o posicionamento da Xperiun antes de escrever, pra pegar o tom de voz da marca.
  3. Raciocina sobre o leitor: "quem vai abrir essa caixa? Um profissional cansado do dia surpreso com algo físico chegando. O que ele precisa sentir não é um parabéns genérico, é 'alguém de verdade notou'."

No final, ele entrega duas versões da carta pro Leo escolher. Esse "dar opções" é um padrão dos agentes: em vez de forçar uma resposta única, eles devolvem alternativas com raciocínio por trás.

Demo 2 · O design da carta

Com a versão escolhida, o Leo pede: "crie o design da carta". O Claude vai na pasta design/ do projeto e pergunta qual design system usar. As opções nessa pasta são:

  • corporate: design mais sóbrio pra documentos formais
  • powerbiexperience: design legado da época do Power BI Experience
  • xperiun-v1, v2, v3: versões iterativas do design Xperiun
  • xperiun-v4: a mais recente, baseada no manual de cultura do Vítor (o mesmo usado na apresentação Xperiun 2.0)

O Leo escolhe o V4. O Claude gera primeiro um arquivo HTML e depois exporta como PNG.

Detalhe importante

O Claude nunca gera imagem como um designer. Ele sempre cria uma página HTML primeiro e, em cima dela, exporta como se tivesse tirando um print. Isso é por design: é muito mais consistente e fácil de iterar.

Como o V4 é dark (fundo preto, ruim pra imprimir), o próprio Claude detecta o problema e inverte automaticamente pra versão clara. "Ele mesmo percebeu que ia ficar ruim pra impressão, inverteu as cores", comenta o Leo.

Demo 3 · Iteração criativa

O Leo não gosta do resultado do primeiro design e pede: "quero colocar riscos de giz azul no background". Claude refaz, mas os riscos saem sutis demais. Ele mesmo comenta: "tá sutil demais, tem que ser mais visível" e aumenta.

O resultado ainda não é o que o Leo tinha na cabeça ("eu imaginava risquinho fininho por trás"). Lição-chave que o Leo extrai ao vivo:

Briefing ruim → output ruim

Quanto mais específico e direcionado você for no pedido, melhor o resultado. "Riscos de giz azul" é vago. "Risquinhos finos, bem sutis, como marcas de caneta esquecidas no papel" dá uma imagem muito mais clara. A criatividade tá em você, o Claude executa.

O Leo pede "volta como era". Claude reverte. Aí entra a criatividade em jogo: ele testa, você direciona, ele ajusta. É um ping-pong.

A pasta producao/

Tudo que o Claude produz fica em producao/. Essa é sua pasta favorita. Organizada por tipo de entrega:

  • producao/carrosseis-xperiun/ e carrosseis-leokarpa/
  • producao/feed-xperiun/: posts de imagem única
  • producao/roteiro-videos-xperiun/: pré-roteiros pra YouTube
  • producao/apresentacoes/: HTMLs widescreen
  • producao/funis-xperiun/: funis A/B/C/D de lançamento
  • producao/catalogo-xperiun/: VSLs e LPs evergreen
  • producao/plataforma-xperiun/: mockup das telas da plataforma
  • producao/pauta/: banco de temas
  • producao/cartas/: cartas físicas (como a que acabou de ser feita)
  • producao/diversos/: tudo que não cabe nas categorias acima
Autonomia total pra editar

O que você tem no seu PC é diferente do que o Leo tem no dele e diferente do que o Jaidson tem no dele, cada um trabalhando num certo escopo. Usa à vontade, mexa à vontade, cria pastas novas se precisar. A hora de unir as versões vem num próximo treinamento, quando o time tiver demanda real de sincronizar trabalhos.

Lembra da Aula 4

Tudo que sai daqui (carrossel, carta, apresentação) fica no seu PC. Pra galera da empresa ter acesso, copia ou move pro Google Drive na pasta do material, como sempre. O producao/ não substitui o Drive, ele complementa.

Aula 6 · 8 min

Criando skills · da carta à skill permanente

⏱ 8 min · ↗ Abrir no YouTube

O fechamento do ciclo que começou na Aula 5. Lá você criou uma carta do zero (com briefing completo, escolha de design, iterações). Nessa aula, você aprende a transformar esse fluxo numa skill pra não precisar reexplicar tudo na próxima vez. O Leo também explica um conceito crítico: como as sessões funcionam e por que skills e CLAUDE.md são tão importantes.

Por que transformar um fluxo em skill

Depois de fazer a carta pros alunos destacados na Aula 5, o Leo percebe: cartas vão se repetir. Aniversário, parabéns, reconhecimento, boas-vindas. Toda vez explicar tudo de novo seria trabalho inútil.

O pedido literal

"Crie uma skill para salvar esse conhecimento, pra facilitar a criação de novas cartas futuramente."

Regra de bolso: só vale criar skill pra o que é recorrente. Se é algo pontual que você nunca mais vai fazer, não compensa o trabalho de criar. A própria skill vai te dizer isso. Se ela for pouco usada, vira ruído.

O que o Claude faz ao criar uma skill

  1. Estuda o padrão das skills existentes pra manter consistência (estrutura de pastas, nome de arquivos, onde salvar os outputs).
  2. Compila o fluxo inteiro que acabou de ser executado na Aula 5 (briefing, escolha do agente Robert Collier, design system V4, iterações).
  3. Cria a estrutura de arquivos em .claude/skills/carta-xperiun/.
  4. Atualiza o CLAUDE.md na raiz pra incluir a nova skill no onboarding. "Vou atualizar o CLAUDE.md pra refletir que agora existe uma skill nova, senão a próxima sessão nem sabe que ela existe."

Conceito-chave · cada sessão é independente

Regra mental

Cada sessão nova começa com memória zerada. Se você abrir uma nova conversa agora, ela NÃO sabe o que foi falado na anterior. Começa do zero.

Então como é que funciona? Toda vez que uma sessão nova abre, o Claude lê automaticamente o CLAUDE.md e os arquivos de contexto/. Esses arquivos são o que "persiste" de uma sessão pra outra. Por isso skills e CLAUDE.md são tão importantes: sem eles você teria que reexplicar tudo toda vez.

Por que não usar uma conversa infinita pra evitar isso? Dois motivos:

  1. Uma hora a conversa enche. Aparece um botão avisando que o contexto (memória da sessão) tá cheio, e o Claude começa a perder as partes mais antigas.
  2. Melhor abrir sessão nova quando a atual estiver quase enchendo. Evita lentidão e perda silenciosa de contexto.

Demo · rodando a skill recém-criada

Numa sessão nova, o Leo digita /carta-xperiun. O Claude percebe que já tem uma carta produzida na pasta e pergunta: "Quer começar do zero, continuar a anterior, ou fazer uma carta nova?"nova.

Briefing em 4 perguntas:

  1. Tipo da carta? → parabéns por aniversário do aluno, com brinde (chaveiro Xperiun), assinada pelo Leo Karpinski, gancho emocional "escolhe o melhor".
  2. Qual design system? → V4 (o Leo comenta: "talvez compense deixar o V4 fixo na skill pra nem perguntar da próxima vez").
  3. Nome do aluno? → "não precisa".
  4. Claude lembra da preferência salva anteriormente ("riscos de giz azul na decoração") e já incorpora.

Chama automaticamente o agente Robert Collier e entrega duas versões. A recomendada:

"Fulano, hoje é seu aniversário. A gente sabe que provavelmente vai ser um dia normal. Reunião de amanhã... O fulano de um ano atrás olharia pro fulano de hoje com um pouco de inveja..."

Tom reflexivo, nada genérico. Exatamente o resultado que o Claude web sozinho não entregaria, porque não sabe como a Xperiun se comunica.

Salva em producao/cartas/aniversario/. Antes tinha ido pra diversos/ na Aula 5, e o Claude mudou sozinho quando percebeu que essa é a pasta dedicada.

Bônus · Claude também reorganiza pastas

O Leo repara que a carta da Aula 5 ficou em diversos/ e a nova em cartas/. Pede:

Pedido literal

"Mova a pasta da carta em diversos e organize no mesmo local desta."

Claude executa: tira de diversos/, joga em cartas/, organiza em subpastas. "Se eu arrastasse ia ser mais rápido, claro. Mas imagina se eu tivesse um monte de pastas pra reorganizar ou editar nome em massa. Ele faz tudo otimizado, sem ter que fazer um por um."

Dica prática

Instala uma extensão pra visualizar PDF direto no VSCode. Por padrão, o PDF no VSCode fica meio ruim de ver. Com a extensão, resolve.

Resumindo

Fluxo recorrente? Vira skill. Skill nova? Claude estuda o padrão, cria a estrutura, atualiza o CLAUDE.md. Sessão nova? Começa do zero, mas as skills e o CLAUDE.md mantêm o conhecimento vivo. Claude não serve só pra gerar conteúdo: ele move pastas, renomeia em massa, organiza o workspace inteiro.

Aula 7 · 10 min

Conhecendo as Skills do Projeto · tour + primeiras rodadas

⏱ 10 min · ↗ Abrir no YouTube

Skill é um atalho pra uma tarefa recorrente. Você digita / seguido do nome, e o Claude roda uma receita pronta no padrão da marca. Nessa aula, um tour completo pelas skills existentes, uma demo ao vivo de /pauta-conteudo e o encadeamento com /carrossel-xperiun.

Onde moram as skills

As skills ficam na pasta .claude/skills/ do projeto. Cada uma tem seu próprio SKILL.md que descreve o que ela faz. Em vez de abrir arquivo por arquivo (chato), o jeito mais rápido é perguntar pro próprio Claude.

Tour: pergunta e o Claude te explica

Numa nova sessão, o Leo digita:

Pergunta literal

"Explique brevemente o que cada skill da Xperiun faz."

O Claude lista, com uma frase cada:

  • /pauta-conteudo: pesquisa tendências, sugere temas, popula banco de ideias (pro perfil @xperiun ou @leokarpa)
  • /carrossel-xperiun e /carrossel-leokarpa: carrosséis completos com design pronto
  • /feed-xperiun: post único (uma imagem só) pro feed do Instagram
  • /roteiro-video-xperiun: pré-roteiro de vídeo pra YouTube, com a Sayuri
  • /html-slides: apresentações HTML widescreen (pitch deck, workshop, talk)
  • /carta-xperiun: carta física (a que foi criada na Aula 5)
  • /resumir-video: cola o link de um YouTube e ele resume (ótimo pra virar pauta)
  • /funil-c-evento e /funil-a-slo: copy completa de lançamento (uso mais restrito: Leo + Iago + Jaidson por enquanto)
  • /xsquads: squads de especialistas (próxima aula)

A lógica: pauta primeiro, entrega depois

Ordem natural

Antes de sair gerando carrossel/feed/vídeo, rode a pauta primeiro. Ela pesquisa o que tá em alta, sugere temas com lógica de sequência e salva no banco. Aí as skills de produção puxam desse banco e você não fica "no que vamos falar hoje?" toda segunda de manhã.

Carol e Fernando, recado direto: rodem vocês mesmas essas skills e vão melhorando aos poucos. À vontade pra editar.

Demo ao vivo · /pauta-conteudo pro @xperiun

  1. O Leo digita /pauta-conteudo no chat → skill é invocada.
  2. Claude pergunta: "Leokarpa ou Xperiun?" → escolhe Xperiun.
  3. Briefing: "pauta semanal pra Xperiun considerando que vamos lançar na sexta da semana que vem um curso novo de Microsoft Fabric".
  4. Claude detecta automaticamente o feriado na sexta e sugere antecipar pra quinta → Leo aceita.
  5. Pergunta: quantos conteúdos? → 3: carrossel + feed + roteiro de vídeo.
  6. Pergunta se Fabric entra na Completa ou é produto separado → "venda direta separada".
  7. Claude roda dois especialistas em paralelo: um de storytelling e um de hooks/gatilhos.
  8. Faz pesquisa automática na web sobre tendências do Microsoft Fabric.
  9. Compila e entrega a narrativa final: "Fabric não é ruptura, é o andar de cima do Power BI, e você já tem a chave."
  10. Sugere cronograma: carrossel na segunda, feed na quarta, roteiro na quinta.
  11. Avisa que checou conteúdos anteriores pra não repetir ângulos.
  12. Salva em producao/pauta/xperiun/[AAAA-MM]/S5.md (semana 5 de abril).

Encadeamento · /carrossel-xperiun

Numa nova sessão (lembra: cada sessão é independente), o Leo digita /carrossel-xperiun. A skill lê automaticamente a pauta semanal que acabou de ser criada e mostra os temas em aberto (os que ainda não foram produzidos). O Leo confirma "quero produzir o carrossel" e a skill começa a rodar.

Como essas skills são demoradas (3-10 minutos, ela tá carregando design system, referências, tom de voz), o Leo não deixa ela terminar ao vivo. Mas mostra exemplos do que já foi feito: um carrossel técnico sobre DAX DATESYTD (carrossel técnico também dá, só precisa pedir), e o feed derivado do mesmo tema.

Paciência esperada

Pauta: alguns minutos. Feed: 1-3 min. Carrossel: 3-10 min. Funis: até 15 min. Se parece lento, lembra que ele tá carregando dados, referências, rodando agentes. Não clica em stop a menos que passe 15-20 min sem nenhuma mensagem nova no chat.

Aula 8 · 7 min

Squads de especialistas · quando chamar

⏱ 7 min · ↗ Abrir no YouTube

Um dos diferenciais mais ricos do Xperiun OS, e algo que pouca gente tem na internet. Squads são times de especialistas simulados (Copy, Brand, Design, Storytelling, Traffic, Data, Hormozi, C-Level, Advisory Board) que você chama pra decisões mais sérias. Nessa aula: como descobrir o squad certo, como chamar direto, quando pedir ajuda ao Claude pra comparar tasks e quando NÃO chamar squad pra ganhar velocidade.

O que são os xsquads

Na pasta xsquads/ do projeto moram diferentes squads temáticos. Cada squad reúne agentes-especialistas: figuras reais da história (Gary Halbert, Donald Miller, Nancy Duarte, Ray Dalio, Charlie Munger, Naval Ravikant) ou papéis funcionais (Copy Chief, Design Chief, CMO Architect).

A diferença de usar um squad é qualitativa: eles seguem um pipeline estruturado (diagnóstico → execução → review) com checklists de qualidade. É mais criterioso que um pedido solto pro Claude. Tem seu custo: mais tempo, mais tokens. Mas pra trabalhos sérios (uma VSL, uma estratégia de lançamento, um rebranding), o ganho vale.

Jeito 1 · Pergunte ao Claude qual squad usar

Se você não tem ideia de qual especialista chamar, deixa que o próprio Claude diagnostica. Exemplo:

Pergunta literal

"Quero um conselho sobre uma campanha de tráfego da Xperiun. Quem você chamaria?"

Ele responde com um raciocínio do tipo "depende do estágio" e sugere agentes diferentes pra cada etapa: um pra diagnóstico geral, outro pra execução, outro pra escala. É o caminho pra quem tá começando ou pra situações ambíguas.

Jeito 2 · Chame um squad diretamente

Quando você já sabe o que quer, digita / e o início do nome do squad pra ver as opções. Exemplos:

  • /brand-squad:tasks:audit-brand: auditoria completa de marca
  • /copy-squad:tasks:analyze-copy: análise estratégica de uma copy
  • /storytelling:tasks:create-pitch: narrativa pra pitch deck
  • /advisory-board:tasks:evaluate-scaling: decisão de escalar o negócio

Demo do vídeo: o Leo chama /brand-squad:tasks:audit-brand. O Claude lê o contexto da Xperiun e confirma: "assumo que é a Xperiun?" → sim. Ele também oferece "pode ser um concorrente", ou seja, dá pra usar o squad pra estudar concorrentes, não só pra auditar a própria marca. O Leo cancela na hora (pra não consumir token à toa, já que a branding da Xperiun já tá bem estabelecida), mas deixa o caminho documentado.

Lista de squads disponíveis

  • Copy: VSL, email, ads, landing page, headline, bullet points
  • Brand: audit, positioning, arquitetura de marca, naming, arquétipos
  • Design: UX, design systems, handoff pra dev
  • Storytelling: narrativa, pitch, apresentações, manifesto
  • Traffic Masters: ads, criativos, tracking, scaling
  • Data: growth, retention, community, audiência
  • Hormozi: ofertas, pricing, leads, workshops (modelo Alex Hormozi)
  • C-Level Squad: CEO, COO, CMO, CTO, CIO, CAIO virtuais (estratégia executiva)
  • Advisory Board: Dalio, Munger, Thiel, Naval, Sinek, Brené Brown + outros (decisões estratégicas multi-lente)

Dica poderosa · pergunte a diferença entre tasks

Às vezes você encontra duas tasks parecidas (/copy-squad:tasks:analyze-copy vs /copy-squad:tasks:critique-copy) e não sabe qual é qual. Em vez de abrir os arquivos e tentar entender sozinho, pergunta pro próprio Claude:

Exemplo

"Qual a diferença entre analyze-copy e critique-copy?"

Claude responde: analyze = diagnóstico estratégico (onde a copy vai bem, onde tá fraca, o que é a dor principal). Critique = auditoria completa, passando por cada elemento com nota e sugestão.

Quando NÃO chamar squad (o modo rápido)

Por padrão, o CLAUDE.md orienta a chamar especialistas em qualquer trabalho sério. Isso consome tokens e é mais lento. Pra tarefas simples, você pode pular o pipeline:

Pedido literal

"Crie uma carta de parabéns pra Karina Fonseca, que ganhou um torneio de tênis, formato A5, sem usar nenhum especialista, sem pipeline, pra ser mais rápido."

O Claude responde: "vou pular os agentes, só preciso de 3 informações rápidas" e faz direto com o conhecimento dele mesmo. Resultado: sai em segundos, e a qualidade pra uma carta rápida tá mais que boa.

Regra prática

Trabalho sério → squad completo (VSL, estratégia, auditoria, pitch). Trabalho simples → "sem squad, sem pipeline" (carta rápida, legenda, revisão leve). Você escolhe o nível de rigor de acordo com a importância da entrega.

Aula 9 · 6 min

Ajustes finais · bypass, esforço médio e otimizações

⏱ 6 min · ↗ Abrir no YouTube

Aula de fechamento. Três observações importantes que fazem toda a diferença no dia a dia: (1) o ícone de Git na barra lateral e por que ignorar ele por enquanto, (2) como ativar o bypass permissions pra não ter que dar "sim" toda hora, (3) ajustar o esforço de raciocínio do Claude de "alto" pra "médio", o que deixa tudo bem mais rápido sem perder qualidade.

Observação 1 · o ícone Source Control (Git) na barra lateral

Na barra lateral esquerda do VSCode, um dos ícones é o de controle de versões (Source Control / Git), parece um "Y" deitado. Quando você clicar nele, vai ver um monte de arquivos em cor verde e com letrinhas (M, U, A).

Isso significa que esses arquivos foram criados, modificados ou editados depois que você clonou o projeto, ou seja, a sua versão local tá diferente da versão oficial que tá lá no GitHub. É completamente normal e esperado. Não precisa mexer em nada.

Ignore por enquanto

Esse ícone só importa quando você quiser contribuir de volta com o sistema: distribuir uma skill nova pro time inteiro, ajustar uma regra do CLAUDE.md, enviar melhorias pro Leo revisar. Isso vai ser tema de um treinamento futuro. Por enquanto, passa reto.

Observação 2 · bypass permissions (pra não dar "sim" o tempo todo)

Por padrão, o Claude pede permissão pra cada ação: criar arquivo, editar, executar comando. Depois de um tempo isso vira fricção. Dá pra ativar um atalho pra pular esse pedido.

Ativar uma única vez nas configurações:

  1. No VSCode, Gerenciar (engrenagem no canto inferior esquerdo) → Configurações.
  2. No campo de busca: bypass permissions.
  3. Encontra a opção Claude Code: Allow Bypass Permissions → marca a caixinha.
  4. Fecha as configurações.

Como usar no dia a dia:

  1. Ao abrir uma nova sessão do Claude, aparece um novo botão: "Bypass permissions".
  2. Clica nele antes de mandar o pedido → ele vai executar todas as ações da sessão sem perguntar.

Demo do vídeo: o Leo pede "salve um .txt na raiz" → Claude pede permissão (normal). Depois ativa o bypass, pede "salve outro .txt" → Claude salva direto, sem perguntar nada. O botão só apareceu porque a configuração foi ativada primeiro.

Observação 3 · ajustar o esforço de raciocínio

No painel do Claude tem um botãozinho de esforço (ou "nível de raciocínio"). Ele controla o quanto o Claude pensa antes de responder. As opções vão de baixo a muito alto.

Descoberta importante

O Leo percebeu que tava tudo rodando em "esforço alto", e isso deixava tudo desnecessariamente lento. Pra quase tudo no dia a dia, esforço médio já é mais que suficiente e entrega respostas excelentes. Troca pra médio no seu PC e você vai sentir a diferença na hora.

Esforço alto faz sentido pra tarefas muito complexas (análise profunda, estratégia delicada). Pra produzir conteúdo, revisar copy, rodar uma skill, tomar decisão simples, médio é o ponto ideal. Se achar que em alguma tarefa específica vale subir, pode mudar pontualmente.

Canal de dúvidas

Tem um canal no Google Chat pra tirar dúvidas, dar sugestões, reportar quando algo não funcionou como esperado. Pede pro Leo te adicionar se ainda não tiver acesso.

Nas primeiras semanas, é normal travar em coisas bobas: o ambiente é novo, as convenções são diferentes do que você tá acostumada. Não insista tentando "descobrir sozinha" coisa técnica, custa tempo demais. Print, manda no chat, resolve em minutos.

Fim do treinamento

Com essas três observações (ignora o ícone de Git, ativa o bypass, coloca esforço em médio), você tá equipada pra trabalhar de forma autônoma com o Claude Code no Xperiun OS. Usa demais, sem medo. Quando a hora de contribuir de volta chegar, a gente grava um treinamento novo e senta pra definir como juntar as versões. Valeu, abraço.