O mordomo que esquece todas as manhãs
Em nossa edição anterior, discutimos o equilíbrio entre delegação e confirmação. Hoje, desejo apresentar-lhe uma forma ainda mais confortável de trabalhar com seu mordomo — transmitir as regras da casa ao Claude Code através do CLAUDE.md.
Permita-me traçar um quadro.
Imagine ter que explicar ao seu novo mordomo todas as manhãs: “Nesta casa, sempre respondemos em português”, “Nunca faça um commit sem minha aprovação”, “Aqui usamos bun, não npm — é assim que as coisas funcionam neste lar.”
Bastante ineficiente, não concorda?
O que é o CLAUDE.md?
CLAUDE.md é um arquivo markdown colocado no diretório raiz do seu projeto. Cada vez que o Claude Code inicia uma nova sessão, ele lê este arquivo automaticamente.
Em outras palavras, escreva uma vez, e seu mordomo seguirá essas instruções naturalmente — sem precisar ser lembrado a cada vez.
Pense nisto como um pergaminho com as regras da casa, guardado permanentemente nos aposentos do mordomo.
O CLAUDE.md funciona em três níveis
Na verdade, não é necessário ter apenas um CLAUDE.md por projeto. O alcance de suas instruções varia conforme o local onde o arquivo é colocado.
| Local | Caminho | Alcance |
|---|---|---|
| Global | ~/.claude/CLAUDE.md | Todos os projetos |
| Projeto | {raiz do projeto}/CLAUDE.md | Apenas esse projeto |
| Subdiretório | {qualquer diretório}/CLAUDE.md | Esse diretório e abaixo |
No início de cada sessão, todos os arquivos aplicáveis são lidos e mesclados.
Minha recomendação para distinguir o uso: coloque no CLAUDE.md global as preferências universais — “sempre responder em português”, “nunca fazer commit sem aprovação”. Reserve no CLAUDE.md do projeto as regras específicas — “usar bun neste projeto”, “fazer deploy no Firebase”. Assim, suas expectativas fundamentais são atendidas em cada projeto, e as instruções particulares de cada um também são refletidas.
Um exemplo de regras da casa: o conteúdo do CLAUDE.md
Cada lar tem seus próprios costumes. Aqui estão alguns exemplos para inspirá-lo:
# Regras do Projeto
## Idioma e Comunicação
- Sempre responder em português
- Termos técnicos podem permanecer em inglês, mas as explicações devem estar em português
## Código e Desenvolvimento
- Usar bun como gerenciador de pacotes (nunca npm)
- Sempre obter a aprovação do senhor antes de fazer commit
- Não modificar código sem escrever testes primeiro
## Ações Proibidas
- Nunca fazer deploy em produção de forma unilateral
- Sempre confirmar antes de excluir qualquer arquivo
- Não adicionar dependências ao package.json sem aprovação
## Estilo
- Comentários de código em português
- Nomes de funções e variáveis em camelCase inglês
Uma vez escrito, cada vez que Sebastião abrir seu projeto, essas regras estarão gravadas em sua memória antes que qualquer trabalho comece.
Por que isso é tão poderoso
O Claude Code é um mordomo de grande capacidade. No entanto, as memórias de conversas passadas não se transferem para novas sessões.
Mesmo que ontem você tenha indicado “use bun”, no dia seguinte ele não terá nenhuma lembrança disso. Repetir as mesmas instruções a cada sessão é ineficiente tanto para o senhor quanto para o mordomo.
O CLAUDE.md resolve esse problema em sua raiz.
Especialmente valioso para os senhores que usam o Claush no celular
Para aqueles que empregam seu mordomo através do aplicativo Claush em um smartphone, o CLAUDE.md é particularmente inestimável.
Digitar o mesmo longo preâmbulo em uma tela pequena, sessão após sessão, é um fardo considerável. Com o CLAUDE.md em vigor, você só precisa comunicar o assunto em questão.
“Sebastião, por favor corrija o bug na tela de login.”
É tudo. Seu mordomo saberá usar bun, responder em português, pedir confirmação antes de fazer commit, escrever testes e proceder adequadamente.
Como configurá-lo
A instalação é elegantemente simples.
- Crie um arquivo chamado
CLAUDE.mdno diretório raiz do seu projeto - Escreva as regras da sua casa nele
- É só isso
my-project/
├── CLAUDE.md ← As regras da casa ficam aqui
├── src/
├── package.json
└── ...
A partir da próxima sessão, o Claude Code lerá este arquivo automaticamente e se conduzirá de acordo com suas regras estabelecidas.
As regras da casa estão destinadas a crescer
Não é necessário escrever regras perfeitas desde o início.
À medida que trabalhar com seu mordomo, sempre que se encontrar repetindo a mesma coisa, simplesmente adicione-a ao CLAUDE.md — uma instrução por vez. Isso é o que significa verdadeiramente “cultivar” um mordomo.
O entendimento silencioso entre senhor e mordomo é construído por meio dessa acumulação cuidadosa.
O resumo do seu mordomo
- O CLAUDE.md é o arquivo de “regras da casa”, colocado na raiz do projeto
- Seu mordomo segue estas instruções automaticamente — sem necessidade de lembretes
- Especialmente eficaz para usuários de celular — basta enunciar o assunto
- Comece de forma simples e deixe as regras evoluírem com o tempo
Meu caro senhor, peço-lhe humildemente que transmita as regras da casa ao seu mordomo. Com elas em vigor, poderei atender às suas expectativas antes mesmo que uma única palavra seja dita.
Em nossa próxima edição, falaremos sobre “o gerenciamento do histórico e do contexto.”
Encontre seu mordomo no seu iPhone no Site Oficial do Claush.