Meine Methode für externe Integrationen: Claude Code web, ohne IDE oder lokale Entwicklung

Hallo zusammen,

Nach dem Hinweis von @pierre-gilles haben viele noch nicht gesehen, wie sehr Claude die Entwicklung vereinfacht. Hier ist, wie ich meine externen Integrationen durchführe und eure Fehler behebe, oft noch am selben Tag :wrench:

Ein kleines Detail, das wichtig ist: Grundsätzlich bin ich kein Entwickler. Wenn ich das schaffe, könnt ihr das auch :wink:


Wofür ich kein Entwickler brauche

Alles, was ein Entwickler normalerweise verwendet, verwende ich nicht:

  • Keine lokale Entwicklung
  • Keine IDE
  • Kein Node oder Docker auf meinem Rechner installieren
  • Keine manuellen Commits

Genau das hat @pierre-gilles gemeint: Viele Entwickler arbeiten noch so, obwohl es nicht mehr nötig ist.

Was ich stattdessen mache

  • Ich beschreibe den Bedarf auf Französisch, mit einfachen Worten
  • Claude Code web erledigt den Rest im GitHub-Repository: den Code, das Pull Request, das Merge und das Release
  • Er bereitet auch die Antwort vor, die ich im Forum posten soll
  • Ich folge den Rückmeldungen und teste, wenn ich das Gerät habe

Das funktioniert auch vom Handy aus, und ich kann mehrere Korrekturen gleichzeitig starten.


Die gemeinsamen Grundlagen meiner 24 Repositories

  • Überprüfung des Manifests bei jedem Pull Request, mit denselben Kontrollen wie im Store
  • Automatisierte Tests auf Node 22 und 24, Lint und Formatierung
  • Bauen des Docker-Images
  • Dependabot für Updates
  • Ein GitHub-Release pro Version, mit einem Changelog
  • Dokumentation auf Französisch und Englisch

Ergebnis: Ein Fehler wird bevor er in den Store gelangt, erkannt.


Wie ich eine Integration starte

Bis zum nächsten SDK gebe ich Claude Code web diese Nachricht in einem leeren GitHub-Repository:

In diesem Repository, im main-Branch, möchte ich, dass du eine externe Integration "Dyson" erstellst.
Gehe vom offiziellen Integrationstemplate aus: https://github.com/GladysAssistant/integration-template-js
Vergiss nicht SECURITY.md, CHANGELOG.md und CLAUDE.md
Vergiss nicht den cloud- und/oder lokalen Tag
Richte dieselben Workflows wie https://github.com/prohand/gladys-devmel ein
Vergiss nicht die Widgets, die Trigger und die Szenenaktionen

Warum jede Zeile:

  • Das offizielle Template: Die erwartete Struktur von Gladys wird von Anfang an eingehalten
  • SECURITY.md: Erklärt, wie man eine Sicherheitslücke meldet
  • CHANGELOG.md: Hält jede Version fest
  • CLAUDE.md: Die Projektregeln für Claude, die bei jeder neuen Sitzung überprüft werden
  • Cloud-/Lokal-Tag: Gibt im Store an, ob die Integration Internet benötigt
  • Die Workflows von gladys-devmel: Tests, Store-Kontrollen, Docker-Image und Releases, alles bereit
  • Widgets, Trigger, Szenen: Sonst beschränkt sich Claude oft auf die Geräte

Es reicht, « Dyson » durch eure Integration zu ersetzen.


Ein Bug, von A bis Z (reales Beispiel mit Dyson)

1. Ihr postet Feedback

@mutmut hat die Dyson-Integration getestet und detailliertes Feedback mit Screenshots gepostet:

2. Ich gebe die Nachricht an Claude Code web

Ich füge den Link zur Forumsnachricht im richtigen Repository ein und bitte ihn, alles zu erledigen: die Korrektur, das Pull Request, das Merge und das Release.

Claude liest das Feedback, sucht die Ursache im Code, korrigiert, fügt Tests hinzu, aktualisiert die Dokumentation und das Changelog.

3. Claude öffnet ein Pull Request

Jedes Feedback im Forum wird zu einem Pull Request. Der Titel sagt, auf welche Nachricht es antwortet.

