Effiziente Einrichtung von Claude Code für leistungsstarkes agentisches Programmieren

Einleitung

Die meisten Nutzer erreichen mit ihrer Claude Code-Einrichtung nie den zweiten Tag. Sie installieren die Software, loggen sich ein, geben einen Befehl ein, erhalten eine nützliche Antwort und berühren die Konfigurationsdateien nie wieder. Wochen später beginnen die Sitzungen, frühere Entscheidungen zu verlieren, die gleichen Berechtigungsaufforderungen erscheinen fünfzig Mal am Tag, und jede längere Aufgabe endet mit einer Wand von Kontextwarnungen, was dazu führt, dass die Konversation abgebrochen und von vorne begonnen werden muss.

Diese Probleme sind jedoch keine Einschränkung des Modells, sondern der Einrichtung geschuldet. Claude Code wird mit sinnvollen Standardeinstellungen geliefert, doch zwischen diesen und einer hohen Leistung liegt eine Kluft, die fast ausschließlich aus einer Handvoll Dateien besteht, die die meisten Anfänger nie öffnen. Dieser Leitfaden schließt diese Lücke und erläutert die tatsächliche Konfiguration, Berechtigungen, Hooks und Befehlsgewohnheiten, die eine frische Installation von einer Einrichtung unterscheiden, die in der Praxis unter realen Bedingungen funktioniert.

Claude Code richtig installieren

Claude Code wird als eigenständige Befehlszeilenschnittstelle (CLI) installiert. Der derzeit empfohlene Installationsweg ist der native Installer anstelle von npm, obwohl npm weiterhin als Fallback funktioniert:

• macOS, Linux oder WSL: curl -fsSL https://claude.ai/install.sh | bash
• Windows PowerShell: irm https://claude.ai/install.ps1 | iex
• Oder über npm: npm install -g @anthropic-ai/claude-code

Nach der Installation sollte in ein tatsächliches Projektverzeichnis gewechselt werden, bevor Claude zum ersten Mal ausgeführt wird. Dies ist wichtiger, als es scheint: Claude Code beschränkt seinen Projektgedächtnis- und Einstellungsbereich auf das Verzeichnis, von dem aus es gestartet wird. Wenn es also aus dem Home-Verzeichnis oder dem Desktop gestartet wird, erhält es nie den richtigen Kontext für die aktuellen Arbeiten.

Wechseln Sie in Ihr Projektverzeichnis und führen Sie dann den Befehl claude aus.

Der erste Start führt durch den Authentifizierungsprozess — entweder über eine OAuth-Anmeldung mit einem Claude-Abonnement (Pro, Max oder Team) oder über einen API-Schlüssel, der mit einem Console-Konto verknüpft ist. Neben der Befehlszeile ist Claude Code auch über eine VS Code-Erweiterung, ein JetBrains-Plugin, eine Desktop-App und eine webbasierte Version unter claude.ai verfügbar, sodass Sitzungen auch über einen Browser fortgesetzt werden können. Alle diese Varianten greifen auf dieselben zugrunde liegenden Einstellungen und Projektdateien zu, sodass nichts, was Sie in der Befehlszeile einrichten, verloren geht, wenn Sie später zu einer integrierten Entwicklungsumgebung (IDE) wechseln.

Die drei entscheidenden Dateien

Claude Code liest die Konfiguration aus zwei Orten: dem .claude/-Verzeichnis Ihres Projekts (und einer CLAUDE.md-Datei im Projektstammverzeichnis) sowie einem globalen ~/.claude/-Verzeichnis, das für jedes Projekt auf Ihrem Computer gilt. Das Verständnis darüber, was wo gespeichert ist, ist der größte Hebel dafür, ob das Tool gut funktioniert oder nicht, so die eigene Dokumentation von Anthropic zur .claude-Verzeichnisstruktur.

