Claude Code-Speichersystem

Jedes Mal, wenn eine Claude Code-Sitzung endet, wird der Kontext gelöscht.

Müssen wir Claude manchmal jedes Mal erneut sagen "verwende pnpm statt npm" oder "unsere Einrückung beträgt 2 Leerzeichen"?Speichersystemwurde genau dafür geschaffen.


Was ist das Speichersystem von Claude Code?

Claude Code hat kein automatisches Gedächtnis über Sitzungen hinweg – jede neue Sitzung beginnt mit einem frischen Kontextfenster.

Das Speichersystem verwendet zwei komplementäre Mechanismen, damit Wissenüber Sitzungen hinweg erhalten bleibtund beim Start jeder Konversation automatisch geladen wird:

Mechanismus Wer schreibt es Am besten geeignet für
CLAUDE.md-Datei Du (der Entwickler) schreibst manuell Projektkonventionen, Teamvereinbarungen, Build-Befehle usw.
Auto-Speicher Claude schreibt automatisch Erfahrung, die aus deinen Korrekturen und Präferenzen gesammelt wurde

Beide Mechanismen werden beim Start jeder Sitzung in den Kontext geladen. Claude behandelt sie alsReferenzkontext, nicht als erzwungene Konfiguration – je spezifischer und prägnanter die Anweisungen, desto konsistenter befolgt Claude sie.


Hierarchische Struktur der Speicherdateien

Claude Code verwendet einevierstufige Speicherhierarchie, mit Priorität von hoch nach niedrig:

1. 企业级配置(Enterprise policy)    ← 最高优先级,只读
2. 用户级 CLAUDE.md                   ← ~/.claude/CLAUDE.md,对所有项目生效
3. 项目级 CLAUDE.md                   ← 项目根目录,随 Git 提交共享给团队
4. 子目录级 CLAUDE.md                 ← src/、api/、tests/ 等子目录,按上下文加载

Die spezifischsten Regeln haben Vorrang: Die CLAUDE.md eines Unterverzeichnisses überschreibt ähnliche Regeln aus höheren Ebenen.


CLAUDE.md-Datei erklärt

Was ist CLAUDE.md?

CLAUDE.mdEs ist eine Markdown-Datei, die im Projektstammverzeichnis (oder Unterverzeichnis) abgelegt wird. Zu Beginn jeder neuen Sitzung wird Claude Code sieautomatisch in den System-Prompt einfügen. Es ist ein Langzeitgedächtnis, das du konfigurieren kannst.

CLAUDE.md erstellen

Methode 1: Verwendung von/initBefehl zur automatischen Generierung

# 在 Claude Code 会话中执行
/init

Claude analysiert deine Verzeichnisstruktur und generiert automatisch ein CLAUDE.md-Gerüst, das auf deinen Tech-Stack zugeschnitten ist. Wenn du es beispielsweise in einem Node.js-Projekt ausführst/init, wird Claude automatisch Frameworks, Testtools, Build-Befehle usw. erkennen und eine erste Datei generieren, die innerhalb von 30 Sekunden zu 80% fertig ist.

Methode 2: Manuelle Erstellung

touch CLAUDE.md

Empfohlene CLAUDE.md-Struktur

# 项目约定

## 技术栈
- 前端:Next.js 15、TypeScript 5.7、Tailwind CSS 4
- 后端:Node.js 22、Prisma 6
- 测试:Vitest 3.2

## 代码规范
- 始终使用函数式 React 组件
- 文件名使用 kebab-case
- 测试文件与源码放在同一目录

## 常用命令
- 构建:`pnpm build`
- 测试:`pnpm test`
- 启动开发服务器:`pnpm dev`

## API 约定
- 所有 API 路由以 `/api/v1/` 开头
- 错误响应格式:`{ error: string, code: number }`

Goldene Regeln für das Schreiben einer guten CLAUDE.md

✅ Tun Sie dies:

  • Verwenden Sie Imperativsätze und kurze Listen, keine erzählenden Absätze
  • Geben Sie konkrete Versionsnummern und Befehle an
  • Fügen Sie Codebeispiele hinzu (ein 5-zeiliges Beispiel ist besser als eine 50-Zeichen-Erklärung)
  • Halten Sie es unter200 Zeilen(alles darüber hinaus wird beim Sitzungsstart nicht geladen)

❌ Vermeiden Sie es, so zu schreiben:

  • Vage Anweisungen wie "Best Practices befolgen" oder "sauberen Code schreiben"
  • Zu viele generische Regeln (nehmen Sie nur Konventionen auf, die für dieses Projekt spezifisch sind)
  • Veraltete Informationen (Überprüfung einmal im Monat empfohlen)

Unterverzeichnis-CLAUDE.md

my-project/
├── CLAUDE.md              # 全局项目规范
├── src/
│   └── CLAUDE.md          # 仅在处理 src/ 文件时加载
├── api/
│   └── CLAUDE.md          # API 特定约定
└── tests/
    └── CLAUDE.md          # 测试特定规则

Claude Code lädt die CLAUDE.md eines Unterverzeichnisses nur, wenn Dateien in diesem Verzeichnis verarbeitet werden, wodurch Tokens gespart und gleichzeitig ein präziserer Kontext bereitgestellt wird.


Auto Memory ausführlich erklärt

Wie funktioniert das?

Auto Memory ermöglicht Claude, Wissen über Sitzungen hinweg zu akkumulierenWissen selbst ansammelnohne dass Sie etwas manuell schreiben müssen. Claude speichert während der Arbeit automatisch Notizen, darunter:

  • Build-Befehle und Debugging-Tipps
  • Notizen zu Architekturentscheidungen
  • Code-Stil-Präferenzen
  • Workflow-Gewohnheiten