Im Pull Request erklärt Claude, was korrigiert wurde, was sich geändert hat und was hinzugefügt wurde. Er gibt auch an, was nicht an einem echten Gerät getestet werden konnte.

Man sieht zum Beispiel, dass er herausgefunden hat, warum die PM-Werte von Matter unterschiedlich waren: Die Integration las die falsche Messreihe des Dyson.

4. Die automatischen Kontrollen sind bestanden

Tests, Lint, Store-Kontrollen, Docker-Image: Alles wird im Pull Request und nach dem Merge überprüft.

Diese Kontrollen ermöglichen es mir, Claude allein weitermachen zu lassen.

5. Claude fusioniert und veröffentlicht die Version

Er fusioniert das Pull Request und startet das Release: Das GitHub-Release, sein Changelog und das Docker-Image werden veröffentlicht. Die neue Version erscheint im Store.

6. Claude bereitet die Forumsantwort vor

Ich bitte ihn um eine Antwort für das Forum, und ich muss sie nur noch einfügen. Sie sagt, was korrigiert wurde, warum und was nach dem Update zu tun ist.

Alle meine Antworten zum Thema Dyson wurden so gemacht.


Das Ergebnis bei Dyson

  • 1.0.0 am Abend des 10. Oktobers, 1.4.0 am Abend des 11. Oktobers
  • 5 Pull Requests, eines pro Feedback von @mutmut
  • Auf dem Weg behoben: Fehlender « Aktualisieren »-Button, falsche PM-Werte, ignorierte lokale IP, verzögertes Widget, Namen auf Englisch…
  • Und ich habe keinen Dyson zu Hause :sweat_smile:

Die Grenzen

  • Claude kann sich irren: Deshalb die automatischen Kontrollen… und eure Tests
  • Ohne das Gerät basiere ich auf dem, was er sendet: Euer Feedback ist Gold wert
  • Manche Probleme kommen vom Kern von Gladys. In diesem Fall schlage ich einen Fix für Gladys vor (z. B. PR #3188 für die Farben der Kacheln)

Um loszulegen (Entwickler oder nicht)

  • Erstelle ein leeres GitHub-Repository, öffne Claude Code web und verbinde dein GitHub-Konto
  • Gib ihm die obige Startnachricht mit dem Namen deiner Integration
  • Fang klein an: eine einfache Integration, dann ein Bug, eine Übersetzung, ein Test
  • Richte die automatischen Kontrollen ein bevor du Claude allein fusionieren lässt: Das ist dein Sicherheitsnetz
  • Am Anfang, lies die Pull Requests durch, um zu verstehen, was Claude macht

Wie ihr helfen könnt (Tester)

  • Ein Thema pro Integration im Forum oder ein GitHub-Issue
  • Gebt an: Modell, Version der Integration, lokal oder cloud
  • Fügt Screenshots und Logs hinzu, ohne E-Mail, IP oder Seriennummer

Je genauer euer Feedback ist, desto schneller ist die Korrektur. Danke an alle Tester, und besonders an @mutmut :folded_hands:

Super, danke fürs Teilen !! :smiley:

Das ist sehr gut erklärt! Danke @prohand

Ich bin noch fauler… und bitte Claude um mehr.
In diesem Rahmen verwende ich Claude auf einem Mini-PC, den ich zu Hause habe (denselben, auf dem ich Frigate für meine Kameras habe).

Der Vorteil, ihn auf diesem Mini-PC statt in Cloud-Sessions zu nutzen, ist, dass er auf viel mehr zugreifen kann.
Ich habe ihm daher Zugriff auf mein Forumskonto gegeben, sodass ich:

  • er liest täglich die Nachrichten in den Threads meiner externen Integrationen
  • wenn es neue Nachrichten gibt, analysiert er sie, codiert Korrekturen, wenn nötig, veröffentlicht eine Release und sobald alle Tests grün sind, veröffentlicht er eine Nachricht im Forum, um euch zu informieren.

Auf ähnliche Weise habe ich ihm Zugriff auf mein GitHub-Repo gegeben, damit er selbst das erstellen kann, was er braucht.
Wenn ich also Claude bitte: « Erstelle eine Vigilance-Säure-Regen-Integration », wird er prüfen, ob niemand im Forum angekündigt hat, sich darum zu kümmern, alles holen, was er braucht, die Integration erstellen und ein Thema im Forum schreiben… Ohne mich.

Absolute Faulheit :wink:

@guim31 Du kannst das alles auch in Cloud-Sessions machen!

Das dachte ich auch (oder muss man ihm die Domains erlauben?).
Jedenfalls nutze ich den auf meinem Mini-PC sehr viel, weil er alle meine Geräte zu Hause verwalten kann :wink:

Ja, man muss alle Domains erlauben, das ist sogar für die Entwicklung entscheidend, sonst kann er nicht auf die Dokumentationen usw. zugreifen…

Ich habe es standardmäßig in der Gladys Assistant Anthropic-Organisation eingestellt :slight_smile:

Du kannst das hier überprüfen:

Danke fürs Teilen! Top

@pierre-gilles Mir ist gerade eine „verrückte“ Idee gekommen, die der nächste Schritt sein könnte: das „Lovable“ von Gladys :grinning_face_with_smiling_eyes: (so in der Art, studio.gladysassistant.com). Ein normaler Nutzer findet seine Integration nicht im Store? Er beschreibt seinen Bedarf, das Tool hilft ihm, sie zu erstellen, zu testen und zu veröffentlichen, ohne GitHub-Konto oder Claude.
Mit einem „Plan“-Modus, um ihm zu helfen, seine Idee vor dem Start zu präzisieren.

Wir könnten über einen Claude-Sitzplatz im Startup-Programm nachdenken, falls die Bedingungen es zulassen, natürlich mit Rate Limiting. Die Idee: Die Erstellung von Integrationen direkt aus Gladys heraus für jeden zugänglich machen!

EDIT: oder nur für Gladys Plus-Nutzer

Danke für das Teilen deiner Methode @prohand. Braucht man dafür ein kostenpflichtiges Claude-Konto, oder funktioniert das auch mit einem einfachen kostenlosen Konto? Es wäre wahrscheinlich mit einer Begrenzung der Tokenzahl, was es langsamer macht, aber ich habe es nicht eilig mit der Erweiterungsidee, die ich habe…

Ja, man braucht ein kostenpflichtiges Claude-Konto, um Claude Code nutzen zu können.
Anfangs habe ich das Pro-Abo für 20€ pro Monat genutzt.
Jetzt nutze ich einen Team-Premium-Sitzplatz, dank @pierre-gilles, der einen dank eines Claude-Angebots bekommen hat.

@prohand : Super Erklärung, dass hat mir gefehlt. Ich komme aus einer anderen Welt. Die letzten Jahre saß ich an meinem Tisch und habe an ESP32 Chips gelötet, denen mühsam Matter over Thread beigebracht und diese dann bei mir eingesetzt. ( Was für einen Quatsch man nicht alles macht, wenn die Flöhe jucken :slight_smile:

Also habe ich jetzt mal einen Entschluss gefasst: Das probiere ich aus, denn es kann doch nicht sein, dass wir die Verkehrspläne jeder größeren kanadischen Stadt bekommen, aber nicht mal einen Zug von Frankfurt nach Hamburg hinbekommen :wink:

Sprich: Ich starte einen Versuch etwas für den deutschsprachigen Raum zu kümmern, also in Anlehnung an die kanadischen Verkehrsbetriebe das gleiche für Deutschland, Schweiz und Österreich.

Auch vermisse ich den Deutschen Wetterdienst und das Umweltbundesamt, die liefern kleinteilige ( teilweise bis auf Gemeindeebene ) Informationen zur Luftbelastung und Pollen. Auch hier würde ich dann einsteigen für Deutschland, Schweiz und Österreich.

Aber alles ganz klein am Anfang und ich habe ja festgestellt, dass im Problemfall die gesamte Community hier einem unter die Arme greift.

Bis zu meinem ersten Versuch,

Grüße

Tom

Ja, kein Problem, leg los und falls du Hilfe brauchst, ist immer jemand da, der dir hilft.

Und wenn du Ideen für Integrationen hast, schreib den Namen auf und jemand wird sich darum kümmern. Wir haben zwei Leute, @prohand und @guim31, die zu schnell sind, wir kommen nicht mehr mit.

Hallo Tom,

Falls ich heute eine Integration für den öffentlichen Verkehr in der Schweiz bekomme :zwinkere: Sie ist schon bereit.

Bis bald