SpyBara
Go Premium

how-claude-code-works.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 39 additions and 77 deletions.

2026
Wed 9 22:58 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

So funktioniert Claude Code

Verstehen Sie die agentengesteuerte Schleife, integrierte Tools und wie Claude Code mit Ihrem Projekt interagiert.

Claude Code ist ein agentengesteuerter Assistent, der in Ihrem Terminal läuft. Obwohl er sich bei der Codierung auszeichnet, kann er bei allem helfen, was Sie von der Befehlszeile aus tun können: Dokumentation schreiben, Builds ausführen, Dateien durchsuchen, Themen recherchieren und vieles mehr.

Dieser Leitfaden behandelt die Kernarchitektur, integrierte Funktionen und Tipps für effektive Zusammenarbeit mit Claude Code. Für schrittweise Anleitungen siehe Häufige Workflows. Für Erweiterungsfunktionen wie skills, MCP und hooks siehe Claude Code erweitern.

Die agentengesteuerte Schleife

Wenn Sie Claude eine Aufgabe geben, arbeitet er durch drei Phasen: Kontext sammeln, Maßnahmen ergreifen und Ergebnisse überprüfen. Diese Phasen verschmelzen miteinander. Claude nutzt Tools durchgehend, ob beim Durchsuchen von Dateien zum Verständnis Ihres Codes, beim Bearbeiten zur Vornahme von Änderungen oder beim Ausführen von Tests zur Überprüfung seiner Arbeit.

Diagramm der agentengesteuerten Schleife: Ihre Eingabeaufforderung führt dazu, dass Claude Kontext sammelt, Maßnahmen ergreift, Ergebnisse überprüft und wiederholt, bis die Aufgabe abgeschlossen ist. Sie können jederzeit unterbrechen. Diagramm der agentengesteuerten Schleife: Ihre Eingabeaufforderung führt dazu, dass Claude Kontext sammelt, Maßnahmen ergreift, Ergebnisse überprüft und wiederholt, bis die Aufgabe abgeschlossen ist. Sie können jederzeit unterbrechen.

Die Schleife passt sich an das an, was Sie fragen. Eine Frage zu Ihrer Codebasis könnte nur Kontextsammlung erfordern. Eine Fehlerbehebung durchläuft alle drei Phasen wiederholt. Eine Umstrukturierung könnte umfangreiche Überprüfung beinhalten. Claude entscheidet, was jeder Schritt erfordert, basierend auf dem, was er aus dem vorherigen Schritt gelernt hat, verkettet Dutzende von Aktionen zusammen und korrigiert seinen Kurs unterwegs.

Sie sind auch Teil dieser Schleife. Sie können jederzeit unterbrechen, um Claude in eine andere Richtung zu lenken, zusätzlichen Kontext bereitzustellen oder ihn zu bitten, einen anderen Ansatz zu versuchen. Claude arbeitet autonom, bleibt aber responsiv gegenüber Ihrer Eingabe.

Die agentengesteuerte Schleife wird von zwei Komponenten angetrieben: Modellen, die denken, und Tools, die handeln. Claude Code dient als agentengesteuerte Umgebung um Claude: Sie bietet die Tools, Kontextverwaltung und Ausführungsumgebung, die ein Sprachmodell in einen fähigen Codierungs-Agenten verwandeln.

Modelle

Claude Code nutzt Claude-Modelle, um Ihren Code zu verstehen und über Aufgaben nachzudenken. Claude kann Code in jeder Sprache lesen, verstehen, wie Komponenten verbunden sind, und herausfinden, was sich ändern muss, um Ihr Ziel zu erreichen. Bei komplexen Aufgaben unterteilt er die Arbeit in Schritte, führt sie aus und passt sich basierend auf dem an, was er lernt.

Mehrere Modelle sind mit unterschiedlichen Kompromissen verfügbar. Sonnet bewältigt die meisten Codierungsaufgaben gut. Opus bietet stärkeres Denken für komplexe architektonische Entscheidungen. Wechseln Sie mit /model während einer Sitzung oder starten Sie mit claude --model <name>.

Wenn dieser Leitfaden sagt „Claude wählt" oder „Claude entscheidet", ist es das Modell, das die Überlegung durchführt.

Tools

