claude-code-screenshots/README.md

Screenshot-Server

Ein minimaler Upload-Server für Screenshots und Bilder, geschrieben in vanilla Node.js – ohne externe Abhängigkeiten.

Motivation

Das Claude Code Terminal unterstützt keine direkte Bildübertragung — Screenshots oder Bilder lassen sich nicht per Copy-Paste oder Dateianhang in das Chat-Interface einfügen.

Dieser Server ist der Workaround: Bilder werden über die Web-Oberfläche hochgeladen und landen direkt im screens/-Verzeichnis des Projekts. Claude Code kann sie von dort lesen und analysieren.

Typischer Ablauf:

1. Server starten: ! server.sh start
2. Web-Oberfläche öffnen: http://<IP>:8765
3. Screenshot hochladen (Drag & Drop)
4. Claude Code liest das Bild aus screens/ — fertig

Funktionsweise

Der Server stellt eine Web-Oberfläche bereit, über die Bilder per Drag & Drop oder Dateiauswahl hochgeladen werden können. Die Dateien werden direkt in das Verzeichnis gespeichert, in dem server.mjs liegt.

• Port: 8765
• Erreichbar unter: http://<IP>:8765
• Unterstützte Dateitypen: Bilder (image/*)
• Dateinamen: Sonderzeichen werden bereinigt; Umlaute (äöüÄÖÜß) sind erlaubt

Screenshot

Voraussetzungen

• Node.js (ES-Module-Unterstützung, d.h. Node 14+)
• Kein npm install notwendig

Starten

Direkt

node server.mjs

Als Hintergrunddienst (über server.sh)

server.sh start    # Starten
server.sh stop     # Stoppen
server.sh restart  # Neustart
server.sh status   # Status anzeigen

Logs werden nach /tmp/server_mjs.log geschrieben.

Tipp für Claude Code: Im Claude Code Terminal kann der Server direkt mit ! server.sh start gestartet werden — das !-Präfix führt den Befehl im aktuellen Session-Kontext aus.

Hinweis: In server.sh ist der Pfad zur server.mjs hardcodiert. Bei abweichendem Speicherort muss APP_CMD in Zeile 3 angepasst werden.