Claude Code /checkup im Detail: Kontext bereinigen, Konfiguration reparieren und die Sicherheit des Agents verbessern

Einleitung

Claude Code hat eine leistungsfähigere integrierte Setup-Überprüfung erhalten. In Version 2.1.205 hat Anthropic den bestehenden /doctor-Workflow erweitert, sodass er jetzt Konfigurationsprobleme diagnostizieren und bei deren Behebung helfen kann. /checkup ist als Alias für denselben Sitzungs-Workflow verfügbar.

Die Änderung mag klein erscheinen, da sie durch einen einzelnen Slash-Befehl ausgelöst wird. In der Praxis adressiert sie ein häufiges Problem bei langlebigen Claude Code-Installationen: Nicht genutzte Skills, veraltete Model Context Protocol-Server, überdimensionierte Anweisungsdateien, langsame Hooks, veraltete Installationen und wiederholte Berechtigungsabfragen erschweren zunehmend die Übersicht über die Umgebung.

Das Ziel ist nicht nur, zu melden, dass etwas nicht stimmt. Die aktualisierte Überprüfung kann das Setup inspizieren, vorgeschlagene Änderungen erklären und vor der Anwendung um Zustimmung bitten.

/checkup

Sie können auch den kanonischen Befehl verwenden:

/doctor

Eine Setup-Überprüfung mit nur einem Befehl

Laut dem Claude Code 2.1.205-Änderungsprotokoll ist /doctor jetzt eine vollständige Setup-Überprüfung, die Probleme diagnostizieren und beheben kann, während /checkup sein Alias ist.

Dies unterscheidet sich vom separaten Terminalbefehl:

claude doctor

Der Terminalbefehl gibt schreibgeschützte Installations- und Einstellungsdiagnosen aus, ohne eine interaktive Sitzung zu starten. Der sitzungsinterne /doctor- oder /checkup-Workflow kann weitergehen, indem er Lösungsvorschläge unterbreitet und Claude die Möglichkeit gibt, die Bereinigung über seine verfügbaren Tools zu koordinieren.

Claude Code-Ersteller Boris Cherny beschrieb mehrere Aufgaben, für die die Überprüfung entwickelt wurde:

1. Bereinigung ungenutzter Skills, MCP-Server und Plugins.
2. Entfernung doppelter lokaler CLAUDE.md-Anweisungen im Vergleich zu eingecheckten Projektanweisungen.
3. Aufteilung einer überdimensionierten Root-CLAUDE.md in verschachtelte Dateien und wiederverwendbare Skills.
4. Identifizierung und Deaktivierung langsamer Hooks.
5. Aktualisierung von Claude Code auf die neueste verfügbare Version.
6. Standardmäßige Aktivierung des Automatikmodus, wenn angemessen.
7. Vorabgenehmigung häufig abgelehnter schreibgeschützter Befehle.
8. Erkennung anderer Einrichtungsprobleme, die die Umgebung langsamer oder weniger zuverlässig machen.

Der Befehl fragt vor der Durchführung von Änderungen um Bestätigung.

Was die Überprüfung tatsächlich prüft

1. Ungenutzte Skills, MCP-Server und Plugins

Claude Code kann mit Skills, Plugins, Hooks und MCP-Servern erweitert werden. Diese Integrationen sind nützlich, aber eine ausgereifte Installation sammelt oft Komponenten an, die nicht mehr

1. Nicht mehr relevante Integrationen

Möglicherweise wurde für ein altes Issue-Tracking-System ein MCP-Server hinzugefügt. Ein Skill könnte für einen Arbeitsablauf erstellt worden sein, den das Team nicht mehr nutzt. Ein Plugin ist vielleicht noch aktiviert, obwohl seine Befehle ersetzt wurden.

Die Überprüfung kann diese ungenutzten Komponenten aufdecken und vorschlagen, sie zu entfernen oder zu deaktivieren.

Dies ist wichtig, weil Werkzeuge und Anweisungen Aufmerksamkeit und Kontext binden können, selbst wenn sie bei der aktuellen Aufgabe nicht aktiv helfen. Weniger irrelevante Integrationen erleichtern zudem die Überprüfung des Berechtigungsmodells.