Tools sind das, was Claude Code agentengesteuert macht. Ohne Tools kann Claude nur mit Text antworten. Mit Tools kann Claude handeln: Ihren Code lesen, Dateien bearbeiten, Befehle ausführen, das Web durchsuchen und mit externen Diensten interagieren. Jede Tool-Nutzung gibt Informationen zurück, die in die Schleife fließen und Claudes nächste Entscheidung informieren.

Die integrierten Tools fallen im Allgemeinen in fünf Kategorien, die jeweils eine andere Art von Agentur darstellen.

Kategorie Was Claude tun kann
Dateivorgänge Dateien lesen, Code bearbeiten, neue Dateien erstellen, umbenennen und reorganisieren
Suche Dateien nach Muster finden, Inhalte mit Regex durchsuchen, Codebases erkunden
Ausführung Shell-Befehle ausführen, Server starten, Tests ausführen, git verwenden
Web Das Web durchsuchen, Dokumentation abrufen, Fehlermeldungen nachschlagen
Code-Intelligenz Typfehler und Warnungen nach Bearbeitungen sehen, zu Definitionen springen, Referenzen finden (erfordert Code-Intelligenz-Plugins)

Dies sind die primären Funktionen. Claude hat auch Tools zum Spawnen von Subagenten, zum Stellen von Fragen und für andere Orchestrierungsaufgaben. Siehe Tools verfügbar für Claude für die vollständige Liste.

Claude wählt basierend auf Ihrer Eingabeaufforderung und dem, was er unterwegs lernt, aus, welche Tools er verwenden soll. Wenn Sie sagen „beheben Sie die fehlgeschlagenen Tests", könnte Claude:

  1. Die Test-Suite ausführen, um zu sehen, was fehlschlägt
  2. Die Fehlerausgabe lesen
  3. Nach den relevanten Quelldateien suchen
  4. Diese Dateien lesen, um den Code zu verstehen
  5. Die Dateien bearbeiten, um das Problem zu beheben
  6. Die Tests erneut ausführen, um zu überprüfen

Jede Tool-Nutzung gibt Claude neue Informationen, die den nächsten Schritt informieren. Dies ist die agentengesteuerte Schleife in Aktion.

Erweitern der Basisfunktionen: Die integrierten Tools sind die Grundlage. Sie können das, was Claude weiß, mit skills erweitern, sich mit externen Diensten mit MCP verbinden, Workflows mit hooks automatisieren und Aufgaben an subagents delegieren. Diese Erweiterungen bilden eine Schicht auf der Grundlage der agentengesteuerten Schleife. Siehe Claude Code erweitern für Anleitung zur Auswahl der richtigen Erweiterung für Ihre Anforderungen.

Worauf Claude zugreifen kann

Wenn Sie claude in einem Verzeichnis ausführen, erhält Claude Code Zugriff auf:

  • Ihr Projekt. Dateien in Ihrem Verzeichnis und Unterverzeichnissen sowie Dateien an anderer Stelle mit Ihrer Genehmigung.
  • Ihr Terminal. Jeden Befehl, den Sie ausführen könnten: Build-Tools, git, Paketmanager, Systemdienstprogramme, Skripte. Wenn Sie es von der Befehlszeile aus tun können, kann Claude es auch.
  • Ihren git-Status. Aktueller Branch, nicht committete Änderungen und aktuelle Commit-Historie.
  • Ihre CLAUDE.md. Eine Markdown-Datei, in der Sie projektspezifische Anweisungen, Konventionen und Kontext speichern, den Claude jede Sitzung kennen sollte.
  • Auto-Speicher. Erkenntnisse, die Claude automatisch speichert, während Sie arbeiten, wie Ihre Vorlieben. Die ersten 200 Zeilen oder 25 KB von MEMORY.md, je nachdem, was zuerst kommt, werden zu Beginn jeder Sitzung geladen.
  • Erweiterungen, die Sie konfigurieren. MCP-Server für externe Dienste, skills für Workflows, subagents für delegierte Arbeit und Claude in Chrome für Browser-Interaktion.

Da Claude Ihr gesamtes Projekt sieht, kann er darin arbeiten. Wenn Sie Claude bitten, „den Authentifizierungsfehler zu beheben", sucht er nach relevanten Dateien, liest mehrere Dateien, um den Kontext zu verstehen, nimmt koordinierte Bearbeitungen vor, führt Tests aus, um die Behebung zu überprüfen, und committed die Änderungen, wenn Sie es fragen. Dies unterscheidet sich von Inline-Code-Assistenten, die nur die aktuelle Datei sehen.

