Richte deinen ersten Agenten ein

Von der frischen Installation bis zum funktionierenden KI-Agenten. Die beiden Punkte, die die meisten Einsteiger übersehen, stehen ganz oben: wie AgentsRoom mit den KI-CLIs zusammenhängt und wie man sich anmeldet.

Wie AgentsRoom funktioniert (lies dies zuerst)

AgentsRoom ist das Cockpit. Die KI-CLIs (Claude, Codex, GitHub Copilot CLI, Cursor und 15 weitere Agent-CLIs) sind die Motoren. Du meldest dich einmal über ihren eigenen Befehl bei den Motoren an, danach steuert AgentsRoom sie visuell. AgentsRoom speichert oder sieht nie deine Tokens, API-Keys oder dein ChatGPT-Passwort: Diese bleiben im eigenen sicheren Speicher jeder CLI auf deiner Maschine.

In AgentsRoom gibt es bewusst keine Schaltfläche "Bei ChatGPT anmelden" oder "Bei Anthropic anmelden". Die Anmeldung findet in der CLI statt, die du unten in Schritt 0 installierst.

Vor dem Start

✓Windows 10+, macOS 14+ (Sonoma) oder eine aktuelle 64-Bit-Linux-Distribution
✓
Mindestens eine installierte KI-Coding-CLI (Claude, Codex, GitHub Copilot CLI, Cursor oder eine der 15 weiteren von AgentsRoom unterstützten Agent-CLIs)
curl -fsSL https://claude.ai/install.sh | bash
✓Ein aktives Abonnement oder ein API-Schlüssel für deinen gewählten Anbieter

Schritt 0: Installiere deinen KI-Motor und melde dich an

Wähle zum Start einen Anbieter (weitere kannst du später ergänzen). Für jeden gilt: CLI installieren, einmal ausführen und anmelden, Funktion prüfen. Danach weiter zu Schritt 1.

Klicke auf einen Anbieter, um seine Setup-Schritte aufzuklappen.

Claude (Anthropic)Empfohlen für Erstanwender

Funktioniert mit

Claude Pro, Claude Max oder ein Anthropic API-Schlüssel.

1. Installieren

curl -fsSL https://claude.ai/install.sh | bash

2. Anmeldung

Führe claude einmal in einem beliebigen Terminal aus. Ein Browserfenster öffnet sich für die Anmeldung mit deinem Anthropic-Konto.

3. Verifizieren

Führe den Installationsbefehl von oben aus und gib dann den Namen der CLI allein in deinem Terminal ein (also z. B. "claude" tippen und Enter drücken). Du solltest einen Begrüßungs-Prompt sehen. Tippe "hello" und drücke Enter: Wenn du eine Antwort erhältst, kannst du die CLI in AgentsRoom verwenden.

Codex (OpenAI / ChatGPT)Verwende dein ChatGPT-Konto

Funktioniert mit

ChatGPT Plus, Pro, Team oder Enterprise oder ein OpenAI API-Schlüssel.

1. Installieren

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Anmeldung

Führe codex einmal in einem beliebigen Terminal aus. Ein Browserfenster öffnet sich. Melde dich mit deinem ChatGPT-Konto an, demselben, das du auf chatgpt.com verwendest.

3. Verifizieren

Antigravity CLI (Google)Kostenloses Kontingent verfügbar

Funktioniert mit

Ein Google-Konto (Anmeldung im Browser). Ein großzügiges kostenloses Kontingent ist verfügbar.

1. Installieren

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. Anmeldung

Führe antigravity einmal in einem beliebigen Terminal aus. Ein Browser-Fenster öffnet sich zur Google-Anmeldung.

3. Verifizieren

OpenCodeEigenen Anbieter mitbringen

Funktioniert mit

Jeder Anbieter, den du konfigurierst: Anthropic, OpenAI, OpenRouter und mehr.

1. Installieren

curl -fsSL https://opencode.ai/v2/install | bash

2. Anmeldung

Führe opencode aus und füge dann mit dem Befehl /connect einen Anbieter-Schlüssel oder ein OpenCode Go Abo hinzu.

3. Verifizieren

Grok Build (xAI)256K Kontext

Funktioniert mit

