Claude CodeBasicClaude Code
Team rules belong in the project's CLAUDE.md
If your conventions live in ~/.claude/CLAUDE.md, a new teammate never gets them: move them to the repo's CLAUDE.md.
CLAUDE.md has three levels: user (~/.claude/CLAUDE.md), project (CLAUDE.md at the root or .claude/CLAUDE.md) and directory. The user file is only yours and is not versioned. The project file is committed and reaches the whole team when they clone. When someone new does not see the conventions, the first thing to check is which level you wrote them in.
Example
Where does each rule live? ~/.claude/CLAUDE.md -> only you (personal preferences) ./CLAUDE.md or ./.claude/CLAUDE.md -> the whole team (committed) ./src/api/CLAUDE.md -> only when working in src/api