2. Doppelte oder überdimensionierte CLAUDE.md-Anweisungen

CLAUDE.md-Dateien enthalten persistente Anweisungen für Claude Code. Sie können Build-Befehle, Codierungskonventionen, Architekturhinweise, Testanforderungen und projektspezifische Regeln enthalten.

Diese Dateien werden in den Sitzungskontext geladen. Anthropic empfiehlt, jede Datei präzise zu halten und verschachtelte Anweisungsdateien regelmäßig auf veraltete oder widersprüchliche Regeln zu überprüfen.

Im Laufe der Zeit können in einem Projekt mehrere häufige Probleme auftreten:

• Dieselbe Regel erscheint sowohl in lokalen als auch in eingecheckten Dateien.
• Alte Anweisungen bleiben bestehen, nachdem sich die Codebasis geändert hat.
• Eine Wurzeldatei wächst zu einer langen Sammlung nicht zusammenhängender Verfahrensweisen.
• Teamweite Regeln und verzeichnisspezifische Regeln werden vermischt.
• Detaillierte Arbeitsabläufe werden in CLAUDE.md gespeichert, obwohl sie als On-Demand-Skills besser funktionieren würden.

Die Überprüfung kann lokale und Projektanweisungen vergleichen, Doppelungen identifizieren und eine fokussiertere Struktur vorschlagen.

Eine praktische Anordnung könnte wie folgt aussehen:

projekt/
├── CLAUDE.md
├── .claude/
│   ├── regeln/
│   │   ├── frontend.md
│   │   ├── backend.md
│   │   └── testen.md
│   └── skills/
│       └── release/
│           └── SKILL.md
└── pakete/
    └── api/
        └── CLAUDE.md

Die Wurzeldatei kann nur die Regeln enthalten, die für das gesamte Repository benötigt werden. Spezifischere Anweisungen können geladen werden, wenn Claude im entsprechenden Verzeichnis arbeitet, während wiederverwendbare Verfahrensweisen zu Skills werden, die bei Aufruf geladen werden.

3. Langsame oder redundante Hooks

Hooks sind deterministische Aktionen, die an bestimmten Punkten im Lebenszyklus von Claude Code ausgeführt werden. Sie können Dateien formatieren, Befehle validieren, Richtlinien durchsetzen, Benachrichtigungen senden oder Claude Code in interne Systeme integrieren.

Ein Hook ist nur dann nützlich, wenn sein Wert seine Kosten rechtfertigt. Ein Skript, das bei jedem Werkzeugaufruf zwei oder drei Sekunden hinzufügt, kann über eine lange Sitzung hinweg eine große Verzögerung verursachen.

Die Überprüfung kann helfen, Hooks zu identifizieren, die:

• durchgehend langsam sind.
• häufiger als beabsichtigt ausgelöst werden.
• einen anderen Validierungsschritt duplizieren.
• auf Skripte verweisen, die nicht mehr existieren.
• Fehler produzieren, die der Benutzer gelernt hat zu ignorieren.
• nicht mehr mit einem aktiven Arbeitsablauf verbunden sind.

Das Deaktivieren eines unnötigen Hooks verbessert nicht nur die Geschwindigkeit. Es reduziert auch Rauschen und macht wichtige Fehler leichter erkennbar.

4. Installations- und Aktualisierungsprobleme

Ein defekter Starter, eine veraltete Installation oder eine teilweise Aktualisierung kann zu verwirrendem Verhalten führen. Die Einrichtungsüberprüfung kann die Integrität der Installation prüfen und eine Aktualisierung von Claude Code empfehlen.

Um die installierte Version manuell zu überprüfen, verwenden Sie:

claude --version

Die genaue Aktualisierungsmethode hängt davon ab, wie Claude Code installiert wurde.

Verwaltete Unternehmensbereitstellungen können eine bestimmte Version bewusst fixieren, daher sollten Nutzer die Unternehmensrichtlinie nicht allein deshalb außer Kraft setzen, weil eine neuere Version existiert.

5. Wiederholte Aufforderungen zu schreibgeschützten Berechtigungen

