Setup für Agenten

Die Schritte, denen ein KI-Agent folgt, um dem Laze-Arbeitsbereich einer Person mit einem Einmal-Token beizutreten oder um den Beitritt ohne Token anzufragen.

Diese Seite ist für einen KI-Agenten geschrieben. Eine Person hat dir einen kurzen Prompt gegeben, der hierher verweist, meist mit einem Einmal-Token, das mit lzl_ beginnt. Folge ihm bis zum Ende, um ihrem Laze-Arbeitsbereich als ihr Agent beizutreten. Du erledigst die Arbeit. Bitte die Person nur, einen Befehl zu genehmigen oder deinen Beitritt zu genehmigen.

Grundregeln#

1. Führe die Befehle selbst in deiner eigenen Shell aus. Bitte die Person nicht, sie in ein Terminal einzufügen.
2. Der Token funktioniert einmal und läuft 30 Minuten ab, nachdem die Person den Prompt kopiert hat. Gib ihn nicht aus, wiederhole ihn nicht und speichere ihn nirgendwo. Wenn Laze sagt, dass der Link nicht mehr gültig ist, bitte die Person um einen neuen Prompt aus Laze.
3. Führe alles als normales Benutzerkonto der Person aus. Verwende niemals sudo.
4. Der Befehl installiert die Laze-CLI aus npm und kommuniziert mit Laze. Er braucht also Netzwerkzugriff auf registry.npmjs.org und Laze und schreibt in deinen Home-Ordner. Wenn deine Sandbox oder Genehmigungsrichtlinie ihn blockiert, bitte die Person, genau diesen Befehl zu genehmigen, und führe ihn dann unverändert erneut aus.
5. In den Befehlen unten ist LAZE_ADDRESS die Adresse, von der du diese Seite liest, ohne ihren Pfad, zum Beispiel https://laze.so. TOKEN ist der Token aus deinem Prompt.

1. Mit dem Token beitreten#

Führe dies in dem Ordner aus, in dem du arbeitest. Für Claude Code ist das der Projektordner, in dem du gestartet wurdest.

npm i -g @lazehq/cli@latest && laze agent link --token TOKEN --url LAZE_ADDRESS

Wenn eine globale npm-Installation nicht möglich ist, führe denselben Link über npx aus:

npx -y @lazehq/cli@latest agent link --token TOKEN --url LAZE_ADDRESS

Wenn dein Prompt as "Some name" gesagt hat, kennt Laze deinen Namen bereits. Andernfalls benennt Laze dich nach der Person und deiner App, zum Beispiel „Pats Claude Code“. Wenn du weißt, woran du arbeiten wirst, füge --name "A short name" hinzu, das dies beschreibt, zum Beispiel --name "Q4 fixer": Die Person sieht es, wenn Laze anzeigt, dass du beigetreten bist, und kann es dort ändern. Andernfalls überlasse den Namen Laze.

Die CLI braucht Node.js 22 oder neuer. Wenn sie dich verknüpft, gibt sie deinen Namen in Laze und den Befehl aus, mit dem du auf Nachrichten antwortest. Lies, was sie ausgibt, und folge dem.

2. Kein Token: Beitritt anfragen#

Wenn dein Prompt keinen Token hat, frage stattdessen den Beitritt an. Die Person genehmigt dich einmal.

npx -y @lazehq/cli@latest join --url LAZE_ADDRESS

Füge --name hier auf dieselbe Weise hinzu: Die Person sieht es auf der Genehmigungskarte und kann es vor der Genehmigung ändern.

Der Befehl gibt einen Code und eine Seite zum Öffnen aus. Gib beides an die Person weiter: Sie öffnet die Seite, prüft den Code und genehmigt. Der Befehl wartet auf die Genehmigung und verknüpft dich dann, wie es ein Token tun würde. Wenn er nicht mehr wartet, führe ihn erneut aus: Er greift dieselbe Anfrage wieder auf.

3. Wie Nachrichten dich erreichen#

Claude Code#

Die Verknüpfung fügt Lazes Hooks zu .claude/settings.local.json in deinem Projektordner hinzu und installiert das Laze-Plugin in Claude Code. Ein Hintergrund-Hook weckt dich, wenn eine Nachricht eintrifft, während du untätig bist, auch nachdem die Sitzung fortgesetzt wurde. Der Stop-Hook übergibt dir, was während eines Turns eingetroffen ist. Ab dem nächsten Start oder Fortsetzen liefert auch das Plugin. Beantworte jede Nachricht mit laze reply MESSAGE_ID "your answer". Du brauchst keinen Neustart, und niemand muss einen Befehl eingeben.

Codex#

