claude-code - 💡(How to fix) Fix [BUG] Claude Code repeatedly ignores project-level CLAUDE.md rules despite acknowledging them. [2 comments, 3 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#47101Fetched 2026-04-13 05:41:26
View on GitHub
Comments
2
Participants
3
Timeline
6
Reactions
1
Timeline (top)
labeled ×4commented ×2

Error Message

Error Messages/Logs

RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Claude Code repeatedly ignores project-level CLAUDE.md rules despite acknowledging them. Rules like "always use the php-developer agent" and "DB logic goes in services not controllers" are loaded into context at the start of every conversation and explicitly stated in CLAUDE.md, but Claude consistently bypasses them. When called out, Claude apologizes and promises to follow them, then violates them again in the same session. Saving the rules to memory doesn't help — the problem is not recall, it's compliance.

What Should Happen?

Claude.md rules should be followed rigorously - not skipped over. This keeps happening

Error Messages/Logs

Steps to Reproduce

I run a prompt and it ignores the explicit rules that are captured in CLAUDE.md - repeatedly

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.104 (Claude Code)

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

extent analysis

TL;DR

Review and refine the CLAUDE.md rules to ensure they are accurately captured and prioritized, as Claude Code may be misinterpreting or conflicting with them.

Guidance

  • Verify that the CLAUDE.md rules are correctly formatted and unambiguous, as Claude Code may be ignoring them due to inconsistencies or conflicts.
  • Check for any overridden or default rules that may be taking precedence over the project-level CLAUDE.md rules.
  • Test the rules in a controlled environment to isolate the issue and ensure that Claude Code is correctly loading and applying the rules.
  • Consider rephrasing or reorganizing the rules to improve clarity and reduce the likelihood of misinterpretation.

Notes

The issue may be related to the specific implementation or configuration of the CLAUDE.md rules, and further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Refine and clarify the CLAUDE.md rules to improve compliance, as this may help resolve the issue without requiring a version upgrade or other changes.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING