Magnus·Imersão Claude Code
Imersão Magnus · Aula 1

Sistema operacional do teu negócio dentro do Claude Code.

3 aulas. 3 Operações. No fim, você tem teu kit rodando, skills próprias funcionando, e o método Magnus orquestrado dentro da ferramenta de execução. Distribuível pra tua equipe via 1 comando.

3 aulas (2h30 cada)·3 Operações entre aulas·Office hours opcional após cada aula

Regra única: build along ou fica para trás. Hands on keyboard.

Aula 1 · 07/05/2026

Instalando o sistema

Ao fim, você tem o kit magnus-os rodando, uma skill editada ao vivo e a primeira análise profissional do teu concorrente arquivada.

Bloco 01

Frame + outcome final

Você não vai sair daqui sabendo “o que é Claude Code”. Você vai sair com seu sistema operacional rodando dentro do Claude Code, customizado pro teu negócio, distribuível pra tua equipe.

Estrutura: 3 aulas · 3 Operações entre aulas (14 dias cada) · 1 office hours opcional após cada aula · canal Magnus pra suporte.

Regra única: build along ou fica para trás. Hands on keyboard.

Faça agora

Abre o Cursor numa pasta vazia onde você quer trabalhar (ex: ~/Documents/magnus-os/). Não precisa baixar nada ainda — no próximo bloco vamos instalar o Claude Code e usar ele pra configurar o projeto.

Bloco 02

Os 4 surfaces, decisão clara

Claude tem 4 lugares onde pode rodar. O cérebro é o mesmo. O que muda é o que ele consegue fazer no seu computador.

SurfaceO que fazQuando usar
Web (claude.ai)Chat puro, sem filesystem realBrainstorm rápido, one-shot
DesktopChat + Cowork + Code, com filesystemQuem prefere GUI ao terminal
Code (terminal do Cursor)Filesystem + hooks + subagentes + skills + MCPsOnde vamos morar.
Extensão ChromeAutomação de navegadorTarefa repetitiva no browser
Decisão da imersão: usamos o terminal do Cursor com o Claude Code embutido. Quem prefere terminal puro (Warp, nativo, iTerm), fica à vontade — todas as opções leem do mesmo ~/.claude/.
Bloco 03

Install Claude Code + setup do projeto via Claude

Você começa com o Cursor abrindo numa pasta vazia. Vai instalar o Claude Code, autenticar, e depois usar o próprio Claude pra configurar o projeto magnus-os. Primeiro “a-ha” da imersão.

Parte A — Cria pasta + abre no Cursor

# Cria pasta vazia (qualquer lugar — Documents, Desktop, etc):
mkdir -p ~/Documents/magnus-os
cd ~/Documents/magnus-os

# Abre Cursor nesta pasta:
cursor .

Parte B — Instala Claude Code