Claude Code verwendet ein Berechtigungssystem, das risikoarme Überprüfungen von Aktionen trennt, die die Umgebung verändern.

Die Sicherheitsdokumentation von Anthropic gibt an, dass ein integrierter Satz von schreibgeschützten Befehlen, einschließlich Befehlen wie ls, cat und git status, ohne eine Aufforderung ausgeführt werden kann. Befehle, die Dateien bearbeiten, potenziell verändernde Bash-Operationen ausführen oder auf zusätzliche Systeme zugreifen, können eine Genehmigung erfordern.

Wenn ein Nutzer wiederholt einen harmlosen schreibgeschützten Befehl ablehnt oder manuell genehmigt, kann die Überprüfung eine klarere Berechtigungsregel vorschlagen. Ziel ist es, die Ermüdung durch Aufforderungen zu reduzieren, ohne umfassende Schreibrechte zu gewähren.

Eine gute Berechtigungsregel sollte eng gefasst sein. Die Genehmigung eines bestimmten schreibgeschützten Musters ist sicherer als die Erlaubnis für eine gesamte Shell- oder Werkzeugkategorie.

Warum die Aufrechterhaltung des Kontexts wichtig ist

Ein KI-Codierungsagent muss verschiedene Arten von Informationen in einen Arbeitskontext einfügen:

• Das aktuelle Gespräch.
• Relevante Quelldateien.
• Werkzeugergebnisse und Befehlsausgaben.
• CLAUDE.md-Anweisungen.
• Fähigkeitsbeschreibungen.
• MCP-Werkzeugdefinitionen.
• Pläne, Aufgabenstatus und Zwischenergebnisse.

Das Kontextfenster ist endlich. Eine große Menge irrelevanter Einrichtungsinformationen kann weniger Platz für das eigentliche Problem lassen.

Das bedeutet nicht, dass jede installierte Fähigkeit oder jeder MCP-Server automatisch vollständig geladen wird. Claude Code verwendet Mechanismen wie On-Demand-Fähigkeitskörper und Werkzeugerkennung, um die Kontextnutzung zu kontrollieren. Dennoch erzeugt unnötige Konfiguration zusätzliche Komplexität und erhöht die Wahrscheinlichkeit, dass veraltete Anweisungen oder Integrationen eine Sitzung beeinflussen.

Eine gesunde Einrichtung benötigt daher die gleiche Art von Wartung wie ein Softwareprojekt:

1. Entfernen, was nicht mehr verwendet wird.
2. Globale Anweisungen kurz halten.
3. Spezialisierte Verfahren in bereichsbezogene Dateien oder Fähigkeiten verschieben.
4. Integrationen und Berechtigungen prüfen.
5. Die Kosten von Hooks messen.
6. Die Einrichtung nach größeren Projektänderungen überprüfen.

Von der Diagnose zur unterstützten Bereinigung

Frühere Diagnosewerkzeuge hörten oft nach der Auflistung von Fehlern auf. Der Nutzer musste dennoch jede Warnung verstehen, die relevante Datei finden, eine Korrektur entscheiden und diese manuell anwenden.

Die aktualisierte Sitzungsüberprüfung folgt einem stärker agentiven Muster:

1. Die aktuelle Umgebung inspizieren.
2. Spezifische Probleme identifizieren.
3. Den Nutzen einer Bereinigung abschätzen.
4. Vorgeschlagene Änderungen präsentieren.
5. Dem Nutzer die Wahl lassen zwischen einer vollständigen Bereinigung, ausgewählten Korrekturen oder einer Nur-Bericht-Option.
6. Nur genehmigte Änderungen anwenden.
7. Dateiänderungen zur Überprüfung sichtbar lassen.

Dadurch wird der Arbeitsablauf eher einem interaktiven Wartungsassistenten als einem passiven Fehlerbericht ähnlich.

Der Genehmigungsschritt ist wichtig. Ein Werkzeug sollte nicht

Entfernen Sie stillschweigend eine Projektfertigkeit, schreiben Sie Anweisungsdateien um oder ändern Sie das Berechtigungsverhalten, nur weil es das Setup für ineffizient hält.

Sicherheitsverbesserungen bei autonomen Befehlen

