[DOCS] CLAUDE.md file location equivalence not working as documented

Resolved 💬 3 comments Opened Feb 10, 2026 by hn3000 Closed Mar 15, 2026

Bug Description
After moving my CLAUDE.md back from .claude/CLAUDE.md, I no longer get the suggestion to use /init to create a CLAUDE.md file. The documentation at https://code.claude.com/docs/en/memory says both locations are equivalent, but that doesn't seem to be true.

This is either a documentation problem or a problem in the suggested actions on launch of claude code.

Steps to reproduce:

1 create a new folder
2 invoke claude, ask it to create a sample project
3 answer prompts as appropriate for sample project creation
4 see that CLAUDE.md exists in project top directory
5 exit claude code
6 start claude code (welcome message is very short)
7 exit claude again
8 mkdir -p .claude && mv CLAUDE.md .claude
9 start claude code (welcome message is large box, suggests to use /init)
10 exit claude again
11 mv .claude/CLAUDE.md .
12 start claude code (welcome message is very short again)

Environment Info

  • Platform: darwin
  • Terminal: vscode
  • Version: 2.1.38
  • Feedback ID: a97af87e-d570-43c1-b496-dbb573d84384

Errors
-- no error messages resulted --

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