# CLAUDE.md

CLAUDE.md is the Markdown file of standing instructions Claude Code reads at the start of every session. Where it goes and what to put in it, with an example.

**Definition:** CLAUDE.md is a Markdown file of standing instructions that Claude Code reads at the start of every session, such as how you like drafts edited or which files to leave alone.

## Where it goes

| File | Applies to |
| --- | --- |
| `CLAUDE.md` or `.claude/CLAUDE.md` in the project folder | Everyone who works in that project |
| `~/.claude/CLAUDE.md` in your home folder | You, in every project |
| `CLAUDE.local.md` in the project folder | You, in that project only; keep it out of Git |

Claude Code loads the CLAUDE.md files in the folder you start it in and every folder above it. A CLAUDE.md in a subfolder loads when Claude works on files there.

## What to put in it

Instructions Claude couldn't work out from the files themselves. For a newsletter project:

```markdown
# Newsletter

- Write in short, plain sentences. No hype words.
- Drafts are in issues/. Don't edit anything in published/.
- Keep each issue under 1,200 words.
- Ask before deleting a section.
```

Keep it short: Anthropic's docs suggest under 200 lines, because a longer file takes more context and is followed less closely.

A procedure you only run now and then, such as a pre-send checklist, belongs in a [skill](/glossary/claude-code-skills), which loads only when it's used.

## CLAUDE.md and AGENTS.md

Codex and many other agents read [AGENTS.md](/glossary/agents-md) instead. Claude Code reads a project's AGENTS.md when the project has no CLAUDE.md, and a CLAUDE.md can include one with an `@AGENTS.md` line, so one file can serve every agent you use.

## In Flywrite

CLAUDE.md is an ordinary Markdown file, so it opens in Flywrite like any draft, and the file tree shows it with the rest of the project, `.claude/` folder included. Claude Code started in Flywrite's terminal reads it as it would anywhere. The [newsletter guide](/guides/claude-code-newsletter-drafts) puts a voice file to work this way.

## Questions

### Does Claude Code always follow CLAUDE.md?

It reads the file every session, but treats it as context rather than enforced rules. Short, specific instructions are followed more reliably than long or vague ones.

### How do I start a CLAUDE.md?

Run /init in Claude Code and it writes a starting file from what it finds in the folder. Then edit it like any other Markdown file.

## Sources

1. [Claude Code: How Claude remembers your project](https://code.claude.com/docs/en/memory), checked 2026-11-10
2. [Claude Code: Extend Claude with skills](https://code.claude.com/docs/en/skills), checked 2026-11-16
3. [Claude Code: Overview](https://code.claude.com/docs/en/overview), checked 2026-11-10
4. [Flywrite docs: Writing with Claude Code](/docs/writing-with-claude-code), checked 2026-11-17

---

This is the Markdown copy of https://flywrite.app/glossary/claude-md.
