CLAUDE.md

Claude Code

Definition

A markdown configuration file read by Claude Code at startup that provides persistent context, instructions, project conventions, and tool configurations. Supports a hierarchy: ~/.claude/CLAUDE.md (global), project root CLAUDE.md, and directory-specific CLAUDE.md files. Uses @import for modular organization.

Example Usage

Put coding standards and architecture decisions in the project CLAUDE.md so Claude Code always has context without repeated instructions.

Related Concepts

CLAUDE.md Configuration Hierarchy

Claude Code & Workflows

Project CLAUDE.md is loaded for every conversation; user-level has lowest priority

Modular CLAUDE.md with @import