Den Kontext von Claude Code verwalten: ein praktisches Handbuch

Anthropics Claude Code und die erweiterte Claude-Familie geben Entwicklern nun eine beispiellose Kontrolle über wie viel das Modell sieht und wie tief Die Gründe dafür liegen auf der Hand. Aktuelle Produktupdates (insbesondere das Sonnet 4 1-Million-Token-Kontextfenster und Claudes erweiterte „Denk“-Steuerelemente) machen die Kontextverwaltung leistungsfähiger und wichtiger: Sie können ganze Repositories in einer einzigen Sitzung verarbeiten – allerdings nur, wenn Sie Eingabeaufforderungen, Dateien und Sitzungsstatus bewusst strukturieren. Dieser Artikel erklärt, wie Sie den Kontext von Claude Code zuverlässig verwalten: Befehle und Verwendung, Denkbudget-Kontrolle, CLAUDE.md-Muster, Subagent-Workflows, Tipps für Power-User, Fehlerbehebung und konkrete Codebeispiele zum Kopieren und Einfügen.

Was ist Claude Code?

Claude Code ist Anthropics Agentencodierungs-CLI – ein Terminal-First-Tool, das Ihre Entwicklungsumgebung mit Claude-Modellen verbindet, sodass der Assistent Ihr Repo lesen, Befehle ausführen, Dateien bearbeiten, Tests ausführen, Commits erstellen und mehrstufige Workflows vom Terminal aus ausführen kann. Es ist so konzipiert, dass die KI in Ihrer Shell „leben“ und auf Ihrer Codebasis agieren kann. Es bietet Funktionen wie Repo-Scanning, Slash-Befehle, Subagenten (spezialisierte Assistenten mit isoliertem Kontext) und Model Context Protocol (MCP)-Integrationen für externe Tools.

---

Warum sollte ich die Kontext von Claude Code?

Denn Kontext = Relevanz + Kosten + Sicherheit. Unkontrolliert verursachen lange Historien:

• Höhere Token-Nutzung (höhere Kosten, langsamere Antworten).
• Kontextdrift (alte/irrelevante Informationen verwirren die Ausgaben).
• Informationslecks (Geheimnisse oder vertrauliche Protokolle bleiben in der Sitzung hängen).
  Durch die Verwaltung des Kontexts bleiben die Ergebnisse präzise, ​​vorhersehbar und kostengünstiger.

Wie organisiert und bewahrt Claude Code den Projektkontext?

Claude Code ist eine agentenbasierte CLI, die Ihr Repo, Ihre Tools und Ihre Konfiguration als erstklassige Kontextquellen behandelt. Es liest Projektdateien, CLAUDE.md, lokale Tools und konfigurierte MCP-Server; es unterstützt auch Subagenten, die jeweils ein eigenes Kontextfenster erhalten (hilfreich, um eine Verschmutzung der Hauptkonversation zu vermeiden). Verwenden Sie dies, um die Strategie auf Hauptebene vom spezialisierten Agentenspeicher (z. B. Testläufer, Codeprüfer) zu trennen.

Wie nimmt Claude Code Repo-Kontext und Hilfsdateien auf?

• Es scannt das Arbeitsverzeichnis und alle zusätzlichen Verzeichnisse, die Sie hinzufügen (--add-dir).
• Es sucht .claude/ Unterordner (Befehle, Agenten) und CLAUDE.md.
• Sie können Model Context Protocol (MCP)-Server für den externen Toolzugriff verkabeln; Claude Code kann diese Tools in sein Toolset übernehmen.

Welche Methoden kann ich anwenden, um den Kontext im Claude-Code zu verwalten?

1. Beherrschen Sie die grundlegenden CLI-Befehle für den Kontext. Speichern Sie wiederverwendbare Eingabeaufforderungen als Schrägstrichbefehle in .claude/commands/, um das wiederholte Einfügen langer Eingabeaufforderungen zu vermeiden.
2. Entwerfen Sie eine geeignete CLAUDE.md-Datei. Fügen Sie CLAUDE.md zum Repository-Stammverzeichnis hinzu, um Ziele, zulässige Tools, Stil, Eskalationsregeln und nützliche Schrägstrichbefehle zu definieren. (Claude Code liest diese automatisch und verwendet sie als verbindliche Anleitung.)
3. Verwenden Sie Subagenten zur Aufgabenisolierung. Jeder Subagent erhält ein eigenes Kontextfenster und eigene Tool-Berechtigungen, wodurch die Hauptsitzung nicht abgefragt wird. Speichern Sie Subagenten in .claude/agents/ und führen Sie eine Versionskontrolle durch.

Was sind die grundlegenden Kontextverwaltungsbefehle?

Nachfolgend finden Sie die Befehle, die Sie am häufigsten verwenden, um den Konversationsstatus in Claude Code zu verwalten. Ich liste das Verhalten, Anwendungsbeispiele, empfohlene Szenarien und Verweise auf zugehörige CLI-Flags auf.

---

/clear – „Neuanfang“

Was es tut: löscht den aktuellen Konversationsverlauf aus der Sitzung, sodass nachfolgende Eingabeaufforderungen von vorne beginnen. Die REPL-Sitzung wird fortgesetzt, aber die hin- und hergehenden Nachrichten werden aus dem Kontext des Modells entfernt. (Projektdateien und CLAUDE.md bleiben für Claude Code zugänglich.)

Wann zu verwenden

• Nachdem Sie eine Funktion oder ein Ticket abgeschlossen haben, möchten Sie eine saubere Sitzung für eine nicht damit zusammenhängende Aufgabe.
• Wenn sich in der Sitzung viele Erkundungsrunden angesammelt haben und die Antworten erniedrigend sind.
• Bevor Sie die Sitzung an einen anderen Benutzer/Agenten übergeben, um zu vermeiden, dass der vorherige Gesprächsstatus preisgegeben wird.

Anwendungsbereich

# in the interactive REPL

/clear

Hinweise & Tipps

• /clear ist destruktiv für den Gesprächsverlauf dieser Sitzung; verwenden Sie /resume/--continue wenn Sie zu alten, auf der Festplatte gespeicherten Sitzungen zurückkehren möchten.

---

/compact — „Zusammenfassen und verdichten“

Was es tut: komprimiert die aktuelle Konversation in eine kürzere Zusammenfassung, die wichtige Fakten und Entscheidungen enthält, und ersetzt dann den ausführlichen Verlauf durch diese Zusammenfassung, sodass die Sitzung fortgesetzt werden kann, ohne dass der wichtige Kontext verloren geht. Dies reduziert die Token-Nutzung und sorgt gleichzeitig für Kontinuität.

Wann zu verwenden

• Wenn Sie den wichtigen Status des Threads beibehalten, aber den Token-Footprint reduzieren möchten.
• Vor einer langen neuen Aufgabe, die das Kontextfenster sonst an seine Grenzen bringen würde.
• Wenn Sie eine prägnante Sitzungserinnerung wünschen und gleichzeitig wichtige Entscheidungen behalten möchten.

Anwendungsbereich

# in the interactive REPL

/compact
# or with an instruction to guide the summary

/compact Summarize decisions, open TODOs, and config changes only

Hinweise & Tipps

• auto-compact, microcompactund andere intelligente Komprimierungsfunktionen werden möglicherweise automatisch ausgeführt, wenn die Konversationslänge in einigen Builds oder Setups ihre Grenzen erreicht. Diese Funktionen werden derzeit eingeführt und können in Ihrer Installation oder gehosteten Umgebung erscheinen. (Die Community und die Änderungsprotokolle behandeln Mikrokompakt- und Autokompaktfunktionen.)

---

--continue, --resumeund Sitzungssteuerungen (CLI-Ebene)

Was sie machen: Steuern Sie die Sitzungspersistenz und -auswahl über die CLI.

