Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT l AI Coding Agents

Mit ALBERT l AI Coding Agents arbeiten

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT l AI Coding Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Diese Dokumentation beschreibt zwei Schritte: wie Sie Claude Code mit agorum core pro verbinden und wie Sie anschließend eine Aufgabe aus ALBERTs Chat an einen Coding Agent übergeben.

Der Coding Agent antwortet dabei unter dem Namen ALBERT | AI. Das ist kein Etikett: Wissen, Skills, Rechte und Daten bleiben in agorum core pro, und ALBERT | AI steuert den Ablauf. Der Coding Agent liefert die Oberfläche und das Sprachmodell.

Claude Code einrichten

Über den Menüeintrag Claude Code einrichten verbinden Sie Claude Code auf Ihrem Rechner mit agorum core pro. Ein Zugriffstoken müssen Sie dafür nicht von Hand erzeugen; das übernimmt agorum core pro.

Voraussetzungen

So richten Sie Claude Code ein

  1. Klicken Sie oben rechts in der Kopfleiste auf das Hauptmenü (Symbol mit den drei Strichen) und wählen Sie Claude Code einrichten.

    Ergebnis: Ein Fenster zeigt, welche Varianten dieses System Ihnen anbietet, jeweils mit Version.

  2. Wählen Sie unter Wofür einrichten?, wofür die Verbindung gedacht ist: Mit agorum core arbeiten oder In agorum core entwickeln.

    Die Auswahl erscheint nur, wenn das System beide Varianten anbietet und Sie für beide berechtigt sind. Sonst gilt die eine Variante, für die Sie berechtigt sind.

  3. Klicken Sie auf Datei herunterladen.

    Unter Windows erhalten Sie die Datei Claude Code mit <Rechnername> verbinden.cmd, unter macOS und Linux eine gleichnamige Datei mit der Endung .sh. Bei der Variante zum Entwickeln heißt sie Claude Code mit <Rechnername> DEV verbinden. Welche Datei Sie bekommen, erkennt die Oberfläche selbst.

  4. Führen Sie die Datei aus: unter Windows per Doppelklick, unter macOS und Linux im Terminal mit bash und dem Dateinamen.

    Ergebnis: Die Einrichtung arbeitet fünf Schritte ab und meldet jeden einzeln: Claude Code prüfen (und bei Bedarf installieren), Zugriffstoken abholen, Token hinterlegen, Arbeitsordner und Plugin einrichten, fertig.

  5. Starten Sie Claude Code neu, wie es die Einrichtung am Ende beschreibt. Unter Linux melden Sie sich stattdessen einmal ab und wieder an.

    Ein bereits laufendes Claude Code kennt das neue Zugriffstoken noch nicht und würde sich nicht mit agorum core pro verbinden.

  6. Starten Sie in Claude Code einen neuen Chat und wählen Sie als Ordner den Arbeitsordner, den die Einrichtung genannt hat. Wer Claude Code im Terminal verwendet, ruft in diesem Ordner claude auf.
Claude Code einrichten

Achtung: Die heruntergeladene Datei ist nur zehn Minuten gültig. Führen Sie sie danach aus, bricht die Einrichtung ab; laden Sie dann eine neue Datei herunter. Die Datei enthält ein persönliches Einrichtungstoken, mit dem sich in dieser Zeit ein Zugriffstoken für Ihren Benutzer abholen lässt – geben Sie sie nicht weiter. Die Datei löscht sich nach dem Ausführen selbst, unter Windows nur, wenn die Einrichtung erfolgreich war.

Was die Einrichtung anlegt

Was Wo
Arbeitsordner In Ihrem Dokumentenordner unter Claude Code im Unterordner <Rechnername>, bei der Variante zum Entwickeln <Rechnername> DEV. Das Plugin ist nur in diesem Ordner eingetragen; in anderen Ordnern ist das System in Claude Code nicht verbunden.
Zugriffstoken In einer Umgebungsvariablen, deren Name sich aus dem Rechnernamen ergibt: in Großbuchstaben, jedes andere Zeichen als Buchstabe oder Ziffer wird zu _, dahinter _TOKEN bzw. bei der Variante zum Entwickeln _DEV_TOKEN. Für agorum.example.com heißt sie AGORUM_EXAMPLE_COM_TOKEN. Wird das System über eine IP-Adresse aufgerufen, steht IP_ davor, zum Beispiel IP_10_0_1_25_TOKEN. Unter Windows als Benutzervariable, unter macOS und Linux in der Startdatei der Shell und zusätzlich so, dass auch eine vom Desktop gestartete Anwendung sie sieht. Das Token selbst steht in keiner Konfigurationsdatei von Claude Code.
Plugin in Claude Code Das Plugin agorum core bzw. agorum core Entwicklung aus dem Marketplace dieses Systems. Es enthält die Skills und die MCP-Verbindung zu diesem System.
Berechtigungen Fehlen Ihnen Mitgliedschaften in den Werkzeuggruppen, die Claude Code braucht, ergänzt die Einrichtung sie und nennt sie in der Ausgabe.

