Claude Code: ein agentischer Coder in Ihrem Terminal

# Claude Code: ein agentischer Coder in Ihrem Terminal

Claude Code liest Ihr Projekt, plant eine Änderung, bearbeitet mehrere Dateien und führt Befehle für Sie aus, alles aus Ihrem Terminal oder Ihrer IDE. Es ist kein Chatfenster, in das Sie Snippets einfügen. Es ist ein Agent, der in Ihrem Repository lebt, Ihren echten Dateibaum sieht und mit Ihrer Erlaubnis darauf agiert.

Den agentischen Loop verstehen Sie im Abstrakten bereits: beobachten, planen, handeln, Ergebnis prüfen, wiederholen. Diese Lektion zeigt Ihnen diesen Loop an echtem Code, wobei die „Tools“ das Lesen von Dateien, das Schreiben von Dateien und das Ausführen von Shell-Befehlen sind. Wir gehen eine konkrete Aufgabe durch (einen fehlschlagenden Test reparieren und die Änderung erklären) und sehen uns die Berechtigungsabfragen genau an, die Ihnen die Kontrolle sichern.

Was Claude Code tatsächlich ist

Claude Code ist ein Kommandozeilen-Tool von Anthropic, das Claude in ein Agent-Harness mit Datei- und Shell-Zugriff einbettet. Sie führen es in einem Projektverzeichnis aus. Es baut ein Verständnis Ihrer Codebasis auf, schlägt einen Plan vor und führt Schritte aus, wobei es vor allem Folgenreichen nachfragt.

Der entscheidende Denkwechsel: In den Claude-Apps bringen Sie den Kontext zum Modell. Mit Claude Code holt sich das Modell seinen Kontext selbst. Es greppt Ihre Dateien, öffnet die relevanten, liest Ihre package.json oder pyproject.toml und führt Ihre Test-Suite aus, um zu sehen, was tatsächlich kaputt ist. Sie kuratieren das Context WindowContext WindowThe context window is the maximum amount of text (measured in tokens) a language model can process at once, including both the input prompt and the generated output.Vollständige Definition ansehen → nicht mehr von Hand.

Es läuft direkt in Ihrem Terminal und lässt sich außerdem in IDEs wie VS Code und JetBrains einbinden. Der offizielle Startpunkt ist die Claude Code Dokumentation.

Installation

Claude Code installiert sich mit einem einzigen Befehl. Node.js muss vorher verfügbar sein.

npm install -g @anthropic-ai/claude-code

Dann wechseln Sie in ein beliebiges Projekt und starten es:

cd my-project
claude

Beim ersten Start führt es Sie durch die Authentifizierung. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen sich mit einem Claude-Konto anmelden (Pro- und Max-Pläne beinhalten die Nutzung von Claude Code) oder einen Anthropic APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → Key verwenden, der über die Console abgerechnet wird. Nach der Authentifizierung landen Sie in einer interaktiven Session in Ihrem Projekt.

Der agentische Loop, konkret gemacht

Machen wir das greifbar. Stellen Sie sich ein kleines Python-Projekt mit einem fehlschlagenden Test vor. Ihre Suite meldet:

FAILED tests/test_cart.py::test_apply_discount - AssertionError: assert 90.0 == 95.0

Sie wissen noch nicht, ob der Bug im Test oder im Code steckt. Sie tippen eine Anweisung:

> Fix the failing test in tests/test_cart.py and explain the change you made.

Das passiert nun Schritt für Schritt, und warum jeder Schritt zählt.

Schritt 1: Es erkundet, bevor es handelt

Claude Code fängt nicht mit dem Bearbeiten an. Es führt zuerst lesende Befehle aus, um sich zu orientieren. Es kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnte Ihren Test-Befehl ausführen, um den Fehler zu reproduzieren, dann tests/test_cart.py und die importierte Quelldatei öffnen, wahrscheinlich cart.py.

Das ist die „Beobachten“-Phase des Loops, und sie läuft gegen Ihre echten Dateien, nicht gegen eine Beschreibung, die Sie getippt haben. Dateien lesen und Verzeichnisse auflisten sind risikoarme Aktionen, je nach Einstellungen passieren sie also, ohne Sie zu unterbrechen.

Schritt 2: Es bildet einen Plan

Claude Code überlegt, was es gefunden hat. Vielleicht multipliziert apply_discount mit der Rabattrate, statt sie abzuziehen, sodass 10 Prozent Rabatt auf einen 100-Dollar-Warenkorb 10.0 statt 90.0 zurückgeben, und die Testerwartung von 90.0 ist korrekt. Der Bug liegt in der Quelle, nicht im Test.

