Agenten im Terminal

Coding-Agenten sind Kommandozeilenprogramme, und das Terminal startet sie mit einem Klick. Setz Claude Code in einen Bereich und Codex in den nächsten, gib jedem seinen Ordner, und lass sie nebeneinander an deinem Bookshop-Projekt arbeiten. Apiboo installiert diese Programme nicht und meldet dich nicht bei ihnen an; es findet sie auf deinem Computer und startet sie.

Die eingebauten Agenten

Jeder zeigt sein Markensymbol in Menüs, Kopfzeilen und Tabs. Eigene Programme fügst du als Profile hinzu (siehe Profile).

Einen Agenten starten

Im +-Menü neben den Tabs, unter Agenten:

Enter auf einem markierten Agenten wirkt wie ein Klick, mit Alt oder Alt+Shift wie oben.

Außerdem startest du Agenten über:

• den Startbildschirm, der den ersten installierten Agenten als Ein-Klick-Schaltfläche anbietet;
• Teilen mit… an jedem Bereich, um einen anderen Agenten daneben zu setzen (siehe Teilen mit…);
• ein gespeichertes Layout mit Agenten (siehe Gespeicherte Layouts).

Installationsprüfung und Installationshinweis

Apiboo prüft, welche Agenten installiert sind, und zeigt das Ergebnis neben jedem:

• keine Markierung: installiert und startbereit;
• ein kleiner Kreisel: wird noch geprüft; ein Klick startet ihn trotzdem;
• Nicht installiert ›: das Programm wurde nicht gefunden.

Klickst du einen Agenten mit Nicht installiert an, öffnet sich statt eines fehlgeschlagenen Starts der Installationshinweis darunter:

1. Er nennt den Grund, zum Beispiel „cursor-agent wurde in deinem PATH nicht gefunden.“
2. Unter Installiere es mit steht der Installationsbefehl für dein System mit einer Schaltfläche Kopieren, manchmal auch ein zweiter Weg („oder …“).
3. Doku öffnet die Installationsseite des Agenten.
4. Installier ihn in einem beliebigen Terminal und klick dann Erneut prüfen.

Apiboo führt die Installation nie selbst aus. Diese Befehle schlägt es vor:

Das Ergebnis der Prüfung bleibt, bis du erneut fragst: Erneut prüfen im +-Menü, im Installationshinweis oder in den Einstellungen prüft neu. Versucht ein Bereich, ein fehlendes Programm zu starten, zeigt er selbst denselben Hinweis; findet Erneut prüfen das Programm, startet der Bereich von allein.

Profile

Ein Profil ist ein Programm, das das +-Menü mit einem Klick öffnet. Die vier Agenten sind eingebaute Profile; eigene legst du dazu an, etwa für einen Dev-Server oder eine Datenbank-CLI.

Öffne Einstellungen → Erweiterungen → Terminal → Profile oder Profile verwalten… unten im +-Menü. Jedes Profil zeigt seinen Befehl und ob es installiert ist („Installiert · “ und der Pfad, oder Nicht installiert). Pro Profil kannst du:

• Im +-Menü ausblenden / Im +-Menü anzeigen (nur eingebaute; das Augensymbol);
• es Bearbeiten;
• Profil löschen (nur eigene Profile).

Profil hinzufügen legt ein neues an, Erneut prüfen prüft den Installationsstatus neu.

Der Profil-Editor

Bei einem eingebauten Agenten änderst du Argumente, Arbeitsverzeichnis, Umgebungsvariablen und den MCP-Schalter; Bezeichnung und Befehl bleiben fest.

Unter Windows startet ein per npm installierter Agent über eine .cmd-Datei. Enthält ein Argument ein Zeichen, das cmd.exe umdeuten würde (" & | < > ^ % ! ( )), startet Apiboo ihn nicht und sagt das im Bereich.

Wo ein Profil startet

Arbeitsverzeichnis im Profil-Editor hat vier Optionen:

Benutzerordner, Ein fester Ordner und Jedes Mal fragen haben Vorrang vor dem Standardordner des Terminals. Ein gespeichertes Layout fragt nie: Ein Bereich öffnet in dem Ordner, den das Layout sich gemerkt hat. Zum Standardordner siehe Das Arbeitsverzeichnis.

Apiboo-MCP anbinden

Claude Code und Codex können die MCP-Werkzeuge von Apiboo direkt aus einem Bereich nutzen. So liest der Agent deine Boards, Dokumente und Requests, während er arbeitet.

• Der Schalter Apiboo-MCP anbinden steckt im Profil des Agenten. Für Claude Code und Codex ist er standardmäßig an.
• Der Bereich bekommt ein eigenes Token mit deinen aktuellen MCP-Freigaben. Es liegt nur im Arbeitsspeicher, geht nur an das Programm dieses Bereichs und endet mit dem Bereich. Dein eigenes MCP-Token wird nie angezeigt oder weitergegeben.
• Der MCP-Server muss laufen. In der Kopfzeile bedeutet MCP aktiv, dass die Werkzeuge angebunden sind. MCP aus heißt, der Server war aus und der Agent ist ohne sie gestartet; ein Klick darauf öffnet die MCP-Einstellungen. Apiboo schaltet den Server nie von selbst ein.
• Im Bereich heißt Apiboo als MCP-Server apiboo_app, damit es nicht mit einem Eintrag apiboo kollidiert, den du vielleicht selbst eingerichtet hast.
• Für ein eigenes Profil wählst du den Stil, den deine CLI versteht: Wie Claude (--mcp-config) oder Wie Codex (-c mcp_servers…), oder Aus.
• Cursor CLI und Grok lassen sich nicht anbinden. Cursor CLI liest MCP-Server nur aus seiner eigenen mcp.json, die Apiboo nicht bearbeitet, und die MCP-Konfiguration von Grok ist nicht bestätigt.

Was der Agent darf, bestimmen deine Freigaben unter Einstellungen → MCP-Server. Siehe MCP-Server und Wie MCP einem KI-Agenten hilft.

Mehrere Agenten nebeneinander

Ein typischer Aufbau für die Bookshop-API:

1. Klick Claude Code im +-Menü. Er öffnet in einem neuen Tab, im Standardordner, falls du einen festgelegt hast.
2. Klick Rechts teilen in seiner Kopfzeile und wähl Codex in Rechts teilen mit…. Codex startet im selben Ordner.
3. Klick Unten teilen am Codex-Bereich und wähl eine Shell für npm run dev.
4. Wähl Anordnungen → Layout speichern…, nenn es „Bookshop agents“ und lass Agenten-Unterhaltungen beim Öffnen fortsetzen angehakt.

Beim nächsten Mal öffnest du „Bookshop agents“ vom Startbildschirm: Claude Code und Codex setzen ihre letzten Unterhaltungen fort, die Shell startet frisch. „An alle“ warnt dich, wenn ein Agent deine Tastatureingaben bekommen würde (siehe Eingabe an alle Bereiche).