• claude --continue (oder claude -c) – Öffnen Sie die letzte Konversation erneut und setzen Sie sie im aktuellen Projektverzeichnis fort.
• claude --resume (oder claude -r <session-id>) – zeigt einen interaktiven Picker an (oder setzt eine bestimmte Sitzung anhand der ID fort). Nützlich, wenn Sie viele Sitzungen gespeichert haben und eine zum Fortsetzen auswählen möchten.

Anwendungsbeispiele

# continue the most recent session

claude --continue

# open an interactive session picker

claude --resume

# resume by id (non-interactive)

claude --resume 550e8400-e29b-41d4-a716-446655440000

---

Verknüpfungen im interaktiven Modus, die für den Kontext wichtig sind (Terminal-UX)

• Ctrl+L — löscht den Terminalbildschirm (visuell), aber hält Gesprächsverlauf. Verwenden /clear um den Verlauf tatsächlich zurückzusetzen.
• Ctrl+D — die Sitzung beenden (EOF).
• Ctrl+C — aktuelle Generation abbrechen.
  Dies sind Komfortsteuerelemente. Sie beeinflussen nur das Terminalverhalten, sofern Sie nicht explizit /clear or --continue/--resume.

---

Andere kontextbezogene Steuerelemente und Flags

• --add-dir <path> – Fügen Sie zusätzliche Verzeichnisse hinzu, die Claude lesen kann (gut, um den Zugriffsbereich von Claude einzuschränken und unnötige Dateilesevorgänge zu reduzieren).
• --allowedTools – Tools vorab zulassen, damit Claude sie ohne wiederholte Berechtigungsabfragen ausführen kann (reduziert Hin- und Her- und laute Tool-Berechtigungsdialoge).
• Schrägstrichbefehle (/.claude/commands/ oder vom MCP bereitgestellt) – speichert häufig verwendete, tokeneffiziente Eingabeaufforderungen; das Aufrufen eines Schrägstrichbefehls ist günstiger als das wiederholte Einfügen langer Eingabeaufforderungen.

Wie sollte ich eine CLAUDE.md-Datei entwerfen, um den Projektkontext zu steuern?

Was ist CLAUDE.md und warum ist es wichtig?

CLAUDE.md ist eine Preflight-Eingabeaufforderung auf Projektebene, die Claude Code beim Starten in einem Repository automatisch liest. Verwenden Sie sie, um kurze, umsetzbare und stabile Fakten zum Projekt (Substantive, Architektur, Standards) einzugeben. Da das Modell CLAUDE.md in die Eingabeaufforderung aufnimmt, reduziert eine gut gestaltete Datei das wiederholte Einfügen derselben Informationen und schont wertvolles Token-Budget.

CLAUDE.md: praktische Vorlage (empfohlen)

Halten Sie sich an diese Regeln: kurze (wenn möglich 100–200 Zeilen), hierarchische (globale → Projekt → Unterverzeichnisüberschreibungen) und maschinenlesbare Abschnitte.

# CLAUDE.md — top of repository