Bei mehrstufiger Arbeit schreibt es oft einen kurzen Plan, manchmal als Checkliste, die es unterwegs nachverfolgt. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen den Plan lesen, bevor Code geändert wird, das ist Ihre erste Gelegenheit umzulenken, falls das Ziel missverstanden wurde.

Schritt 3: Es schlägt eine Änderung vor und fragt um Erlaubnis

Jetzt will es cart.py ändern. Hier erscheint die erste echte Berechtigungsabfrage. Claude Code zeigt Ihnen einen Diff: genau die Zeilen, die es entfernen und hinzufügen will. Nichts wird auf die Platte geschrieben, bevor Sie zustimmen.

cart.py
-     return price * discount_rate
+     return price * (1 - discount_rate)

Do you want to make this edit?
  > Yes
    Yes, and don't ask again for this session
    No, tell Claude what to do differently

Sie sehen genau, was sich ändern wird. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen annehmen, ablehnen oder steuern. Dieses Muster „Diff, dann Zustimmung“ ist der Kern dessen, warum das Tool an echtem Code sicher einsetzbar ist: keine stillen Änderungen.

Schritt 4: Es führt den Befehl aus und fragt erneut

Nach der Änderung will Claude Code seine Arbeit überprüfen, indem es die Tests erneut ausführt. Einen Shell-Befehl auszuführen ist eine separate, empfindlichere Aktion als eine Datei zu bearbeiten, also fragt es noch einmal:

Claude wants to run:
  pytest tests/test_cart.py

  > Yes
    Yes, and don't ask again for pytest commands
    No

Sie stimmen zu. Die Tests laufen. Claude Code liest die Ausgabe, sieht Grün und meldet zurück.

Schritt 5: Es schließt den Loop und erklärt

Weil Sie um eine Erklärung gebeten haben, fasst es zusammen: Die Rabattfunktion multiplizierte den Preis mit der Rate, statt die Rate als Abzug anzuwenden, der Fix zieht den Rabatt vom Vollpreis ab, und die vorher fehlschlagende Assertion läuft jetzt durch. Die Phase „Ergebnis prüfen“ des agentischen Loops fand statt, indem Ihre Tests tatsächlich ausgeführt wurden, nicht indem Claude riet, ob die Änderung funktioniert.

Das ist der ganze Loop: erkunden, planen, bearbeiten (mit Zustimmung), ausführen (mit Zustimmung), verifizieren, erklären.

Berechtigungen sind das Sicherheitsmodell

Der Grund, warum ein Agent mit Shell-Zugriff nicht beängstigend ist, ist das Berechtigungssystem. Verstehen Sie es, und Sie nutzen Claude Code mit Zuversicht.

Standardmäßig behandelt Claude Code Aktionen nach Risikostufe. Dateien lesen und durchsuchen ist permissiv. Dateien schreiben löst eine Abfrage mit Diff aus. Shell-Befehle löst eine Abfrage mit dem exakten Befehl aus. Alles, was das Netzwerk berührt oder etwas Destruktives ausführt, wird jedes Mal abgefragt.

Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen das anpassen. Die Optionen „Yes, and don't ask again“ erteilen eine dauerhafte Erlaubnis für ein bestimmtes Tool oder Befehlsmuster innerhalb einer Session, sodass Sie nicht zwanzigmal denselben harmlosen pytest-Aufruf bestätigen. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen auch eine Allowlist und Denylist von Befehlen in Ihren Projekteinstellungen konfigurieren, damit die Regeln über Sessions hinweg bestehen bleiben.

Für mehr Autonomie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen Sie bewusst breitere Berechtigungen erteilen, und für nicht vertrauenswürdige Arbeit kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen Sie Claude Code in einem Sandbox- oder eingeschränkten Modus laufen lassen. Das Prinzip ist: *Sie* bestimmen die Leinenlänge. Der Standard ist absichtlich konservativ.

Wo es in das übrige Claude-Ökosystem passt

Claude Code ist keine separate Intelligenz. Es ist Claude (dieselbe Modellfamilie, die Sie in den Apps und der Messages APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → nutzen), verdrahtet in ein Coding-Agent-Harness. Zu wissen, wie es mit den anderen Teilen zusammenhängt, hilft Ihnen, zum richtigen Werkzeug zu greifen.

CLAUDE.md: dauerhaftes Projektgedächtnis

Legen Sie eine Datei namens CLAUDE.md in Ihr Projekt-Root, und Claude Code liest sie automatisch am Anfang jeder Session. Dort hinterlegen Sie Projektkonventionen, den Befehl zum Ausführen der Tests, Architekturnotizen und „dieses Verzeichnis nicht anfassen“-Warnungen. Es sind dauerhafte Anweisungen, die Sessions überleben, sodass Sie Ihr Projekt nicht jedes Mal neu erklären.

