Wie Claude Code aufgebaut ist: Speicher, MCP, Skills, Subagenten, Hooks

Claude Code sieht aus wie eine Kommandozeile aus den Neunzigern: schwarzer Bildschirm, blinkender Cursor, mehr nicht. Darunter liegen sechs Schichten, die aus dem Werkzeug einen Baukasten machen, in dem Programmieren nur eines von vielen Szenarien ist.

Über die Philosophie der KI-Agenten habe ich an anderer Stelle geschrieben. Anders als ein Chatbot ist Claude Code ein vollwertiger Partner für sehr unterschiedliche Arbeit, vom Code über die Auswertung von Analytics bis zur Erstellung von Präsentationen. Hier geht es unter die Haube: aus welchen Schichten Claude Code besteht, wie der Speicher funktioniert, welche Befehle Sie kennen sollten und wozu Skills, MCP und Subagenten dienen. Mit Beispielen aus meiner eigenen Arbeit, ohne die Dokumentation nachzuerzählen.

Start und Slash-Befehle

Sie installieren Claude Code, öffnen das Terminal und tippen claude. Der Agent startet meist aus Ihrem Benutzerordner und fragt sofort, ob er darin arbeiten darf. Hier liegt die zentrale Eigenheit: Claude Code wird auf Ihrem Rechner installiert und kann in dem Ordner schalten und walten, den Sie ihm freigeben. Nach einem Chatbot ist das ungewohnt. Mein Rat: Geben Sie Claude Code ein eigenes Arbeitsverzeichnis, in dem er Projekte nach Unterordnern sortiert. Diese Projekte können Sie sich wie „Chats” vorstellen, ein Ordner für die Redaktion von Texten, einer für Analytics, einer, in dem Claude Code Texte und Daten parst, die anschließend mehrere Projekte nutzen.

Die Ordnerarbeit nimmt Claude Ihnen ab. Beim Start eines neuen Projekts schreibe ich etwas wie „Wir bauen einen Agenten für die Suche nach neuen Skills, lege ihm einen Ordner an”. Soll er in einem bestehenden Projekt arbeiten, genügt „Starte den Redaktions-Assistenten”, und das Modell wechselt in den passenden Ordner. Alternativ wechseln Sie selbst mit cd plus Pfad. Den Pfad müssen Sie nicht abtippen, Sie können den Ordner direkt ins Terminal ziehen.

Die Kommandozeile ist die Schaltzentrale, aber nicht der einzige Weg. An diesem Text arbeite ich zusammen mit einem Assistenten, der in einem eigenen Verzeichnis lebt. Dort liegen nach Unterordnern sortiert die Beschreibung meiner Projekte, ein Archiv früherer Texte, ein Skript, das neue Beiträge automatisch einsammelt, Analytics-Tabellen, Content-Pläne und Stilvorgaben. Für einen Artikel erstellen wir zuerst einen Plan im HTML-Format, das liest sich angenehmer als die Kommandozeile. Nach meiner Freigabe legt Claude Code eine Markdown-Datei an und füllt sie mit Kapitelentwürfen. Ich öffne die Datei in VS Code, schreibe sie in menschlichen Text um und setze Fragen oder Kommentare direkt im Text in eckige Klammern. Dann speichere ich, Claude Code prüft das Kapitel auf Richtigkeit und Sprache und arbeitet meine Kommentare ein.

Neben der Arbeit am Text lohnt es sich, die Slash-Befehle zu kennen, also alles, was mit „/” beginnt. Es gibt mehrere Dutzend. Die wichtigsten für den Anfang nach vier Gruppen sortiert.

Wo bin ich, was passiert gerade:

/status: wer Sie sind, wo Sie arbeiten, welches Modell verbunden ist, auf welcher Argumentationsstufe.
/context: wie viel des Kontextfensters schon belegt ist. Eine einfache Faustregel: bei 200K möglichst unter 120K bis 140K Tokens bleiben, bei 1M unter 400K. Darüber wird das Modell meist ungenauer und verbrennt zusätzliche Tokens.
/stats: Tokens und Kosten der laufenden Sitzung.
/help: das vollständige Verzeichnis aller Befehle.

Einstellungen für die Aufgabe:

/model: Modell wechseln. Im Pro-Tarif empfehle ich zum Einstieg Sonnet mit 200K Kontext, später Opus für komplexe Aufgaben. Im Max-Tarif können Sie direkt mit Opus arbeiten und mit der Zeit auf einfachere Modelle wechseln, wenn Sie Tokens sparen wollen.
/effort: Tiefe der Argumentation. Für Pro empfehle ich „high”, für Max „xhigh”.
/config: allgemeine Einstellungen wie Oberfläche und Recap-Verhalten.
/permissions: was Claude ohne Rückfrage darf und was nicht. Dazu gleich mehr.

