anthropics / anthropics/claude-code

Docs: clarify whether /compact reloads user-level ~/.claude/CLAUDE.md, not just project-root CLAUDE.md

Offen Anfängerfreundlich
#91,243 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
documentation enhancement
Vorherrschende Sprache
Python
Sterne
145k
Forks
23.1k
PR-Merge-Kennzahlen
PR-Kennzahlen ausstehend

Beschreibung

Title: Docs: clarify whether `/compact` reloads user-level `~/.claude/CLAUDE.md`, not just project-root CLAUDE.md

## Summary

The troubleshooting/docs content around `/compact` explicitly states that
**project-root** `CLAUDE.md` is re-read after compaction. It does not say
anything about the **user-level** `~/.claude/CLAUDE.md` — even though that
file is documented elsewhere as its own distinct scope, loaded alongside the
project-root file at session start via the same mechanism.

This leaves it unclear whether:

- `/compact` also re-reads `~/.claude/CLAUDE.md` from disk (picking up
mid-session edits), or
- only project-root `CLAUDE.md` gets this treatment, and `~/.claude/CLAUDE.md`
is fixed to whatever was loaded at session start until a restart.

## Why this should be documented

It's architecturally plausible both files are reloaded the same way, since
they're loaded through the same mechanism at session start — but that's an
assumption, not something the docs currently confirm. Anyone who wants to
rely on `~/.claude/CLAUDE.md` for standing instructions and needs to know
whether an edit takes effect after `/compact` (vs. requiring a session
restart) currently has to test it themselves rather than find it documented.

## Suggested addition

A one-line clarification next to the existing "`/compact` re-reads
project-root CLAUDE.md" note, stating explicitly whether user-level
`~/.claude/CLAUDE.md` is included in that reload or not.

## Environment

- Claude Code CLI, VS Code extension context

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Rechercherichtung

Start with the troubleshooting/docs content that describes `/compact` and the existing note about re-reading project-root `CLAUDE.md`. Verify whether user-level `~/.claude/CLAUDE.md` is also reloaded, then add a one-line clarification stating the documented behavior.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
cli, documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Aktiv
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
76/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.