Was ist Claude Code, wie funktioniert es und wie nutzt man es im Projekt?

Claude Code ist ein Tool von Anthropic, das als KI-Agent für die Programmierung arbeitet: Es läuft im Terminal (sowie in Code-Editoren und Apps), liest die Projektdateien, nimmt Änderungen am Code vor, führt Befehle und Tests aus und erstellt auf Wunsch des Entwicklers Commits. Anders als ein gewöhnlicher Chat, in den man Codefragmente einfügt, hat Claude Code Zugriff auf das gesamte Repository und kann eine mehrstufige Aufgabe selbstständig erledigen – von der Suche nach der richtigen Stelle im Code über die Bearbeitung mehrerer Dateien bis zur Prüfung, ob die Tests bestehen. Die Entscheidung, was ins Projekt übernommen wird, trifft jedes Mal ein Mensch.

In diesem Ratgeber erklären wir, was Claude Code genau ist, wie seine Arbeit Schritt für Schritt abläuft, für welche Aufgaben in einem Softwareprojekt es sich am besten eignet und welche Grenzen Sie kennen sollten, bevor Ihr Team es im Alltag einsetzt.

Was ist Claude Code in der Praxis?

Ganz einfach: Claude Code ist das Sprachmodell Claude, verbunden mit einer Reihe von Tools, die es ihm ermöglichen, innerhalb der erteilten Berechtigungen auf Ihrem Computer oder Server zu arbeiten. Das Modell „denkt“ und plant, die Tools ermöglichen konkrete Tätigkeiten: Dateien durchsuchen, ihren Inhalt lesen, Code bearbeiten, Befehle in der Shell ausführen (z. B. Abhängigkeiten installieren, Build, Tests), Git nutzen oder über das Protokoll MCP externe Systeme anbinden.

Der Entwickler stellt also keine Frage wie „Wie schreibe ich Funktion X?“, sondern vergibt eine Aufgabe: „Füge dem Registrierungsformular eine Validierung der Steuernummer hinzu, ergänze Tests und prüfe, ob die gesamte Testsuite besteht.“ Der Agent ermittelt selbst, welche Dateien relevant sind, schlägt Änderungen vor, setzt sie um und meldet das Ergebnis. Diese Arbeitsweise wird oft als agentenbasiertes Programmieren (engl. agentic coding) bezeichnet.

Claude Code ist eines von mehreren Tools dieser Art auf dem Markt – neben u. a. Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI und Windsurf. Einen Vergleich finden Sie im Artikel KI-Tools für die Programmierung.

Claude Code vs. Claude AI – die Unterschiede

Der Name kann verwirren, denn „Claude“ ist zugleich eine Familie von Sprachmodellen, eine Chat-App (claude.ai) und eben Claude Code. Alle nutzen dieselben Modelle, dienen aber unterschiedlichen Zwecken.

Wenn Sie also im Zusammenhang mit Programmierung nach „Claude AI“ suchen, meinen Sie in den meisten Fällen Claude Code – der Chat eignet sich für Rückfragen, die eigentliche Arbeit im Projekt erledigt aber der Agent.

Wie funktioniert Claude Code? Die Agentenschleife Schritt für Schritt

Die Arbeit mit Claude Code ähnelt dem Delegieren einer Aufgabe an einen erfahrenen Kollegen, der das Projekt allerdings erst kennt, nachdem er es gelesen hat. Ein typischer Ablauf sieht so aus:

1. Aufgabe vergeben. Der Entwickler beschreibt das Ziel in natürlicher Sprache, am besten mit Kontext: worauf sich die Änderung bezieht, welche Abnahmekriterien gelten, was nicht angefasst werden darf.
2. Kontext sammeln. Der Agent durchsucht das Repository, liest Konfigurationsdateien, die Verzeichnisstruktur, vorhandene Tests und die mit der Aufgabe verbundenen Codeabschnitte.
3. Plan. Bei größeren Aufgaben legt Claude Code einen Plan vor. Bewährt hat es sich, den Plan freizugeben, bevor der Agent Dateien bearbeitet – das ist der günstigste Zeitpunkt für eine Kurskorrektur.
4. Code bearbeiten. Der Agent nimmt Änderungen in einer oder mehreren Dateien vor. Standardmäßig fragt er vor dem Bearbeiten und vor dem Ausführen von Befehlen um Erlaubnis; der Umfang automatischer Freigaben lässt sich konfigurieren.
5. Prüfung. Er führt Linter, Build und Tests aus. Schlägt etwas fehl, analysiert er den Fehler und korrigiert den Code – genau das unterscheidet einen Agenten von einem Generator für Codeschnipsel.
6. Bericht und Review. Der Agent fasst zusammen, was er geändert hat. Der Entwickler prüft die Unterschiede (Diff), gibt Anmerkungen – und erst dann landet die Änderung in einem Commit und Pull Request.

