Wer anfängt, KI für die Softwareentwicklung zu nutzen, verwendet Claude Code oft wie Google vor zehn Jahren. Frage eingeben, Antwort erhalten. Das funktioniert, aber nur bis zu einem gewissen Punkt. Sobald das Projekt eine relevante Größe erreicht, reicht dieser Ansatz nicht mehr aus. 

Zwischen dieser einfachen, Google-ähnlichen Nutzung und einem Agenten-Team, das selbstständig liefert, während Sie Entscheidungen überprüfen, haben wir sieben klar unterscheidbare Levels identifiziert. Auf Level 7 fügt sich alles zusammen. Ebenso kann alles zusammenbrechen, wenn man direkt dorthin springt, ohne die darunter liegenden Levels solide aufgebaut zu haben. 

Dieses Modell ist auf Claude Code ausgelegt – alle Pfade, Befehle und Beispiele beziehen sich darauf. Mit kleinen Anpassungen lässt es sich aber auch auf andere Agenten wie Copilot oder Codex übertragen. Betrachten Sie die Levels als sieben Hebel – nicht als Checkliste, die man schnell abhakt. 

Die 7 Levels im Überblick

  1. Direkte Prompts: Sie erhalten Antworten
  2. CLAUDE.md: Claude bekommt Kontext
  3. MCPs: Claude bekommt Augen und Hände
  4. Skills: Claude bekommt wiederverwendbare Shortcuts
  5. Agenten: Claude bekommt Fokus
  6. Hooks: Claude bekommt Guardrails
  7. Agenten-Orchestrierung: Claude bekommt ein Team

Jedes Level löst ein Problem, das das vorherige offenlässt. Deshalb weist jeder Abschnitt auf eine Einschränkung hin, denn diese Einschränkung ist der Grund für die nächste Stufe. 

Level 1: Direkte Prompts – wo die meisten aufhören 

Kurz gesagt: Ein Prompt geht rein, Code kommt raus. Sie stellen Fragen zur Codebase, beheben Bugs oder schreiben Funktionen – ohne jegliches Setup. Für einmalige Fragen und schnelle Snippets ist das genau das richtige Werkzeug. Mit dem Plan-Modus lässt sich die Ausgabe deutlich verbessern – Claude durchdenkt dabei zunächst das große Ganze, bevor es handelt. 

Die Grenze zeigt sich, sobald Sie ein neues Gespräch starten. Jedes Gespräch beginnt bei null. Claude weiß nichts über Ihre Architektur, kennt weder Ihre Team-Konventionen noch das, was Sie letzte Woche ausgeliefert haben – es sei denn, Sie fügen es jedes Mal explizit ein. Sie sind das Gedächtnis und der Kontext. Sie tragen alles mit sich und jedes Mal wächst der Aufwand mit der Größe der Codebase und des Teams. 

Level 2: CLAUDE.md gives Claude persistent context

Mit /initerstellt Claude eine Projektdatei, die es zu Beginn jeder Sitzung liest. Halten Sie sie kurz und präzise.

Beispiel:

# Project Overview

A single-page HTML slide presentation.

No build system, just open index.html in a browser.

## Architecture

Vertical scroll-snap layout. Each <section class="slide">

is exactly one viewport tall. SlidePresentation JS

class handles keyboard/wheel nav + IntersectionObserver.

## Key Constraint

Every slide must fit in a single viewport (overflow: hidden).

Jetzt erinnert sich Claude. Sie schreiben es einmal und müssen sich nicht mehr wiederholen. Alle im Team erben den gleichen Ausgangpunkt. Die Datei sollte wie Code behandelt werden: regelmäßig überprüfen und aktuell halten, aber der Versuchung widerstehen, die gesamte Architektur hineinzupacken. Alles in dieser Datei wird zu Beginn jedes Gesprächs in den Kontext geladen und belegt Platz. Dieses Problem lässt sich zumindest teilweise reduzieren, indem die Inhalte der CLAUDE.md auf mehrere themenspezifische Dateien verteilt werden. In der CLAUDE.md wird dann nur auf diese Dateien verwiesen, sodass ihre Inhalte erst bei Bedarf in das Kontextfenster geladen werden. 

