Richte deinen eigenen Agenten-Arbeitsbereich ein

Vor einer Weile habe ich darüber geschrieben, wie mein Agenten-System wirklich funktioniert. Jener Beitrag ist das Warum. Dieser ist das Wie, plus eine Datei, die du heute herunterladen und nutzen kannst.

Woran die Leute hängen bleiben, ist nicht die Idee. Es ist das leere Blatt. Du öffnest den Agenten in einem leeren Ordner und weißt nicht, was du ihm vorlegen sollst. Hier ist also der kleinste nützliche Ausgangspunkt, fertig verpackt.

Lade das Kit herunter

Starter-Kit herunterladen (zip)

Im Zip:

CLAUDE.md ist die Datei, die du tatsächlich benutzt. Sie ist die Hülle: eine zweiseitige Beschreibung deines Projekts und wie der Agent darin arbeiten soll. Das ist der Teil, auf den es ankommt.
README.md ist die Installationsanleitung und eine Seite mit hart erarbeiteten Notizen.
.claude/ zeigt die Struktur, die um die Hülle herum wächst: wo Befehle leben, eine Beispiel-Befehlsvorlage und ein echter Sicherheits-Hook, der den Agenten daran hindert, deine Geheimnisse zu bearbeiten.
.mcp.json.example zeigt die Form einer Verbindung zu einem externen Werkzeug, ohne Schlüssel darin.

Das Kit ist absichtlich generisch. Es ist nicht mein System. Mein System sind sechs Monate Korrekturen, gestapelt auf einer Datei wie dieser. Es geht darum, dir den Samen zu geben, nicht den Baum.

Installiere es (etwa zehn Minuten)

Hol dir ein IDE mit Agent. Ich nutze VS Code mit Claude Code. Installiere Claude Code, melde dich an. Jeder Editor mit Agenten-Integration funktioniert gleich.
Öffne einen Ordner. Ein echtes Projekt oder einen leeren für etwas Neues.
Leg CLAUDE.md ins Wurzelverzeichnis. Kopiere den .claude/-Ordner dazu, wenn du die Beispiele griffbereit haben willst.
Bearbeite CLAUDE.md, damit sie dein tatsächliches Projekt beschreibt: was es ist, der Stack, das Layout, die Regeln, die dir wichtig sind. Zwei Seiten, nicht zehn.
Richte den Agenten darauf aus. Öffne den Ordner in Claude Code und sag: “Lies CLAUDE.md und schlag ein Gerüst vor. Frag mich, was du brauchst, bevor du baust.”
Kritisiere, was er tut, für die nächste halbe Stunde. Jede Korrektur, die du gibst, wird zu einer neuen Zeile in CLAUDE.md. Das ist der ganze Kreislauf, und der einzige Schritt, der sich summiert.

Wenn der Agent über das Repository hinausgreifen soll (eine Datenbank, ein Automationswerkzeug, ein Analyse-Produkt), dafür ist MCP da. Kopiere .mcp.json.example zu .mcp.json, trag die echten Werte ein, mach niemals einen Commit davon, und starte das IDE komplett neu, damit die Verbindung lädt. Dann führe einen kleinen Test aus, bevor du etwas Echtes darauf baust.

Was am ersten Tag schiefgeht (das ist normal)

Ich habe jetzt jemandem zugesehen, der das von null aufgesetzt hat, und dieselben Kleinigkeiten haben sie stolpern lassen, die jeden stolpern lassen. Keine davon bedeutet, dass du etwas falsch gemacht hast. Zu wissen, dass sie kommen, ist die halbe Miete.

Die Verbindung ist nicht aktiv, bevor du sie verdrahtest. Der Agent erreicht dein externes Werkzeug nicht, nur weil du es erwähnt hast. Du musst den API-Schlüssel auf dem Dienst erstellen, ihn in .mcp.json einfügen, und erst dann kann der Agent damit reden. Bis dahin scheitert jeder Versuch, und dieses Scheitern ist erwartet, kein Fehler.
Du musst das IDE komplett neu starten. Nicht nur das Agenten-Fenster, das ganze Fenster. Befehle und neue Verbindungen laden beim Start. Die Hälfte der “es geht nicht”-Momente löst sich, indem du alles schließt und wieder öffnest.
Du wirst auf Berechtigungsabfragen stoßen. Der Agent fragt, bevor er Dateien bearbeitet oder Befehle ausführt, was richtig ist. Sobald du einem Projekt vertraust, gibt es eine Einstellung, die das lockert, damit du nicht den ganzen Tag “Ja” klickst. Finde sie früh, sie verändert, wie sich die Arbeit anfühlt.
Er gibt dir Hausaufgaben, die er selbst erledigen könnte. Der Agent sagt dir, du sollst einen Schritt tun, für den er selbst den Zugriff hat. Die nützlichste Angewohnheit ist, dagegenzuhalten: “Kannst du den Teil selbst machen?” Die ehrliche Antwort ist meistens ja. Die Automationsgrenze steigt jedes Mal, wenn du fragst.