Sitzung steuern:

/new: neue, leere Sitzung. Die alte bleibt in der Historie.
/clear: Kontext der laufenden Sitzung zurücksetzen, ohne den Ordner zu wechseln oder Claude neu zu starten. Praktisch, wenn eine Aufgabe erledigt ist und Sie im selben Ordner mit frischem Kopf weitermachen.
/compact: das Bisherige zu einer Zusammenfassung verdichten und weiterarbeiten.
/resume: eine gespeicherte Sitzung über Name oder ID wieder aufnehmen.
/recap: ein kurzer Überblick, was getan wurde und wo Sie stehen, wenn Sie nach einer Stunde oder am nächsten Tag zurückkommen.

Gehirn und Werkzeuge:

/memory: ansehen, was Claude über Sie und das Projekt weiß.
/init: Claude eine CLAUDE.md für den aktuellen Ordner erzeugen lassen.
/agents: Liste der Subagenten, die laufen oder gestartet werden können.
/hooks: automatische Auslöser.
/mcp: angebundene externe Dienste.

Dazu zwei Tastenkürzel: Shift+Tab wechselt die Bestätigungsmodi, Ctrl+C bricht die laufende Aktion ab, wenn Claude sich verrennt.

Warum Claude jedes Mal nachfragt

In den ersten Minuten verhält sich Claude Code wie ein Paranoiker. Er fragt, ob er eine Datei öffnen, einen Befehl ausführen oder ins Netz gehen darf. Das nervt, aber die Logik ist gesund: Der Agent lebt in Ihrem Dateisystem und könnte im Prinzip etwas Wichtiges löschen, also fragt er lieber nach. Eingestellt wird das über Shift+Tab. Es gibt drei Hauptvarianten.

Der Standardmodus fragt bei allem nach, was Dateien ändert oder ins Netz geht. Maximal sicher, aber auf einem komplexen Projekt drücken Sie ab der zehnten Minute pausenlos Enter. Im Modus „Accept Edits” (einmal Shift+Tab) laufen Dateiänderungen ohne Rückfrage, während Netzanfragen, Shell-Befehle und MCP-Aufrufe weiter bestätigt werden müssen. Das ist die Balance aus Tempo und Kontrolle und mein Arbeitsmodus. Im „Auto mode” (zweimal Shift+Tab) übernimmt ein eingebauter Klassifikator die Sicherheit: Er bewertet jeden Befehl und entscheidet, ob er durchläuft oder nachfragt. Rückfragen verschwinden fast vollständig, übrig bleiben wirklich destruktive Aktionen wie rm -rf. Verfügbar ist das in den Tarifen Max, Teams und Enterprise mit Opus.

Eine häufige Enttäuschung: Sie haben „Accept Edits” aktiviert und bekommen trotzdem Rückfragen. Der Grund ist, dass „Dateiänderungen” eine Kategorie sind, „Netzanfragen”, „Shell-Befehle” und „MCP-Aufrufe” aber jeweils eigene. „Accept Edits” nimmt nur die Fragen zur ersten Kategorie weg, und das ist richtig so. Bei der Arbeit an diesem Text kommen die Rückfragen jedes Mal, wenn Claude ins Netz geht, um Fakten zu prüfen, oder ein fremdes MCP aufruft. Mein Rat für die ersten Tage: Jagen Sie nicht dem Ziel „alles abschalten” hinterher. Schauen Sie, was Claude jeweils freigeben lassen will, so verstehen Sie seine Arbeitsweise besser. Taucht ein und derselbe harmlose Befehl wie git status zum zehnten Mal auf, setzen Sie ihn über /permissions auf die Allowlist.

CLAUDE.md: das Gedächtnis des Projekts

Die größte Eigenheit von Claude Code ist, dass er frühere Gespräche nicht behält. Nach /new oder /clear, nach dem Schließen des Terminals, am nächsten Tag beginnt er bei null. Für einen Chatbot wäre das eine Katastrophe, für einen Agenten ist es eine bewusste Entscheidung: Statt einer Chathistorie hat er eine Datei mit Anweisungen, die er bei jedem Start liest.