Die Grenze: Claude kann immer noch nicht prüfen, ob Ihre Benutzeroberfläche (UI) im Browser korrekt gerendert wird, und kann die Fehler-Logs aus Ihrer CI/CD-Pipeline nicht lesen. Es kennt nur Ihr Projekt, nicht das Umfeld drumherum. 

Level 3: MCPs geben Claude Augen und Hände

Das Model Context Protocol (MCP) verbindet Claude mit Systemen außerhalb Ihres Dateibaums. Ohne MCPs beschränkt sich die Reichweite auf Claude und Ihre Dateien. Mit MCPs stehen Figma, Postgres, Chrome-Steuerung, interne APIs und vieles mehr zur Verfügung. 

Sie geben Claude damit nicht nur mehr Intelligenz, sondern verbinden es mit Ihrer Welt. Claude liest das Datenbankschema, statt es zu erraten. Es öffnet die Seite, statt zu beschreiben, wie sie aussehen sollte. Und es ruft die API auf, statt Sie zu bitten, eine Beispielantwort einzufügen. 

Dann taucht eine weitere Einschränkung auf: Sie bemerken, was Sie trotz all dieser Reichweite immer wieder tun. Denselben Workflow tippen, Tests ausführen, Code linten, Dateien stagen und Änderungen mit Commit-Nachricht committen. 

Level 4: Skills turn your best prompts into reusable shortcuts

Ein Skill ist ein Prompt, den Sie einmal schreiben und nie wieder schreiben müssen. In .claude/skills/ ablegen und  dann er steht als /write-tests zur Verfügung.

Beispiel: 

# .claude/skills/write-tests/SKILL.md

Look at the file provided.

Write full test coverage using Vitest.

Follow patterns in __tests__/examples/.

Cover happy path, edge cases, error states.

> /write-tests src/payments/processor.ts

Der Slash-Befehl ist dabei der kleinere Teil. Was Ihren Arbeitsalltag wirklich verändert: Claude liest die Skill-Beschreibung und lädt den Skill selbstständig, wenn eine Aufgabe dazu passt, ohne dass ihn jemand explizit aufruft. Ihre Konventionen sind nicht mehr etwas, das Sie im Review durchsetzen müssen,  sie werden zum Ausgangspunkt des Agenten. 

Die Grenze: Manchmal läuft eine Aufgabe aus dem Ruder. Sie bitten um ein Code-Review, und Claude fängt stattdessen an, Tests zu schreiben. 

Level 5: Agenten geben Claude Fokus

CLAUDE.md liefert Kontext. Agenten liefern Verhalten. Sie definieren eine Rolle, und Claude arbeitet darin. 

Beispiel: 

# Adversarial Reviewer

Try to break this PR. Find edge cases, race

conditions, and security holes. No praise, only problems.

 

# Technical Architect

Evaluate design for scalability and maintainability.

Flag coupling, missing abstractions, future bottlenecks.

 

# QA Engineer

Write tests: happy path, edge cases, failure modes.

If a test passes too easily, it's not testing enough.

Bessere Anweisungen schlagen mehr Autonomie. Ein fokussierter Agent übertrifft einen generalisierten Agenten, denn die meisten enttäuschenden Ergebnisse entstehen aus einem Aufgabenbereich, der nie eingegrenzt wurde. Auch braucht nicht jeder Agent das stärkste Modell. Einfachere Aufgaben lassen sich mit einem schnelleren und günstigeren Modell erledigen. Das teurere bleibt für Arbeit reserviert, die es wirklich braucht. Drei oder vier klar definierte Rollen bringen die meisten Teams weiter als eine lange Liste von Rollen, die sich kaum unterscheiden 

Die Grenze: Ihr ship it Skill wirkt lokal einwandfrei, aber dann schlägt das Linting in der CI/CD-Pipeline fehl. Manchmal ignoriert Claude eine Anweisung schlicht.