Umgebungen und Schnittstellen

Die agentengesteuerte Schleife, Tools und Funktionen, die oben beschrieben sind, sind überall gleich, wo Sie Claude Code verwenden. Was sich ändert, ist, wo der Code ausgeführt wird und wie Sie damit interagieren.

Ausführungsumgebungen

Claude Code läuft in drei Umgebungen, jede mit unterschiedlichen Kompromissen für die Ausführung Ihres Codes.

Umgebung Wo Code läuft Anwendungsfall
Lokal Ihr Computer Standard. Vollständiger Zugriff auf Ihre Dateien, Tools und Umgebung
Cloud Von Anthropic verwaltete VMs oder selbst gehostete Umgebungen, die Ihre Organisation betreibt Aufgaben auslagern, an Repos arbeiten, die Sie nicht lokal haben
Remote Control Ihr Computer, gesteuert von einem Browser Verwenden Sie die Web-UI, während Ausführung und Ihre Dateien lokal bleiben

Schnittstellen

Sie können auf Claude Code über das Terminal, die Desktop-App, IDE-Erweiterungen, claude.ai/code, Remote Control, Slack und CI/CD-Pipelines zugreifen. Die Schnittstelle bestimmt, wie Sie Claude sehen und damit interagieren, aber die zugrunde liegende agentengesteuerte Schleife ist identisch. Siehe Claude Code überall verwenden für die vollständige Liste.

Mit Sitzungen arbeiten

Claude Code speichert Ihre Konversation lokal, während Sie arbeiten. Jede Nachricht, Tool-Nutzung und jedes Ergebnis wird in einer Klartextdatei im JSONL-Format unter ~/.claude/projects/ geschrieben, was Zurückspulen, Fortsetzen und Verzweigen von Sitzungen ermöglicht. Bevor Claude Code-Änderungen vornimmt, erstellt er auch einen Snapshot der betroffenen Dateien, damit Sie bei Bedarf zurückrollen können. Für Pfade, Aufbewahrung und wie Sie diese Daten löschen, siehe Anwendungsdaten in ~/.claude.

Sitzungen sind unabhängig. Jede neue Sitzung beginnt mit einem frischen Kontextfenster, ohne die Konversationshistorie aus vorherigen Sitzungen. Claude kann Erkenntnisse über Sitzungen hinweg mit Auto-Speicher beibehalten, und Sie können Ihre eigenen persistenten Anweisungen in CLAUDE.md hinzufügen.

Über Branches arbeiten

Jede Claude Code-Konversation ist eine Sitzung, die an Ihr aktuelles Verzeichnis gebunden ist. Die /resume-Auswahl zeigt standardmäßig Sitzungen aus dem aktuellen Worktree an, mit Tastaturkürzeln zum Erweitern der Liste auf andere Worktrees oder Projekte. Siehe Sitzungen verwalten für die vollständige Liste der Auswahl-Tastaturkürzeln und wie die Namensauflösung funktioniert.

Claude sieht die Dateien Ihres aktuellen Branches. Wenn Sie Branches wechseln, sieht Claude die Dateien des neuen Branches, aber Ihre Konversationshistorie bleibt gleich. Claude erinnert sich an das, was Sie besprochen haben, auch nach dem Wechsel.

Da Sitzungen an Verzeichnisse gebunden sind, können Sie parallele Claude-Sitzungen ausführen, indem Sie git worktrees verwenden, die separate Verzeichnisse für einzelne Branches erstellen.

Sitzungen fortsetzen oder verzweigen

Wenn Sie eine Sitzung mit claude --continue oder claude --resume fortsetzen, setzen Sie diese unter derselben Sitzungs-ID fort und hängen neue Nachrichten an die bestehende Konversation an. Wenn Sie mit --fork-session oder /branch verzweigen, wird die Historie in eine neue Sitzungs-ID kopiert, wobei die ursprüngliche unverändert bleibt.

Diagramm der Sitzungskontinuität: Fortsetzen setzt dieselbe Sitzung fort, Verzweigung erstellt einen neuen Branch mit einer neuen ID. Diagramm der Sitzungskontinuität: Fortsetzen setzt dieselbe Sitzung fort, Verzweigung erstellt einen neuen Branch mit einer neuen ID.

Für die Fortsetzen-Flags, die /resume-Auswahl, Benennung und was passiert, wenn dieselbe Sitzung in zwei Terminals offen ist, siehe Sitzungen verwalten.

