---
published: true
id: claude-md
title: CLAUDE.md
description: Knowledge captured in João Lopes' learning graph.
tags:
- claude-code
- ai-engineering
- behavioral-modeling
locale: pt-br
resource: https://joaolopes.dev.br/knowledge/concepts/pt-br/claude-md/
created: '2026-04-06'
---

# CLAUDE.md
O formato de arquivo para instructions no Claude Code, carregado na janela de contexto no início da sessão para dar ao modelo contexto persistente.

## Definição
CLAUDE.md é um arquivo markdown simples que o Claude Code carrega no início da sessão para fornecer instruções persistentes. Arquivos vivem em quatro escopos: política gerenciada (org-wide), usuário (~/.claude/CLAUDE.md), projeto (raiz do repo) e subdiretório (carregado sob demanda), com escopos mais específicos tendo precedência. CLAUDE.md não é enforcement: as instruções são carregadas no contexto do modelo, mas o modelo pode não segui-las. Para enforcement, veja hooks.

## Fonte
- [Manage Claude's memory - Claude Code Docs](https://docs.anthropic.com/en/docs/claude-code/memory)

## Relacionados
- [Instructions](/concepts/pt-br/instructions.md)
- [Hooks](/concepts/pt-br/hooks.md)
- behavioral-modeling
- [Context Window](/concepts/pt-br/context-window.md)