Tipp: Neue Skill-Stände erhalten Sie über das Marketplace dieses Systems, ohne dass jemand ein Archiv weitergeben muss. Auf Systemen ohne gültiges Zertifikat geht das nicht; dort weist die Einrichtung gelb hervorgehoben darauf hin. Führen Sie die Einrichtung dann einfach erneut aus, um den neuen Stand zu erhalten. Auch sonst ist ein erneuter Lauf jederzeit möglich und bringt Token, Plugin und Skills auf den aktuellen Stand.

Eine Aufgabe an einen Coding Agent übergeben

Sie stellen Ihre Aufgabe wie gewohnt in ALBERTs Chat und übergeben den Chat an einen Coding Agent. Dieser übernimmt Aufgabe, Kontext und Systemprompt des Chats, arbeitet in seiner eigenen Umgebung weiter und meldet Fortschritt und Ergebnis in den Chat zurück.

Voraussetzungen

Hinweis: Dürfen Sie keinen Coding Agent starten, erscheint der Knopf für die Übergabe in der Chat-Eingabe nicht, und ALBERT | AI fragt auch nicht nach dem Ziel.

So übergeben Sie eine Aufgabe

  1. Öffnen Sie ALBERTs Chat und formulieren Sie Ihre Aufgabe wie gewohnt. Wählen Sie bei Bedarf eine Chat-Voreinstellung; ihr Systemprompt geht mit an den Coding Agent.
  2. Klicken Sie unten rechts an der Chat-Eingabe auf den Knopf In einem externen Coding Agent ausführen.

    Das Menü zeigt die Coding Agents, die Sie starten dürfen, zum Beispiel In Claude Code ausführen, und zuletzt In ALBERT | AI ausführen.

  3. Klicken Sie auf den gewünschten Eintrag.

    Ergebnis: Die Nachricht wird sofort übergeben – ein eigenes Absenden ist nicht nötig. Eine Meldung An <Coding Agent> übergeben bestätigt die Übergabe. Ihr Browser öffnet den Coding Agent und fragt dabei gegebenenfalls, ob er die Anwendung starten darf. Der Coding Agent liest den Chat und beginnt zu arbeiten. Wählen Sie In ALBERT | AI ausführen, beantwortet ALBERT | AI die Nachricht wie gewohnt selbst.

Ziel der Übergabe wählen

Hinweis: Der Coding Agent erhält Ihren Text beim Start mit, bei sehr langen Texten gekürzt. Das ist unkritisch: Der vollständige Text steht im Chat, und den liest der Coding Agent als Erstes.

Die Abfrage beim Absenden

Statt das Ziel über den Knopf zu wählen, können Sie die Nachricht auch wie gewohnt absenden. Dürfen Sie mindestens einen Coding Agent starten, fragt ALBERT | AI dann im Fenster Womit soll gearbeitet werden?, wer die Aufgabe bearbeiten soll: einer der Coding Agents oder ALBERT | AI (in dieser Oberfläche). Mit OK geht die Nachricht an das gewählte Ziel, mit Abbrechen wird nichts gesendet.

 

Abfrage beim Absenden
Verhalten Beschreibung
Vorauswahl Vorausgewählt ist das Standardziel, das Ihr Administrator eingestellt hat. Ist keines eingestellt oder dürfen Sie den eingestellten Coding Agent nicht starten, ist nichts vorausgewählt, und OK bleibt gesperrt, bis Sie ein Ziel wählen.
Wahl ALBERT | AI Wählen Sie ALBERT | AI, merkt sich der Chat diese Wahl. Solange Sie im Chat weiterarbeiten, fragt ALBERT | AI nicht erneut.
Erneute Abfrage Hat der Chat länger als die Ruhezeit geruht, fragt ALBERT | AI beim nächsten Absenden erneut. Vorausgewählt ist dann wieder das Standardziel und nicht Ihre frühere Wahl. Die Ruhezeit beträgt ohne eigene Einstellung 60 Minuten; das Fenster nennt den eingestellten Wert.

Während der Coding Agent arbeitet

Solange der Chat dem Coding Agent gehört, ist die Eingabe gesperrt. Statt des Eingabefelds sehen Sie den Hinweis Dieser Chat wird gerade von <Coding Agent> bearbeitet. – hat der Coding Agent einen Zwischenstand gemeldet, steht dieser in Klammern dahinter. Nach der Fertigmeldung lautet der Hinweis <Coding Agent> hat die Aufgabe abgeschlossen. Der Chat bleibt bei <Coding Agent> – übernehmen Sie die Kontrolle, um hier weiterzuarbeiten. Der Coding Agent meldet sich zu Beginn, zwischendurch bei längeren Aufgaben und am Ende mit einer Zusammenfassung im Chat.

 

Ein übergebener Chat mit Stand-Hinweis

