Write it once. Claude reads it at the start of every session. No more re-explaining your clients, workflow, or preferences from scratch.
A plain markdown file that lives in your project folder. Claude Code reads it automatically every time you start a session. It's your AI handbook — the thing that makes Claude remember everything about your work without you repeating it. Think of it as a permanent briefing document for your AI assistant.
| ✓ Write this | ✗ Skip this |
|---|---|
| Client name, industry, what they do | Stuff already in your files (Claude can read those) |
| Brand voice and tone (warm, mentor-like, never corporate) | Every possible edge case — keep it focused |
| Your preferences ("use bullet points, not numbered lists") | Things you only need once — put those in your prompt |
| Key rules ("never mention competitors") | Passwords or API keys — those belong in .env |
| What the project produces and for whom | Personal opinions that might change next week |
| File and folder structure | Duplicate info already in your README |
| Location | Scope | Use for |
|---|---|---|
~/.claude/CLAUDE.md | Global — all projects | Your personal preferences, writing style, universal rules |
[project]/CLAUDE.md | Project — this folder only | Client info, project-specific rules, file structure |
[subfolder]/CLAUDE.md | Folder — that subfolder | Module-specific rules (rarely needed) |
Start small. Your first CLAUDE.md doesn't need to be perfect. Write the 5 most important things Claude should know about your work. You can add more as you go — Claude reads any updates automatically.
HivePowered AI — AI Like a Pro Training | CLAUDE.md Guide