Import other files into CLAUDE.md
memory & settings
// what it does
Reference another file from CLAUDE.md with @path/to/file and it is expanded into context at launch — handy for pulling in a README, a package.json, or a shared workflow doc. Relative paths resolve against the importing file, imports can nest up to four hops deep, and paths inside backticks or code blocks are left literal instead of imported. Import @AGENTS.md so Claude and other agents share one instruction file.
// shell
$ See @README.md for the project overview.$ @AGENTS.md$ - @~/.claude/my-project-instructions.md// gotcha
Imports load the file's full content into context every session, so they don't save tokens the way path-scoped rules do — use @ imports for organization, and .claude/rules/ with a paths field when you want content to load only for matching files.