Press enter or click to view image in full size
Member-only story
CLAUDE.md NEW Best Practices
Nick Babich
5 min readJust now
CLAUDE.md is a Markdown file that Claude Code loads every time it works on a project. Before the release of Opus 5.5 and Fable 5.2, this file used to serve as a project encyclopedia for Claude AI models: it provided an overview of the project’s architecture and a list of SHOUTED rules to follow.
The reason I say “ used to ” is that CLAUDE.md now serves a different functional purpose.
CLAUDE.md is now a short file containing facts Claude can’t discover by reading your repo.
In this article, I will explain the new logic Claude Code follows when working with CLAUDE.md and share best practices for creating an effective CLAUDE.md file for the new generation of Claude AI models.
How Claude works with CLAUDE.md now
Claude Code still follows the same fundamental approach: it adds CLAUDE.md to every session in which it works on a project.…