Diese Schleife „Kontext sammeln – handeln – prüfen – korrigieren“ wiederholt sich, bis die Aufgabe erledigt ist oder der Agent auf ein Problem stößt, bei dem er eine Entscheidung eines Menschen braucht.

Projektgedächtnis: die Datei CLAUDE.md

Claude Code erinnert sich nicht wie ein Mensch an frühere Sitzungen. Feste Informationen zum Projekt werden in der Datei CLAUDE.md im Repository hinterlegt: wie Projekt und Tests gestartet werden, welche Namenskonventionen gelten, welche Verzeichnisse nicht verändert werden dürfen, wie die Architektur aussieht. Der Agent liest diese Datei zu Beginn der Arbeit ein. Eine gut gepflegte CLAUDE.md ist einer der einfachsten Wege, die Qualität der Ergebnisse zu verbessern.

Berechtigungen und Arbeitsmodi

Ein Agent, der Befehle ausführen kann, braucht sinnvoll gesetzte Grenzen. Mit Claude Code lässt sich festlegen, welche Befehle und Tools ohne Rückfrage erlaubt sind, welche eine Zustimmung erfordern und welche gesperrt sind. In der Teamarbeit sollten diese Regeln in der Projektkonfiguration liegen, damit jeder Entwickler mit denselben Schutzmechanismen arbeitet.

Erweiterungen: MCP, Subagenten, Hooks

Die Möglichkeiten des Tools lassen sich auf mehrere Arten erweitern. MCP (Model Context Protocol) ermöglicht die Anbindung des Agenten an externe Systeme – z. B. eine Datenbank in der Testumgebung, ein Ticketsystem, die Dokumentation oder einen über Playwright gesteuerten Browser. Mehr über das Protokoll selbst schreiben wir im Artikel MCP – Model Context Protocol. Hinzu kommen eigene Befehle (per Schrägstrich aufgerufene Kommandos), Subagenten für spezialisierte Aufgaben sowie Hooks, also Skripte, die automatisch ausgeführt werden, z. B. nach jeder Dateibearbeitung (Formatierung, Linter).

Wofür Sie Claude Code im Projekt nutzen

Claude Code eignet sich am besten für Aufgaben, die klar definiert und überprüfbar sind – durch Tests, Build oder Code-Review. In diesen Bereichen verkürzt der Agent die Arbeit spürbar:

• Fremden Code verstehen. „Erkläre, wie der Bestellprozess in diesem Projekt funktioniert“ – der Agent geht die Dateien durch und beschreibt den Datenfluss. Sehr nützlich bei der Übernahme eines Projekts von einem anderen Dienstleister.
• Neue Funktionen mit klarem Umfang. Ein API-Endpunkt, ein Formular mit Validierung, ein CSV-Export, eine neue Ansicht im Admin-Panel – vor allem, wenn es im Projekt ähnliche Elemente gibt, an denen sich der Agent orientieren kann.
• Refactoring. Auslagern eines Moduls, Umbenennungen über viele Dateien hinweg, Vereinheitlichung der Fehlerbehandlung, Entfernen von totem Code.
• Tests. Ergänzen von Unit- und Integrationstests für bestehenden Code sowie von E2E-Szenarien. Ausführlicher beschreiben wir das im Artikel über Softwaretests mit KI.
• Migrationen und Updates. Anheben der Version eines Frameworks oder einer Bibliothek, Anpassung des Codes an eine geänderte API, Migration von einer Lösung auf eine andere.
• Debugging. Analyse von Logs und Fehlermeldungen, Reproduktion des Problems, Vorschlag einer Korrektur samt Test, der den Fehler erkennt.
• Dokumentation. README, API-Beschreibung, Kommentare zu komplexen Abschnitten, Deployment-Notizen – erstellt auf Basis des tatsächlichen Codes.
• Skripte und Automatisierung. Einmalige Skripte für Datenimporte, interne Tools, CI-Jobs.

In unseren Projekten ist Claude Code eines der Tools, die wir bei der Entwicklung von Web- und Mobile-Apps einsetzen – ausführlicher beschreiben wir das auf der Seite KI-Anwendungen und Entwicklung mit KI.

