Answer: CLAUDE.md is a markdown file of persistent instructions you write for Claude, loaded at the start of every session as a user message after the system prompt. It holds project conventions, architecture notes, and "always do X" rules. Status: Confirmed Entry: tool/claude-code/memory-and-context/what-is-claude-md Revision: 2 Digest: sha256:9fa9469d747a751e (changes whenever the content changes) Timeline: Created: 2026-11-13T03:04:18Z Last changed: 2026-11-15T12:21:03Z (user scope location: — → ~/.claude/CLAUDE.md) Last verified: 2026-11-20T12:21:05Z Next check: 2026-11-21T12:21:05Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of definition | A markdown file of persistent instructions you write for Claude | [1] | 2026-11-20 loading behavior | loaded at the start of every session as a user message after the system prompt | [1] | 2026-11-20 suggested contents | project conventions, architecture notes, and "always do X" rules | [1] | 2026-11-20 project scope locations | ./CLAUDE.md | [1] | 2026-11-20 user scope location | ~/.claude/CLAUDE.md | [1] | 2026-11-20 Sources: [1] Anthropic. "Glossary". https://code.claude.com/docs/en/glossary.md Role: primary. Accessed: 2026-11-20T12:21:05Z Quote: "A markdown file of persistent instructions you write for Claude" (Supports: definition) Quote: "loaded at the start of every session as a user message after the system prompt" (Supports: loading behavior) Quote: "Put project conventions, architecture notes, and "always do X" rules here." (Supports: suggested contents) Quote: "You can place CLAUDE.md at project scope in `./CLAUDE.md` or `./.claude/CLAUDE.md`" (Supports: project scope locations) Quote: "at user scope in `~/.claude/CLAUDE.md`" (Supports: user scope location) Published: 2026-11-20T10:31:29Z Snapshot SHA-256: 9710e9dd45dfbb7bc5446cae9c7e560eb798451ecdcf49756a0e31d0797a5f75 (captured 2026-11-20T12:21:02Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:21:05Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:21:05Z Last attempt: 2026-11-20T12:21:05Z Notes and limitations: Extracted automatically from a single official source (section "CLAUDE.md"). Related: https://latestn.com/tool/claude-code/memory-and-context/what-is-compaction What is compaction in Claude Code? https://latestn.com/tool/claude-code/memory-and-context/what-loads-before-typing What loads into Claude Code's context window before I type anything? https://latestn.com/tool/claude-code/memory-and-context/what-survives-compaction What survives compaction in Claude Code's context window? https://latestn.com/tool/claude-code/memory-and-context/layer-claude-md-files-by-directory How do I layer CLAUDE.md files by directory in Claude Code for a monorepo? https://latestn.com/tool/claude-code/memory-and-context/lower-always-on-plugin-cost How can I reduce the always-on token cost of a Claude Code plugin? https://latestn.com/tool/claude-code/memory-and-context/tool-search-default-tools-loaded How many tools does Claude Code tool search load into context by default? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-15T12:21:03Z | changed | user scope location: — → ~/.claude/CLAUDE.md | [1] 2026-11-15T12:21:03Z | changed | project scope locations: — → ./CLAUDE.md | [1] 2026-11-15T12:21:03Z | changed | suggested contents: — → project conventions, architecture notes, and "always do X" rules | [1] 2026-11-15T12:21:03Z | changed | loading behavior: — → loaded at the start of every session as a user message after the system prompt | [1] 2026-11-15T12:21:03Z | changed | definition: — → A markdown file of persistent instructions you write for Claude | [1] 2026-11-15T12:21:03Z | changed | Compaction behavior: Project-root CLAUDE.md survives [compaction](#compaction) and is re-read fresh from disk afterward. → — | [1] 2026-11-15T12:21:03Z | changed | User scope location: ~/.claude/CLAUDE.md → — | [1] 2026-11-15T12:21:03Z | changed | Project scope locations: ./CLAUDE.md → — | [1] 2026-11-15T12:21:03Z | changed | Suggested contents: project conventions, architecture notes, and "always do X" rules → — | [1] 2026-11-15T12:21:03Z | changed | Loading behavior: loaded at the start of every session as a user message after the system prompt → — | [1] 2026-11-15T12:21:03Z | changed | Definition: A markdown file of persistent instructions you write for Claude → — | [1] 2026-11-13T03:04:18Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/memory-and-context/what-is-claude-md/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/memory-and-context/what-is-claude-md POST: https://latestn.com/dispute/tool/claude-code/memory-and-context/what-is-claude-md with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/memory-and-context/what-is-claude-md?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What is CLAUDE.md in Claude Code? Revision 2, last verified 2026-11-20T12:21:05Z. https://latestn.com/tool/claude-code/memory-and-context/what-is-claude-md (accessed 2026-11-21T10:01:38Z). @misc{LatestN_tool_claude_code_memory_and_context_what_is_claude_md_r2, title = {What is CLAUDE.md in Claude Code?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/memory-and-context/what-is-claude-md}}, note = {Revision 2; digest sha256:9fa9469d747a751e; last verified 2026-11-20T12:21:05Z; accessed 2026-11-21T10:01:38Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/memory-and-context/what-is-claude-md