Skip to content
BENIBIX Learn

CLAUDE.local.md

AI⌨️ Claude CodeClaude Code Concepts

Also known as Local instructions, Personal project memory

Your own CLAUDE.md for one project, kept out of git.

Think of it like

It is like a sticky note on your own desk, not on the class wall.

Example

Lucy uses a test server only she has. She writes its address in CLAUDE.local.md, so Claude knows it and her team never sees it.

Why it matters

It keeps your own notes out of the file the whole team shares.

Definition

CLAUDE.local.md is a personal instruction file that sits in your project folder. Claude Code loads it beside CLAUDE.md and treats it the same way. The difference is who sees it. You add it to .gitignore, so it is never committed and only you get it. Use it for things that are true for you alone, such as your test server or your own way of working.

Example code

bash
echo "CLAUDE.local.md" >> .gitignore
Keep the personal file out of git.
One file for the team, one only for you.

Common mistake

Forgetting to add it to .gitignore. Then your private notes get committed for everyone.

Key takeaways

  1. 1
    Personal. Only you.
  2. 2
    Same as CLAUDE.md. Loaded beside it.
  3. 3
    Out of git. Add it to .gitignore.

Learn it properly