Choose other name for "CLAUDE.md" (again)

Status Closed — not planned
Maintainer reply None cached
Activity 11 comments · opened Sep 3, 2025 · closed Jan 13, 2026

Previous issue was closed with "wontfix" without properly addressing concerns of the users. Reopening it again, as it's clearly becoming very annoying issue with Claude Code in real world projects/teams and deserves at least proper discussion and attention.

Previous issue: https://github.com/anthropics/claude-code/issues/995#issue-3047073190

"Solution" provided says:

Our recommendation for this is to use imports to configure Claude Code memory. You can put "Read @AGENTS.md for more info" in the CLAUDE.md to configure Claude Code.

My understanding of that solution is to have user-level CLAUDE.md with instruction to read AGENTS.md. That's a nice workaround, but it removes a lot of benefits of the current memory system - no "# Remember ...", no recursive discovery of (currently) CLAUDE.md in the projects subfolders, etc.

This workaround may work for some cases, but it clearly doesn't address all the concerns discussed in the previous issue.

View original on GitHub ↗

11 Comments

github-actions[bot] · 12 months ago

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/995
  2. https://github.com/anthropics/claude-code/issues/1091
  3. https://github.com/anthropics/claude-code/issues/6235

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

PatrickHeneise · 12 months ago

We'd like to use a different filename too.

peterHoburg · 11 months ago

Claude Code being the odd one out and not supporting AGENTS.md out of the box is becoming really annoying when working on repo with people who use cursor/codex. Yes I know the "solution" (@AGENTS.md in CLAUDE.md), but that is just a hack. Please consider supporting AGENTS.md.

ferdinandyb · 11 months ago

It's not even a solution since the agents.md spec says their is a hierarchy of agents.md as you can put the in subfolders as well

Uzere · 11 months ago

I’m going to consider switching to another tool if this isn’t made configurable.

pidgeon777 · 10 months ago

I hope AGENTS.md will be the only one used.

github-actions[bot] · 8 months ago

This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.

divan · 8 months ago
If the issue is still occurring

All the time )

github-actions[bot] · 7 months ago

This issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.

marcindulak · 7 months ago

This issue was closed incorrectly despite recent human comments. This behavior of the bot is reported at https://github.com/anthropics/claude-code/issues/16497. Upvote or comment on that issue, so maybe it gets noticed.

github-actions[bot] · 7 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.