CLAUDE.md Files - Claude Code
Persistent project instructions loaded every session; supports nested dirs.
CLAUDE.md is the canonical place to put project-specific instructions. Claude reads it automatically every session, so you don't have to re-explain the same context.
What it does
A CLAUDE.md at the repo root becomes part of the system context. Nested CLAUDE.md files in subdirectories layer in when Claude works in those paths. Use it for stack overview, conventions, critical rules, common commands, and anything you'd otherwise repeat in every prompt.
When to use it
- Coding standards that should never be broken (style, banned patterns, design rules).
- Architecture overviews so Claude understands module boundaries.
- Stack-specific commands (how to run tests, build, deploy).
- Team-wide prompts you want every contributor's Claude to see.
Gotchas
- Huge CLAUDE.md files eat context budget. Keep it focused - 500 lines is already a lot.
- Nested files stack, they don't replace. A conflicting rule deep in the tree still fires.
- It's committed, so don't put secrets or personal preferences there. Use
~/.claude/CLAUDE.mdfor those.
Official docs: https://code.claude.com/docs/en/memory.md
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Was this helpful?
Related Guides
Related Tools
Claude Code
Anthropic's agentic coding CLI. Runs in your terminal, edits files autonomously, spawns sub-agents, and maintains memory...
View ToolCodeburn
Interactive TUI dashboard that shows exactly where your Claude Code and Cursor tokens are going, in real time.
View Tool
Claude Opus 4.7
Anthropic's flagship reasoning model. Best-in-class for coding, long-context analysis, and agentic workflows. 1M token c...
View ToolConductor
Mac app for running parallel Claude Code, Codex, and Cursor agents in isolated workspaces. Watch every agent work at onc...
View ToolRelated Videos
Generate Videos in Codex + Claude Code with This...
Check out HeyGen! https://heygen.1stcollab.com/developersdigest The video introduces HeyGen, an AI video generation platform with a rich API and a CLI that lets developers create, fetch, and manipula...
10x Design in Claude Code and Codex
Try Higgsfield: https://higgsfield.ai/s/higgsfield-general-campaign-developersdigest-juDMTi AI coding agents can build entire websites in minutes, but the default results often still look generic and...
Self Improving Applications with Claude Code & Codex
Build a Self‑Improving Next.js App: Supabase + Vercel Eve + GitHub Issues + Agent Loops Check out Supabase: https://supabase.plug.dev/1wWOTGS The video demonstrates how to build and deploy a self-im...
Related Posts
Opus 5.5 in Claude Code: The Playbook and Where It Breaks
claude.dev's Opus 5.5 playbook says to name the finish line, delete 'think hard' lines and write stop rules into CLAUDE....
Claude Sonnet 5.5 Developer Guide: Pricing, Benchmarks, and the Five API Changes
Claude Sonnet 5.5 (claude-sonnet-5-5) is Anthropic's new mid-tier model: $2/$10 per million tokens, 70.6% on Terminal-Be...
Claude Opus 5.5 Developer Guide: API Examples, Claude Code Setup, Pricing, and When to Use It
Claude Opus 5.5 (claude-opus-5-5) is Anthropic's new default Opus: $4/$20 per million tokens, $0.20 cache reads, 1M cont...
Claude Outages Are a Workflow Design Problem
Claude outages and 529 overloads expose whether your AI coding workflow has checkpoints, receipts, model-switch paths, a...
Claude Opus 4.8 Is an Agent Honesty Release
Claude Opus 4.8 looks like a benchmark bump, but the developer story is better honesty, dynamic workflows, and effort co...
Karpathy CLAUDE.md Skills: Use the Viral Rules as a Menu, Not a Template
The andrej-karpathy-skills repo exploded because every coding agent needs behavioral rails. The useful move is not copyi...
