New to AI? Start here → Start 1. What can you do with Claude?
Make a memory note for Claude Code
In one line
CLAUDE.md is the note Claude Code reads first every time it starts working. Write “here’s how to do things in this folder,” and, like Project instructions at the Basics level, you don’t have to explain every time.
The big picture
★ A handoff note to read first thing at work ★
📁 The folder's CLAUDE.md
"This folder is my budget. Don't delete files"
Only read in that folder.
🏠 My shared CLAUDE.md
"Always use plain, simple words"
Read in every folder.
Follow along
Step 1. Start with /init
Start Claude Code in the folder you work in and type /init. Claude Code looks around the folder and makes a first draft of CLAUDE.md.
Step 2. Add your rules in plain words
Illustration (may look a little different from the real screen)
Add these rules to CLAUDE.md: 1) Never delete files; move them to an "archive" folder. 2) Name files as "date_description." 3) Explain things in plain, simple words.
Sample replyI added a "Working rules" section to CLAUDE.md with those three rules. From now on, I'll follow them in this folder.
Step 3. Look at the note and edit it yourself
Type /memory to open the memory files it’s currently reading. CLAUDE.md is a plain text file, so you can also open it in a text editor and change it.
Step 4. A shared note for every folder
What you write in .claude/CLAUDE.md inside your user folder (on a Mac: ~/.claude/CLAUDE.md) gets read no matter which folder you start in. Put things like “Always explain in simple words” here.
Where people get stuck
“It doesn’t follow the rules”
If the note is too long, the important parts get buried. Write a short list, with the most important rules at the top. Clear words like “always” and “never” work well.
“I can’t see the file”
Folders whose names start with a dot (.claude) are hidden. In the Mac Finder, press Command + Shift + period to show them. On Windows, turn on View → Hidden items in File Explorer.
“Does this site have a CLAUDE.md too?”
Yes! Ella Note is also built with Claude Code, and rules like “keep the site’s wording polite” and “hide personal information” are written in its CLAUDE.md.
I'm stuck here
Stuck while following along? Tell me where. Only the site owner sees this. Leave your email only if you'd like a reply.
💌 Get new tips by email
I'll email you when a new tip goes up. No ads, ever.