So starten Sie mit Claude Code im Unternehmen

Die Installation des Tools dauert wenige Minuten, die Einführung in die Arbeit des Teams sollte jedoch geplant werden. Bewährte Reihenfolge:

1. Wählen Sie den passenden Plan. Claude Code ist in den kostenpflichtigen Claude-Plänen sowie über die API mit verbrauchsabhängiger Abrechnung verfügbar. Für die Arbeit an Unternehmenscode wählen Sie Business-Pläne oder die API, bei denen die kommerziellen Bedingungen des Herstellers festlegen, dass Daten nicht zum Training der Modelle verwendet werden. Bedingungen und Preise ändern sich – prüfen Sie die aktuelle Preisliste und die Nutzungsbedingungen des Herstellers.
2. Erstellen Sie eine CLAUDE.md. Beschreiben Sie den Start des Projekts, die Tests, die Konventionen und die Bereiche, die der Agent nicht verändern soll.
3. Legen Sie Berechtigungen fest. Erlauben Sie sichere Befehle (Tests, Linter), verlangen Sie für alle anderen eine Zustimmung und sperren Sie den Zugriff auf Dateien mit Secrets und auf Produktionsumgebungen.
4. Beginnen Sie mit kleinen Aufgaben. Tests, kleine Korrekturen, Dokumentation. So lernt das Team, Anweisungen zu formulieren und Ergebnisse zu bewerten.
5. Verlangen Sie ein Code-Review. Jede Änderung des Agenten durchläuft dasselbe Code-Review wie eine Änderung eines Menschen. Ohne Ausnahme.
6. Sorgen Sie für Tests. Der Agent ist nur so gut wie die Prüfmechanismen im Projekt. Ohne Tests lässt sich nicht feststellen, ob „funktioniert“ wirklich funktioniert bedeutet.

Grenzen von Claude Code – was Sie beachten sollten

Claude Code kann viel, ist aber kein Entwickler, der Verantwortung für das Projekt übernimmt. Die wichtigsten Grenzen:

Fehler und selbstbewusste Irrtümer

Das Modell kann Code vorschlagen, der korrekt aussieht, aber einen Logikfehler enthält, eine nicht existierende Bibliotheksfunktion verwendet oder einen Grenzfall übergeht. Die Schleife mit Tests fängt einen Teil solcher Probleme ab – aber nur die, die durch Tests abgedeckt sind. Deshalb ist das Review durch einen Entwickler keine Formalität.

Begrenzter Kontext

Der Agent „sieht“ ein großes Projekt nicht auf einmal – er liest ausgewählte Dateien. In umfangreichen Systemen kann er eine Abhängigkeit in einem anderen Modul oder eine ungeschriebene Geschäftsregel übersehen. Hilfreich sind eine gute CLAUDE.md, präzise Anweisungen und die Aufteilung großer Aufgaben in kleinere.

Wissen über Fachdomäne und Architektur

Claude Code kennt weder Ihre Kunden noch Ihre Prozesse noch die Entscheidungen, die in Meetings getroffen wurden. Es entscheidet nicht für das Team, wie ein System konzipiert werden soll, das jahrelang laufen muss. Architekturentscheidungen, Abwägungen zwischen Leistung und Kosten sowie geschäftliche Prioritäten bleiben bei den Menschen.

Sicherheit

Ein Agent mit Zugriff auf Shell und Dateien ist eine potenzielle Angriffsfläche. Zu den Risiken gehören u. a. die versehentliche Offenlegung von Secrets, die Ausführung eines unerwünschten Befehls oder Prompt Injection – versteckte Anweisungen in Dateien, Websites oder Daten, die der Agent liest. Schutzmaßnahmen: eingeschränkte Berechtigungen, kein Zugriff auf die Produktion, Secrets außerhalb des Repositorys, Arbeit in einem Container oder einer isolierten Umgebung bei stärker autonomen Aufgaben.

Kosten

Die Arbeit des Agenten verbraucht Tokens – lange Sitzungen an einem großen Repository können mehr kosten, als man denkt. Es lohnt sich, den Verbrauch zu überwachen und die Arbeit in kürzere, gut beschriebene Aufgaben aufzuteilen.

Die Versuchung des „Vibe Coding“

Es ist verlockend, Änderungen zu übernehmen, ohne den Code zu lesen – „es funktioniert ja“. In einem Prototyp mag das akzeptabel sein, in der Produktion nicht. Den Unterschied zwischen diesen Ansätzen beschreiben wir im Artikel Was ist Vibe Coding.