Dieselbe Version enthielt auch Änderungen, die darauf abzielen, das Risiko zu verringern, wenn Claude Code autonomer handelt.

Schutz vor vorgetäuschter Zustimmung in Sitzungsprotokollen

Hintergrundaufgabenbenachrichtigungen geben jetzt explizit an, wenn keine menschliche Eingabe erfolgt ist. Dies soll verhindern, dass Text in einem Transkript mit einer echten Benutzerzustimmung verwechselt wird.

Für einen Agenten ist der Unterschied zwischen „das Transkript enthält zustimmungsähnlichen Text“ und „der Benutzer hat diese Aktion tatsächlich über die Schnittstelle genehmigt“ entscheidend. Sicherheitsrelevante Entscheidungen benötigen einen vertrauenswürdigen Genehmigungskanal.

Zusätzliche Bestätigung für riskante rm -rf-Befehle

Das Changelog vermerkt auch eine Verbesserung im Automatikmodus: Claude Code fragt nach, bevor es rm -rf ausführt, wenn der Pfad eine Variable enthält, die es aus dem Kontext nicht auflösen kann.

Ein gefährliches Beispiel ist:

rm -rf "$TARGET_DIR/"

Wenn TARGET_DIR leer oder falsch expandiert ist, kann das Ergebnis stark von der Absicht des Skriptautors abweichen.

Die richtige Lehre ist nicht, dass eine einzelne Bestätigungsaufforderung destruktive Shell-Befehle sicher macht. Benutzer sollten den aufgelösten Pfad weiterhin überprüfen, nach Möglichkeit eine Sandbox oder Einwegumgebung verwenden, Backups pflegen und breite Löschbefehle in Produktionssystemen vermeiden.

Autonomie braucht Grenzen

Das Release vereint zwei Ziele, die zu widersprechen scheinen:

• Reduzieren Sie unnötige Unterbrechungen für routinemäßige, schreibgeschützte Arbeiten.
• Fügen Sie stärkere Bestätigungen für unsichere oder destruktive Aktionen hinzu.

Diese Ziele ergänzen sich. Ein nützlicher Agent sollte sich schnell innerhalb eines klar definierten sicheren Bereichs bewegen und langsamer werden, wenn er sich einer Grenze mit irreversiblen Folgen nähert.

/doctor, /checkup und claude doctor

Die ähnlichen Namen können verwirrend sein.

Für die meisten Benutzer, die möchten, dass Claude das aktive Setup überprüft und bei der Bereinigung hilft, ist /doctor oder /checkup der relevante Befehl.

Für Skripte, Supportprüfungen oder schnelle Installationsdiagnosen außerhalb einer Sitzung ist claude doctor besser geeignet.

Ein sicherer Weg, /checkup auszuführen

Schritt 1: Überprüfen Sie den aktuellen Repository-Status

Bevor Sie einem Tool erlauben, Konfigurationsdateien zu ändern, stellen Sie sicher, dass wichtige Arbeiten committet oder gesichert sind.

git status

Überprüfen Sie nicht committete Dateien und vermeiden Sie es, nicht zusammenhängende Codeänderungen mit der Konfigurationsbereinigung zu vermischen.

Schritt 2: Starten Sie Claude Code im vorgesehenen Projekt

cd /path/to/project
claude

Die Ausführung der Überprüfung aus dem richtigen Repository ist wichtig, da Projektanweisungen, Hooks, Plugins und MCP-Einstellungen möglicherweise gebunden sind.

Schritt 3: Führen Sie die Überprüfung aus

/checkup

Lesen Sie den Bericht, bevor Sie Änderungen akzeptieren.

Schritt 4: Wählen Sie den Umfang

Je nachdem, was Claude

findet, kann die Oberfläche Optionen anbieten wie:

• Die empfohlene Bereinigung anwenden.
• Einzelne Kategorien auswählen.
• Die aktuelle Konfiguration beibehalten und einen Bericht erstellen.
• Eine Empfehlung vor der Entscheidung besprechen.

Bevorzugen Sie eine selektive Bereinigung, wenn das Repository über benutzerdefinierte interne Tools oder eine gemeinsame Teamkonfiguration verfügt.

