@~/.claude/file.md syntax in CLAUDE.md not loading personal preferences into context

Resolved 💬 7 comments Opened Oct 2, 2025 by uptownhr Closed Jan 12, 2026

According to the Memory documentation, CLAUDE.md files should support importing additional files using @path/to/import syntax, including files from the user's home directory like @~/.claude/my-project-instructions.md.

Expected Behavior

When a project's CLAUDE.md contains:

# Individual Preferences
- @~/.claude/CLAUDE_PROJECT.md

The referenced file should be loaded into context and appear in /context output under "Memory files".

Actual Behavior

The file is NOT loaded. Running /context shows:

Memory files · /memory
└ User (/home/uptown/.claude/CLAUDE.md): 737 tokens
└ Project (/home/uptown/Projects/project/project-app/sql-view/CLAUDE.md): 783 tokens

No entry for CLAUDE_PROJECT.md appears, even though the file exists and is readable.

Steps to Reproduce

  1. Create a file at ~/.claude/CLAUDE_PROJECT.md
  2. Reference it in a project CLAUDE.md using: - @~/.claude/CLAUDE_PROJECT.md
  3. Run /context in Claude Code
  4. Observe the file is not listed in "Memory files"

Environment

  • Claude Code CLI
  • Platform: Linux

Additional Notes

The file can be read directly via Read tool, confirming it exists and has proper permissions. The @ syntax appears to work for other files but not for home directory references in list format.

View original on GitHub ↗

This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