Zum Inhalt springen

Serie

Claude Code in deiner eigenen Web-App

Bau eine Web-App, die Claude Code in tmux laufen lässt, ihm Arbeit gibt und jede Frage, jede Berechtigungsabfrage und jeden Plan in deine Seite holt: auf deinem eigenen Rechner, mit deinem eigenen Abo oder einem lokalen Modell.

Fortgeschritten16 Teile · etwa 8,5 Std.

Sechzehn Teile, vom Tippen in ein Terminal, das niemand ansieht, bis zu einer kleinen Web-App, die du vom Handy aus bedienen kannst. Du baust Sitesmith: Du beschreibst eine Website, Claude Code baut sie in einem Ordner, und die Seite zeigt sie, während sie wächst. Claude Code läuft als das echte Programm, in tmux, mit allen seinen Werkzeugen und deinen eigenen Einstellungen, über dein Claude-Abo. Die Seite startet es, tippt deine Aufträge hinein, liest seinen Bildschirm, wo es sein muss, und hört für alles andere auf seine Hooks: was es tut, wann es fertig ist und was es wissen will. Seine Fragen, Berechtigungsabfragen und Pläne erscheinen als Dialoge in der Seite, und was die Seite nicht beantworten kann, geht zurück ans Terminal, das einen Klick entfernt ist. Spätere Teile bringen mehrere Websites gleichzeitig, Benachrichtigungen, Dateien und Bilder für Claude Code, ein lokales Modell über Ollama und einen Login fürs Handy. Jeder Teil endet mit funktionierendem Code, und das fertige Projekt gibt es zum Herunterladen.

Mit Teil 1 beginnen

Questreihe

  1. Claude Code in einem Terminal, auf das niemand schautLern Sitesmith kennen, die Web-App, die diese Serie um das echte Claude Code baut, und probier ihr Fundament von Hand aus: Claude Code in einer tmux-Sitzung im Hintergrund, Tasten, die du hineintippst, und den Bildschirm, den du zurückliest.25 Min.
  2. Ein Server und eine SeiteRichte das Projekt Sitesmith ein: einen kleinen Node-Server, der TypeScript direkt ausführt, jede Site in einem Ordner verwaltet und Änderungen an die Seite schickt, einen Vorschau-Server auf einem eigenen Port und eine schlichte TypeScript-Seite, gebaut mit Vite.50 Min.
  3. Eine tmux-Sitzung für jede SiteGib jeder Site eine eigene Sitzung von Claude Code: einen tmux-Server, der fürs Steuern eingerichtet ist, Sitzungen, die über deine Login-Shell im Ordner der Site starten, und einen Kopf, der zeigt, ob Claude Code läuft, arbeitet oder beendet ist.35 Min.
  4. Das Terminal in der SeiteHol die tmux-Sitzung jeder Site in die Seite: node-pty hängt sich auf dem Server an, ein WebSocket trägt die Bytes, und xterm.js zeichnet sie in einem Tab Terminal neben der Vorschau.35 Min.
  5. Einen Auftrag eintippenLass die Seite Aufträge schicken: Der Text kommt in eine Datei im Ordner der Site, und Sitesmith tippt eine kurze Zeile in Claude Code, aber erst, wenn der Bildschirm ein leeres Eingabefeld zeigt.40 Min.
  6. Hooks melden sich zurückGib jeder Sitzung eine Einstellungsdatei mit Hooks: Ein kleines Skript schickt jedes Ereignis an den Server, der die Werkzeuge verfolgt, die Claude Code benutzt, aus seinem Transkript liest, was es sagt, und das genaue Ende jeder Runde erfährt.40 Min.
  7. Das Ende einer RundeZeig, was Claude Code sagt, wenn es fertig ist, aus Markdown gerendert, ohne dass der Text des Modells eigenes HTML mitbringen kann, antworte ihm aus der Seite und erkenne genau, wann eine Runde vorbei ist, auch wenn sie ohne Stop-Hook endet.25 Min.
  8. Die Fragen von Claude Code in der SeiteDas Herz von Sitesmith: Ein PreToolUse-Hook hält Claude Code an, wenn es eine Frage stellt, der Server gibt die Frage an die Seite, und deine Antwort geht als Ausgabe des Hooks zurück, sodass Claude Code weitermacht, als hättest du im Terminal geantwortet.40 Min.
  9. Berechtigungsabfragen in der SeiteHalte die Berechtigungsabfragen von Claude Code mit einem PermissionRequest-Hook an und beantworte sie in der Seite: einmal erlauben, ab jetzt erlauben oder ablehnen. Und versteh, warum das Terminal gleichzeitig seinen eigenen Dialog zeigt.25 Min.
  10. Wenn die Seite nicht antworten kannKeine Seite offen, der Tab zu, der Server startet neu, ein unbekannter Dialog: alle Wege, auf denen eine Frage die Seite verfehlt, und wie jeder in der Seite oder im Terminal endet, nie im Warten auf niemanden. Dazu der Vertrauensdialog, vom Bildschirm gelesen und mit Tasten beantwortet.35 Min.
  11. Einen Plan freigebenEin Kästchen „Plan first“ für den Auftrag: Claude Code arbeitet im Plan-Modus, der Server schaltet den Modus mit Shift+Tab um und liest ihn aus der Statuszeile ab, und der Plan erscheint in der Seite, zum Freigeben oder zum Zurückschicken mit einer Notiz.25 Min.
  12. Mehrere Sites gleichzeitigLass mehrere Sites nebeneinander arbeiten: Der Server führt von Anfang an alles pro Site, also geht es in diesem Teil um die Seite. Die Seitenleiste zeigt, was das Claude Code jeder Site gerade tut, und der Titel des Tabs zählt die Sites, die auf dich warten.15 Min.
  13. Sag mir Bescheid, wenn es mich brauchtEin Schalter in der Seitenleiste schaltet Browser-Benachrichtigungen und einen kurzen Klang ein: für eine Frage in einer Site, die du gerade nicht ansiehst, und für das Ende eines Laufs, während der Tab im Hintergrund liegt. Ein Klick auf die Benachrichtigung öffnet die Site.20 Min.
  14. Dateien und Bilder für Claude CodeGib Claude Code mit einem Auftrag ein Logo, Fotos oder ein PDF: mit einem Knopf ausgewählt oder irgendwo auf die Seite gezogen, mit sauberem Namen und Größenlimit in den Ordner assets/ der Site gestreamt und im Auftrag genannt, damit Claude Code sie zuerst ansieht.25 Min.
  15. Ein lokales Modell als GehirnLass das Claude Code einer Site mit einem Modell auf deinem Rechner denken: Ollama spricht die API von Anthropic, ein paar Umgebungsvariablen lenken die Sitzung dorthin, der Rest von Sitesmith bleibt. Mit einem ehrlichen Blick darauf, was ein kleines Modell auf einer CPU kann.35 Min.
  16. Sitesmith auf deinem HandyÖffne Sitesmith in deinem Heimnetz vom Handy aus: Der Server lauscht im LAN, druckt einen Login-Link mit QR-Code und hält alle anderen mit einem Token, einem Cookie und den Prüfungen von Host und Origin draußen. Danach ein Blick zurück auf die ganze Serie.35 Min.