CLAUDE.md
CLAUDE.md is a Markdown file containing persistent instructions and contextual guidance for Claude Code.
Vibe Engineering
CLAUDE.md is a Claude Code project instruction file containing persistent guidance that is loaded for agent sessions.
- How it is used
- Preserves project instructions across Claude Code sessions and reduces reliance on conversation history.
- How deep it goes
- Explains session loading and compaction tradeoffs, then gives file-reading and command-output rules for controlling context costs.
- Examples
- Provides rules excluding generated directories and lockfiles, narrowing test reads, and filtering test and build output.
- What you can do after
- Operate/configure Claude Code with persistent file-reading and command-output guidance.
Claude at Work
A CLAUDE.md file is a Markdown instruction file that provides Claude Code with project or personal guidance for software development work.
- How it is used
- Provides Claude Code with repository context and working instructions at the start of each session.
- How deep it goes
- Shows Markdown headings and selected instructions, without prescribing a fixed schema.
- Examples
- Uses a design-doc-backed app, an /init prompt, Docker, Helm, Kubernetes, and conventions to avoid mistakes.
- What you can do after
- Configure shared project guidance with /init, resolve missing decisions, and review instructions before later sessions rely on them.
What to know first
- CursorCursor is an AI-powered code editor that integrates artificial-intelligence assistance into software development.
- MarkdownMarkdown is a lightweight markup language that uses readable plain-text syntax to represent structured and formatted documents.
Related concepts
- Markdownuses · Markdown is a lightweight markup language that uses readable plain-text syntax to represent structured and formatted documents.
- Claude Codeconfigures · Claude Code is Anthropic’s command-line AI coding agent for inspecting and modifying codebases and carrying out software-development tasks through natural-language interaction and tools.
- AGENTS.mduses · AGENTS.md is a tool-agnostic Markdown file that provides project context and instructions to AI coding agents, often scoped to a repository or directory.
- auto memoryuses · Auto memory is a mechanism for preserving reusable information outside an active context so it can be recovered later.
- contextuses · Context is the relevant information, state, or circumstances surrounding an input, decision, or activity that influence its interpretation or behavior.
- Git repositorypart of · A Git repository is a directory and version-control database that stores files, commits, and their change history.
Questions about CLAUDE.md
What is CLAUDE.md?
CLAUDE.md is a Markdown file containing persistent instructions and contextual guidance for Claude Code.
Which Manning books explain CLAUDE.md?
Vibe Engineering and Claude at Work.
What should I know before learning CLAUDE.md?
Manning books that teach CLAUDE.md usually introduce Cursor and Markdown first.
What is CLAUDE.md part of?
CLAUDE.md is part of Git repository. A Git repository is a directory and version-control database that stores files, commits, and their change history.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

