Black Friday sale: 30% off Flywrite

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:

# 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, which loads only when it's used.

CLAUDE.md and AGENTS.md

Codex and many other agents read 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 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. Checked .
  2. Claude Code: Extend Claude with skills. Checked .
  3. Claude Code: Overview. Checked .
  4. Flywrite docs: Writing with Claude Code. Checked .

Write with your agent in a writing app.

Buy now