Das Kontextfenster

Claudes Kontextfenster enthält Ihre Konversationshistorie, Dateiinhalte, Befehlsausgaben, CLAUDE.md, Auto-Speicher, geladene Skills und Systemanweisungen. Während Sie arbeiten, füllt sich der Kontext. Claude komprimiert automatisch, aber Anweisungen von früh in der Konversation können verloren gehen. Legen Sie persistente Regeln in CLAUDE.md ab, und führen Sie /context aus, um zu sehen, was Platz verbraucht.

Für eine interaktive Anleitung zu dem, was geladen wird und wann, siehe Erkunden Sie das Kontextfenster.

Wenn der Kontext voll wird

Claude Code verwaltet den Kontext automatisch, wenn Sie sich dem Limit nähern. Es löscht zuerst ältere Tool-Ausgaben, dann fasst die Konversation zusammen, falls erforderlich. Ihre Anfragen und wichtige Code-Snippets werden beibehalten; detaillierte Anweisungen von früh in der Konversation können verloren gehen. Legen Sie persistente Regeln in CLAUDE.md ab, anstatt sich auf die Konversationshistorie zu verlassen.

Um zu kontrollieren, was während der Komprimierung beibehalten wird, fügen Sie einen Abschnitt „Compact Instructions" zu CLAUDE.md hinzu oder führen Sie /compact mit einem Fokus aus (wie /compact focus on the API changes).

Wenn eine einzelne Datei oder Tool-Ausgabe so groß ist, dass sich der Kontext unmittelbar nach jeder Zusammenfassung wieder füllt, stoppt Claude Code die automatische Komprimierung nach einigen Versuchen und zeigt stattdessen einen Fehler an. Siehe Auto-Komprimierung stoppt mit einem Thrashing-Fehler für Wiederherstellungsschritte.

Führen Sie /context aus, um zu sehen, was Platz verbraucht. MCP-Tool-Definitionen werden standardmäßig aufgeschoben und bei Bedarf über Tool-Suche geladen, daher verbrauchen nur Tool-Namen und Server-Anweisungen Kontext, bis Claude ein bestimmtes Tool verwendet.

Kontext mit Skills und Subagents verwalten

Über die Komprimierung hinaus können Sie andere Funktionen verwenden, um zu kontrollieren, was in den Kontext geladen wird.

Skills werden bei Bedarf geladen. Claude sieht Skill-Beschreibungen zu Sitzungsbeginn, aber der vollständige Inhalt wird nur geladen, wenn ein Skill verwendet wird. Für Skills, die Sie manuell aufrufen, setzen Sie disable-model-invocation: true, um Beschreibungen aus dem Kontext zu halten, bis Sie sie benötigen. Für Skills, die Sie nicht geschrieben haben, verwenden Sie skillOverrides, um dasselbe aus den Einstellungen zu tun.

Subagents arbeiten in ihrem eigenen Kontextfenster. Ein Subagent startet neu, es sei denn, es ist ein Fork, der mit einer Kopie Ihrer bisherigen Konversation startet. In jedem Fall bleiben die Tool-Aufrufe des Subagents aus Ihrem Kontext, und Claude erhält eine Zusammenfassung, wenn der Subagent fertig ist.

Siehe Kontextkosten für die Kosten jeder Funktion und Token-Nutzung reduzieren für Tipps zur Verwaltung des Kontexts.

Sicher bleiben mit Checkpoints und Berechtigungen

Claude hat zwei Sicherheitsmechanismen: Checkpoints ermöglichen es Ihnen, Dateiänderungen rückgängig zu machen, und Berechtigungen kontrollieren, was Claude ohne Nachfrage tun kann.

Änderungen mit Checkpoints rückgängig machen

Jede Dateibearbeitung ist reversibel. Bevor Claude eine Datei bearbeitet, erstellt er einen Snapshot des aktuellen Inhalts. Wenn etwas schief geht, drücken Sie zweimal Esc, um zu einem vorherigen Zustand zurückzuspulen, oder bitten Sie Claude, rückgängig zu machen.

Checkpoints sind getrennt von git und bleiben verfügbar, wenn Sie ein Gespräch fortsetzen. Sie decken nur Dateiänderungen ab, und eine Wiederherstellung überspringt symverlinkte und hardgelinkte Dateien. Aktionen, die sich auf Remote-Systeme auswirken (Datenbanken, APIs, Bereitstellungen), können nicht checkpointed werden. Sie kontrollieren diese mit Ihrem Berechtigungsmodus und Ihren Berechtigungsregeln.

