Claude Code: ein agentischer Coder in Ihrem Terminal

Claude Code liest Ihr Projekt, plant eine Änderung, bearbeitet mehrere Dateien und führt in Ihrem Auftrag Befehle aus, alles direkt aus Ihrem Terminal oder Ihrer IDE. Sie kopieren keine Snippets in ein Chatfenster. Es ist ein Agent, der in Ihrem Repository arbeitet, Ihren echten Dateibaum sieht und mit Ihrer Erlaubnis darauf handelt.

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

Was Claude Code eigentlich ist

Claude Code ist ein Kommandozeilen-Tool von Anthropic, das Claude in ein Agent-Harness mit Datei- und Shell-Zugriff einbettet. Sie starten es in einem Projektverzeichnis. Es verschafft sich ein Verständnis Ihrer Codebasis, schlägt einen Plan vor und führt Schritte aus, wobei es vor allem, was Folgen hat, innehält und nachfragt.

Der entscheidende Perspektivwechsel: In den Claude-Apps bringen Sie den Kontext zum Modell. Bei Claude Code holt sich das Modell seinen Kontext selbst. Es durchsucht Ihre Dateien mit grep, öffnet die relevanten, liest Ihre package.json oder pyproject.toml und lässt Ihre Test-Suite laufen, um zu sehen, was tatsächlich kaputt ist. Sie müssen das Kontextfenster nicht mehr von Hand kuratieren.

Es läuft direkt in Ihrem Terminal. Es lässt sich außerdem in IDEs wie VS Code und JetBrains einbinden und läuft über Claude Code on the web auch im Browser. Offizieller Einstiegspunkt ist die Claude Code documentation.

Installation

Empfohlen ist der native Installer, der kein Node.js benötigt. Unter macOS, Linux oder WSL:

curl -fsSL https://claude.ai/install.sh | bash

Unter Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

In älteren Anleitungen finden Sie eventuell noch npm install -g @anthropic-ai/claude-code. Diese Methode ist veraltet, nutzen Sie für neue Setups den nativen Installer.

Wechseln Sie dann in ein beliebiges Projekt und starten Sie das Tool:

cd my-project
claude

Beim ersten Start führt es Sie durch die Authentifizierung. Sie kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen sich mit einem Claude-Konto anmelden (die Pläne Pro, Max, Team und Enterprise enthalten Nutzung von Claude Code). Sie können auch einen Anthropic APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →-Key verwenden, der über die Claude Console abgerechnet wird. Nach der Authentifizierung landen Sie in einer interaktiven Session in Ihrem Projekt.

Der agentische Loop ganz konkret

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 10.0 == 90.0

Sie wissen noch nicht, ob der Fehler im Test oder im Code steckt. Sie geben eine einzige Anweisung ein:

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

Im Folgenden sehen Sie Schritt für Schritt, was passiert und warum jeder Schritt wichtig ist.

Schritt 1: Es erkundet, bevor es handelt

Claude Code fängt nicht sofort an zu editieren. Zuerst führt es Befehle ohne Schreibzugriff aus, um sich zu orientieren. Es lässt vielleicht Ihren Testbefehl laufen, um den Fehler zu reproduzieren, und öffnet dann tests/test_cart.py sowie die importierte Quelldatei, vermutlich cart.py.

Das ist die „Beobachten“-Phase des Loops, ausgeführt an Ihren echten Dateien statt an einer Beschreibung, die Sie eingetippt haben. Dateien lesen und Verzeichnisse auflisten ist risikoarm, deshalb kann das je nach Ihren Einstellungen ohne Unterbrechung passieren.

Schritt 2: Es erstellt einen Plan

Claude Code wertet aus, was es gefunden hat. apply_discount multipliziert den Preis mit dem Rabattsatz, statt den Preis um diesen Satz zu reduzieren. Ein Rabatt von 10 Prozent auf einen Warenkorb von 100 Dollar ergibt 10.0 statt 90.0. Die Erwartung des Tests von 90.0 ist korrekt, der Fehler liegt also im Quellcode.

