Claude Code Ignoring Your Instructions? Real Causes
Published Aug 6, 2026
It feels like being ignored, but it's almost always one of three specific, fixable causes — not the tool arbitrarily disregarding what you asked for.
Cause 1 — most common
The Instruction Isn't Where It Can See It
CLAUDE.md is read at the start of a session — an instruction added mid-session, or living in the wrong file, won't be picked up until the next fresh session starts.
Fix: confirm the instruction is actually in CLAUDE.md before the session starts, not added partway through and expected to retroactively apply. See CLAUDE.md best practices for what actually belongs there.
Cause 2
The Instruction Is Genuinely Ambiguous
What reads as clear to you can have more than one reasonable interpretation without the context you're carrying in your head. What looks like ignoring is often just a different, defensible reading of an underspecified request.
Fix: describe the goal and the constraint explicitly, not just the goal — "fix this test, but don't change the public API" beats "fix this test."
Cause 3
Competing Instructions
A global instruction and a project-specific one can genuinely conflict, and the resolution isn't always the one you'd expect at a glance.
Fix: check for conflicting instructions across CLAUDE.md files and the current prompt before assuming something was skipped — see common errors, explained for the fuller troubleshooting picture.
Check where the instruction actually lives before assuming it was ignored
Add constraints explicitly, not just the goal — ambiguity is the most common real cause
Check for a conflicting instruction elsewhere before repeating yourself louder
A fresh session is needed for a CLAUDE.md change to take effect
New to Claude Code? Start With the Basics
The free guide covers the permission model and a first real workflow — good instruction habits from the start.
Is it actually ignoring me, or is something else going on?
Almost always something else — usually an instruction buried in a CLAUDE.md file it isn't reading, competing instructions, or ambiguity in how the request was phrased. True ignoring is rare.
Should I repeat the instruction louder or in caps?
No — that treats the symptom, not the cause. Check where the instruction actually lives and whether it's genuinely unambiguous first.
Does this mean CLAUDE.md isn't working?
Not necessarily — CLAUDE.md is read at the start of a session, so an instruction added mid-session or in the wrong file won't be picked up until the next fresh session.