Level 6: Hooks sind die Governance-Schicht für Autonomie

Claude Code stellt rund 30 Hook-Events bereit. In der Praxis beginnt man mit vier davon: PreToolUse, bevor ein Tool ausgeführt wird; PostToolUse, nachdem es abgeschlossen ist; Stop, wenn eine Aufgabe endet und Notification, wenn Claude Ihre Aufmerksamkeit benötigt.

Beispiel:

# Block production config edits

PreToolUse: file == ".env.production" → deny

 

# Auto-lint after every file write

PostToolUse: on file_write → npm run lint

Sie verlassen sich nicht mehr darauf, dass Claude jedes Mal das Richtige tut. Stattdessen stellen Sie sicher, dass das Falsche schlicht unmöglich wird. Das schafft eine andere Grundlage für Vertrauen und ist die Voraussetzung dafür, weitere Aufgaben zu übertragen. Auch Prüfungen, die Sie normalerweise erst im Nachhinein manuell durchführen würden, gehören dazu. Denn eine Regel, die automatisch angewendet wird, ist wertvoller als eine, die lediglich dokumentiert ist 

Die Grenze: Hooks regeln eine Sitzung, erinnern sich aber nicht daran, was die letzte gelernt hat. 

Level 7: Agenten-Orchestrierung und warum sie nicht immer hält, was sie verspricht

Sie beschreiben, was gebraucht wird. Ein Business-Analyst erfasst die Anforderungen. Ein technischer Architekt schreibt den Plan. Ein Builder setzt ihn um. Ein Reviewer prüft das Ergebnis. Ein Fixer löst die offenen Punkte. Sie sind kein Einzelspieler mehr, Sie dirigieren ein Orchester. 

Das ist das Level, das alle begeistert und auch das, was am meisten offensichtlichsten scheitert. Ein Dirigent, der nie ein Instrument gespielt hat, weiß nicht, was möglich ist. Richten Sie ein solches Setup auf ein Repository ohne CLAUDE.md, MCP-Zugriff, Skills und Hooks aus, produziert es schnell Output, aber ohne jeden Maßstab zum Beurteilen, ob irgendetwas davon gut ist. Das ist Chaos mit höherer Taktfrequenz. 

Die Einschränkung ist dieselbe wie auf Level1, nur skaliert. Jede Sitzung beginnt noch immer bei null. 

Citadel: Damit die Levels 2 bis 6 die Sitzung überleben 

Level 7 manuell aufzubauen ist echte Arbeit, welche sich in Luft auflöst, wenn der Laptop zugeklappt wird. Citadel wird als Betriebssystem-Schicht für Claude Code beschrieben. Es ist eine Infrastruktur, die KI-Agenten ermöglicht, autonom und zuverlässig an großen Codebasen zu arbeiten. 

Es adressiert die Einschränkung, auf die Sie erstmals auf Level 1 gestoßen sind: Kontext geht zwischen Sitzungen verloren und dieselben Fehler wiederholen sich. Aufgaben manuell zwischen Agenten aufzuteilen, skaliert ebenfalls nicht. Der Koordinationsaufwand fällt damit wieder auf Sie zurück. 

Citadel ersetzt die darunter liegenden Levels nicht. Es nimmt das, was Sie über die Levels 2 bis 6 aufgebaut haben, und lässt es sitzungsübergreifend bestehen. Ohne Kontext, Skills oder Hooks im Repository gibt es jedoch nichts, was Citadel dauerhaft bewahren könnte. 

Ein Citadel besteht aus fünf ineinandergreifenden Systemen: 

  • Intelligentes Routing. Eine vierstufige Klassifizierung leitet Ihre Absicht über /do an das günstigste geeignete Tool  und spart Zeit und Tokens. 
  • Campaign-Persistenz. Der Projektstatus bleibt auch über mehrere Tage nach dem Schließen des Laptops erhalten. Weiter mit /do continue. 
  • Fleet-Modus. Mehrere Agenten laufen in isolierten Git Worktrees, teilen Erkenntnisse und führen Ergebnisse automatisch zusammen. 
  • Domain-Skills. Formalisierte Protokolle werden in den Agenten-Kontext geladen. /review aufrufen und die Sicherheitsregeln greifen automatisch. 
  • Sicherheit und Kostenkontrolle. Obligatorische Lifecycle-Hooks verhindern gefährliche Aktionen. Token-Verbrauch und API-Kosten werden für jeden Schritt nachverfolgt und verhindern unerwarteten Abrechnungen. 