No terminal do Cursor (Ctrl+`):

# Mac (recomendado, instala nativo):
curl -fsSL https://claude.ai/install.sh | bash

# Windows: instala Node 18+ (nodejs.org) + Git (git-scm.com), depois:
npm install -g @anthropic-ai/claude-code

# Verifica:
claude --version
claude doctor

Roda claude. Vai abrir o browser pra autenticação. Loga com tua conta Pro/Max.

Parte C — Delega o setup pro Claude

Aqui vem a virada. Em vez de seguir 5 passos manuais (git clone, cd, ler arquivos, etc), você descreve em linguagem natural e o Claude faz. Cole exatamente:

Eu acabei de iniciar este projeto vazio. Quero configurá-lo como o
"magnus-os", o kit Magnus de Claude Code. Faça o seguinte:

1. Faça git clone do repositório
   https://github.com/yuribranco/magnus-os pra dentro desta pasta
   atual (sem criar subpasta — coloca os arquivos direto aqui).
2. Lista o que veio (estrutura de pastas + arquivos principais).
3. Lê o CLAUDE.md e me dá um resumo de 3 frases do que esse kit faz.
4. Lista as skills disponíveis em .claude/skills/ com 1 frase cada.

Claude executa: clona, lista, lê CLAUDE.md, sumariza, e te dá panorama. Em segundos, projeto configurado e você sabe o que tem dentro.

Lição-âncora deste bloco: Claude Code não é só pra escrever código — é pra delegar tarefas em linguagem natural. Setup, configuração, organização, refactor, instalação de skills: tudo em prompt. Esse é o jeito de operar daqui pra frente.
Travou no install ou no clone? Posta no canal Magnus. Equipe responde. Não trava sua aula em troubleshooting individual.
Bloco 04

Comandos essenciais decorados

Decorar 14 comandos hoje vai te poupar 2h por semana de Googling depois.

Comandos do Claude Code

ComandoO que faz
/helpLista tudo
/initClaude lê pasta atual e cria CLAUDE.md
/modelEscolhe modelo (Opus / Sonnet / Haiku)
/contextMostra quanto contexto está usando
/compactResume sessão preservando essencial
/clearSessão zerada
/resumeRetoma sessão anterior
/agentsLista subagentes (Aula 3)
/pluginGerencia plugins
/mcpGerencia integrações externas (Aula 2)

Atalhos críticos

AtalhoO que faz
Shift+TabAlterna modo de permissão (ver abaixo)
EscInterrompe Claude no meio
!comandoBash literal (executa direto)
@arquivo.mdReferencia arquivo na conversa

Modos de permissão (Shift+Tab cicla)

  • Default — Claude pede confirmação pra cada ação. Bom pros primeiros dias.
  • Auto-accept — Claude executa sem perguntar. Modo padrão do Yuri.
  • Plan — Claude planeja TUDO antes de executar nada, espera tua aprovação. Pra tarefas grandes/incertas.
Bloco 05

Contexto + memória: como Claude lembra (e esquece)

Claude tem 2 tipos de memória, e entender a diferença é o que separa operador iniciante de operador profissional. Sem isso, vocês começam sessões de 5h, Claude “fica burro” no minuto 200, e ninguém entende por quê.

Analogia rápida

Janela de contexto = a memória curta da conversa ATUAL. Tudo que falaram, todo arquivo lido, todo comando rodado. Cabe muita coisa (~150 mil palavras) mas tem limite. Quando enche, Claude esquece o começo. Igual reunião de 6h.

Memória persistente = arquivos que ele consulta TODA vez que abre o projeto. Não some entre sessões. CLAUDE.md, business-brain.md, skills — tudo isso. Igual caderno de bolso.

Comandos pra cuidar da janela

ComandoO que fazQuando usar
/contextMostra quanto da janela tá ocupada (%).Sempre que sentir lentidão ou ele esquecendo coisa.
/compactResume o histórico mantendo o essencial.Sessão longa que ainda quer continuar.
/clearApaga tudo e começa do zero (sem fechar a janela).Trocou de tarefa / vai começar coisa nova.
/resumeRecupera última sessão (ou ↑ no prompt).Abriu Cursor de novo no mesmo projeto.
Sintomas de janela cheia: Claude esquece o que falaram no começo · respostas mais lentas · repete info que já tinha dado · /context passa de 70%.

Heurística: sessão > 2h, tarefa nova, ou /context > 60% → /clear ou /compact. Operador profissional reseta cedo.

O que vem agora

Vocês acabaram de ver o que Claude esquece. No próximo bloco mostro o que ele NÃO esquece — o CLAUDE.md, o caderno permanente do projeto. Aulas 2 e 3: técnicas avançadas (auto-memória, salvamento estratégico de contexto, contexto isolado entre subagentes).

Bloco 06

O que é CLAUDE.md

Manual que Claude lê toda vez que abre seu projeto. Sem ele, Claude começa do zero. Com ele, Claude lembra quem você é, qual é o tom de voz, quais são as regras.

Hierarquia (mais específico vence)

~/.claude/CLAUDE.md                       ← global pessoal
magnus-os/CLAUDE.md                       ← do projeto (kit Magnus)
magnus-os/clients/<cliente>/CLAUDE.md     ← lazy: só carrega no cliente

O CLAUDE.md do magnus-os contém: missão, stack, critical files (business-brain, learnings), operating rules (Schwartz First, Implementation-ready, Cite a fonte), skill index e workflow pattern.

Bloco 07

Customizar business-brain ao vivo

CLAUDE.md é o manual do kit. business-brain.md é a alma do teu negócio. Toda skill referencia ele antes de fazer qualquer coisa.

Você vai preencher 4 slots:

  1. ICP (1 frase). Específico. Ex: “Mães 35-50, classe média alta de capital, que querem voltar a trabalhar após filhos crescerem mas têm medo de não conseguir.”
  2. Top 3 ofertas. Nome + preço + o que entrega em 1 frase.
  3. Voice (3 sempre + 3 nunca). Frases curtas vs headlines genéricos vs emojis em B2B.
  4. Regra-âncora. A regra mais importante. Ex: “Toda copy declara Schwartz awareness em comment no topo.”
Bloco 08

O que é skill — testando /ba ao vivo

CLAUDE.md é o manual da empresa. Skill é o playbook de UMA tarefa específica. Todo problema repetitivo do teu negócio merece skill.

Estrutura mínima

nome-da-skill/
└── SKILL.md          ← arquivo único obrigatório

# skills mais complexas:
nome-da-skill/
├── SKILL.md
├── references/       ← docs longos lazy-loaded
├── scripts/          ← código deterministic
└── assets/           ← templates

Frontmatter (o gatilho)

---
name: nome-da-skill
description: O que faz + quando usar (frase pushy)
allowed-tools: WebFetch, Read, Write, Bash
---

Description é o gatilho. Claude lê o frontmatter de TODAS as skills quando abre o projeto e decide se vai usar a skill quando você fala algo.

Progressive disclosure (conceito chave)

Claude lê só ~30 tokens de cada skill na inicialização. Só carrega o resto quando precisa rodar. Por isso você pode ter 50 skills sem matar performance.

Vamos sentir uma skill funcionar — /ba (Breakthrough Advertising)

O kit já vem com a /ba instalada. É a skill que aplica os frameworks de Eugene Schwartz (mass desire + awareness + sophistication) em qualquer copy. Vamos rodar agora.

Faça agora

No Claude Code, dentro de magnus-os/:

/ba quero gerar 2 headlines pro meu produto principal

(descreva: produto, ICP, ticket, mecanismo único)
peça as 2 versões com awareness + sophistication
diferentes e a JUSTIFICATIVA de cada escolha

A skill vai te perguntar coisas que você nunca tinha pensado. Vai forçar você a declarar awareness e sophistication antes de escrever — porque copy não cria desejo, canaliza desejo pré-existente. Saída esperada: 2 headlines + 1 parágrafo de justificativa por que aquela combinação awareness × sophistication faz sentido pro teu mercado agora.

Importante: toda copy que sair do /ba declara awareness + sophistication em comentário no topo. Sem isso, você está escrevendo do gosto, não da estratégia.
Bloco 09

Skill vs Agente vs MCP vs CLI

CLI são os comandos da ferramenta (built-in). Skill, Agente e MCP são as 3 formas de estender a ferramenta.

 CLISkillAgenteMCP
O que éComandos built-inProcedimento markdownMini-Claude isoladoTool/API externa
Quem criaAnthropicVocê ou comunidadeVocêAnthropic, comunidade ou você
Pra que serveOperar o ClaudeTarefa repetitivaTarefa grande isoladaSistema externo
Custo de tokensZeroBaixo (lazy)Alto (context próprio)Médio
Onde moraBuilt-in.claude/skills/.claude/agents/.mcp.json

Aula 1 (hoje): foco em skill. Aula 2: aprofunda MCP (incluindo magnus-mentor). Aula 3: ativa agentes + hooks + output style.

Bloco 10

Como instalar algo do GitHub

Lembra do Bloco 3? Você pediu pro Claude clonar o magnus-os e ele fez. É exatamente assim que você instala qualquer coisa do GitHub a partir de hoje: descreve em linguagem natural, Claude executa.

Por baixo do capô existem 3 caminhos. Bom conhecer pra entender o que Claude está fazendo:

1. Git clone (o que fizemos no Bloco 3)

git clone https://github.com/usuario/nome-skill ~/.claude/skills/nome-skill

Atualizável. Quando o autor publicar nova versão, roda git pull.

2. Download zip

GitHub → Code → Download ZIP → descompacta em ~/.claude/skills/. Mais simples, mas não atualizável depois.

3. Plugin marketplace (avançado)

/plugin marketplace add github:usuario/marketplace-repo
/plugin install nome-do-plugin@nome-marketplace
Operacionalmente: você não precisa decorar comandos. Diz pro Claude “instala a skill X do repositório Y” e ele escolhe o caminho certo.
Bloco 11

BUILD-ALONG: rodar e editar competitive-scraping

O coração da Aula 1. Se um bloco vale tudo, é esse.

Passo 1 — Escolher concorrente

URL de UM concorrente real do teu nicho. Se não tem, escolhe alguém que admira.

Passo 2 — Rodar a skill

No Claude Code, dentro de magnus-os/:

/competitive-scraping https://url-do-concorrente.com.br

Saída em 2-3min: positioning, pricing, copy angles, Schwartz awareness, gaps, recomendações pelo método Magnus.

Passo 3 — Abrir a skill no editor

Abre magnus-os/.claude/skills/competitive-scraping/SKILL.md. Você vai ver: frontmatter, passo a passo, output template.

Passo 4 — Editar a skill

Procura no SKILL.md a seção ## Passo 3 — Mapping competitivo. Adiciona logo abaixo dos itens existentes:

- **Tom emocional dominante:** medo / aspiração / urgência / status
- **3 palavras-chave repetidas no hero:** [extrair as mais frequentes]

Salva (Cmd+S / Ctrl+S).

Passo 5 — Rodar de novo na MESMA URL

/competitive-scraping https://url-do-concorrente.com.br

O output muda. Agora vem com Tom emocional e 3 palavras-chave do hero. Você vê uma skill editada produzindo um output diferente, em segundos.

Passo 6 — Salvar análise

Salva esta análise em clients/EXEMPLO/research/2026-05-07-concorrente-<nome>.md
Saída do bloco: análise profissional do teu concorrente + skill editada + a prova de que skill é editável como qualquer arquivo.
Heads-up Aula 2: a versão atual da competitive-scraping usa fetch básico — ótima pra sites estáticos e maioria dos casos, mas alguns sites SPA-pesados (React/Next/Vue modernos) bloqueiam. Próxima aula a gente plugga uma engine industrial chamada Scrapling que renderiza JS e contorna anti-bot. A skill fica muito mais robusta. Você sai com versão pro.
Bloco 12

Operação 1 + canal

Briefing curto da Operação 1. Detalhes completos abaixo.

Compromisso público: escreve no canal Magnus 1 frase: “Vou usar isso pra resolver [dor específica do meu negócio].”
  • Office hours 1: 14/05/2026 (1 sem após Aula 1, 45min coletivo)
  • Aula 2: 21/05/2026 — magnus-mentor MCP + skill-creator + skill autoral própria
  • Canal Magnus: dúvidas e troca contínua entre aulas
Operação 1

Operação 1 — Inteligência de Mercado

Prazo: 14 dias (até 21/05/2026)

Obrigatórias (4)

  • Rodar /competitive-scraping em 3 concorrentes

    Salva outputs em clients/<seu-projeto>/research/. Posta no canal: 1 print do output mais surpreendente + 1 frase do que te chamou atenção.

  • Customizar business-brain.md com voz autêntica

    Preenche os 4 slots completamente. Voice mínimo: 5 always + 5 never (já tem 3 e 3, expanda). Posta no canal: seções "Sempre" e "Nunca".

  • Editar 1 skill do kit com prompt customizado

    Escolhe 1 skill do kit. Adiciona 1-2 instruções customizadas pro teu nicho. Posta antes/depois do prompt + razão da mudança.

  • Instalar 1 skill de fora

    Outro aluno do canal, GitHub público, ou anthropics/skills. Pratica git clone OU plugin install. Posta qual instalou e por quê.

Bônus (opcional)

  • →Refinar competitive-scraping com 2 instruções customizadas pro teu nicho. Compartilha versão melhorada no canal Magnus.
  • →Roda /schwartz-headline pra teu produto principal. Compara as 5 versões.

Office hours 1: 14/05/2026 · 45min coletivo · link no canal Magnus

Kit

Repositório magnus-os

Tudo que precisa pra Aula 1 já está no repo: CLAUDE.md kernel, business-brain template, 4 skills do kit. Clona e abre no Claude Desktop.

$ git clone https://github.com/yuribranco/magnus-os
$ cd magnus-os
$ claude
Abrir repo no GitHub