Claude Code does not reliably follow CLAUDE.md project instructions across sessions
Resolved 💬 3 comments Opened Feb 22, 2026 by mongkonmo Closed Feb 26, 2026
Description
Claude Code does not reliably follow instructions specified in CLAUDE.md project instruction files, particularly when starting new sessions without prior conversation history.
Steps to Reproduce
- Create a
CLAUDE.mdfile in the project root with specific instructions (e.g., "When generating test data, always use emailtest@example.comand nameTest Student") - Start a Claude Code session and perform tasks — Claude follows the instructions
- Start a new Claude Code session (no prior conversation history)
- Ask Claude to perform the same type of task
- Claude ignores the
CLAUDE.mdinstructions and uses default/improvised values instead
Expected Behavior
Claude Code should consistently follow all instructions in CLAUDE.md project files, regardless of whether there is prior conversation history. The instructions should be treated as binding project-level rules.
Actual Behavior
Claude intermittently ignores CLAUDE.md instructions, especially:
- Specific test data requirements (emails, names) that must be used for test generation
- The instructions are read and acknowledged but not reliably applied during task execution
Impact
Users rely on CLAUDE.md to encode project-specific rules that prevent mistakes. When these rules are silently ignored, it leads to:
- Wasted time correcting avoidable errors
- Loss of trust in the tool's reliability
- Frustration when the same mistakes recur across sessions
Environment
- Claude Code CLI (VSCode extension)
- macOS
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