# Project: checkout-service

## Commands
- Test: `pytest -q`
- Lint: `ruff check .`

## Conventions
- All prices are in integer cents, never floats.
- Do not edit files in `legacy/` without asking.

MCP: Claude Code neue Tools geben

Das Model Context Protocol haben Sie zuvor als offenen Standard kennengelernt, der Claude erlaubt, mit externen Tools und Datenquellen zu sprechen. Claude Code ist ein MCP-Client. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen MCP-Server anbinden, um ihm Fähigkeiten über Dateien und Shell hinaus zu geben: Ihre Datenbank abfragen, Ihren Issue Tracker lesen, eine interne APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → ansprechen. Die Model Context Protocol Seite ist die Referenz, und dieselben Connectors, die Sie in den Claude-Apps nutzen, gelten hier größtenteils ebenfalls.

GitHub-Integration

Claude Code arbeitet ganz natürlich mit Ihrem Git-Workflow. Es kann Branches erstellen, Commits mit sinnvollen Messages schreiben und Pull Requests öffnen. Anthropic bietet zudem eine GitHub-Integration, sodass Sie Claude in einem Issue oder Pull Request taggen und direkt im Repo Änderungen vorschlagen lassen kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen, asynchron, ohne offenes Terminal. Die offiziellen Tools finden Sie unter github.com/anthropics.

Das Claude Agent SDK: wenn Sie bauen wollen, nicht nur nutzen

Claude Code ist ein fertiges Produkt. Dasselbe Agent-Harness darunter gibt es als Claude Agent SDK, sodass Sie eigene Agents mit Dateizugriff, Tool-Nutzung und den Berechtigungsmustern bauen kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen, die Sie gerade gesehen haben. Wenn Sie merken, dass Sie einen eigenen internen Agent wollen, etwa zum Triagieren von Logs oder zum Pflegen von Docs, ist das die Aufgabe des SDK. Claude Code ist der Coding-Agent von der Stange, das Agent SDK ist der Bausatz für Ihren eigenen.

Praktische Gewohnheiten, die es gut funktionieren lassen

Einige Muster trennen frustrierende Sessions von produktiven.

Geben Sie ihm eine Möglichkeit, sich selbst zu prüfen. Das Wirksamste überhaupt ist ein funktionierender Test-Befehl. Wenn Claude Code Tests ausführen kann, korrigiert es sich selbst. Das Rabatt-Beispiel lief glatt, weil pytest ein Ground-Truth-Signal lieferte. Ohne Tests arbeitet es teilweise blind.

Fassen Sie Ihre Anfragen eng. „Fix this failing test“ ist eine gute Anweisung, weil sie überprüfbar und begrenzt ist. „Refactor the whole payment system“ lädt zu einem ausufernden, schwer zu prüfenden Diff ein. Zerlegen Sie große Arbeit in Schritte, die Sie einzeln freigeben kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen.

Lesen Sie den Plan, dann die Diffs. Ihr Review ist Teil des Loops. Die Berechtigungsabfragen sind keine Bürokratie, sie sind die Momente, in denen Ihr Urteil einfließt. Ein Diff vor der Freigabe zu überfliegen fängt den einen oder anderen Fehlweg früh ab.

Nutzen Sie CLAUDE.md, statt sich zu wiederholen. Jede Einschränkung, die Sie mehr als einmal aussprechen, gehört in diese Datei.

Zentrale Erkenntnisse

• Installieren mit npm install -g @anthropic-ai/claude-code, claude in einem Projekt ausführen und mit einem Claude-Plan oder einem APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → Key authentifizieren.
• Claude Code fährt einen echten agentischen Loop auf Ihrer Codebasis: Es erkundet Dateien, plant, bearbeitet mit einem Diff, den Sie freigeben, führt Befehle aus, die Sie freigeben, und verifiziert durch Ausführen Ihrer Tests.
• Das Berechtigungssystem ist das Sicherheitsmodell. Dateiänderungen zeigen vor dem Schreiben einen Diff, Shell-Befehle fragen mit dem exakten Befehl nach. Die Leinenlänge steuern Sie über Allowlists und „don't ask again“-Freigaben.
• Legen Sie eine CLAUDE.md mit Ihrem Test-Befehl, Konventionen und Tabu-Verzeichnissen an, damit der Agent dauerhaften Kontext über Sessions hinweg mitnimmt.
• Greifen Sie zu MCP-Servern und der GitHub-Integration, um es zu erweitern, und zum Claude Agent SDK, wenn Sie auf demselben Harness Ihren eigenen Agent bauen wollen.