CLAUDE.md
ELI5 — The Vibe Check
CLAUDE.md is a special file you put in your project to give Claude Code persistent instructions — your project's personality file. Stack preferences, coding conventions, deployment rules, things to never do — it's all in there. Think of it as onboarding documentation, but for your AI assistant. The better your CLAUDE.md, the better your AI partner.
Real Talk
CLAUDE.md is a project configuration file for Claude Code that provides persistent instructions, coding conventions, and project context. It's read automatically at the start of each session, serving as a system prompt for the coding assistant. It typically includes tech stack details, coding standards, deployment procedures, and project-specific rules.
Show Me The Code
# CLAUDE.md
## Stack
- Next.js 14 with App Router
- TypeScript strict mode
- Tailwind CSS + shadcn/ui
## Rules
- Always use server components by default
- Never use `any` type
- Run `npm test` before committing
When You'll Hear This
"Update the CLAUDE.md with our new API patterns." / "Claude follows the CLAUDE.md instructions — it knows to use our custom hooks."
Related Terms
Claude Code
Claude Code is Anthropic's agentic coding tool that lives in your terminal.
Cursor Rules
Cursor Rules (formerly .cursorrules) are instructions you put in your project to tell Cursor IDE how to behave — like a CLAUDE.md but for Cursor.
Developer Experience
Developer Experience is everything about how pleasant or miserable it is to work with a piece of software as a developer.
Documentation
Documentation is written explanation of how your code works and why.