Ergebnisse legt der Coding Agent in agorum core pro ab, nicht auf Ihrem Rechner. Die Zusammenfassung im Chat verweist mit Links darauf.

Tipp: Rückfragen stellt der Coding Agent in seiner eigenen Oberfläche, nicht im Chat. Dort könnten Sie ihm nicht antworten. Steht eine Aufgabe länger als erwartet, lohnt ein Blick in das Fenster des Coding Agents.

Den Chat zurückholen

Ein übergebener Chat bleibt dem Coding Agent zugeordnet, auch nachdem dieser fertig gemeldet hat – seine Sitzung kann weitergehen, und Sie können ihm dort weitere Aufträge zum selben Chat geben. Über die Schaltfläche Kontrolle übernehmen rechts neben dem Hinweis holen Sie den Chat jederzeit zurück und arbeiten wie gewohnt in ALBERTs Chat weiter.

Arbeitet der Coding Agent noch, fragt ALBERT | AI zuerst nach (Kontrolle übernehmen?). Der Coding Agent bemerkt das Zurückholen erst bei seiner nächsten Rückmeldung und stellt die Arbeit daran dann ein. Objekte, die er bis dahin angelegt oder geändert hat, bleiben bestehen.

Tipp: Holen Sie den Chat auch dann zurück, wenn der Coding Agent gar nicht startet oder unterwegs abbricht. Sonst bleibt die Eingabe gesperrt.

Wenn der Coding Agent den Chat nicht findet

Ein Coding Agent startet in dem Arbeitsordner, in dem er zuletzt benutzt wurde. Dieser Ordner kann mit einem anderen agorum core pro System verbunden sein oder mit gar keinem. Dann findet der Coding Agent den übergebenen Chat nicht.

Er hält in diesem Fall an, rät die Aufgabe nicht und nennt Ihnen die Chat-ID, den Arbeitsordner, in dem er läuft, und das System, mit dem er verbunden ist. Wählen Sie den Arbeitsordner, der zu dem System gehört, auf dem der Chat liegt, und übergeben Sie die Aufgabe erneut.

Tipp: Die Einrichtung benennt jeden Arbeitsordner nach dem Rechnernamen des Systems. Ein Blick auf den Ordnernamen zeigt deshalb, womit der Coding Agent gerade verbunden ist. Wechseln Sie den Ordner, bevor Sie einen Chat von einem anderen System übergeben.

Sprache

Der Coding Agent antwortet in der Sprache, in der Sie den Chat führen. Fragen Sie ihn ausdrücklich nach der verwendeten Umgebung, dem Hersteller oder dem Modell, nennt er sie Ihnen wahrheitsgemäß.

Wenn etwas nicht funktioniert

Beobachtung Ursache und Abhilfe
Der Menüeintrag Claude Code einrichten fehlt. Sie sind nicht berechtigt, Claude Code einzurichten. Wenden Sie sich an Ihren Administrator.
Das Fenster meldet, Sie seien für keine Einrichtung berechtigt. Ihnen fehlt die Berechtigung für die Varianten, die das System anbietet. Wenden Sie sich an Ihren Administrator.
Die Einrichtung meldet, das Zugriffstoken konnte nicht abgeholt werden. Die heruntergeladene Datei ist älter als zehn Minuten, oder Ihre Berechtigung wurde inzwischen entzogen. Laden Sie in agorum core pro eine neue Datei herunter.
Die Einrichtung meldet, dass sie http statt https verwendet. Das Zertifikat des Systems ist selbst signiert oder lautet auf einen anderen Namen, auf Entwicklungssystemen der Regelfall. Die Verbindung funktioniert trotzdem; neue Skill-Stände erhalten Sie dann durch erneutes Ausführen der Einrichtung.
Claude Code verbindet sich nicht, die Verbindung scheitert mit 401 – Authentication needed. Claude Code wurde nach der Einrichtung nicht neu gestartet (unter Linux: keine Ab- und Anmeldung), oder das Zugriffstoken wurde zurückgezogen. Starten Sie Claude Code neu bzw. führen Sie die Einrichtung erneut aus.
Claude Code zeigt keine Werkzeuge von agorum core pro. Sie arbeiten nicht im Arbeitsordner der Einrichtung. Das Plugin ist nur dort eingetragen.
Der Knopf In einem externen Coding Agent ausführen fehlt in der Chat-Eingabe. Sie dürfen keinen der aktivierten Coding Agents starten, oder Ihr Administrator hat alle deaktiviert. Ist das Chat-Fenster schon länger offen, öffnen Sie es neu. Während ALBERT | AI gerade antwortet, ist der Knopf gesperrt.
Nach der Übergabe passiert nichts, die Eingabe bleibt gesperrt. Der Coding Agent ist nicht installiert, der Browser hat den Start blockiert, oder der Coding Agent findet den Chat nicht. Sehen Sie im Fenster des Coding Agents nach und holen Sie den Chat über Kontrolle übernehmen zurück.