Aufbau eines persönlichen KI-Agenten mit Claude Code: Erkenntnisse aus 6 Monaten Wiz

Ein Entwickler hat seine sechsmonatige Reise beim Aufbau von Wiz geteilt, eines persönlichen KI-Agenten, der Claude Code sowohl als Entwicklungsumgebung als auch als Laufzeitumgebung nutzt. Das Projekt begann mit einer ambitionierten "Jarvis aus Iron Man"-Vision, entwickelte sich aber zu einem praktischen System für den täglichen Gebrauch.

Was Wiz tatsächlich macht

Wiz ist ein persönlicher KI-Agent, der auf Claude Code aufbaut und autonom für Routineaufgaben läuft. Das System übernimmt Morgenberichte, Abendzusammenfassungen, E-Mail-Vorauswahl und verschiedene Experimente. Für kreative oder qualitätssensitive Arbeiten bleibt der Entwickler in der Schleife.

Technische Umsetzung

Die Architektur ist bewusst einfach gehalten:

• Claude Code dient als Rahmenwerk/Framework
• CLAUDE.md enthält die Anweisungsdatei
• Der Speicher lebt in Markdown-Dateien
• Werkzeuge werden als Skripte in Ordnern implementiert

Entwicklungsprozess mit Claude Code

Der Entwickler nutzte Claude Code intensiv während des gesamten Projekts:

• Der /init-Befehl generierte die erste CLAUDE.md-Datei in einem Durchgang
• Bei Bedarf an Fehlerbehebung wurden Fehler zurück in Claude Code eingefügt zur Diagnose
• Claude Code schrieb den größten Teil des Codes, wobei der Entwickler jede Datei überprüfte und Probleme korrigierte

Wichtige Fehler und Lehren

Der Entwickler identifizierte 9 spezifische Fehler, die Probleme verursachten:

• Claude die erste CLAUDE.md ohne sorgfältige Überprüfung generieren lassen - führte zu stundenlanger Fehlerbehebung aufgrund eines einzigen schlechten Satzes
• Selbstverbesserung zulassen, um Kernanweisungen ohne Sicherheitsvorkehrungen umzuschreiben - verursachte, dass das System in mehrere Richtungen abdriftete
• Opus bei jeder kleinen Abfrage laufen lassen, bis Nutzungslimits vor dem Mittagessen erreicht wurden - behoben durch Implementierung von Modell-Routing (klein/lokal für einfache Aufgaben, Sonnet für allgemeine Arbeit, Opus für komplexe Aufrufe)
• Versuchen, "Jarvis" am ersten Tag zu bauen statt schrittweise - kostete etwa drei Monate Entwicklungszeit
• Einen LLM-Aufruf in jeden Schritt jeder Pipeline setzen, wo die meisten einfache Skripte hätten sein sollen

Praktischer Startpunkt

Der Entwickler empfiehlt, mit einem kleinen, funktionalen Agenten zu beginnen statt mit einem ambitionierten System. Er schlägt vor, etwas zu bauen, das über Nacht eingegangene E-Mails liest und eine einabsatzige Morgenzusammenfassung schreibt, als erstes Projekt.

Der vollständige Beitrag enthält eine Schritt-für-Schritt-Anleitung zum Aufbau eines ersten Agenten und beschreibt alle 9 Fehler im Detail. Der Entwickler merkt an, dass Wiz ein persönliches Projekt bleibt und nicht öffentlich veröffentlicht wird.