Claude speichert nicht jedes Mal alles; es beurteilt, welche Informationen in zukünftigen Sitzungen nützlich sein werdenin zukünftigen Sitzungen nützlichbevor es sie schreibt.

Dateistruktur von Auto Memory

~/.claude/projects/<project>/memory/
├── MEMORY.md          # 简洁的索引文件,每次会话开始时加载(前 200 行)
├── debugging.md       # 调试模式的详细笔记
├── api-conventions.md # API 设计决策
└── ...                # Claude 创建的其他主题文件

MEMORY.mdist der Index des gesamten Speicherverzeichnisses; Claude verwendet ihn, um zu verfolgen, was in jeder Datei gespeichert ist.

Auto Memory auslösen

Wenn Sie Claude bestimmte Dinge mitteilen, speichert es sie automatisch im Speicher:

你:始终使用 pnpm,不要用 npm
你:记住 API 测试需要本地运行 Redis 实例
你:我们的日期格式统一用 ISO 8601

Möchten Sie stattdessen in CLAUDE.md statt in Auto Memory speichern?Sagen Sie es explizit:

你:把这条加到 CLAUDE.md

Auto Memory aktivieren/deaktivieren

Methode 1: Über/memoryBefehl zum Umschalten(siehe nächsten Abschnitt)

Methode 2: In den Projekteinstellungen konfigurieren

// .claude/settings.json
{
  "autoMemoryEnabled": false
}

Methode 3: Umgebungsvariablen

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1
blockquote>

Hinweis:Auto Memory istlokal auf Maschinenebene; alle Worktrees und Unterverzeichnisse desselben Git-Repositorys teilen sich ein Speicherverzeichnis, aberes wird nicht zwischen Maschinen oder Cloud-Umgebungen synchronisiert.。


/memoryAnleitung zur Befehlsnutzung

/memoryist der Kernbefehl zur Verwaltung des Speichersystems.

/memoryBefehlsfunktionen

In einer Claude Code-Sitzung geben Sie/memory, und Sie können:

  • AnzeigenListe aller CLAUDE.md- und Regeldateien, die in der aktuellen Sitzung geladen sind
  • UmschaltenAuto Memory Ein/Aus-Status
  • ÖffnenAuto-Memory-Ordner-Link
  • Wählen Sie eine beliebige Dateizum Öffnen und Bearbeiten im Editor

#Tastenkürzel — schnell eine Erinnerung hinzufügen

Dies ist ein verborgenes Effizienz-Juwel:

# 始终在函数参数中使用具名参数(named parameters)

Drücken Sie#Taste, geben Sie ein, was Sie sich merken möchten, drücken Sie die Eingabetaste — Claude Code schreibt es automatisch in die entsprechende CLAUDE.md-Datei. Perfekt für:

  • Projektkonventionen festhalten
  • Häufige Bash-Befehle speichern
  • Code-Stil-Details notieren

Häufige Probleme und Debugging

Ignoriert Claude die Anweisungen in CLAUDE.md?

  1. Führen Sie/memoryum zu bestätigen, dass die CLAUDE.md-Datei geladen wurde
  2. Stellen Sie sicher, dass Claude Code in dem Verzeichnis läuft, das CLAUDE.md enthält (oder in einem Unterverzeichnis)
  3. Prüfe, ob die Anweisung spezifisch genug ist – „Folge Best Practices“ ist zu vage, während „verwende named imports (tree-shaking-kompatibel)“ effektiver ist
  4. Prüfe, ob die Datei 200 Zeilen überschreitet (Inhalt darüber hinaus wird nicht geladen)

CLAUDE.md ist Kontext, keine erzwungenen Regeln

Claude liestund versucht sein Bestes, CLAUDE.md zu befolgen, aber es gibt keine Garantie für strikte Einhaltung, besonders wenn Anweisungen vage oder widersprüchlich sind. Betrachte es als „einen Arbeitsleitfaden für Claude“ und nicht als „unumstößliche Regeln“.


Praxisnahe Workflow-Beispiele

Szenario 1: Initialisierung eines neuen Projekts

# 1. 在项目根目录启动 Claude Code
cd my-project
claude

# 2. 生成记忆文件骨架
/init

# 3. 审查并完善生成的 CLAUDE.md
/memory  # 打开文件编辑

# 4. 开始工作,Claude 会自动积累记忆

Szenario 2: Debugging-Erkenntnisse festhalten

你:记住,运行集成测试前必须先启动 Docker Compose
Claude:好的,我已将这条记录到 Auto Memory 中。
In der nächsten Sitzung wird Claude diese Abhängigkeit automatisch kennen.

Szenario 3: Teamzusammenarbeit

Lege die des ProjektstammverzeichnissesCLAUDE.mdFühre einen Commit in das Git-Repository durch – der Claude-Assistent jedes Teammitglieds liest dieselben Spezifikationen und gewährleistet so eine konsistente KI-unterstützte Erfahrung.

git add CLAUDE.md
git commit -m "feat: add Claude Code memory configuration"

Zusammenfassung der Best Practices

Szenario Empfohlene Vorgehensweise
Im Team geteilte Spezifikationen CLAUDE.md im Projektstammverzeichnis, in Git eingecheckt
Persönliche Präferenzen ~/.claude/CLAUDE.md(Benutzerebene)
Modulspezifische Regeln Unterverzeichnis-CLAUDE.md
Claude selbst lernen lassen Auto Memory aktivieren, Präferenzen mündlich mitteilen
Temporärer Kontext @docs/filename.mdBei Bedarf referenzieren, nicht in CLAUDE.md hineinzwängen
Aufgabenverfolgung In Markdown-Dateien verwenden[ ]Kontrollkästchen

Referenzressourcen

Weitere Erweiterungen