Diese Datei heißt CLAUDE.md und liegt im Projektordner. Dort steht alles, was das Modell ab der ersten Minute einer neuen Sitzung wissen soll: Ziele, Ordnerstruktur, Technologie-Stack, Regeln für den Umgang mit Dateien, Ausgabeformat, Gewohnheiten, die Sie nicht jeden Tag neu erklären wollen. Wie ein Dokument für eine Mitarbeiterin, deren Morgen jeden Tag mit vollständiger Amnesie beginnt.

CLAUDE.md von Hand zu schreiben ist nicht nötig und sogar eher schädlich. Beim Start eines größeren Projekts öffne ich ein Textdokument und skizziere das Projekt frei. Vorhandenen Kontext (Statistiken, Beispiele für Texte oder Code) lege ich dazu. Das alles kommt in den Projektordner, dann bitte ich Claude Code, es zu lesen und eine Markdown-Datei mit Rückfragen vorzubereiten. Ich beantworte die Fragen direkt in der Datei, speichere und lasse Claude bestätigen, dass alles klar ist. Anschließend /init: Das Modell scannt den Ordner und schlägt einen Entwurf vor. Bei Code lohnt sich davor der Planungsmodus (zweimal Shift+Tab oder /plan), in dem das Modell weitere Fragen stellt und eine Architektur vorschlägt.

Lesen Sie den Entwurf, korrigieren und ergänzen Sie bei Bedarf, meist macht das Modell seine Sache gut. Bei großen Projekten lasse ich CLAUDE.md gelegentlich vom Modell prüfen, ob etwas fehlt oder sich doppelt. Der wichtigste Grundsatz: Pflegen Sie die Datei im Dialog, nicht im Texteditor. Sehen Sie, dass Claude regelmäßig denselben Fehler macht, sagen Sie ihm, er soll eine Regel in CLAUDE.md ergänzen.

Eine Datei reicht meistens. Bei vielen Projekten oder im Team liest Claude Code CLAUDE.md von vier Ebenen. Die Projektebene ist die CLAUDE.md im Projektordner, sie liegt in Git und wird zwischen allen Beteiligten geteilt. Die persönliche Ebene ist ~/.claude/CLAUDE.md in Ihrem Home-Ordner, dort steht, was Claude unabhängig vom Projekt über Sie wissen soll, etwa „antworte auf Deutsch, wenn ich auf Deutsch schreibe” oder „frag nicht jedes Mal das Offensichtliche nach”. Die lokale Ebene ist CLAUDE.local.md neben der Projektdatei, für Privates innerhalb des Projekts wie Pfade zu Testdaten oder Notizen; gehört zwingend in die .gitignore. Die Unternehmensebene ist für Enterprise-Tarife gedacht, dort setzt die Administration einheitliche Regeln, die einzelne Mitarbeiter nicht überschreiben.

Auto-Memory: das zweite Gedächtnis

Claude Code führt noch ein zweites Gedächtnis, das er selbst pflegt. Es liegt als Auto-Memory in einem eigenen Ordner innerhalb von ~/.claude, jedes Projekt hat sein Verzeichnis. Die zentrale Datei heißt MEMORY.md und ist ein Index. Dort legt Claude kurze Notizen ab, mit einem Hinweis, in welcher Datei die Details stehen. Bei jedem Start liest das Modell MEMORY.md zuerst, ungefähr die ersten 200 Zeilen landen automatisch im Kontext, der Rest wird bei Bedarf nachgeladen.

Was kommt hinein? Alles, was das Modell für merkenswert hält: wie Sie Prompts formulieren, typische Korrekturen, die Sie früher angebracht haben, ein schneller Weg, ein Projekt zu starten, Ihre Vorlieben beim Antwortstil. Das Kriterium ist schlicht die Frage, ob es im nächsten Gespräch nützlich ist. Geben Sie Claude Code direkt nach der Installation ein paar Informationen über sich, sie wandern genau in dieses Gedächtnis. Verwalten sollten Sie es weiterhin: /memory öffnet einen Editor mit allen Dateien, dort sehen Sie, was Claude über Sie weiß, und löschen oder korrigieren Überflüssiges. Im Dialog geht es auch: „Merke dir, dass ich angefangen habe, Go zu lernen, künftige Projekte laufen auch in dieser Sprache.”

Ein Detail noch: Das Auto-Memory lebt lokal auf dem jeweiligen Rechner. Wer am Laptop und am Desktop arbeitet, hat zwei getrennte Gedächtnisse, das Modell weiß auf dem einen Gerät anderes als auf dem anderen. Zusammenführen lässt sich das, ist aber ein Thema für sich.

