Claude Code: do zero à prática · Capítulo 9 de 23 · 4 min
Guardar as regras do projeto em CLAUDE.md
Registre o que precisa valer em novas sessões e teste se as instruções foram usadas.
Este capítulo faz parte do curso gratuito Claude Code: do zero à prática.
Você repetiu algumas orientações nos pedidos: escrever em português, preservar as anotações, não inventar prazos e não enviar mensagens. Quando uma regra vale em toda tarefa daquele projeto, pode ser registrada em CLAUDE.md. É um arquivo de texto com instruções que o Claude Code carrega como contexto. Ele reduz a necessidade de explicar o mesmo combinado a cada sessão.
A raiz do projeto é a pasta principal do trabalho. Na nossa simulação, é curso-claude, onde já estão as anotações e os resumos. Criaremos o arquivo de regras ali. Isso mantém as instruções do exercício junto do material a que se aplicam, sem transformá-las em preferências para todos os seus projetos.
Envie o pedido com o conteúdo abaixo. Tudo se refere à simulação, por isso não exige que você invente uma empresa, uma assinatura ou comandos de programação.
# Projeto de treino — equipe de pedidos
Esta pasta contém uma simulação para aprender a usar o Claude Code.
## Material de origem
- notas-reuniao.txt registra os fatos da reunião. Preserve esse arquivo.
- Os resumos e rascunhos precisam conservar a identificação de simulação.
## Regras de trabalho
- Escreva em português do Brasil, com acentuação e linguagem simples.
- Preserve responsáveis, prazos e condições das anotações.
- Quando faltar informação, registre a ausência; não invente uma resposta.
- Antes de substituir um arquivo existente, apresente a mudança pretendida.
- Não envie mensagens nem publique o conteúdo deste exercício.
## Conferência
Compare a entrega com notas-reuniao.txt e informe o caminho do arquivo salvo.Abra CLAUDE.md no editor e leia cada linha. O arquivo precisa descrever decisões suas, não convenções que o assistente supôs. Em um projeto existente, o comando /init pode gerar um ponto de partida; ele também exige revisão. Você não precisa acrescentar linguagem de programação, banco de dados ou comandos de construção se a pasta contém apenas documentos.
Testar numa sessão nova
Saia com /exit e abra uma sessão nova com claude, na mesma pasta, sem usar -c. Digite /memory para inspecionar as instruções disponíveis e confirme o arquivo do projeto. Depois faça o pedido abaixo. Esse teste evita atribuir ao arquivo uma regra que o Claude só lembrava da conversa anterior.
A resposta deve manter o português, a identificação de simulação e a data de entrega em aberto. Compare esses pontos com o arquivo de regras e com as anotações. Se uma instrução não for seguida, confira o caminho carregado, a clareza do texto e a existência de regras conflitantes. Não acrescente a mesma regra em vários lugares apenas para enfatizar: as cópias podem divergir depois.
Diferenciar instrução de memória automática
Além das instruções que você escreve, o Claude Code pode manter notas de memória automática. São registros produzidos pelo assistente a partir do trabalho, e devem ser revisados pelo usuário. /memory ajuda a inspecionar esses mecanismos. Memória automática não é uma terceira versão do CLAUDE.md nem um lugar para guardar senhas. Corrija uma anotação equivocada antes que ela influencie novas tarefas.
Há instruções pessoais, instruções do projeto e regras aplicadas a partes específicas do trabalho. Alguns projetos usam AGENTS.md, que o Claude Code também pode ler conforme a configuração. Não mantenha dois manuais contraditórios nem suponha que uma frase sempre “vence” outra: inspecione as instruções efetivamente carregadas. Para começar, o arquivo curto na raiz da pasta de treino é suficiente.
Use CLAUDE.md para regras gerais. Guarde um procedimento longo e específico, como preparar o resumo, em uma skill. Para impedir uma ação, como publicar sem aprovação, configure também os controles de acesso da ferramenta; o arquivo de instruções orienta o modelo.
Anotações pessoais (opcional)
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.
Terminou a leitura?
Você está aqui: capítulo 9 de 23
0 de 23 concluídos
- Próximo · Capítulo 10 de 23 · 6 minPlanejar mudanças e reutilizar um procedimentoLer o capítulo 10 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 8 de 23 · 4 minRetomar a conversa e acompanhar o usoVoltar para o capítulo 8