Richten Sie Ihren ersten Agenten ein

Von einer frischen Installation bis zu einem funktionierenden KI-Agent. Die beiden Teile, die die meisten Anfänger vermissen, sind oben: wie AgentsRoom die AI CLIs betrifft und wie man sich einloggt.

Wie AgentsRoom funktioniert (lesen Sie dies zuerst)

AgentsRoom ist das Cockpit. Die AI CLIs (Claude Code, Codex, OpenCode, Gemini, Aider) sind die Motoren. Sie melden sich einmal über ihren eigenen Befehl an die Motoren, dann treibt AgentsRoom sie visuell an. AgentsRoom speichert oder sieht nie Ihre Token, API keys oder ChatGPT Passwort: Diese bleiben innerhalb jeder CLI eigenen sicheren Speicher auf Ihrer Maschine.

Es gibt keine "Anmelden an ChatGPT" oder "Anmelden an Anthropic" Taste innerhalb AgentsRoom durch Design. Der Login lebt in der CLI, die Sie in Schritt 0 unten installieren.

Vor dem Start

✓macOS 14+ (Sonoma oder später)
✓
Mindestens eine AI-Codierung CLI installiert (Claude, Codex, OpenCode, Gemini CLI oder Aider)
npm install -g @anthropic-ai/claude-code
✓Ein aktives Abonnement oder API key für Ihren gewählten Anbieter

Schritt 0: Installieren und melden Sie sich an Ihrem KI-Motor

Wählen Sie einen Anbieter zum Starten (Sie können später noch hinzufügen). Für jeden: Installieren Sie die CLI, führen Sie es einmal ein, um sich anzumelden, überprüfen Sie es funktioniert. Dann springen Sie auf Schritt 1.

Klicken Sie auf einen Anbieter, um seine Setup-Schritte zu erweitern.

Claude (Anthropic)Empfohlen für Erstanwender

Arbeiten mit

Claude Pro, Claude Max, oder ein Anthropic XGLOS23XGLOS.

1. Installieren

npm install -g @anthropic-ai/claude-code

2. Anmeldung

Führen Sie Claude einmal in jedem Terminal. Ein Browser-Fenster öffnet für die Anmeldung mit Ihrem Anthropic-Konto.

3. Verifizieren

Führen Sie oben den Installationsbefehl aus, führen Sie dann den Namen des CLI allein in Ihrem Terminal aus (z.B. geben Sie "claude" und drücken Sie die Eingabe). Sie sollten eine willkommene Aufforderung sehen. Geben Sie "Hallo" ein und drücken Sie die Eingabe: Wenn Sie eine Antwort erhalten, sind Sie bereit, es in AgentsRoom zu verwenden.

Codex (OpenAI / ChatGPT)Verwenden Sie Ihr ChatGPT-Konto

Arbeiten mit

XGLOS27XGLOS Plus, Pro, Team oder Enterprise, oder ein OpenAI API key.

1. Installieren

npm install -g @openai/codex

2. Anmeldung

Führen Sie Codex einmal in jedem Terminal aus. Ein Browser-Fenster öffnet. Melden Sie sich mit Ihrem ChatGPT-Konto an, das gleiche, das Sie auf chatgpt.com verwenden.

3. Verifizieren

XGLOS29XBringen Sie Ihren eigenen Anbieter

Arbeiten mit

Jeder Anbieter, den Sie konfigurieren: Anthropic, OpenAI, OpenRouter und mehr.

1. Installieren

npm install -g opencode-ai

2. Anmeldung

Führen Sie opencode auth login aus und folgen Sie den Aufforderungen, um einen Providerschlüssel hinzuzufügen.

3. Verifizieren

Gemini CLI (Google)Kostenloser Tier verfügbar

Arbeiten mit

Ein Google-Konto (kostenlos verfügbar) oder ein Gemini API key.

1. Installieren

npm install -g @google/gemini-cli

2. Anmeldung

Lauf mal Gemini. Ein Browser-Fenster öffnet für Google Sign-in.

3. Verifizieren

XGLOS37XNetznutzer

Arbeiten mit

Jeder Anbieter über API key (Anthropic, OpenAI, DeepSeek und mehr).

1. Installieren

pip install aider-chat

2. Anmeldung

Kein Login-Befehl. Setzen Sie Ihre API key als Umgebungsvariable in Ihrem Shell-Profil, zum Beispiel: Export von ANTHROPIC API KEY=sk-...

3. Verifizieren

Stuck an diesem Schritt? Sehen Sie den Fehlersuche Abschnitt unten auf dieser Seite.

AgentsRoom herunterladen und installieren

Laden Sie die .dmg-Datei herunter, öffnen Sie sie und ziehen Sie AgentsRoom in Ihren Anwendungsordner. Starten Sie es aus dem Spotlight oder dem Applications Ordner.

Tip: AgentsRoom Auto-Checks für Updates. Sie werden benachrichtigt, wenn eine neue Version verfügbar ist.