Die Datei CLAUDE.md dient als Projektgedächtnis — sie enthält Anweisungen, die Claude zu Beginn jeder Sitzung in diesem Repository liest: Architekturhinweise, Build- und Testbefehle, Regeln für den Code-Stil und alles andere, was sonst jedes Mal neu erklärt werden müsste. Führen Sie /init in einem neuen Projekt aus, und Claude Code scannt den Code und generiert eine anfängliche CLAUDE.md für Sie, die Sie dann mit /memory verfeinern können. Halten Sie es schlank. Die Empfehlung von Anthropic ist, es als lebendiges Referenzdokument mit etwa 2.500 Tokens zu behandeln und alles, was länger oder spezifisch für den Pfad ist, in .claude/rules/*.md-Dateien zu verschieben, die nur geladen werden, wenn Claude entsprechende Dateien berührt.

Die Datei settings.json, die sich in .claude/settings.json für projektbezogene Konfiguration oder ~/.claude/settings.json für persönliche Standardeinstellungen befindet, ist der Ort, an dem Berechtigungen, Hooks, Umgebungsvariablen und Modellstandards tatsächlich festgelegt sind. Dies ist die Datei, die die meisten Anfänger nie öffnen, und sie ist direkt verantwortlich für zwei der häufigsten Beschwerden über das Tool: ständige Berechtigungsunterbrechungen und Claude, der auf ein teureres Modell zugreift, als es die Aufgabe tatsächlich erfordert. Anthropic präsentiert kostensparende Strategien für Claude Fable 5

Die Auto-Speicherfunktion ist die neuere, ruhigere Schicht: Claude kann während einer Sitzung eigene Arbeitsnotizen schreiben und lesen, ohne dass Sie eine Datei direkt verwalten müssen. Dies wird mit der Einstellung autoMemoryEnabled oder der Umgebungsvariable CLAUDE_CODE_DISABLE_AUTO_MEMORY umgeschaltet, falls Sie das Gedächtnis vollständig manuell und prüfbar über CLAUDE.md allein halten möchten.

Berechtigungen und Hooks einrichten

Claude Code läuft in einem von drei Berechtigungsmodi, die mit Shift+Tab durchgeschaltet werden:

• Standard: Fragt vor jedem potenziell riskanten Toolaufruf nach.
• Auto-Accept Edits: Lässt Dateiänderungen ohne Aufforderung zu, während andere Tools weiterhin abgefragt werden.
• Plan-Modus: Ist schreibgeschützt — keine Änderungen, keine Shell-Befehle — bis Sie einen Plan genehmigen. Der Plan-Modus ist für die ersten Sitzungen in einem unbekannten Codebestand empfehlenswert, da er Claude zwingt, Vorschläge zu machen, bevor es handelt.

Über die interaktiven Modi hinaus ermöglicht die settings.json-Datei das Schreiben tatsächlicher Berechtigungsregeln, sodass Sie nicht während einer Sitzung dieselbe sichere Anweisung fünfzig Mal manuell genehmigen müssen:

{
 "permissions": {
 "allow": [
 "Bash(npm test:*)",
 "Bash(npm run lint:*)",
 "Read(**)"
 ],
 "ask": [
 "Bash(git push:*)"
 ],
 "deny": [
 "Bash(rm -rf /*)",
 "Bash(sudo:*)",
 "Read(.env)"
 ]
 }
}

Was dies bewirkt: Alles, was mit allow übereinstimmt, wird ohne Aufforderung ausgeführt, alles, was mit deny übereinstimmt, wird unabhängig von anderen Übereinstimmungen blockiert, und alles, was nicht aufgeführt ist, wird direkt angefragt. Die Reihenfolge der deny-Regeln ist wichtig: Eine deny-Regel hat immer Vorrang, selbst wenn eine breitere allow-Regel sie abdecken würde, was es sicher macht, relativ breite Lese- und Testzugriffsrechte zu gewähren, ohne auch destruktive Befehle zuzulassen.

Hooks gehen einen Schritt weiter als Berechtigungsregeln, da eine Regel nur einen Aufruf erlauben oder blockieren kann, während ein Hook tatsächlich etwas als Reaktion auf einen Aufruf ausführen kann. Ein PostToolUse-Hook, der jede von Claude bearbeitete Datei automatisch formatiert, ist einer der am häufigsten empfohlenen Ausgangspunkte:

{
 "hooks": {
 "PostToolUse": [
 {
 "matcher": "Write|Edit",
 "hooks": [
 {
 "type": "command",
 "command": "npx prettier --write \"$CLAUDE_TOOL_INPUT_FILE_PATH\""
 }
 ]
 }
 ]
}

Was dies bewirkt: Jedes Mal, wenn Claude eine Datei schreibt oder bearbeitet, wird dieser Hook ausgelöst und führt Prettier gegen genau die Datei aus, die geändert wurde, wobei der Pfad verwendet wird, den Claude Code über die Umgebungsvariable $CLAUDE_TOOL_INPUT_FILE_PATH übergibt. Sie müssen das manuelle Formatieren nach jeder Bearbeitung nicht mehr durchführen, und Ihre Stilregeln gelten konsistent, unabhängig davon, ob Claude die Datei geschrieben hat oder Sie.

Die wichtigsten Befehle für den Einstieg

Claude Code wird mit mehr als sechzig integrierten Befehlen geliefert, und der Versuch, alle am ersten Tag auswendig zu lernen, ist Zeitverschwendung. Die folgende Tabelle umfasst die Befehle, die tatsächlich die Leistung einer Sitzung beeinflussen, organisiert nach ihrem Zweck, direkt aus dem offiziellen Befehlsverzeichnis von Claude Code entnommen.

Eine nützliche Gewohnheit für Anfänger: Entwickeln Sie zuerst eine Vertrautheit mit /compact, /plan und /diff, da diese drei allein die meisten frühen Frustrationen lösen — Sitzungen, die aufgrund von Kontextüberlastung abnehmen, Änderungen, die weiter gehen als beabsichtigt, und das Unwissen darüber, was genau geändert wurde. Alles andere in der Tabelle verdient seinen Platz, sobald diese drei zur Muskelgedächtnis geworden sind.

Eigene /truth-Befehle erstellen

Ein wichtiger Hinweis vor diesem Abschnitt: /truth ist kein Befehl, der mit Claude Code geliefert wird. Er erscheint nicht im offiziellen Befehlsverzeichnis, und es ist mir nicht gelungen, ihn in der aktuellen Dokumentation oder in Community-Leitfäden zu bestätigen. Was jedoch tatsächlich nützlich ist — und wahrscheinlich die Idee inspiriert hat — ist ein Befehl, der Claude dazu bringt, seine eigenen jüngsten Aussagen mit dem tatsächlichen Code abzugleichen, bevor Sie ihnen vertrauen und fortfahren. Das ist eine echte Lücke, die es zu schließen gilt, und ein perfektes Beispiel für das benutzerdefinierte Befehlsystem von Claude Code. Hier ist, wie Sie es selbst erstellen können.

Benutzerdefinierte Befehle werden als Fähigkeiten definiert — ein Ordner mit einer SKILL.md-Datei. Erstellen Sie eine solche Datei unter .claude/skills/truth/SKILL.md:

---
description: Überprüfen Sie Claudes jüngste Aussagen und Änderungen im Vergleich zum tatsächlichen Code
allowed-tools: Read, Grep, Glob, Bash(git diff:*)
---
Überprüfen Sie alles, was Sie mir in dieser Konversation gesagt haben, im Vergleich zu dem, was tatsächlich im Code vorhanden ist. Insbesondere:
1. Für jede Datei, von der Sie behaupten, sie bearbeitet zu haben, lesen Sie sie erneut und bestätigen Sie, dass die Änderung tatsächlich vorhanden ist und mit dem übereinstimmt, was Sie beschrieben haben.
2. Für jede Behauptung über bestehenden Code (das Verhalten einer Funktion, ein Konfigurationswert, ein Import, eine Abhängigkeitsversion) überprüfen Sie sie gegen die echte Datei, anstatt sich auf Ihr Gedächtnis zu verlassen.
3. Führen Sie `git diff` aus und vergleichen Sie den tatsächlichen Diff mit dem, was Sie beschrieben haben.
4. Berichten Sie klar: welche Behauptungen zutreffen, welche nicht, und genau was die Abweichung für alles war, was nicht stimmte. Mildern oder beschönigen Sie keine Abweichung, die Sie finden, sondern geben Sie sie direkt an.

Was dies bewirkt: Der YAML-Header schränkt diesen Befehl auf schreibgeschützte Tools plus einen eingeschränkten git diff ein, sodass der Befehl /truth niemals selbst Änderungen vornehmen kann — was wichtig ist, da ein Verifizierungsschritt, der auch Änderungen vornehmen kann, kein vertrauenswürdiger Verifizierungsschritt ist. Der Anweisungstext ist absichtlich spezifisch, was „überprüfen“ bedeutet: tatsächliche Dateien erneut lesen, anstatt sich auf die frühere Beschreibung des Modells zu verlassen, und Claude ausdrücklich zu sagen, dass es keine Abweichung mildern soll, wenn es eine findet, da eine Selbstüberprüfung, die dazu angeregt wird, beruhigend zu klingen, tatsächlich nichts überprüft.

Sobald die Datei gespeichert ist, wird /truth in jeder Sitzung in diesem Projekt verfügbar — genau wie jeder andere benutzerdefinierte Befehl — und es wird angezeigt, wenn Sie / eingeben und mit der Eingabe beginnen. Führen Sie es aus, nachdem Claude eine mehrstufige Aufgabe abgeschlossen hat, insbesondere eine, bei der es mehrere Dateien berührt oder Behauptungen über bestehenden Code aufgestellt hat, den es nicht kürzlich erneut gelesen hat, und bevor Sie etwas basierend auf diesen Behauptungen festschreiben.

Subagenten und paralleles Arbeiten für echte Geschwindigkeitsgewinne nutzen

Alles bisherige macht eine einzelne Claude Code-Sitzung zuverlässiger. Subagenten sorgen dafür, dass die Arbeit schneller erledigt wird, wenn diese nicht sequenziell ablaufen muss. Ein Subagent ist eine spezialisierte Instanz mit eigenem Kontextfenster, eigenem Systemprompt und eigenen Toolberechtigungen. Die Dokumentation von Anthropic zu Subagenten beschreibt sie als isoliert von der Hauptsitzung laufend, wobei sie eine Zusammenfassung zurückgeben, anstatt jede Zwischenablage und jeden Toolaufruf in Ihre primäre Konversation zurückzuziehen.

Diese Isolation ist der tatsächliche Leistungsgewinn. Die Erkundung großer Codebasen, Abhängigkeitsprüfungen und das Schreiben von Tests sind alles ausführliche Arbeiten, die sonst stark in das Kontextbudget Ihrer Hauptsitzung eingreifen würden. Delegieren Sie sie stattdessen an einen Subagenten, und nur das fertige Ergebnis kommt zurück.

Innerhalb einer Sitzung können Sie Claude auffordern, einen Subagenten zu erstellen, indem Sie den Befehl /agents ausführen.

Die Ausführung von /agents öffnet ein

Quellen: kdnuggets

Bildquelle: KI generiert

KI Snack