Kontrollieren Sie, was Claude tun kann

Wählen Sie einen Berechtigungsmodus, um festzulegen, was Claude ohne Nachfrage tun kann. Drücken Sie Shift+Tab, um durch die Berechtigungsmodi zu wechseln:

  • Auto: Ein Klassifizierer überprüft die meisten Aktionen im Hintergrund und blockiert die riskanten, anstatt Sie zu fragen. In Pro-, Max- und Team-Plänen ist es der integrierte Standard-Berechtigungsmodus für interaktive Terminal- und VS Code-Sitzungen
  • Manual: Claude fragt vor Dateibearbeitungen und Shell-Befehlen
  • Accept edits: Claude bearbeitet Dateien und führt häufige Dateisystem-Befehle wie mkdir und mv ohne Nachfrage aus, fragt aber immer noch nach anderen Befehlen
  • Plan: Claude erkundet und schlägt einen Plan vor, ohne Ihre Quelldateien zu bearbeiten

Sie können auch spezifische Befehle in .claude/settings.json zulassen, damit Claude nicht jedes Mal fragt. Dies ist nützlich für vertrauenswürdige Befehle wie npm test oder git status. Einstellungen können von organisationsweiten Richtlinien bis zu persönlichen Vorlieben reichen. Siehe Berechtigungen für Details.

Effektiv mit Claude Code arbeiten

Diese Tipps helfen Ihnen, bessere Ergebnisse von Claude Code zu erhalten. Weitere Informationen zu spezifischen Eingabeaufforderungen, Überprüfung und Planung finden Sie unter Best Practices.

Fragen Sie Claude Code um Hilfe

Claude Code kann Ihnen beibringen, wie man ihn verwendet. Stellen Sie Fragen wie „Wie richte ich hooks ein?" oder „Was ist der beste Weg, meine CLAUDE.md zu strukturieren?" und Claude wird erklären.

Integrierte Befehle führen Sie auch durch die Einrichtung:

  • /init führt Sie durch die Erstellung einer CLAUDE.md für Ihr Projekt
  • /doctor führt eine Einrichtungsüberprüfung durch, die Installations- und Konfigurationsprobleme diagnostiziert und diese beheben kann

Es ist eine Konversation

Claude Code ist konversativ. Sie benötigen keine perfekten Eingabeaufforderungen. Beginnen Sie mit dem, was Sie möchten, und verfeinern Sie dann:

Beheben Sie den Login-Fehler

[Claude untersucht, versucht etwas]

Das ist nicht ganz richtig. Das Problem liegt in der Sitzungsverwaltung.

[Claude passt seinen Ansatz an]

Wenn der erste Versuch nicht richtig ist, müssen Sie nicht von vorne anfangen. Sie iterieren.

Unterbrechen und lenken

Sie können Claude jederzeit unterbrechen, ohne auf das Ende des Durchgangs zu warten oder von vorne anzufangen:

  • Drücken Sie Esc, um Claude sofort zu stoppen. Der laufende Toolaufruf wird abgebrochen und Claude wartet auf Ihre nächste Anweisung. Wenn Sie Nachrichten in der Warteschlange haben, sendet Claude Code sie als nächstes.
  • Geben Sie eine Korrektur ein und drücken Sie Enter, um sie zu senden, ohne das laufende Tool zu stoppen. Claude liest sie, sobald die aktuelle Aktion abgeschlossen ist, und passt sich an, bevor er seinen nächsten Schritt entscheidet.

Delegieren, nicht diktieren

Denken Sie daran, an einen fähigen Kollegen zu delegieren. Geben Sie Kontext und Richtung, dann vertrauen Sie Claude, die Details herauszufinden:

Der Checkout-Fluss ist für Benutzer mit abgelaufenen Karten unterbrochen.
Der relevante Code ist in src/payments/. Können Sie ihn untersuchen und beheben?

Sie müssen nicht angeben, welche Dateien zu lesen sind oder welche Befehle auszuführen sind. Claude findet das heraus.

Nächste Schritte

puzzle-piece Mit Funktionen erweitern

Fügen Sie Skills und MCP-Verbindungen hinzu
graduation-cap Häufige Workflows

Schritt-für-Schritt-Anleitungen für typische Aufgaben