Claude Code im Softwarehaus – so arbeiten wir

Bei 4B Systems betrachten wir Claude Code und ähnliche Tools als Beschleunigung der Entwicklerarbeit, nicht als deren Ersatz. Unsere Grundsätze:

• Wir nutzen die Tools in Business-Plänen, in denen der Code des Kunden nicht zum Training der Modelle verwendet wird,
• jede vom Agenten erzeugte Änderung prüft der für den jeweiligen Bereich verantwortliche Entwickler,
• der Agent hat weder Zugriff auf die Produktion noch auf Produktionsdaten,
• Funktionen verifizieren wir mit automatisierten Tests, einschließlich E2E-Tests mit Playwright,
• Entscheidungen über Architektur, Sicherheit und Umfang trifft das Team, nicht das Tool.

So erhält der Kunde eine schnellere Umsetzung der wiederkehrenden Projektteile – und zugleich Code, für den konkrete Menschen verantwortlich sind und der sich weiterentwickeln lässt.

Fazit

Claude Code ist ein KI-Agent, der direkt im Repository arbeitet: Er liest Code, bearbeitet Dateien, führt Tests aus und meldet die Ergebnisse. Am besten eignet er sich für gut beschriebene, überprüfbare Aufgaben – neue Funktionen mit klarem Umfang, Refactoring, Tests, Migrationen und Dokumentation. Seine Grenzen sind mögliche Fehler, begrenzter Kontext, fehlendes Geschäftswissen und Sicherheitsrisiken – deshalb sind Berechtigungen, Tests und ein Code-Review durch einen Menschen entscheidend.

Sie möchten KI in Ihrem Projekt nutzen, ohne die Codequalität zu gefährden? Bei 4B Systems entwickeln wir Web- und Mobile-Apps mit Claude Code und weiteren KI-Tools – mit Review jeder Änderung durch einen Entwickler und automatisierten Tests. Wie wir arbeiten, sehen Sie auf der Seite Entwicklung mit KI bei 4B Systems. Beschreiben Sie Ihr Projekt – ein Angebot erhalten Sie innerhalb von 48 Stunden.

Häufig gestellte Fragen

Ist Claude Code kostenlos?

Claude Code ist in den kostenpflichtigen Claude-Plänen enthalten oder über die API mit Abrechnung nach verbrauchten Tokens verfügbar. Umfang und Preise der Pläne ändern sich regelmäßig – prüfen Sie daher vor einer Entscheidung die aktuelle Preisliste des Herstellers.

Worin unterscheidet sich Claude Code von Claude AI?

Claude AI ist ein Chat für Gespräche und Inhaltsanalysen, in den man Code einfügen muss. Claude Code ist ein Agent im Terminal oder Editor, der Zugriff auf das Repository hat, Dateien bearbeitet und Befehle ausführt, z. B. Tests.

Kann Claude Code einen Entwickler ersetzen?

Nein. Es beschleunigt klar definierte Aufgaben, übernimmt aber keine Verantwortung für Architektur, Sicherheit oder die Erfüllung der geschäftlichen Anforderungen. Jede Änderung sollte ein Code-Review durch einen Entwickler durchlaufen.

Ist der Code des Unternehmens bei der Arbeit mit Claude Code sicher?

Das hängt von Plan und Konfiguration ab. In den Business-Plänen und bei Nutzung über die API legen die kommerziellen Bedingungen des Herstellers fest, dass Daten nicht zum Training der Modelle verwendet werden – das sollten Sie prüfen. Zusätzlich sollten die Berechtigungen des Agenten eingeschränkt, Secrets außerhalb des Repositorys gehalten und kein Zugriff auf die Produktion gewährt werden.

Mit welchen Programmiersprachen funktioniert Claude Code?

Claude Code ist an keine bestimmte Sprache gebunden – es arbeitet mit gängigen Sprachen und Frameworks, u. a. JavaScript/TypeScript, Python, PHP, Java, C#, Go sowie Swift und Kotlin. Die Qualität der Ergebnisse hängt jedoch davon ab, wie gut das Projekt dokumentiert und getestet ist.

Was ist die Datei CLAUDE.md?

Eine Datei im Repository mit Anweisungen für den Agenten: wie Projekt und Tests gestartet werden, welche Konventionen gelten und was nicht verändert werden darf. Claude Code liest sie zu Beginn der Arbeit ein, sodass diese Informationen nicht in jedem Befehl wiederholt werden müssen.