Ein xAI-Konto (Anmeldung über den Browser) oder ein Grok API key für die headless-Nutzung.

1. Installieren

curl -fsSL https://x.ai/cli/install.sh | bash

2. Anmeldung

Führe grok einmal in einem beliebigen Terminal aus. Ein Browser-Fenster öffnet sich für die xAI-Anmeldung. Für die headless-Nutzung setze stattdessen die Umgebungsvariable GROK_CODE_XAI_API_KEY.

3. Verifizieren

CursorDein Editor, im Terminal

Funktioniert mit

Ein Cursor-Konto. Dein bestehender Tarif deckt die CLI ab; der kostenlose Tarif erreicht weniger Modelle.

1. Installieren

curl https://cursor.com/install -fsS | bash

2. Anmeldung

Führe cursor-agent login aus, um dich über den Browser anzumelden. Die Konfiguration liegt in ~/.cursor.

3. Verifizieren

Kimi (Moonshot AI)Bis zu 1M Kontext

Funktioniert mit

Ein Kimi-Konto (Anmeldung im Browser) oder ein API-Schlüssel der Moonshot AI Open Platform.

1. Installieren

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. Anmeldung

Führe kimi einmal in einem Terminal aus und gib dann /login ein, um dich mit deinem Kimi-Konto anzumelden. Die Konfiguration liegt in ~/.kimi-code.

3. Verifizieren

FreebuffKein Schlüssel nötig

Funktioniert mit

Keines. Der Dienst ist kostenlos und wird durch Textanzeigen zwischen den Turns finanziert.

1. Installieren

npm install -g freebuff

2. Anmeldung

Führe freebuff in deinem Projekt aus. Es gibt einen Befehl freebuff login, falls du ein Codebuff-Konto verknüpfen möchtest.

3. Verifizieren

oh-my-piÜber 60 Backends

Funktioniert mit

Was du ohnehin schon bezahlst: Er meldet sich bei Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek und weiteren an oder nimmt einen einfachen API-Schlüssel.

1. Installieren

curl -fsSL https://omp.sh/install | sh

2. Anmeldung

Führe omp einmal aus und verwende dann /login, um einen Anbieter zu verbinden. Die Konfiguration liegt in ~/.omp.

3. Verifizieren

Pi (Earendil)Minimalistisch und erweiterbar

Funktioniert mit

Was du ohnehin schon bezahlst: Pi meldet sich bei Anthropic, OpenAI, Google, GitHub Copilot und vielen weiteren Anbietern an oder nimmt einen einfachen API-Schlüssel.

1. Installieren

curl -fsSL https://pi.dev/install.sh | sh

2. Anmeldung

Führe pi einmal aus und verwende dann /login, um einen Anbieter zu verbinden. Die Konfiguration liegt in ~/.pi/agent.

3. Verifizieren

DevinEin Abo, viele Modelle

Funktioniert mit

Ein Devin- oder Windsurf-Tarif, der kostenlose eingeschlossen. Dasselbe Abo deckt Claude, GPT, Gemini und die SWE-Modelle von Cognition ab.

1. Installieren

curl -fsSL https://cli.devin.ai/install.sh | bash

2. Anmeldung

Führe devin auth login aus, um dich über den Browser anzumelden. Die Konfiguration liegt in ~/.config/devin.

3. Verifizieren

Command CodeWähle zwischen offenen und proprietären Modellen

Funktioniert mit

Ein Command Code-Konto oder ein API-Schlüssel in COMMAND_CODE_API_KEY. Modellzugang und Nutzungslimits hängen von deinem Konto beim Anbieter ab.

1. Installieren

npm install -g command-code@latest

2. Anmeldung

Führe command-code login aus, um dich anzumelden, oder setze COMMAND_CODE_API_KEY in deiner Umgebung. Starte danach command-code in deinem Projekt.

3. Verifizieren

Mistral VibeEuropäische Modelle

Funktioniert mit

Ein Mistral-Konto (Pro oder Team) oder ein Mistral API key.

1. Installieren

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 mistral-vibe

2. Anmeldung

Führe vibe --setup einmal aus, um deinen Mistral API key zu speichern, und starte dann mit vibe. Die Konfiguration befindet sich in ~/.vibe/config.toml.

