Setup Completo: do zero ao Claude Code · Capítulo 12 de 18 · 10 min
Registre suas preferências uma vez para o Claude lembrar sempre
Um briefing permanente em texto comum poupa minutos de reexplicação em cada sessão e deixa o Claude no seu tom.
Este capítulo faz parte do curso gratuito Setup Completo: do zero ao Claude Code.
Toda vez que você abre o Claude Code, ele começa zerado, sem lembrar de nada da sessão anterior. Na prática, é como receber um estagiário novo toda manhã: competente e rápido, porém sem a menor ideia de como você trabalha. Você gasta os primeiros minutos repetindo instruções, e ainda corre o risco de ele decidir por conta própria justo onde você nem chegou a orientar.
O CLAUDE.md é o briefing permanente que resolve isso. É um arquivo de texto, escrito em português comum, com as orientações que você daria a esse estagiário no primeiro dia e que passam a valer para sempre: como você gosta das respostas, o que nunca fazer, como são os seus projetos. O Claude Code lê esse arquivo assim que abre e já começa "sabendo de você". Você escreve uma vez, e ele aplica a cada sessão. Suponha um escritório de contabilidade que registra ali "clientes são tratados por senhor e senhora": todo e-mail que o Claude rascunhar já sai nesse tom.
VOCÊ digita "claude" no terminal
│
▼
Claude Code inicia
│
├── Procura CLAUDE.md em %USERPROFILE%\.claude\ (global)
│ └── Lê preferências globais do usuário
│
├── Procura CLAUDE.md na pasta atual (local)
│ └── Lê contexto específico do projeto
│
├── Carrega %USERPROFILE%\.claude\settings.json
│ (permissões, MCPs, hooks)
│
└── Agora aparece o cursor esperando instruções
JÁ sabendo suas preferências. (tudo em uma fração de segundo)Existem dois lugares para colocar esse arquivo
| Onde | Quando vale | Exemplo |
|---|---|---|
| Pasta do usuário | Para TODOS os seus projetos | "Sempre responda em português", "Sem emojis" |
| Pasta de cada projeto | Só para aquele projeto | "Este projeto usa Tailwind", "Não mexa em backup/" |
┌─────────────────────────────────────────────────────────────────┐ │ CLAUDE.md (%USERPROFILE%\.claude\CLAUDE.md) — □ × │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ # Minhas preferências │ │ │ │ Responda sempre em português do Brasil, com acentuação correta. │ │ │ │ Seja direto e curto. Sem rodeios, sem preâmbulos. │ │ │ │ Não use emojis em nenhuma resposta ou arquivo. │ │ │ │ Antes de apagar qualquer arquivo, me avise e peça confirmação. │ │ │ │ Quando eu pedir um site, use HTML simples + Tailwind CDN. │ │ Não monte projeto Next.js salvo se eu pedir explicitamente. │ │ │ │ Meu nome é Maria. Me chame de você, não de tu. │ │ │ │ ↑ Cada linha aqui economiza uma explicação a mais por sessão. │ └─────────────────────────────────────────────────────────────────┘
Forma fácil: deixe o próprio Claude criar o arquivo.
- 01Abra o Claude Code (PowerShell ou terminal do VS Code, digite
claude). - 02Digite /init e aperte Enter.
- 03O Claude vai olhar a pasta atual, entender o que tem dentro e criar um CLAUDE.md automaticamente com sugestões.
- 04Ele te mostra o conteúdo proposto antes de salvar. Aceite ou peça ajustes em português.
Se preferir escrever você mesmo, siga a forma manual
- 01Aperte Windows + R, digite %USERPROFILE%\.claude e Enter.
- 02Clique com botão direito na pasta → Novo → Documento de Texto.
- 03Renomeie para CLAUDE.md (apague o
.txtno final). - 04Clique com botão direito → Abrir com → Visual Studio Code.
- 05Cole o exemplo abaixo, ajuste como quiser, salve com Ctrl+S.
Exemplo de CLAUDE.md para iniciante
# Minhas preferências
Sempre responda em português do Brasil, com acentuação correta.
Seja direto e curto. Sem rodeios.
Não use emojis em nenhum lugar.
Antes de fazer uma alteração grande, me explique o que vai fazer e peça confirmação.
Quando eu pedir uma página de site, use HTML simples com Tailwind via CDN — não monte projeto Next.js a não ser que eu peça.
Se eu falar algo confuso, pergunte para esclarecer em vez de adivinhar.Você não precisa escrever isso em "linguagem técnica". Pode ser exatamente como você falaria com uma pessoa: "prefiro respostas curtas", "sempre me lembre de fazer backup antes de apagar arquivos", "meu nome é Maria, me chame de você não de tu". O Claude entende e aplica.
Atalho dentro do Claude Code: digite /memory para abrir e editar a memória sem sair da conversa. Mantenha o arquivo abaixo de 200 linhas, como recomenda a Anthropic: ele é lido em toda sessão e ocupa espaço de trabalho do modelo. Material de consulta longo vai para arquivos à parte.
Atalho turbo: uma entrevista de 5 perguntas que monta o seu CLAUDE.md sob medida.
Em vez de você ficar pensando "o que escrever?" diante de um arquivo em branco (como aquele momento em que abrem o caderno na primeira página e a caneta paralisa), deixe o Claude te entrevistar. Cole o prompt abaixo e responda as perguntas em português normal; ele monta o documento por você.
Pense no CLAUDE.md como o briefing que você daria a um estagiário novo no primeiro dia: ele não precisa saber tudo, só o suficiente para acertar 80% das coisas sem te pedir confirmação. O resto ele aprende com o tempo, e com você acrescentando regras pelo /memory.
Crie o seu CLAUDE.md com três a cinco preferências, por qualquer um dos três caminhos. Depois feche o Claude Code, abra de novo e peça "resuma minhas preferências". Acertou se ele repete o que você escreveu sem você colar nada. Repetiu? Ele já chega sabendo de você.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Depois, siga para
- CursoClaude Code CLI: Programação com IA
- CursoAgentes de código para executivossugerido pelo grafoO Setup ensina permissões, contexto do projeto e escolha de modelo por custo. Essa preparação sustenta os exercícios de comparação de assistentes, criação do gerador de UTM e regras de projeto no curso de aprendizado por reforço e vibecoding.
- CursoSetup de Vibecoding no Macsugerido pelo grafo11 capítulos de “Setup de Vibecoding no Mac” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
- CursoVídeo com IA: Claude Code, Codex e ElevenLabssugerido pelo grafo7 capítulos de “Vídeo com IA: Claude Code, Codex e ElevenLabs” usam conceitos apresentados em “Setup Completo: do zero ao Claude Code”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Setup de Vibecoding no MacCLAUDE.md — a memória do Claude sobre vocêExaminar conexões de CLAUDE.md — a memória do Claude sobre você
- Claude Code CLI: Programação com IAEscrever o CLAUDE.md, o manual que o Claude sempre lêExaminar conexões de Escrever o CLAUDE.md, o manual que o Claude sempre lê
- VS Code: Do Zero ao Editor ProfissionalClaude Code: o que um líder faz sem programarExaminar conexões de Claude Code: o que um líder faz sem programar
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.