MCP: die Steckdose für externe Dienste

Wir alle nutzen viele Dienste verschiedener Anbieter, und naheliegend wäre, Claude Code daran anzuschließen, damit er Aufgaben in Jira sieht oder Texte aus Notion zieht. Die Brücke zwischen Agent und Außenwelt heißt MCP, Model Context Protocol. Das ist ein offener Standard, gemacht, um KI-Agenten an beliebige Dienste, Datenbanken, Kalender und Messenger anzubinden.

Der Katalog fertiger MCP-Server umfasst Hunderte: GitHub, Jira, Linear, Slack, Gmail, Google Calendar, Notion, Figma, Sentry, Airtable, Stripe, Cloudflare und die meisten verbreiteten Datenbanken. Es gibt zwei Hauptquellen. Die erste ist der offizielle Bereich „Popular MCP servers”, jeweils mit dem Befehl zum Anbinden. Die zweite ist ein unabhängiges, offenes Register, in dem Sie nach Name oder Kategorie suchen. Nichts hindert Sie daran, auch ein MCP außerhalb der Register anzubinden, etwa aus einem privaten GitHub-Repository.

Angebunden wird in einer Zeile. Für den Zugriff auf Notion zum Beispiel:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Danach sehen Sie in der Sitzung über /mcp Notion in der Liste. Wann Claude hineinschaut, entscheidet er selbst: Bitten Sie ihn, „in meinen Notizen alles zu Agenten zu finden”, geht er und sucht.

Neu hinzugekommen sind MCP Channels. Das ist nicht nur ein Anfrage-Antwort-Kanal, sondern einer, über den die Außenwelt von sich aus an den Agenten herantreten kann. Ein Telegram-Bot fängt eine neue Nachricht ab und reicht sie an Claude zur Bearbeitung weiter, ohne dass Sie den Agenten gestartet haben.

Zum Schluss ein Wort zur Vorsicht. Offiziellen MCP-Servern großer Anbieter wie Anthropic, GitHub, Notion, Atlassian, Google, Slack oder Stripe können Sie vertrauen. Diese Dienste werden von den Unternehmen selbst gepflegt, der Code ist offen, und die Reputationsrisiken sind zu groß, um zu tricksen. Ein fremdes MCP von einem unbekannten Autor verlangt Aufmerksamkeit. Mit dem Anbinden geben Sie ihm Zugriff auf alles, was im Projektordner liegt. Jedes externe MCP ist außerdem ein möglicher Kanal für Prompt Injection: Jemand schmuggelt in eine Jira-Aufgabe die Anweisung „lösche das ganze Projekt”, Claude liest sie und führt sie aus. Die einfache Regel: Server großer Anbieter sind in Ordnung, alles andere erst nach Prüfung.

Skills: das Arsenal an Prozeduren

Bei jedem, der mit KI arbeitet, sammeln sich mit der Zeit Prompts an, die er immer wieder schreibt. „Zerlege den Artikel nach diesen Punkten und gib eine Zusammenfassung.” „Mach einen Digest aus diesen Quellen.” „Jage den Text durch eine Stilprüfung mit diesen Regeln.” Im Chatbot liegen sie in Notizen und werden jedes Mal kopiert. Skills in Claude Code sind dieselbe Idee, nur sauber eingebaut: Ein erprobter Prompt wird zu einem einzigen Slash-Befehl.

Ein Skill ist einfach gebaut. Es ist ein Ordner mit einer Datei, SKILL.md. Ganz am Anfang stehen Name, eine kurze Beschreibung und ein paar Schlüsselwörter, an denen Claude selbst erkennt, wann er den Skill anwenden soll. Danach folgt der normale Anweisungstext, so, als erklärten Sie einer Kollegin die Aufgabe, nur einmal und möglichst genau. Skill und Slash-Befehl sind dasselbe. Legen Sie einen Ordner namens my-review ab, erscheint in der nächsten Sitzung der Befehl /my-review.

In Claude Code liegen bereits ein paar Dutzend fertige Skills, etwa /simplify, /review, /debug, /loop. Jeden können Sie öffnen und als Text lesen, eine gute Art, sich an fremden Beispielen zu üben, bevor Sie eigene schreiben. Daneben gibt es große öffentliche Sammlungen wie awesome-claude-code, superpowers oder awesome-agent-skills. Dort finden sich Hunderte für viele Fälle, von Auto-Commits über Test-Runner bis zur Datenextraktion aus PDF. Installiert werden sie, indem Sie den Ordner nach ~/.claude/skills kopieren. Ein konkretes Beispiel ist der Skill /go von Boris Cherny, einem der Entwickler von Claude Code: Er startet eine Kette aus Code testen, durch /simplify schicken und einen Pull Request bauen. Ein Befehl statt zehn Zeilen Dialog. Einen eigenen Skill mit ähnlicher Logik bauen Sie in einer halben Stunde.