Project: Acme Payment Gateway
Primary language: typescript
Build: pnpm build
Run tests: pnpm test
API routing: src/api/*
Database: Postgres via prisma (schema at prisma/schema.prisma)

# Conventions

- commit format: Conventional Commits
- test coverage threshold: 80%
- style: eslint + prettier (configs in .eslintrc, .prettierrc)

# What I'm asking Claude to do

- When asked to create a feature, always include tests and update the CHANGELOG.
- When modifying DB schema, present migration plan and migration files.

Anmerkungen:

• Stellen Sie wertvolle Elemente (APIs, wichtige Dateien, Infrastrukturbefehle, Testbefehle) an die erste Stelle.
• Separat verwenden CLAUDE.md Dateien in Unterverzeichnissen, wenn verschiedene Module unterschiedliche Konventionen haben; Claude kombiniert und priorisiert spezifischere Dateien.

Wie stelle ich Workflows und Subagenten zusammen, um den Kontext zu verwalten und die Arbeit zu parallelisieren?

Was sind Unteragenten?

Unteragenten sind Claude-Code-Muster, bei denen der Hauptagent einzelne Aufgaben an untergeordnete Agenten delegiert (zum Beispiel: frontend-agent, backend-agent, qa-agent) und dann gleicht der Hauptagent ihre Ausgaben ab. Mit Subagenten können Sie parallel an verschiedenen Teilen des Systems arbeiten, ohne alles in einen einzigen Chat zu packen.

Beispiel-Workflow: Funktionsimplementierung (parallele Agenten)

1. main-agent liest CLAUDE.md, erstellt Plan.
2. frontend-agent (Subagent) erhält fokussierten Kontext: UI-Verträge, Storybook, bestimmte Dateien.
3. backend-agent (Subagent) ruft DB-Schema und API-Verträge ab und implementiert Endpunkte.
4. qa-agent führt Tests aus, schreibt fehlgeschlagene Tests zurück an main-agent.
5. main-agent orchestriert Commits, Merge-Requests und aktualisiert CLAUDE.md.

CLI-Muster:

# start main session

claude --session main

# spawn frontend subagent (conceptually: new session with scoped CLAUDE.md)

claude --session frontend --cwd frontend/

Tipp: Erstellen Sie einen Bereich CLAUDE.md Dateien in Unterverzeichnissen (frontend/CLAUDE.md, backend/CLAUDE.md), sodass jeder Subagent mit dem minimalen Kontext beginnt, den er benötigt.

Beispiel-Subagent: .claude/agents/code-reviewer.md

---
name: code-reviewer
description: Focused code reviewer. Limited tools: Read, Grep, Bash
---

You are a code reviewer. When invoked:
1. Run `git diff --name-only` to see changed files.
2. Prioritize security, correctness, tests.
3. Return a patch (diff) and a 3-item actionable checklist.

---

Welche Tipps haben Power-User, um den Kontext gesund und die Kosten niedrig zu halten?

1) CLAUDE.md schlank und hierarchisch halten

Vermeiden Sie riesige monolithische CLAUDE.md-Dateien. Verwenden Sie eine globale Datei für die Präferenzen des Entwicklers und kleine Moduldateien für bereichsspezifische Anforderungen. Siehe vorherige Vorlage.

2) Verwenden Sie Schrägstrichbefehle für Verben, CLAUDE.md für Substantive

Machen Sie CLAUDE.md zum Ort für Fakten (welche Dateien vorhanden sind, Architektur), und Schrägstrich-Befehle den Ort für Verfahren (Tests erstellen, Refactoring ausführen). Dies verhindert, dass die prozedurale Logik bei jeder Sitzung erneut gesendet wird. Die Community-Weisheit betont diese Trennung.

3) Verbose-Modus + Plan-Modus als Debugging-Tools

Wenn Claude sich unerwartet verhält, führen Sie „Verbose“ aus, um den genauen Kontext anzuzeigen, und verwenden Sie den Planmodus, um einen expliziten Plan zu erzwingen, den Sie vor der Bearbeitung genehmigen können.

4) Sorgfältiges Budgetdenken

Beginnen Sie mit Standard-/Minimal-Denkmarken und erhöhen Sie diese nur, wenn Aufgaben mehrstufiges Denken erfordern (komplexe Refactorings, formale Verifizierung). Verwenden Sie für Routinebearbeitungen niedrigere Budgets.

5) Instrumentenausgaben und -commits

Verwenden Sie Hooks, die automatisch Tests ausführen und deren Ausgabe an die Sitzung anhängen (Bash-Modus ! um einen Shell-Befehl auszuführen und die Ausgabe als Kontext einzuschließen). Verwenden Sie Commit-Hooks, um klare atomare Commits mit Nachrichten zu erstellen.

Wie kann ich Fehler beheben, wenn der Kontext verloren geht oder Claude Anweisungen vergisst?

Häufige Symptome und Lösungen

• Symptom: Claude ignoriert CLAUDE.md oder vorherige Anweisungen.
• Fixes: Stellen Sie sicher, dass sich die Datei im aktuellen Arbeitsverzeichnis der Sitzung befindet. Suchen Sie nach einem spezifischeren Unterverzeichnis, CLAUDE.md, das sie überschreibt. Verwenden Sie den ausführlichen Modus, um die aktuelle Eingabeaufforderung anzuzeigen.
• Symptom: Die Leistung nimmt bei langen Sitzungen ab (das Modell „vergisst“ frühe Teile).
• Fixes: Komprimieren Sie die Sitzung: Extrahieren Sie stabile Fakten in CLAUDE.md oder erstellen Sie Snapshots von Gesprächsabschnitten in Dateien und referenzieren Sie diese, anstatt sie zu wiederholen. Erwägen Sie auch, kurze Sitzungen neu zu starten und nur prägnante Kontextinformationen weiterzugeben.
• Symptom: Längeres Denken dauert zu lange oder läuft ab.
• Fixes: Reduzieren Sie das Denkbudget, zerlegen Sie die Aufgabe in kleinere Teilprobleme oder führen Sie eine Batch-Offline-Analyse durch, wenn Sie extrem große Budgets benötigen. Anthropic empfiehlt Batch-Verarbeitung, wenn optimale Denkbudgets ca. 32 Token überschreiten, um Timeouts zu vermeiden.

Fazit

Die Verwaltung des Kontexts in Claude Code ist mittlerweile ein mehrdimensionales Problem: Modellauswahl, Subagenten-Design, CLAUDE.md Disziplin, Budgets und Werkzeugarchitektur interagieren. Investieren Sie zunächst 1–2 Stunden in die Erstellung eines klaren CLAUDE.md, bauen Sie 2–3 fokussierte Subagenten auf und fügen Sie Nutzungsinstrumente für Token und Denkbudgets hinzu – Sie werden sofortige Verbesserungen bei Zuverlässigkeit, Kostenvorhersehbarkeit und Teamproduktivität feststellen.

Verwenden Sie Claude Code über CometAPI

CometAPI ist eine einheitliche API-Plattform, die über 500 KI-Modelle führender Anbieter – wie die GPT-Reihe von OpenAI, Gemini von Google, Claude von Anthropic, Midjourney, Suno und weitere – in einer einzigen, entwicklerfreundlichen Oberfläche vereint. Durch konsistente Authentifizierung, Anforderungsformatierung und Antwortverarbeitung vereinfacht CometAPI die Integration von KI-Funktionen in Ihre Anwendungen erheblich. Ob Sie Chatbots, Bildgeneratoren, Musikkomponisten oder datengesteuerte Analyse-Pipelines entwickeln – CometAPI ermöglicht Ihnen schnellere Iterationen, Kostenkontrolle und Herstellerunabhängigkeit – und gleichzeitig die neuesten Erkenntnisse des KI-Ökosystems zu nutzen.

Wir freuen uns, Ihnen mitteilen zu können, dass CometAPI jetzt den leistungsstarken Claude Code vollständig unterstützt. Sie müssen nur Claude Code installieren und sich mit dem erhaltenen Comet-API-Schlüssel und der Basisadresse authentifizieren, um das Comet-API-Modell auf Claude Code zu verwenden.

Warum sollte man Claude-Code über CometAPI verwenden?

Top-Funktionen der künstlichen Intelligenz: Einfaches Generieren, Debuggen und Optimieren von Code mithilfe von Modellen, die speziell für Entwickler erstellt wurden.

• Flexible Modellauswahl: Unser umfassendes Modellangebot ermöglicht Ihnen eine nahtlosere Entwicklung.
• Nahtlose Integration: APIs sind immer verfügbar. Integrieren Sie Claude Code in wenigen Minuten direkt in Ihren bestehenden Workflow.
• Die Verwendung von Claude Code über CometAPI spart weitere Kosten. Die von CometAPI bereitgestellte API ist 20 % günstiger als der offizielle Preis und wird vom offiziellen Anbieter mit dem neuesten Modell aktualisiert. Das neueste Modell ist Claude Opus 4.1.

Bereit, Claude Code zu verwenden? Konsultieren Sie die API-Leitfaden für detaillierte Anweisungen.

Siehe auch Wie installiere und führe ich Claude Code über CometAPI aus?