Bei mehrstufigen Aufgaben schreibt es oft einen kurzen Plan, manchmal als Checkliste, die es nach und nach abhakt. Sie können den Plan lesen, bevor sich irgendein Code ändert. Das ist Ihre erste Gelegenheit, gegenzusteuern. Bei größeren Aufgaben wechseln Sie mit Shift+Tab in den Plan-Modus, in dem es recherchiert und einen Plan vorschlägt, ohne Dateien anzufassen.

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

Jetzt will es cart.py ändern, und die erste echte Berechtigungsabfrage erscheint. Claude Code zeigt Ihnen ein Diff mit genau den Zeilen, die es entfernen und hinzufügen will. Bis Sie zustimmen, wird nichts auf die Festplatte geschrieben.

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 können annehmen, ablehnen oder umlenken. Dieses Muster aus Diff und anschließender Freigabe macht das Tool für echten Code sicher: Es gibt 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 laufen lässt. Einen Shell-Befehl auszuführen ist eine eigene, sensiblere Aktion als eine Datei zu bearbeiten, deshalb 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 sich zurück.

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

Weil Sie danach gefragt haben, fasst es den Fix zusammen. Die Funktion hat den Preis mit dem Satz multipliziert, statt den Satz als Abzug anzuwenden. Der Fix berechnet price * (1 - discount_rate), und die fehlgeschlagene Assertion besteht jetzt. Die Phase „Ergebnis prüfen“ lief über Ihre Tests, Claude hat nicht geraten.

Das ist der ganze Loop: erkunden, planen, editieren (mit Freigabe), ausführen (mit Freigabe), überprüfen, erklären.

Berechtigungen sind das Sicherheitsmodell

Ein Agent mit Shell-Zugriff bleibt beherrschbar, weil es das Berechtigungssystem gibt. Wenn Sie es verstehen, arbeiten Sie mit Claude Code souverän.

Standardmäßig behandelt Claude Code Aktionen nach Risikostufe. Dateien lesen und durchsuchen ist großzügig erlaubt. Beim Schreiben von Dateien bekommen Sie eine Abfrage mit Diff. Beim Ausführen von Shell-Befehlen bekommen Sie eine Abfrage mit dem genauen Befehl, und alles, was ins Netzwerk geht oder destruktiv ist, löst jedes Mal eine Abfrage aus.

Das lässt sich anpassen. Die Optionen „Yes, and don't ask again“ erteilen eine dauerhafte Erlaubnis für ein bestimmtes Tool oder Befehlsmuster, damit Sie nicht zwanzigmal denselben harmlosen pytest-Aufruf freigeben müssen. Sie können außerdem Allow- und Deny-Regeln in .claude/settings.json festlegen, sodass sie über Sessions hinweg gelten, und der Befehl /permissions zeigt, was aktuell erlaubt ist.

Für mehr Autonomie können Sie bewusst in einen Modus wechseln, der Änderungen automatisch übernimmt. Für nicht vertrauenswürdige Arbeit lassen Sie Claude Code in einer Sandbox oder einem Container laufen. Sie bestimmen, wie lang die Leine ist, und die Voreinstellung ist absichtlich konservativ.

Wie es zum restlichen Claude-Ökosystem passt

Claude Code ist keine eigene Intelligenz. Es ist Claude, dieselbe Modellfamilie, die Sie in den Apps und in der Messages API nutzen, eingebunden in ein Agent-Harness für Coding. Wer weiß, wie es mit den anderen Bausteinen zusammenhängt, greift zum richtigen Werkzeug.

CLAUDE.md: dauerhaftes Projektgedächtnis

Legen Sie eine Datei namens CLAUDE.md im Stammverzeichnis Ihres Projekts ab, dann liest Claude Code sie zu Beginn jeder Session. Dort gehören Projektkonventionen hinein, außerdem der Testbefehl, Architekturnotizen und Warnungen wie „dieses Verzeichnis nicht anfassen“. Mit /init erstellt Claude Code aus Ihrer Codebasis einen Entwurf für Sie.

# 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.

MCPMCPEin offener Standard, mit dem KI-Assistenten einheitlich und kontrolliert an die Werkzeuge und Daten des Unternehmens angebunden werden, statt jede Integration einzeln zu bauen.Vollständige Definition ansehen →: Claude Code neue Tools geben