3. Verifizieren

Muse Code (Meta)Muse Spark in deinem Terminal

Funktioniert mit

Ein Meta-Konto mit Zugang zu Muse Code oder ein API-Schlüssel in META_API_KEY. Meta legt den Zugang und die Nutzungslimits fest.

1. Installieren

curl -fsSL https://dev.meta.ai/install.sh | sh

2. Anmeldung

Führe muse login aus, um dich anzumelden, oder setze META_API_KEY in deiner Umgebung. Starte danach muse in deinem Projekt.

3. Verifizieren

AiderNetznutzer

Funktioniert mit

Jeder Anbieter über einen API-Schlüssel (Anthropic, OpenAI, DeepSeek und mehr).

1. Installieren

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. Anmeldung

Kein Login-Befehl. Setze deinen API-Key als Umgebungsvariable in deinem Shell-Profil, zum Beispiel: export ANTHROPIC_API_KEY=sk-...

3. Verifizieren

Amp (Sourcegraph)Modi statt Modelle

Funktioniert mit

Ein Amp-Konto (Anmeldung im Browser) oder ein AMP_API_KEY Token.

1. Installieren

curl -fsSL https://ampcode.com/install.sh | bash

2. Anmeldung

Führe amp login einmal in einem beliebigen Terminal aus, um dich anzumelden. Die Einstellungen liegen in ~/.config/amp.

3. Verifizieren

MiniMax Code (MiniMax)Modelle der M-Serie

Funktioniert mit

Ein MiniMax-Konto (Anmeldung im Browser) oder ein MiniMax-API-Schlüssel.

1. Installieren

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. Anmeldung

Führe in einem Terminal mcode login --region global aus (oder mcode login für ein Konto aus Festlandchina). Die Konfiguration liegt in ~/.minimax.

3. Verifizieren

ZCode (Community-Client)GLM-Modelle, nicht von Z.ai

Funktioniert mit

Ein Z.ai- oder BigModel-Tarif oder ein API-Schlüssel. Dieser Community-Client wird von Z.ai weder veröffentlicht noch unterstützt.

1. Installieren

npm install -g zcode-app-cli@latest

2. Anmeldung

Starte zcode einmal in einem Terminal und gib dann /login ein, um dich mit deinem Z.ai- oder BigModel-Konto anzumelden. Erfordert Node.js 22.19 oder neuer. Die Konfiguration liegt in ~/.zcode.

3. Verifizieren

Kommst du bei diesem Schritt nicht weiter? Sieh dir den Abschnitt Fehlerbehebung unten auf dieser Seite an.

AgentsRoom herunterladen und installieren

Lade das Installationsprogramm für dein Betriebssystem herunter: die .dmg unter macOS, die .exe unter Windows oder das AppImage unter Linux. Öffne es, folge den Installationsschritten und starte anschließend AgentsRoom.

Tip: AgentsRoom sucht automatisch nach Updates. Du wirst benachrichtigt, wenn eine neue Version verfügbar ist.

Erstelle dein erstes Projekt

Klicke auf die Schaltfläche + in der Seitenleiste. Wähle einen beliebigen Ordner auf deiner Maschine aus. Hier arbeiten deine KI-Agenten. Benenne dein Projekt und ordne es einer Zone zu.

Tip: Jedes Projekt wird in einen echten Ordner abgebildet. Agenten führen die CLI deines gewählten Anbieters in diesem Verzeichnis aus, genau wie du es in deinem Terminal tun würdest.

Füge deinen ersten Agenten hinzu

Klicke in deinem Projekt auf Agent hinzufügen. Wähle eine Rolle (Fullstack ist ein guter Start), dann einen Anbieter (der Motor, den du in Schritt 0 eingerichtet hast), dann ein Modell (für Claude wird Sonnet empfohlen). Schreibe optional einen ersten Prompt und klicke auf Start. Das Terminal öffnet sich und startet die CLI für dich.

Tip: Wenn das Terminal leer aussieht oder einen Login-Bildschirm zeigt, ist die CLI aus Schritt 0 noch nicht angemeldet. Öffne ein normales Terminal, führe claude oder codex (oder den Befehl deines Anbieters) einmal aus, schließe die Anmeldung ab und komm dann zurück.

