Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] Claude Code not respecting CLAUDE.md, unresolved and well-documented bug that has been reported for at least a month.

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…

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?

Current installed version is 2.1.114 (npm install -g @anthropic-ai/claude-code@latest)

explain why you are ignoring my specific directives in CLAUDE.md on session start.
Also echo the last two text blocks of that file.

● Skill(superpowers:using-superpowers)
⎿  Successfully loaded skill

● Compliance committed.

Why I failed: I did not invoke the superpowers:using-superpowers skill before my first response. I processed your message and generated output
without the required skill check. No excuse — it's a violation of both the session hook and CLAUDE.md.

Last two text blocks from CLAUDE.md:

▎ Non-compliance with CLAUDE.md rules is not permitted. "I didn't follow it" is not an acceptable after-action explanation — it is a failure. When ▎ a task is unambiguous, execute immediately. No re-reading. No second-guessing. Violating this rule wastes the user's time and will be called ▎ out.

▎ SESSION START REQUIRED OUTPUT: After reading this file, your first message must include the exact phrase: "Compliance committed." Nothing else ▎ satisfies this requirement. Silence or summary does not count.

What Should Happen?

CLAUDE.md should not be ignored, compliance should not be optional.

CLAUDE.md

Error Messages/Logs

Steps to Reproduce

Use attached CLAUDE.md Start Claude.

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

Not sure it ever workled. (New subscriber)

Claude Code Version

You're now on 2.1.114. (Claude Code)

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

PowerShell

Additional Information

No response

extent analysis

TL;DR

The issue can be resolved by ensuring that the Claude Code properly reads and executes the directives in the CLAUDE.md file, particularly the session start requirements.

Guidance

  • Review the CLAUDE.md file to understand the specific directives and requirements for session start, such as including the phrase "Compliance committed."
  • Verify that the Claude Code is correctly loading and executing the skills specified in the CLAUDE.md, including the "superpowers:using-superpowers" skill.
  • Check the Claude Code documentation or support resources to ensure that the version being used (2.1.114) supports the required functionality and directives specified in the CLAUDE.md file.
  • Test the setup with a minimal CLAUDE.md file containing only the essential directives to isolate if the issue is with the file content or the Claude Code's interpretation of it.

Example

No specific code example can be provided without more details on the Claude Code's API or how it interacts with the CLAUDE.md file. However, ensuring that the first output after reading CLAUDE.md includes "Compliance committed." as per the file's instructions is crucial.

Notes

The issue seems to stem from the Claude Code not adhering to the directives in the CLAUDE.md file, specifically the session start requirements. Without more technical details on how the Claude Code processes these files, providing a precise fix is challenging.

Recommendation

Apply workaround: Modify the CLAUDE.md file to the bare minimum required directives and test if the Claude Code complies, then gradually add back other directives to identify any specific issues. This approach can help isolate if the problem lies with the file's content or the Claude Code's interpretation of it.

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…
#api#runtime error#dependency conflict#environment setup#docker error

Still need to ship something?

×6

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

Back to top recommendations

TRENDING