CLAUDE.md explained
What is CLAUDE.md?
CLAUDE.md is a Markdown file that gives Claude Code persistent project instructions, workflow preferences, and context.
CLAUDE.md meaning
`CLAUDE.md` is used by Claude Code as a memory and instruction file. Anthropic describes these files as Markdown files that give Claude persistent instructions for a project, personal workflow, or organization.
What to put in CLAUDE.md
- Project overview and goals
- Commands for setup, tests, lint, and build
- Preferred coding style
- Architecture notes and important paths
- Review rules and safety constraints
- Links to DESIGN.md, API docs, or other project notes
CLAUDE.md vs AGENTS.md
AGENTS.md is a broader convention for coding agents. CLAUDE.md is Claude-specific. If you use multiple AI coding tools, keep shared instructions in AGENTS.md and Claude-only preferences in CLAUDE.md.
How CLAUDE.md helps AI coding
A good CLAUDE.md reduces repeated explanations. It tells the assistant how to run the project, what files matter, how to verify changes, and what style to follow. That can make AI-assisted work faster and more consistent.
Preview CLAUDE.md before using it
Use Markdown Docs online editor to preview headings, command blocks, and lists. For local projects, install Markdown Docs and open CLAUDE.md directly from Windows.
Related references
- Anthropic Claude Code memory docs for CLAUDE.md behavior.
- Claude Code overview for Claude Code context.
FAQ
Is CLAUDE.md only for Claude Code?
Yes, CLAUDE.md is most closely associated with Claude Code. Other tools may not read it unless they explicitly support that convention.
Can I have both CLAUDE.md and AGENTS.md?
Yes. Many teams can use AGENTS.md for shared agent rules and CLAUDE.md for Claude-specific context or preferences.
Should CLAUDE.md be short?
Usually yes. Keep it focused and link to deeper Markdown files for long architecture, design, or process notes.