Das ist eine Infrastrukturschicht, die Agenten verwaltet, statt sie clever zu prompten. Das ist auch die ehrliche Grenze dessen, was ein Framework leisten kann: Es kann Ihren Kontext zwischen Sitzungen tragen, aber keinen erfinden, den Sie nie aufgeschrieben haben. 

That’s an infrastructure layer that manages the agents rather than a smarter way to prompt them. Which is also the honest boundary of what a framework can do for you: it can carry your context between sessions, but it can’t invent context you never wrote down.

Jedes Level verändert Ihre Rolle 

  • L1: Sie sind der Entwickler, Claude assistiert.
  • L2: Sie sind der Lehrer, Claude lernt Ihre Welt.
  • L3: Sie sind der Integrator, Claude erreicht Ihr Ökosystem.
  • L4: Sie sind der Toolmaker, Claude greift auf Ihre Workflows zurück.
  • L5: Sie sind der Reviewer, Claude erledigt die Arbeit.
  • L6: Sie sind der Aufseher, Claude arbeitet nach Ihren Regeln.
  • L7: Sie sind der Dirigent, Claude führt das Team. 

Wenn Sie sich diese Liste ansehen, werden Sie vermutlich schnell erkennen, ab welchem Punkt Sie sich mit Ihrer aktuellen Arbeitsweise unwohl fühlen würden. Denn bei jedem Schritt liegt die größte Herausforderung darin, selbst bereit zu sein, Kontrolle abzugeben. 

Fünf Dinge, die Sie auf dem Weg nach oben wissen sollten 

Kontextfenster im Blick behalten.

Wer die 50-Prozent-Marke überschreitet, riskiert Context Poisoning. Wenn es eng wird: neu starten. 

Aufräumrunden einplanen.

Claude generiert schnell, aber das geht mit dem Risiko einher, Entropie einzuführen. Refactoring- und Dokumentations-Durchläufe einplanen, bevor die Codebase in Richtungen driftet, in denen nur noch Agenten navigieren können. 

Lokale Überprüfung aktivieren.

Claude sollte Linting, Tests und Builds selbst ausführen. Jeder Umweg über einen Menschen kostet Zeit, die besser dafür genutzt wird, Dinge zu finden, die einfache automatisierte Prüfungen nicht erkennen. 

Kritisch bleiben.

Reviewen Sie kritisch, nicht nur zustimmend. Claude wird Ihnen sagen, dass eine Lösung korrekt ist, auch wenn sie es nicht ist. Aktuelle KI-Agenten neigen stark dazu, überzeugend falsch zu liegen. 

Claude als Sparringspartner nutzen.

Eigene Ideen einbringen, seine Vorschläge hinterfragen und das Denken nicht zusammen mit dem Tippen abgeben. Die besten Ergebnisse entstehen im Dialog, die schlechtesten durch reine Delegation. 

Der Wandel, der sich lohnt

Hören Sie auf zu fragen, was Claude für Sie schreiben kann. Beginnen Sie zu fragen, was Sie selbst sicher abgeben können. 

Die zweite Frage bringt ihre eigene Voraussetzung mit. Sicher bedeutet: 

  • der Kontext ist aufgeschrieben. 
  • die Tests existieren. 
  • die Workflows sind wiederverwendbar. 
  • die Guradrails halten. 

Bauen Sie das auf, und Level 7 ist keine Demo mehr, der Sie nur zugeschaut haben. Starten Sie auf dem Level, auf dem Sie sich gerade befinden, und arbeiten Sie sich Schritt für Schritt nach oben.