Das Model Context Protocol haben Sie bereits als offenen Standard kennengelernt, über den Claude mit externen Tools und Datenquellen kommuniziert. Claude Code ist ein MCP-Client. Binden Sie MCP-Server an, um ihm Fähigkeiten jenseits von Dateien und Shell zu geben, etwa Abfragen auf Ihrer Datenbank, das Lesen Ihres Issue-Trackers oder den Aufruf einer internen API. Die Referenz ist die Model Context Protocol site. Über MCP hinaus unterstützt Claude Code auch Subagents, Hooks und Plugins, mit denen Sie eigene Workflows paketieren.

GitHub-Integration

Claude Code fügt sich in Ihren Git-Workflow ein. Es kann Branches anlegen, Commits mit sinnvollen Messages schreiben und Pull Requests öffnen. Anthropic bietet außerdem eine GitHub-Integration an (Einrichtung mit /install-github-app). Damit können Sie @claude in einem Issue oder Pull Request markieren und asynchron Änderungen vorschlagen lassen, ohne dass Ihr Terminal offen ist. Die offiziellen Tools finden Sie unter github.com/anthropics.

Das Claude Agent SDK: wenn Sie selbst bauen statt nur nutzen wollen

Claude Code ist ein fertiges Produkt. Das Agent-Harness darunter steht als Claude Agent SDK zur Verfügung, sodass Sie eigene Agents mit Dateizugriff, Tool-Nutzung und den eben gezeigten Berechtigungsmustern bauen können. Wenn Sie einen eigenen internen Agent zum Triagieren von Logs oder zur Pflege von Dokumentation brauchen, nehmen Sie das SDK. Claude Code ist der Coding-Agent von der Stange, das Agent SDK ist der Baukasten für Ihren eigenen.

Arbeitsgewohnheiten, mit denen es gut funktioniert

Einige Muster unterscheiden frustrierende Sessions von produktiven.

Geben Sie ihm eine Möglichkeit, sich selbst zu prüfen. Ein funktionierender Testbefehl ist hier wichtiger als alles andere. Wenn Claude Code Tests ausführen kann, korrigiert es sich selbst. Das Rabatt-Beispiel lief sauber, weil pytest ein verlässliches Signal lieferte. Ohne Tests editiert es teilweise blind.

Grenzen Sie Ihre Anfragen ein. „Fix this failing test“ ist überprüfbar und klar umrissen. „Refactor the whole payment system“ führt zu einem ausufernden Diff, den niemand reviewen kann. Teilen Sie große Aufgaben in Schritte auf, die Sie einzeln freigeben, oder beginnen Sie im Plan-Modus.

Lesen Sie erst den Plan, dann die Diffs. In den Berechtigungsabfragen kommt Ihr Urteil in den Loop, und wer einen Diff vor der Freigabe kurz überfliegt, erkennt Fehlentwicklungen früh.

Jede Vorgabe, die Sie mehr als einmal aussprechen, gehört in die CLAUDE.md.

Key Takeaways

• Installieren Sie mit dem nativen Installer (curl -fsSL https://claude.ai/install.sh | bash), starten Sie claude in einem Projekt und melden Sie sich mit einem Claude-Plan oder einem API-Key an. Die npm-Installation ist veraltet.
• Claude Code fährt einen echten agentischen Loop auf Ihrer Codebasis: Es erkundet Dateien, plant, editiert mit einem Diff, den Sie freigeben, führt Befehle aus, die Sie freigeben, und überprüft das Ergebnis über Ihre Tests.
• Das Berechtigungssystem ist das Sicherheitsmodell. Die Länge der Leine legen Sie mit Allow- und Deny-Regeln, „don't ask again“-Freigaben und Modi wie dem Plan-Modus fest.
• Eine CLAUDE.md mit Ihrem Testbefehl, Ihren Konventionen und gesperrten Verzeichnissen gibt dem Agent dauerhaften Kontext über Sessions hinweg.
• Erweitern Sie es mit MCP-Servern und der GitHub-Integration, und nutzen Sie das Claude Agent SDK, wenn Sie auf demselben Harness einen eigenen Agent bauen wollen.