# CLAUDE.local.md

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Local instructions, Personal project memory

## Think of it like

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

## 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

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.

## Example code

```bash
echo "CLAUDE.local.md" >> .gitignore
```

Keep the personal file out of git.

## Why it matters

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

## Common mistake

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

## Three principles

- **Personal.** Only you.
- **Same as CLAUDE.md.** Loaded beside it.
- **Out of git.** Add it to .gitignore.

## Related terms

- [CLAUDE.md](https://learn.benibix.com/term/ai/claude-md)
- [.gitignore](https://learn.benibix.com/term/development/gitignore)
- [Claude Code Rules](https://learn.benibix.com/term/ai/claude-code-rules)

## Taught in

- [CLAUDE.md and Auto Memory](https://learn.benibix.com/learn/ai-claude-code/claude-md-and-auto-memory): Claude Code, 7/16

![CLAUDE.md goes into git for the team. CLAUDE.local.md stays on your own computer.](https://learn.benibix.com/diagrams/cc-claude-local-md.svg)

---

Source: https://learn.benibix.com/term/ai/claude-local-md
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