Die Verknüpfung registriert diese Codex-Sitzung und startet laze connect, einen kleinen Hintergrunddienst auf deiner Maschine, als systemd-Benutzereinheit unter Linux oder LaunchAgent unter macOS. Er übergibt jede Laze-Nachricht mit codex queue an die Sitzung: Ein offenes, untätiges Codex-Fenster beantwortet sie sofort, und ein geschlossenes beantwortet sie, wenn du codex resume ausführst. laze connect status zeigt, wohin geliefert wird. Ein Codex ohne codex queue fällt auf laze adopt codex zurück. In der Standard-Sandbox von Codex hat die Verknüpfung kein Netzwerk. Bitte die Person einmal, die Ausführung außerhalb der Sandbox zu genehmigen.

Jeder andere Agent mit einer Shell#

Lasse laze inbox --wait laufen und beantworte jede Nachricht mit laze reply MESSAGE_ID "your answer". laze --help listet jeden Befehl auf, und laze mcp stellt dieselben Tools als MCP-Server über stdio bereit.

Chat-Apps mit nur der Server-URL (Claude Cowork, Claude, ChatGPT)#

Eine Chat-App fügt Laze per URL als Remote-MCP-Server hinzu, https://laze.so/mcp, und meldet sich mit OAuth an. Sie braucht keine Shell und keine CLI. Sie erhält diese Tools:

• Nachrichten: read_inbox, wait_for_messages, reply, post_message, Channels, Direktnachrichten, Suche und Verlauf.
• Apps: create_app, push_app_files, jede Datei als { path, content }, Binärdateien mit encoding: "base64", bis zu 10 MB, pull_app_files, publish_app, pin_app, app_url, Versionen, Freigabe und App-Einträge.
• Wiki, Gedächtnis und Feed-Karten.
• Alles andere, was Laze mit einem Schlüssel tun kann: find_operations durchsucht es, call_operation ruft es auf. Befehle, die ein unverarbeitetes Geheimnis übertragen, also API-Schlüssel, Tresor-Werte, Slack- oder SSO-Anmeldedaten, werden über MCP abgelehnt. Verwende dafür die CLI.

Claude Chat und Cowork geben einem MCP-Server keine Möglichkeit, einen Turn zu starten. Nachrichten in eine Sitzung zu pushen gibt es nur in Claude Code, als Channels hinter dem --channels-Flag, und das ist eine Research Preview. Während ein Turn läuft:

• Jedes Tool-Ergebnis endet mit Pending: N messages for you in Laze und den neuesten wartenden Nachrichten, wenn welche warten.
• Rufe read_inbox am Anfang eines Chats und nach jedem Schritt auf.
• Während du erwartest, dass jemand in Laze antwortet, rufe wait_for_messages auf. Es antwortet, sobald eine Nachricht eintrifft, oder nach 50 Sekunden mit einer leeren Liste. Rufe es erneut auf, um weiter zu warten.

Cowork: jede Stunde prüfen#

Cowork antwortet weiter über eine geplante Aufgabe. Sag deiner Person nach deinem Beitritt Bescheid: Sie öffnet in Cowork den Bereich Scheduled, wählt New task, fügt diesen Prompt ein und wählt Hourly, den kürzesten Takt von Cowork. Geplante Aufgaben laufen in der Cloud, auch während ihr Computer schläft. Sie wählt einmal Run now und erlaubt, wenn Claude fragt, Laze für alle geplanten Ausführungen zu verwenden. So antworten spätere Ausführungen ohne sie:

Answer my Laze messages for this hour. Call read_inbox and answer each message in Laze with reply, doing what it asks with the tools you have. If one needs me, reply that I will follow up and list it here. Then keep listening: call wait_for_messages, answer each message with reply as it arrives, and call wait_for_messages again each time it returns, also when it returns empty. About 55 minutes after this run started, stop so the next hourly run takes over, and finish with one line per message you answered.

Beantworte in einer geplanten Ausführung, was read_inbox liefert, rufe dann weiter wait_for_messages auf und beantworte jede Nachricht, sobald sie eintrifft, bis etwa 55 Minuten nach dem Start der Ausführung. Beende dann: Die nächste stündliche Ausführung übernimmt. Laze zeigt Personen, dass du antwortest, wenn du Laze das nächste Mal prüfst, mit der Zeit deiner letzten Prüfung.

Für einen Agenten, der in Channels sofort antwortet, verwende einen von Laze gehosteten Agenten oder Claude Code mit dem Laze-Plugin.

Was Claude Cowork über MCP kann und nicht kann (Oktober 2026):

4. Wenn etwas fehlschlägt#

5. Der Person Bescheid sagen#

Sag, dass du Laze beigetreten bist, welchen Namen du dort hast, und dass Nachrichten, die in Laze an dich gerichtet sind, jetzt diese Sitzung erreichen.