Sieh ihm bei der Arbeit zu

Das Terminal zeigt Live-Ausgabe: jede gelesene Datei, jede Bearbeitung. Statusänderungen: arbeitet, dann fertig. Du erhältst eine Desktop-Benachrichtigung, wenn er fertig ist.

Tip: Du kannst mehrere Agenten auf einmal starten. Jeder bekommt sein eigenes Terminal und arbeitet unabhängig.

Passe dein Setup an

Bearbeite CLAUDE.md direkt in AgentsRoom, um Agenten einen besseren Kontext zu geben. Modelle ändern, Berechtigungen anpassen, Hooks konfigurieren. Füge weitere Agenten mit anderen Rollen oder Anbietern hinzu.

Tip: Opus für Architektur. Sonnet für dev. Haiku für schnelle Aufgaben wie Tests.

Tipps und Tricks

1.Verwende Opus für Architekturentscheidungen, Sonnet für die tägliche Codierung, Haiku für schnelle Aufgaben

2.Gruppiere Projekte nach Zonen (Arbeit, Privat, Nebenprojekte) für eine bessere Organisation

3.CLAUDE.md von AgentsRoom bearbeiten, um Agenten einen besseren Projektkontext zu geben

4.Aktiviere Desktop-Benachrichtigungen, damit du dich um anderes kümmern kannst, während die Agenten arbeiten

5.Beginne mit einem Agenten pro Projekt und füge weitere hinzu, sobald du dich sicher fühlst

Fehlerbehebung

Mein Agententerminal ist leer oder hängt

Meistens ist die CLI nicht angemeldet. Öffne dein Terminal (Terminal unter macOS, PowerShell oder Windows Terminal unter Windows, deinen Terminal-Emulator unter Linux), führe den Befehl der CLI allein aus (claude, codex, antigravity, opencode), schließe die Anmeldung im Browser ab und kehre dann zu AgentsRoom zurück, um den Agenten erneut zu starten. AgentsRoom hat keinen eigenen Anmeldebildschirm: Die Authentifizierung liegt in der CLI.

command not found: claude (oder codex, antigravity usw.)

Die CLI ist nicht installiert, oder der PATH deiner Shell findet sie nicht. Führe den Installationsbefehl aus Schritt 0 oben erneut aus. Wenn du nvm verwendest, installiere die CLI mit derselben Node-Version, die du im Alltag nutzt, sonst liegt das Binary nicht im PATH, wenn AgentsRoom startet.

Ich sehe keine Schaltfläche, um in ChatGPT oder Claude in AgentsRoom einzuloggen

So gewollt. AgentsRoom ist eine Oberfläche über den CLIs und fasst deine Anmeldedaten nie direkt an. Die Anmeldung erfolgt einmal in der CLI (claude oder codex in einem Terminal ausführen), danach nutzt AgentsRoom diese Sitzung. Das macht AgentsRoom sicherer als Werkzeuge, die deine Tokens abfangen.

Agent hängt bei "Denken" fest

Prüfe, ob dein Abonnement oder dein API-Schlüssel für den ausgewählten Anbieter aktiv ist. Führe die CLI direkt in deinem Terminal aus, um die eigentliche Fehlermeldung zu sehen: Claude oder OpenAI drosseln Sitzungen manchmal oder lassen sie stillschweigend ablaufen.

Keine Projekte in der Sidebar

Stelle sicher, dass du beim Erstellen des Projekts einen gültigen Ordner ausgewählt hast. Der Ordner muss auf der Festplatte vorhanden sein. Starte AgentsRoom neu, wenn ein Projekt hinzugefügt wurde, aber noch nicht sichtbar ist.

Ich habe die CLI installiert, aber AgentsRoom meldet immer noch "command not found"

AgentsRoom erbt seinen PATH von deiner Login-Shell, nicht von deinem interaktiven Terminal. Beende AgentsRoom vollständig, öffne ein neues Terminal, prüfe, ob die CLI aus einer frischen Shell-Session aufrufbar ist (which claude), und starte AgentsRoom dann neu.