Skript zum Ausführen von Claude Code über Telegram

Einführung

Dies ist ein npx-Skript, das ich für dringende Fälle (nach Feierabend, unterwegs) erstellt habe, damit sich Claude Code über Telegram steuern lässt.

Funktionen

• Ein Chatraum pro Projekt (Pfad) (ein eigener Telegram-Bot ist erforderlich)
• Parallele Ausführung, wiederholte Ausführung (bis zum Erfolg), Priorisierung möglich
• Status von Aufgaben prüfen und Aufgaben abbrechen möglich

Installation und Verwendung

• Mit npx cc-telegram ausführen, den Bot-Token eintragen, der Anleitung folgen, die Telegram-Chat-ID registrieren und einige weitere Einstellungen vornehmen – danach ist alles einsatzbereit.
• Danach erneut mit npx cc-telegram starten und über Telegram mit dem Befehl /new eine neue Anfrage senden.
• In Telegram wird per /-Autovervollständigung eine Liste der verfügbaren Befehle angezeigt. Weitere Details finden sich unter dem Link.

Kurze Entwicklungsgeschichte

Version 1

Die erste Version nutzte einen Relay-Server und ein Agent-Programm, in dem mehrere Pfade auf dem PC angegeben werden konnten, sodass Projekte aus verschiedenen Pfaden über einen einzigen Chatraum verwendet werden konnten.
Als ich versuchte, mehrere Projekte in einem Chatraum zu verwalten, stieg die Komplexität nur unnötig an, daher habe ich die Version nach nur zwei Tagen verworfen.

Version 2

In der zweiten Version wurde der Relay-Server entfernt und das Skript so geändert, dass Telegram-Nachrichten per Polling abgerufen werden.
Damals waren Sub-Agenten in die Funktionen eingebaut; diese Agenten analysierten Anfragen und führten Arbeiten aus, und wenn keine Arbeit anlag, schlugen sie Verbesserungen vor bzw. führten diese automatisch aus.
Nach einem viertägigen Testlauf über die Feiertage zum Jahresende stellte sich heraus, dass dabei massenhaft unbrauchbarer Code erzeugt wurde, daher wurde auch diese Version verworfen.

Version 2.5

Dies ist eine Version von Version 2, bei der der Teil zum Vorschlagen von Verbesserungen bzw. zur automatischen Ausführung entfernt wurde. Irgendwie funktioniert sie zwar, aber

Aktuelle Version

Vor einiger Zeit bin ich auf das ralph-loop-Plugin gestoßen, habe es für einzelne Projekte ausprobiert und bin zu dem Schluss gekommen, dass ein Ansatz mit wiederholter Ausführung und projektbezogenen Claude-Einstellungen am besten ist.

Das Problem von Version 2 war, dass es für jedes einzelne Projekt passende Einstellungen für Sub-Agenten gibt, dies aber nicht berücksichtigt wurde und stattdessen integrierte Sub-Agenten bereitgestellt wurden, was meiner Einschätzung nach eher zu Leistungseinbußen führte.

Ich habe fast alle bisherigen Arbeiten verworfen (nur der Teil zum Ausführen von Claude Code je nach OS und der Code für die Telegram-Anbindung wurden wiederverwendet), praktisch von Grund auf neu entworfen, und daraus ist die aktuelle Version entstanden.
Persönlich denke ich, dass damit jetzt erstmals eine wirklich brauchbare Version herausgekommen ist.

Ich würde mich freuen, wenn ihr es ausprobiert und mir eure Eindrücke oder euer Feedback gebt.