Erstellen Sie Ihr erstes Projekt

Klicken Sie auf die + Taste in der Seitenleiste. Wählen Sie einen beliebigen Ordner auf Ihrer Maschine aus. Hier arbeiten Ihre KI-Agenten. Nennen Sie Ihr Projekt und geben Sie es einer Zone zu.

Tip: Jedes Projekt wird in einen echten Ordner abgebildet. Agenten führen die CLI Ihres gewählten Anbieters in diesem Verzeichnis aus, genau wie Sie es in Ihrem Terminal tun würden.

Fügen Sie Ihren ersten Agenten hinzu

Klicken Sie in Ihrem Projekt auf Agent hinzufügen. Wählen Sie eine Rolle (Fullstack ist ein guter Start), dann ein Anbieter (der Motor, den Sie in Schritt 0 einrichten), dann ein Modell (Sonnet wird für Claude empfohlen). Schreiben Sie optional eine erste Aufforderung und klicken Sie auf Start. Das Terminal öffnet und führt das CLI für Sie.

Tip: Wenn das Terminal leer aussieht oder einen Login-Bildschirm zeigt, wird der CLI von Schritt 0 noch nicht angemeldet. Öffne ein reguläres Terminal, laufe Claude oder Codex (oder den Befehl deines Providers) einmal aus, vervollständige das Anmelden und komm zurück.

ANHANG

Passt es auf

Das Terminal zeigt Live-Ausgabe: jede Datei gelesen, jede Bearbeitung. Statusänderungen: Denken, Codieren, fertig. Sie erhalten eine macOS Benachrichtigung, wenn es beendet.

Tip: Sie können mehrere Agenten auf einmal starten. Jeder bekommt sein eigenes Terminal und arbeitet unabhängig.

Passen Sie Ihr Setup an

Bearbeiten Sie CLAUDE.md direkt von AgentsRoom, um Agenten einen besseren Kontext zu geben. Modelle ändern, Berechtigungen anpassen, Haken konfigurieren. Fügen Sie weitere Agenten mit verschiedenen Rollen oder Anbietern hinzu.

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

Tipps und Tricks

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

2.Gruppenprojekte nach Zone (Work, Personal, Side-Projekte) für bessere Organisation

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

4.Aktivieren Sie macOS Benachrichtigungen, so dass Sie Multitask, während Agenten arbeiten

5.Beginnen Sie mit einem Agenten pro Projekt, fügen Sie mehr hinzu, wie Sie sich wohl fühlen

Fehlerbehebung

Mein Agententerminal sieht leer oder fest

Die meiste Zeit der CLI ist nicht angemeldet. Öffnen Sie ein reguläres Terminal (Terminal.app), führen Sie den Befehl CLI allein aus (claude, codex, gemini, opencode), füllen Sie das Browser-Zeichen ein, gehen Sie zurück zu AgentsRoom und starten Sie den Agenten wieder. AgentsRoom verfügt nicht über einen eigenen Login-Bildschirm: Die Auth lebt im CLI.

befehl nicht gefunden: claude (oder codex, gemini, etc.)

Das CLI ist nicht installiert, oder Ihre Shell PATH sieht es nicht. Starten Sie den Installationsbefehl von Schritt 0 oben. Wenn Sie nvm verwenden, installieren Sie die CLI mit der gleichen Node-Version, die Sie Tag für Tag verwenden, andernfalls wird die Binär nicht in PATH sein, wenn AgentsRoom startet.

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

Durch Design. AgentsRoom ist ein UI auf CLIs und behandelt Ihre Anmeldeinformationen nie direkt. Die Anmeldung erfolgt einmal im CLI (Claude oder Codex in einem Terminal ausführen), dann verwendet AgentsRoom diese Sitzung. Dies macht AgentsRoom sicherer als Werkzeuge, die Ihre Token abfangen.

Agent am "Denken" festhalten

Überprüfen Sie, ob Ihr Abonnement oder API key für den ausgewählten Anbieter aktiv ist. Versuchen Sie, die CLI direkt in Ihrem Terminal zu laufen, um die eigentliche Fehlermeldung zu sehen: Claude oder OpenAI manchmal drosseln oder ablaufen Sitzungen still.

Keine Projekte in der Sidebar

Stellen Sie sicher, dass Sie beim Erstellen des Projekts einen gültigen Ordner ausgewählt haben. Der Ordner muss auf der Festplatte vorhanden sein. Starten Sie AgentsRoom, wenn ein Projekt hinzugefügt wurde, aber noch nicht sichtbar.

Ich habe die CLI installiert, aber AgentsRoom sagt immer noch "Befehl nicht gefunden"

AgentsRoom erbt seine PATH von Ihrer Anmeldeschale, nicht von Ihrem interaktiven Endgerät. Quit AgentsRoom komplett, öffnen Sie ein neues Terminal, überprüfen Sie die CLI ist aus einer frischen Shell-Session (die claude), dann wieder AgentsRoom.