Die Haltung, die das alles erträglich macht: Es ist ein Marathon, kein Sprint. Du bist am Anfang langsam, weil jede Kleinigkeit bricht und du lernen musst, was jeder Bruch bedeutet. Dann bist du schnell, weil du die Brüche schon gesehen hast und genau weißt, wo du nachschauen musst. Die Reibung am Anfang ist nicht das Hindernis. Sie ist der Lehrplan.

Du musst den Code nicht lesen

Die Angst, die die meisten aufhält, ist, dass sie nicht technisch genug seien. Leg sie ab.

Du musst nicht verstehen, wie das Modell innen funktioniert. Du musst lesen, was es produziert hat, und beurteilen, ob es richtig ist, die nächste Frage stellen und es in eine Richtung weisen. Du bist der Fakten-Checker, der Sanity-Checker, der den Kontext hält. Das ist ein echter Job, und es ist kein Programmier-Job.

Es ist keine Blackbox. Sie braucht nur eine Taschenlampe und jemanden, der dir zeigt, wo der Schalter ist. Nach einer Woche wirst du überrascht sein, wie viel von dem Dunkel einfach nur unbeleuchtet war.

Warum die leere Version nicht funktioniert

Du kannst den Agenten in einem leeren Ordner öffnen und ihn bauen lassen. Er tut es. Das Ergebnis sieht vernünftig aus und ist auf subtile Weise falsch, weil das Modell keine Ahnung hat, wie deine Arbeit aussieht. Es ist ein Auftragnehmer ohne Briefing.

Die Hülle ist das Briefing. Wenn mein Agent in etwas gut ist, ist das Modell nicht klüger geworden. Die CLAUDE.md wurde von zwanzig Sitzungen voller Fehler geformt. Das ist der Unterschied zwischen einem rohen Agenten und einem System: der rohe rät jedes Mal, das System erinnert sich, was du schon entschieden hast.

Ein paar Notizen aus dem täglichen Tun

Lade den Kontext auf einmal, nicht tröpfchenweise. Gib dem Agenten das ganze Bild auf einmal. Die Qualität der Ausgabe folgt der Qualität der Eingabe, und ein langes Briefing schlägt zehn winzige Prompts.
Sprich mit ihm, tipp nicht nur. Spracheingabe ist schneller und trägt mehr, und reichere Eingabe ergibt bessere Ausgabe. Ein Diktierwerkzeug plus der Agent ist ein echter Sprung gegenüber dem Tippen.
Gib ihm positives Feedback. Wenn er etwas trifft, sag es. Es klingt seltsam, aber genauso, wie du einen Menschen lenken würdest, macht es den nächsten Durchlauf besser, dem Agenten zu sagen “das war richtig, mach weiter so”.
Dräng ihn, mehr selbst zu tun. Agenten reichen dir Arbeit, die sie selbst erledigen könnten. Frag öfter “Kannst du den Teil selbst machen?”, als es sich natürlich anfühlt. Die Automationsgrenze steigt jedes Mal.
Du bist der Sanity-Checker. Du musst nicht wissen, wie das Modell innen funktioniert. Du musst lesen, was es produziert hat, und es beurteilen. Wenn du nicht lesen kannst, was es geschrieben hat, besitzt du nicht, was es gebaut hat.
Mach einen Checkpoint, bevor der Kontext voll ist. Das Fenster sich selbst komprimieren zu lassen, verwirft still und leise Detail. Eine kurze Zusammenfassung plus ein Reibungs-Protokoll hält den Faden.
Dann repariere das Design, nicht nur den Bug. Frag alle paar Checkpoints, ob dieselbe Art von Fehler wiederkehrt, weil das Design falsch ist. Das zu beheben, beendet den Kreislauf.
Synchronisiere ständig mit Git. Die Hülle ist das Kapital. Den Ordner zu verlieren heißt, Monate zu verlieren.

Die ehrliche Version von “mit KI schneller liefern” ist diese: Du gibst die gesparte Zeit dafür aus, das System zu bauen, das dir erlaubt, der Geschwindigkeit zu vertrauen. Fairer Tausch. Kein kostenloser.

Das Kit ist die erste Stunde dieses Tauschs, für dich erledigt. Der Rest gehört dir.