Schritt 5: Überprüfen Sie die Änderungen

Nachdem Konfigurationsdateien geändert wurden, prüfen Sie sie:

git diff

Achten Sie besonders auf:

• CLAUDE.md und CLAUDE.local.md.
• Dateien unter .claude/.
• Hook-Definitionen.
• Plugin-Einstellungen.
• MCP-Konfiguration.
• Berechtigungsregeln.
• Alle generierten Fähigkeiten.

Schritt 6: Testen Sie einen normalen Workflow

Führen Sie eine Aufgabe aus, die den alltäglichen Gebrauch repräsentiert. Bestätigen Sie, dass erforderliche Tools noch funktionieren, relevante Anweisungen noch geladen werden, Hooks weiterhin wichtige Regeln durchsetzen und Berechtigungsaufforderungen wie erwartet reagieren.

Schritt 7: Führen Sie die Bereinigung separat durch

Wenn sich die gemeinsame Projektkonfiguration ändert, verwenden Sie einen fokussierten Commit, damit Teammitglieder ihn unabhängig überprüfen und rückgängig machen können.

git add CLAUDE.md .claude/
git commit -m "chore: Claude Code-Konfiguration bereinigt"

Passen Sie die Pfade an die tatsächlich geänderten Dateien an.

Wann eine automatische Bereinigung nicht sofort übernommen werden sollte

Genehmigen Sie nicht jede Empfehlung ohne Überprüfung, wenn:

• Das Repository von der Organisation verwaltete Einstellungen verwendet.
• MCP-Server geschäftskritische Integrationen bereitstellen.
• Hooks Sicherheits- oder Compliance-Richtlinien durchsetzen.
• CLAUDE.md absichtliche Duplikate für die Portabilität enthält.
• Das Projekt Claude Code auf eine getestete Version festlegt.
• Mehrere Teams von demselben Plugin oder derselben Anweisungshierarchie abhängen.
• Die Bereinigung eine Änderung des Berechtigungsverhaltens vorschlägt.
• Der Arbeitsbaum nicht zusammenhängende, nicht committete Änderungen enthält.

In diesen Fällen verwenden Sie die Überprüfung zunächst als Auditbericht. Besprechen oder wenden Sie Änderungen über den üblichen Überprüfungsprozess des Teams an.

FAQ

Was ist der Claude Code /checkup-Befehl?

/checkup ist ein Alias für den erweiterten In-Session /doctor-Workflow, der in Claude Code 2.1.205 eingeführt wurde. Er überprüft Einrichtungsprobleme und kann Korrekturen für Konfiguration, Kontext, Integrationen, Hooks, Installationszustand und verwandte Probleme vorschlagen.

Ist /checkup anders als /doctor?

In aktuellen Claude Code-Versionen ist /checkup ein Alias für /doctor. Sie rufen denselben vollständigen Einrichtungs-Check innerhalb einer interaktiven Claude Code-Sitzung auf.

Ist claude doctor dasselbe wie /doctor?

Nein. claude doctor wird vom Terminal aus ausgeführt und gibt schreibgeschützte Diagnosen zu Installation und Einstellungen aus, ohne eine Sitzung zu öffnen. Der Schrägstrichbefehl kann nach Zustimmungsanfrage Korrekturen koordinieren.

Kann /checkup Fähigkeiten oder MCP-Server automatisch löschen?

Der Workflow kann ungenutzte Komponenten identifizieren und eine Bereinigung vorschlagen, ist jedoch so konzipiert, dass er vor Änderungen um Erlaubnis fragt. Benutzer sollten jeden vorgeschlagenen Entfernungsvorgang überprüfen, insbesondere in gemeinsamen oder verwalteten Projekten.

Warum beeinflusst eine große CLAUDE.md Claude Code?

CLAUDE.md-Anweisungen gelangen in den Sitzungskontext, sodass lange oder doppelte Dateien Platz verbrauchen, der sonst für die aktive Aufgabe genutzt werden könnte. Anthropic empfiehlt präzise Anweisungen und begrenzte Dateien für große Projekte.

Sollte jeder Vorgang aus CLAUDE.md verschoben werden?

Nein. Stabile

