ALBERT l AI Coding Agents einrichten

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 richtet sich an Administratoren. Sie beschreibt, wie Sie das Plugin in Betrieb nehmen und welche Einstellungen es mitbringt. Die Verbindung zu seinem Coding Agent stellt danach jeder Anwender selbst her, siehe Mit ALBERT | AI Coding Agents arbeiten.

Voraussetzungen

agorum core pro ab Version 11.13.1
ALBERT | AI Suite ab Version 1.39.0. Sie enthält dieses Plugin.
Ein Coding Agent wie Claude Code oder Codex mit eigener Installation bzw. Lizenz. Das Plugin ist im Lizenzumfang der ALBERT | AI Suite enthalten, den Coding Agent selbst stellen Sie bereit.

Die Inbetriebnahme im Überblick

Installieren oder aktualisieren Sie das Plugin ALBERT | AI Suite über den agorum core plugin manager. Das Plugin ALBERT | AI Coding Agents wird dabei mit installiert.
Ergebnis: Die Coding Agents Claude Code und Codex sind angelegt und aktiv. Die Benutzergruppen des Plugins sind angelegt und leer.
Nehmen Sie die Benutzer in die passenden Benutzergruppen auf, siehe ALBERT l AI Coding Agents berechtigen. Das gilt auch für Administratoren.
Deaktivieren Sie bei Bedarf in der Konfigurationsmaske Coding Agents die Coding Agents, die nicht verwendet werden sollen, und stellen Sie Standardziel und Ruhezeit ein.
Schalten Sie bei Bedarf in derselben Maske die Protokollierung der Sitzungen ein, siehe Sitzungen von Coding Agents protokollieren.
Die Anwender richten Claude Code anschließend über den Menüeintrag Claude Code einrichten selbst ein.

Hinweis: Bei einem Update legt das Plugin nur fehlende Coding Agents und Einstellungen an. Ein deaktivierter Coding Agent, ein gewähltes Standardziel und eine eigene Ruhezeit bleiben erhalten.

Die Konfigurationsmaske Coding Agents

Sie öffnen die Maske über das Hauptmenü oben rechts in der Kopfleiste (Symbol mit den drei Strichen): Administration > Konfiguration > Coding Agents. Der Eintrag steht Benutzern zur Verfügung, die über die Berechtigung für die ALBERT | AI Einstellungen verfügen.

Coding Agents konfigurieren

Einstellung	Beschreibung
Aktive Coding Agents	Ein Schalter je Coding Agent. Ein deaktivierter Coding Agent erscheint weder im Menü am Übergabe-Knopf noch in der Abfrage beim Absenden – für niemanden, unabhängig von den Gruppen. Die Einrichtung von Claude Code ist davon nicht betroffen; sie hängt allein an der Berechtigung.
Vorausgewähltes Ziel in der Abfrage beim Absenden	Das Ziel, das die Abfrage beim Absenden vorauswählt: Kein Standard, einer der Coding Agents oder ALBERT \| AI (in dieser Oberfläche). Ausgeliefert wird Kein Standard; dann ist nichts vorausgewählt, und der Anwender muss selbst wählen. Ein Anwender, der den eingestellten Coding Agent nicht starten darf, bekommt ebenfalls nichts vorausgewählt. Ein deaktivierter Coding Agent lässt sich nicht als Standardziel speichern.
Erneut nach dem Ziel fragen nach einer Ruhezeit von (Minuten)	Hat ein Anwender in einem Chat ALBERT \| AI gewählt, fragt der Chat erst wieder nach dem Ziel, wenn er länger als diese Zeit geruht hat. Möglich sind ganze Zahlen von 1 bis 10080 Minuten (eine Woche); ausgeliefert werden 60 Minuten. Für die Eingabe steht ein Taschenrechner bereit.
Sitzungen von Coding Agents protokollieren	Protokolliert Eingaben, Antworten und Werkzeugaufrufe der Sitzungen, zum Beispiel von Claude Code. Für Claude Code wirkt das Einschalten erst, nachdem der Anwender Claude Code neu eingerichtet hat. Siehe Sitzungen von Coding Agents protokollieren.
Sitzungen als Chat in ALBERT \| AI anzeigen	Zeigt die Sitzungen als Chat in ALBERT \| AI an. Wirkt nur zusammen mit Sitzungen von Coding Agents protokollieren; solange diese ausgeschaltet ist, ist der Schalter gesperrt.