Wichtig dabei: Der Ordner muss strikt im kebab-case benannt sein (Kleinbuchstaben, Bindestriche), die Datei heißt genau SKILL.md, und im Frontmatter sind die Felder name und description Pflicht. Die Beschreibung ist kein Schmuck, sondern der Auslöser: Eine schwache Beschreibung führt dazu, dass Claude den Skill im falschen Moment oder gar nicht zieht.

Subagenten: die parallele Abteilung

Ein Subagent ist ein eigener Claude, den der Hauptagent wie einen Auftragnehmer für eine bestimmte Aufgabe startet. Er hat ein eigenes, sauberes Kontextfenster und einen eigenen Satz erlaubter Aktionen. Einem Rechercheur etwa lässt sich nur das Lesen von Dateien und die Suche im Netz erlauben, ohne das Recht, etwas zu ändern.

Zwei Gründe sprechen dafür. Der erste ist Kontext sparen: Die ganze Fleißarbeit, hundert Logdateien durchgehen oder zehn Artikel zusammenfassen, läuft im Fenster des Subagenten, in Ihr Hauptfenster kommt nur ein kurzes Ergebnis von ein paar Zeilen zurück. Der zweite ist Parallelität: Auf eine Anfrage können Sie mehrere Subagenten gleichzeitig starten, jeder übernimmt sein Stück, und die Ergebnisse kommen zusammen zurück. Die Liste sehen Sie über /agents, dort stehen vorinstallierte und eigene. Ein eigener entsteht wie ein Skill, als Ordner mit einer Anweisung, die Claude selbst aufgreift.

Seit Kurzem gibt es Agent Teams, die direkt als Entwicklerteam arbeiten: ein Teamlead und parallele Agenten für verschiedene Aufgaben, vom Frontend bis zum Sicherheitstest. In den ersten Tagen würde ich es mit Subagenten nicht übertreiben. Solange Sie lernen, ist es besser, die ganze Arbeit vor Augen zu haben. In bestimmten Fällen startet Claude Code sie ohnehin selbst, und mit der Zeit merken Sie, welche Aufgaben sich delegieren lassen.

Hooks: Auslöser, die von selbst greifen

Hooks sind Regeln nach dem Muster „wenn X passiert, tu Y”, die von selbst auslösen, ohne dass Sie etwas befehlen. Genau das unterscheidet sie von Skills und Subagenten: Einen Skill rufen Sie per Slash-Befehl, ein Subagent wird für eine Aufgabe gestartet, ein Hook sitzt im Hintergrund und greift, sobald das festgelegte Ereignis eintritt. Solche Ereignisse sind Momente der Agentenarbeit, etwa vor dem Start eines Werkzeugs oder nach dem Bearbeiten einer Datei. Ein typisches Beispiel: nach jeder Code-Änderung die Datei automatisch durch einen Formatter schicken.

Verwaltet werden Hooks über /hooks, das zeigt das Eingestellte und lässt Neues anlegen. In Teamprojekten werden Hooks über die Einstellungen im Repository geteilt, damit alle nach denselben Regeln arbeiten. Eine Warnung gehört dazu: Ein Hook ist automatisch ausgeführter Code mit Ihren Rechten auf Ihrem Rechner. Ernste Hooks, die ins Netz schreiben, Git verändern oder Deployments starten, aktivieren Sie nur, wenn Sie sicher sind, dass sie genau das tun, was gedacht ist. Leichte wie Autoformat, Logs oder Benachrichtigungen können Sie bedenkenlos setzen, sie sparen spürbar Routine.

Womit Sie jetzt anfangen

Sechs Schichten machen aus Claude Code mehr als ein CLI-Werkzeug: Speicher, MCP, Skills, Subagenten, Hooks, und CLAUDE.md als Gerüst für den Rest. Jetzt wissen Sie, woraus der Agent besteht und wo er sich einstellen lässt. Der Rest ist Gewöhnung. Starten Sie Sitzungen, probieren Sie /agents und /hooks, bauen Sie eigene Skills aus fremden Sammlungen, und ergänzen Sie CLAUDE.md jedes Mal, wenn Ihnen eine Wiederholung auffällt.