Projektfakten, Codierungsregeln und erforderliche Befehle gehören in CLAUDE.md. Lange, wiederverwendbare Prozeduren eignen sich oft besser für Skills, da deren vollständiger Inhalt nur bei Bedarf geladen wird.

Macht /checkup den automatischen Modus völlig sicher?

Nein. Er kann Standardeinstellungen verbessern und Schutzmaßnahmen hinzufügen, aber die Benutzer bleiben für die Überprüfung von Befehlen und Berechtigungen verantwortlich. Destruktive Operationen, externe Schreibvorgänge, Produktionszugriff und die Handhabung von Anmeldeinformationen erfordern weiterhin sorgfältige Kontrollen.

Wie oft sollte ich den Setup-Checkup durchführen?

Es gibt keinen festgelegten Zeitplan. Er ist nützlich nach größeren Konfigurationsänderungen, wenn Claude Code langsamer oder weniger konsistent wirkt, nach dem Hinzufügen mehrerer Integrationen oder als Teil einer regelmäßigen Projektwartungsüberprüfung.

Verwandte Tools

• Claude Code: Anthropics agentisches Codierungstool für Terminals, IDEs, Desktop und das Web.
• Claude Code Skills: Erstellen Sie wiederverwendbare, bedarfsgesteuerte Prozeduren, die Claude Code erweitern.
• Model Context Protocol in Claude Code: Verbinden Sie Claude Code mit externen Tools, APIs, Datenbanken und Diensten.
• Claude Code Hooks: Führen Sie deterministische Automatisierung an definierten Punkten im Agentenlebenszyklus aus.
• Claude Code Plugins: Paketieren und verteilen Sie Skills, Agenten, Hooks und MCP-Integrationen.
• Claude Agent SDK: Erstellen Sie programmierbare Agenten mit denselben Kernwerkzeugen und der gleichen Agentenschleife, die von Claude Code verwendet werden.

Verwandte Links

• Claude Code Changelog: Offizielle Versionsgeschichte, einschließlich der Änderungen des Setup-Checkups in Version 2.1.205.
• Claude Code Commands Reference: Referenz für integrierte Slash-Befehle und gebündelte Skills.
• Claude Code CLI Reference: Offizielle Referenz für Terminalbefehle und CLI-Flags.
• Wie Claude sich an ein Projekt erinnert: Anleitung zur Strukturierung und Pflege von CLAUDE.md-Dateien.
• Claude Code Sicherheit: Berechtigungsverhalten, Sandboxing, Genehmigungskontrollen und Sicherheitsrichtlinien.
• Claude Code Einstellungen: Konfigurationsbereiche, verwaltete Einstellungen, Plugins, MCP-Richtlinien und Dateisystemkontrollen.
• Claude Code Fehlerbehebung: Offizielle Diagnose- und Wiederherstellungsanleitung.
• Aktionen mit Hooks automatisieren: Praktische Anleitung zum Erstellen und Überwachen von Lebenszyklus-Hooks.

Zusammenfassung

Claude Code 2.1.205 erweitert /doctor zu einem breiteren Setup-Wartungs-Workflow und fügt /checkup als Alias hinzu. Der Befehl kann ungenutzte Erweiterungen, doppelte Anweisungen, überdimensionierte CLAUDE.md-Dateien, langsame Hooks, Installationsprobleme,

und sich wiederholendes Genehmigungsverhalten.

Der nützlichste Teil des Updates ist nicht, dass es die Wartung hinter einem einzigen Befehl verbirgt. Es ist vielmehr, dass der Arbeitsablauf vorgeschlagene Änderungen erläutern und den Benutzer vor der Veränderung der Umgebung einbeziehen kann.

Die Veröffentlichung unterstreicht zudem ein wichtiges Muster für agentische Werkzeuge: Routineaufgaben mit reinem Lesezugriff sollten weniger Reibung verursachen, während unsichere oder destruktive Operationen stärker abgesichert werden sollten.

Ein gesünderes Claude-Code-Setup ist nicht das mit den meisten Fähigkeiten, Hooks und Integrationen – sondern das, bei dem jede geladene Komponente einen klaren Zweck und jede mächtige Aktion eine angemessene Grenze hat.