Speichern Sie Ihre Änderungen mit Speichern in der Leiste am unteren Rand des Fensters. Eine ungültige Eingabe, etwa eine Ruhezeit außerhalb der Grenzen, zeigt ihren Fehler schon beim Eingeben am Feld, und die Maske speichert nichts. Haben Sie Änderungen noch nicht gespeichert, fragen Abbrechen und das X des Fensters erst nach, ob Sie speichern, verwerfen oder abbrechen wollen.

Hinweis: Die ersten drei Einstellungen gelten für alle Benutzer und für Chat-Fenster, die danach geöffnet werden. Ein bereits offenes Chat-Fenster übernimmt sie erst, wenn es neu geöffnet wird. Wann die Protokollierung der Sitzungen wirkt, beschreibt der Abschnitt Sitzungen von Coding Agents protokollieren.

Tipp: Benutzer ohne die Berechtigung für die ALBERT | AI Einstellungen sehen die Maske, falls sie sie öffnen, nur mit gesperrten Feldern und einem Warnhinweis.

Sitzungen von Coding Agents protokollieren

Mit der Einstellung Sitzungen von Coding Agents protokollieren zeichnet agorum core pro auf, was in den Sitzungen der Coding Agents geschieht. Für Claude Code erhält das Plugin in Claude Code dazu Hooks, die Eingaben, Antworten und alle Werkzeugaufrufe jeder Sitzung an agorum core pro melden. Aufrufe von Werkzeugen von agorum core pro sieht zusätzlich der MCP-Server; beide Sichten werden zu einem Aufruf zusammengeführt.

Achtung: Für einen Anwender wirkt das Einschalten erst, nachdem er Claude Code neu eingerichtet hat, siehe Mit ALBERT l AI Coding Agents arbeiten.

Eingeschaltet entsteht Folgendes:

Ergebnis	Beschreibung
Protokoll	Jede Sitzung bekommt eine Protokolldatei neben den Protokollen der Chats, aufgebaut wie das Protokoll eines Chats: Eingaben und Antworten als Nachrichten, Werkzeugaufrufe mit ihrem Ergebnis.
Einträge in der Kostenkontrolle	Jede Sitzung erscheint in der ALBERT \| AI Kostenkontrolle mit der Zahl ihrer Werkzeugaufrufe und, je Durchgang, mit ihrer aktiven Zeit – ohne Kosten und Token, denn das Sprachmodell läuft außerhalb von agorum core pro. Wie bei einem Chat entsteht je Durchgang (Eingabe bis Antwort) ein Eintrag. Siehe ALBERT \| AI Kostenkontrolle verwenden.

Hinweis: Die aktive Zeit ist die Zeit, in der der Coding Agent an einer Eingabe gearbeitet hat, ohne die Zeit, in der er auf den Anwender gewartet hat, etwa auf die Antwort auf eine Rückfrage oder auf die Freigabe eines Werkzeugs.

Feineinstellungen

Was im Einzelnen protokolliert wird, steht in der Handler-Konfiguration Coding Agents: Sitzungen protokollieren (agorum_ai_codingagents_sessions) unter Administration > Konfiguration > KI-Handler. Änderungen an Umfang und Eingaben wirken für das, was gespeichert wird, sofort; für das, was Claude Code sendet, erst nachdem es neu eingerichtet wurde.

Einstellung	Beschreibung
Umfang	Welche Werkzeugaufrufe protokolliert werden: Alle Werkzeuge Nur Werkzeuge von agorum core Alle Werkzeuge, ohne Ausgaben lokaler Werkzeuge Standard: Alle Werkzeuge
Eingaben und Antworten protokollieren	Ob auch Eingaben und Antworten im Protokoll stehen. Standard: eingeschaltet
Nicht zugeordnete MCP-Aufrufe protokollieren	Ob auch MCP-Aufrufe protokolliert werden, die sich keiner Sitzung zuordnen lassen. Standard: eingeschaltet
Sub-Agents im Usage-Protokoll als eigene Einträge	Ob die Sub-Agents einer Sitzung in der Kostenkontrolle eigene Einträge bekommen. Standard: eingeschaltet

Die Einrichtung von Claude Code durch die Anwender

Über den Menüeintrag Claude Code einrichten verbinden Anwender Claude Code selbst mit agorum core pro. Sie müssen dafür nichts vorbereiten außer der Berechtigung. Für den Betrieb ist Folgendes wichtig:

Zugriffstoken: Das System stellt je Benutzer ein Zugriffstoken ohne Ablaufdatum aus. Wie Sie es zurückziehen, beschreibt ALBERT l AI Coding Agents berechtigen.
Einrichtungsdatei: Die heruntergeladene Datei enthält nur ein Einrichtungstoken, das zehn Minuten gilt und ausschließlich zum Abholen des Zugriffstokens taugt. Beim Einlösen prüft das System die Berechtigung erneut.
Werkzeuggruppen: Fehlende Mitgliedschaften in den Werkzeuggruppen ergänzt die Einrichtung selbst.
Erreichbarkeit: Der Rechner des Anwenders muss das System unter dem Rechnernamen erreichen, unter dem er es im Browser aufruft. Einige Adressen der Einrichtung sind ohne Anmeldung erreichbar; sie liefern nur Inhalte ohne Geheimnis, etwa das Marketplace und das Einrichtungsskript.
Protokollierung der Sitzungen: Schalten Sie die Protokollierung ein, müssen die Anwender Claude Code neu einrichten, damit sie bei ihnen wirkt.

Skills über das Marketplace

agorum core pro stellt ein eigenes Marketplace für Claude Code bereit und baut die Plugin-Archive auf Anfrage – mit dem eigenen Rechnernamen und der passenden Werkzeuggruppe. Angeboten wird, was vorhanden ist: die Variante zum Arbeiten immer, die Variante zum Entwickeln nur auf Systemen mit dem Plugin ALBERT | AI Dev.

Ändert sich ein Skill in agorum core pro, erreicht der neue Stand die Anwender von selbst, ohne dass jemand ein Archiv weitergeben muss.

Achtung: Auf Systemen ohne gültiges Zertifikat weicht die Einrichtung auf http aus und trägt das Plugin örtlich ein, weil Claude Code Plugin-Archive ausschließlich über https annimmt. Neue Skill-Stände kommen dann nicht mehr von selbst an; die Anwender führen dafür die Einrichtung erneut aus. Dauerhaft beheben Sie das mit einem gültigen Zertifikat. Für ein Produktivsystem ist das dringend empfohlen.

Wenn etwas nicht funktioniert

Beobachtung	Ursache und Abhilfe
Der Knopf In einem externen Coding Agent ausführen erscheint für einen Benutzer nicht.	Der Benutzer ist in keiner Gruppe eines aktiven Coding Agents, oder alle Coding Agents sind deaktiviert. Das gilt auch für Administratoren. Nach einer Änderung das Chat-Fenster neu öffnen.
Der Menüeintrag Claude Code einrichten fehlt.	Der Benutzer ist nicht Mitglied der zuständigen Benutzergruppe, siehe ALBERT l AI Coding Agents berechtigen.
Die Variante In agorum core entwickeln wird nicht angeboten.	Das Plugin ALBERT \| AI Dev ist nicht installiert, oder der Benutzer ist nicht in der Gruppe für die Entwicklung.
Die Verbindung scheitert mit 401 – Authentication needed.	Der Anwender hat Claude Code nach der Einrichtung nicht neu gestartet (unter Linux: nicht ab- und angemeldet), oder das Zugriffstoken wurde zurückgezogen. Neu starten bzw. die Einrichtung erneut ausführen.
Die Werkzeugliste im Coding Agent ist leer oder unvollständig.	Es fehlt die Mitgliedschaft in den Werkzeuggruppen der gewählten Variante, oder der Anwender arbeitet nicht im Arbeitsordner der Einrichtung. Die Einrichtung erneut ausführen; sie ergänzt fehlende Mitgliedschaften.
Die Einrichtung bricht mit dem Hinweis ab, das Zugriffstoken konnte nicht abgeholt werden.	Die Einrichtungsdatei ist abgelaufen (zehn Minuten), oder der Benutzer hat die Berechtigung inzwischen verloren. Eine neue Datei herunterladen.
Die Sitzungen eines Anwenders erscheinen weder im Protokoll noch in der Kostenkontrolle.	Die Protokollierung ist in der Maske Coding Agents nicht eingeschaltet, die Handler-Konfiguration Coding Agents: Sitzungen protokollieren ist nicht aktiv, oder der Anwender hat Claude Code nach dem Einschalten nicht neu eingerichtet. Fehlen die Sitzungen nur in der Kostenkontrolle, ist die Zählung dort nicht eingeschaltet, siehe ALBERT \| AI Kostenkontrolle einrichten.