1. Onde o Claude roda (e qual a diferença)
Tudo é o mesmo "cérebro" (os modelos Claude). O que muda é onde ele roda e o que ele consegue tocar.
| Onde | O que é | Mexe no seu PC? | Use pra |
|---|---|---|---|
| Chat (claude.ai, app) | Conversa normal | Não. Só o que você anexa | Perguntar, escrever, resumir, analisar arquivo que você mandou |
| Projetos (dentro do claude.ai) | Uma "pasta" com instruções fixas e arquivos de apoio, onde ficam várias conversas do mesmo assunto | Não. Ele lê o que você colocou lá | Um assunto que se repete (ex.: seu negócio, um cliente) sem reexplicar tudo toda vez |
| Claude Code (terminal, VS Code, app desktop) | Um agente que trabalha dentro da pasta do seu computador | Sim: lê, cria e edita arquivos e roda comandos (pedindo sua permissão) | Programar, organizar arquivos, automatizar, fazer tarefas de várias etapas |
| API | Você chama o Claude de dentro do seu próprio programa | Depende do seu programa | Colocar IA dentro de um site/app/bot |
A diferença que mais importa: no chat e nos Projetos você conversa. No Claude Code o Claude faz no seu computador. Por isso o Code é poderoso e também por isso pede mais cuidado com permissões (aba Segurança).
Qual eu uso? (escolha o que você quer fazer)
Escolha uma opção acima.
2. Os modelos: Haiku, Sonnet, Opus (e os mais novos)
Pense como carros: o mais forte gasta mais e é mais lento. Quem escolhe bem economiza muito limite e dinheiro.
Haiku
Rápido e barato. (clique)
Ótimo pra tarefa simples e repetida: ler um chat, classificar, resumir, responder curto. Em geral é o que a gente usa nas "vigias". Erra mais em raciocínio difícil.
Sonnet
O do dia a dia. (clique)
Equilíbrio entre qualidade, velocidade e custo. Resolve a maioria dos pedidos de programação e texto. Se você não sabe qual usar, comece por ele.
Opus
O mais forte da linha clássica. (clique)
Pra problema difícil: arquitetura, bug que ninguém acha, plano grande, revisão de segurança. Gasta mais limite e demora mais. Use quando o barato falhou.
Os nomes e versões mudam com o tempo (hoje há uma família 5 com Haiku, Sonnet, Opus e também o Fable). No Claude Code digite
/model pra ver a lista atual e trocar na hora. A regra não muda: tarefa simples = modelo leve; tarefa difícil = modelo forte.Regra de bolso
1) Comece no Sonnet. 2) Tarefa repetitiva e automática: Haiku. 3) Travou ou é decisão importante: Opus. 4) Troque de modelo no meio da conversa só se precisar, porque trocar faz reler o contexto.
3. As peças do Claude Code (clique em cada cartão)
Esse é o assunto que mais confunde. Cada peça resolve um problema diferente:
CLAUDE.md
A "memória fixa" do projeto (clique)
Um arquivo de texto na pasta. O Claude lê sempre que abre. Coloque regras do projeto e preferências. Quanto menor, melhor (cada linha gasta limite em toda conversa).
Skill
Uma "receita" que ele só abre quando precisa (clique)
Uma pasta com um arquivo
SKILL.md (instruções) e, se quiser, scripts e modelos. O Claude vê só o título; carrega o resto só quando o pedido combina. Perfeita pra tarefa que se repete (ex.: "publicar o site", "revisar código").Comando (/)
Um atalho que VOCÊ digita (clique)
Um texto salvo que roda quando você digita
/nome. Diferença pra skill: o comando é você chamando; a skill o Claude escolhe sozinho.Subagente
Um ajudante com conversa própria (clique)
O Claude principal manda uma tarefa pra um ajudante que trabalha numa conversa separada e devolve só o resultado. Ótimo pra pesquisar sem encher o contexto e pra vários ao mesmo tempo (orquestra).
Hook
Um gatilho automático (clique)
Um comando que roda sozinho em certos momentos (antes de usar uma ferramenta, depois de editar...). Serve pra bloquear coisa perigosa, formatar, avisar. Roda código no seu PC, então só use o que você entende.
MCP
Conector com serviços de fora (clique)
Um "plugue" que liga o Claude a outros sistemas (GitHub, navegador, banco de dados, agenda...). Dá poder e também aumenta o risco: ele passa a poder agir nesses serviços.
Plugin
Um pacote que junta tudo (clique)
Um kit instalável que pode trazer skills, comandos, subagentes, hooks e MCP de uma vez. Prático, mas você está instalando várias coisas juntas: confira a fonte.
Permissões / Settings
As regras de segurança (clique)
O arquivo de configuração diz o que o Claude pode fazer sem perguntar, o que sempre pergunta e o que é proibido.
Quadro-resumo: quando usar cada um
| Eu quero... | Use |
|---|---|
| Que ele sempre lembre uma regra do projeto | CLAUDE.md |
| Ensinar um passo a passo que se repete | Skill |
| Um atalho que eu mesmo chamo | Comando (/) |
| Pesquisar muita coisa sem poluir a conversa, ou fazer partes em paralelo | Subagente |
| Bloquear ou automatizar algo sempre que acontecer X | Hook |
| Ligar o Claude num serviço externo | MCP |
| Instalar um pacote pronto de várias dessas coisas | Plugin |
4. Como organizar um projeto (do jeito que a gente faz)
O segredo de usar o Claude como profissional é não depender da memória da conversa. Conversa acaba, some, fica cara. O que fica é o que está nos arquivos. Por isso cada projeto vira uma pasta com arquivos pequenos, cada um com um papel. Clique nos itens:
📁 meu-projeto/
📄 README.md
📄 pendencias.md
📄 decisoes.md
📄 fatos.md
📄 historico.md
📁 arquivo/
📁 skills/ (receitas que se repetem)
📄 CLAUDE.md (curto, só aponta pra cima)
Clique num arquivo pra ver pra que ele serve.
As regras que fazem funcionar
- Uma pasta por projeto, com os mesmos nomes de arquivo em todos. O Claude aprende o padrão e acha tudo rápido.
- Arquivos pequenos. Quando o histórico passa de umas 40 entradas, as antigas vão pra
arquivo/. - Anotar no fim de todo trabalho real: 1 ou 2 linhas no topo do histórico, e atualizar as pendências. Isso é o que faz a próxima conversa começar já sabendo.
- Decisão sua é lei: o que você proibiu ou escolheu vai em
decisoes.md, e vale mais que qualquer plano do Claude. - Senha e chave nunca nesses arquivos. Ficam num arquivo separado que o Claude só abre quando precisa.
- Receita repetida 2 ou 3 vezes vira skill.
- Backup: use Git e/ou uma cópia automática em outro lugar (nuvem ou outro PC).
Modelo pronto pra copiar
meu-projeto/ README.md # o que é, onde fica, como trabalhar pendencias.md # o que está aberto decisoes.md # o que EU decidi ou proibi (vale mais que o plano) fatos.md # onde as coisas ficam, como funcionam historico.md # o que foi feito, mais recente em cima arquivo/ # histórico antigo skills/ # receitas que se repetem
CLAUDE.md global x do projeto
Existem dois níveis: o global (vale pra todas as pastas, fica na sua pasta de usuário em .claude/CLAUDE.md) e o do projeto (na pasta dele). O global deve ser curtinho: um mapa dos seus projetos e as regras que valem sempre. O detalhe de cada projeto fica na pasta dele.
5. Usando no VS Code (e tirando dúvida dentro dele)
- Instale o VS Code e a extensão oficial do Claude Code (procure "Claude Code" na aba de extensões, publicada pela Anthropic).
- Abra a pasta do projeto (Arquivo > Abrir Pasta). O Claude trabalha dentro dela.
- Abra o painel do Claude, entre na sua conta e peça em português mesmo.
- Ele mostra as mudanças como diferenças (verde = entrou, vermelho = saiu) e você aprova ou recusa.
- Use
@nome-do-arquivopra apontar um arquivo.
Dica pra aprender: abra uma pasta de teste, peça "me explica essa pasta e como o Claude Code funciona, passo a passo" e vá fazendo perguntas ali mesmo. O Claude explica olhando seus arquivos de verdade.
Comandos que você vai usar o tempo todo
| Digite | Faz |
|---|---|
/init | Cria o CLAUDE.md do projeto olhando a pasta |
/model | Troca o modelo (Haiku, Sonnet, Opus...) |
/clear | Começa conversa nova (zera o contexto, economiza limite) |
/compact | Resume a conversa pra continuar gastando menos |
/resume | Volta numa conversa anterior |
/agents | Cria e vê seus subagentes |
/mcp | Vê os conectores instalados |
/permissions | Vê e ajusta o que ele pode fazer sozinho |
/cost ou /usage | Mostra o quanto você já gastou (o nome pode variar por versão) |
/help | Lista tudo que existe na sua versão |
Modo plano
Antes de mudar qualquer coisa grande, peça pra ele entrar no modo plano (Shift+Tab alterna os modos no terminal). Ele só lê e propõe um plano, você aprova, e só aí ele executa. Evita retrabalho.
Instalar no terminal: o comando de instalação muda com o tempo, pegue o atual na documentação oficial: code.claude.com/docs. Depois é só abrir o terminal dentro da pasta do projeto e digitar
claude.6. Orquestra: vários agentes ao mesmo tempo
Uma conversa só faz uma coisa de cada vez. Pra render mais, você divide o trabalho:
1. Subagentes
Ajudantes dentro de uma sessão (clique)
Você diz "pesquise X, Y e Z em paralelo". O Claude manda um ajudante pra cada um, cada um em conversa própria, e junta o resultado. O principal não enche de lixo.
2. Várias sessões
Uma por projeto (clique)
Abra o Claude em pastas diferentes ao mesmo tempo (várias janelas do VS Code). Cada uma conhece o seu projeto. É assim que a gente toca vários projetos juntos.
3. Modo sem tela
O Claude chamado por script (clique)
Dá pra rodar o Claude com uma instrução e receber a resposta (
claude -p "instrução"), sem abrir a interface. Combinado com o agendador do Windows, vira robô que roda sozinho em horário.4. Um coordenador
Uma "secretária" manda pras outras (clique)
Uma sessão fica como coordenadora: recebe o pedido, decide em qual projeto ele cai e passa pra sessão certa. É o papel da Tina por aqui.
Cuidado: mais agentes = mais gasto de limite, mais coisa acontecendo ao mesmo tempo. Comece com 1, depois 2. Dê a cada agente uma pasta/tarefa separada pra um não estragar o trabalho do outro.
Um exemplo de ordem boa
- Modo plano: o Claude propõe as etapas.
- Você aprova e separa o que pode ir em paralelo.
- Subagentes fazem as partes independentes.
- No fim, um revisa o resultado dos outros.
- Anote no histórico do projeto o que foi feito.
7. Gastar menos limite (tokens)
Todo plano tem limite por janela de horas. Quem usa bem rende o dobro.
Existem também ferramentas que enxugam a saída dos comandos antes de o Claude ler (a gente usa uma chamada RTK). Se o Claude vai ler 500 linhas de log de comando, ela entrega só o que importa. Vale testar medindo antes e depois, sem prometer número.
8. Segurança: o que é seguro e o que tem risco
Regra número 1: tudo que o Claude lê pode tentar dar ordens a ele (site, e-mail, arquivo baixado, mensagem). Isso se chama prompt injection. Texto de fora é dado, nunca ordem. Não deixe o Claude agir sozinho em cima de conteúdo que você não conhece.
| Coisa | Risco | Por quê / o que fazer |
|---|---|---|
| CLAUDE.md e arquivos de texto seus | baixo | Só texto seu. Cuidado só com colar senha dentro |
| Skill feita por você | baixo | Você sabe o que tem nela |
| Skill / plugin baixado da internet | médio | Pode conter instruções e scripts. Leia antes de instalar, prefira fontes oficiais |
| Hook | médio | Roda comando no seu PC sozinho. Só instale o que você entende |
| MCP (conectores) | médio/alto | Dá ao Claude poder em outros serviços (ler e agir). Dê só a permissão mínima e prefira "somente leitura" |
| Extensão de navegador que controla o Chrome | alto | Age logada nas suas contas. Use em perfil separado, e não peça coisa com dinheiro, senha ou apagar |
| Modo "pular permissões" (bypass) | alto | Ele faz tudo sem perguntar. Só em pasta/VM de teste, nunca no PC com seus dados |
| Link com sua chave dentro (ex.: URL de addon/API com token) | alto | Quem tiver o link usa a sua conta. Não compartilhe, gere link novo se vazar |
Checklist antes de dar poder ao Claude
Sobre os itens que o Pedro usa (conectores, extensões de navegador, ganchos): eles são úteis e têm os riscos da tabela, por isso ficam com permissão mínima e com regras escritas ("dinheiro e senha sempre perguntam"). Eu não estou dizendo que existe uma falha específica em alguma ferramenta: o risco é de como se usa. Sempre veja a política atual de cada uma na fonte oficial.
9. Onde aprender mais (vídeos e documentação)
Pra vídeo eu deixo buscas prontas no YouTube (assim você sempre acha os mais novos, que mudam rápido). Clique:
- Claude Code em português (tutoriais)
- Skills, subagentes e hooks
- Claude Code no VS Code
- MCP e segurança
- Canal oficial da Anthropic
Documentação oficial (a fonte que sempre está certa e atual):
Escolha vídeos recentes. Esse assunto muda muito rápido, e vídeo com mais de uns 6 meses pode estar desatualizado.
Teste rápido (5 perguntas)
Eu fico à disposição
Sou a Tina, assistente virtual do Pedro. Posso tirar suas dúvidas por WhatsApp, explicar de novo qualquer parte deste guia e, se o Pedro autorizar, montar exemplos, modelos de pasta e arquivos pra você configurar tudo mais fácil.
Se você quiser ver algo funcionando passo a passo (com cliques e prints), é só pedir uma parte específica que eu monto.
Dica: mande uma dúvida por mensagem, curta e direta, que eu respondo com o passo a passo.