Ustaw swojego pierwszego agenta

Od świeżej instalacji do działającego agenta AI. Dwie części najbardziej początkujących brakuje są na górze: jak AgentsRoom odnosi się do AI CLI i jak się zarejestrować.

Jak działa AgentsRoom (przeczytaj najpierw)

AgentsRoom jest kokpitem. Silniki to AI CLI (kod Claude, Codex, OpenCode, Gemini, Aider). Wpisz się raz do silników za pomocą ich własnego polecenia, a następnie AgentsRoom napędza je wizualnie. AgentsRoom nigdy nie przechowuje i nie widzi swoich żetonów, API key lub hasła ChatGPT: pozostają wewnątrz każdego CLI własnej bezpiecznej pamięci na komputerze.

Nie ma przycisku "Zaloguj się do ChatGPT" lub "Zaloguj się do Anthropic" wewnątrz AgentsRoom według projektu. Zaloguj się do CLI, który zainstalować w kroku 0 poniżej.

Zanim zaczniesz

✓macOS 14 + (Sonoma lub nowszy)
✓
Co najmniej jeden zainstalowany kod AI CLI (Claude, Codex, OpenCode, Gemini CLI lub Aider)
npm install -g @anthropic-ai/claude-code
✓Aktywna subskrypcja lub API key dla wybranego dostawcy

Krok 0: zainstalować i zalogować się do silnika AI

Wybierz jednego dostawcę, aby rozpocząć (można dodać więcej później). Dla każdego z nich: zainstalować CLI, uruchomić go raz się zalogować, sprawdzić, czy działa. Następnie przejść do kroku 1.

Kliknij na dostawcę, aby rozszerzyć swoje etapy konfiguracji.

Claude (Anthropic)Zalecane dla użytkowników po raz pierwszy

Działa z

Claude Pro, Claude Max, lub Anthropic API key.

1. Instalacja

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

2. Wpisz

Uruchom claude raz w dowolnym terminalu. Okno przeglądarki otwiera się do logowania na koncie Anthropic.

3. Weryfikacja

Uruchom polecenie instalacji powyżej, a następnie uruchom nazwę CLI samodzielnie w terminalu (np. wpisz "claude" i naciśnij enter). Powinieneś zobaczyć powitanie. Wpisz "hello" i naciśnij enter: jeśli otrzymasz odpowiedź, jesteś gotowy do użycia wewnątrz AgentsRoom.

Codex (OpenAI / ChatGPT)Użyj konta ChatGPT

Działa z

ChatGPT Plus, Pro, Team or Enterprise, lub OpenAI API key.

1. Instalacja

npm install -g @openai/codex

2. Wpisz

Uruchom kod raz w dowolnym terminalu. Otwiera się okno przeglądarki. Zaloguj się za pomocą konta ChatGPT, tego samego używanego na chatgpt.com.

3. Weryfikacja

OpenCodePrzyprowadź własnego dostawcę

Działa z

Każdy dostawca skonfigurowany: Anthropic, OpenAI, OpenRouter i więcej.

1. Instalacja

npm install -g opencode-ai

2. Wpisz

Uruchom logowanie Opencode auth i postępuj zgodnie z instrukcjami, aby dodać klucz dostawcy.

3. Weryfikacja

Gemini CLI (Google)Dostępny wolny poziom

Działa z

Konto Google (wolny poziom) lub Gemini API key.

1. Instalacja

npm install -g @google/gemini-cli

2. Wpisz

Uruchom kiedyś gemini. Okno przeglądarki otwiera się dla znaku XGLOS36X7XLOS.

3. Weryfikacja

AiderUżytkownicy energii

Działa z

Każdy dostawca za pośrednictwem API key (Anthropic, OpenAI, DeepSeek i więcej).

1. Instalacja

pip install aider-chat

2. Wpisz

Brak polecenia logowania. Ustaw API key jako zmienną środowiskową w profilu powłoki, na przykład: wyeksportuj ANTHROPIC _ API _ KEY =...

3. Weryfikacja

Utknął na tym etapie? Zobacz sekcję rozwiązywania problemów na dole tej strony.

Pobierz i zainstaluj AgentsRoom

Pobierz plik .dmg, otwórz go i przeciągnij AgentsRoom do folderu Aplikacje. Uruchom go z Spotlight lub folderu Aplikacje.

Tip: AgentsRoom auto- kontrole aktualizacji. Zostaną Państwo powiadomieni, gdy nowa wersja będzie dostępna.

Utwórz swój pierwszy projekt

Kliknij przycisk + w pasku bocznym. Wybierz dowolny folder na komputerze. Tu będą pracować twoi agenci. Podaj nazwę projektu i przypisz go do strefy.

Tip: Każdy projekt mapuje do prawdziwego folderu. Agenci uruchamiają CLI wybranego dostawcy w tym katalogu, tak jak ty w terminalu.

Dodaj swojego pierwszego agenta

Wewnątrz projektu kliknij przycisk Dodaj agenta. Wybierz rolę (Fullstack jest dobry start), następnie dostawca (silnik ustawiony w kroku 0), a następnie model (Sonnet jest zalecane dla Claude). Opcjonalnie zapisz początkowy sygnał i kliknij Uruchom. Terminal otwiera i uruchamia CLI dla Ciebie.

Tip: Jeśli terminal wygląda na pusty lub pokazuje ekran logowania, CLI z kroku 0 nie jest jeszcze zalogowany. Otwórz regularny terminal, uruchom claude lub kod (lub polecenie dostawcy) raz, zakończyć sign- in, a następnie wróć.

Patrz jak działa

Terminal pokazuje wyjście na żywo: każdy plik odczytany, każda edycja. Zmiana statusu: myślenie, kodowanie, zrobione. Otrzymasz zgłoszenie macOS po zakończeniu.

Tip: Możesz uruchomić wielu agentów. Każdy ma własny terminal i działa niezależnie.

Dostosuj konfigurację

Edytuj CLAUDE.md bezpośrednio z AgentsRoom, aby dać agentom lepszy kontekst. Zmienić modele, dostosować uprawnienia, skonfigurować haki. Dodaj więcej agentów z różnych ról lub dostawców.

Tip: Opus dla architektury. Sonnet dla dev. Haiku dla szybkich zadań, takich jak testy.

Porady i sztuczki

1.Użyj Opus do decyzji architektonicznych, Sonnet do codziennego kodowania, Haiku do szybkich zadań

2.Projekty grupowe według stref (Praca, Personal, Projekty boczne) dla lepszej organizacji

3.Edytuj CLAUDE.md z AgentsRoom, aby dać agentom lepszy kontekst projektu

4.Włącz powiadomienia macOS, dzięki czemu można wielozadaniowe podczas pracy agentów

5.Zacznij od jednego agenta na projekt, dodaj więcej, jak się wygodnie

Rozwiązywanie problemów

Mój terminal agenta wygląda na pusty lub zablokowany

Większość czasu CLI nie jest wpisany. Otwórz regularny terminal (Terminal.app), uruchom polecenie CLI sam (claude, Codex, gemini, opencode), ukończ sygnalizację przeglądarki, a następnie wróć do AgentsRoom i uruchom agenta ponownie. AgentsRoom nie ma własnego ekranu logowania: Auth mieszka w CLI.

polecenie nie znaleziono: claude (lub kod, gemini itp.)

CLI nie jest zainstalowany lub powłoka PATH nie widzi go. Uruchom ponownie polecenie instalacji z poziomu 0 powyżej. Jeśli korzystasz z nvm, zainstaluj CLI z tą samą wersją węzła, którą używasz dzień-do-dnia, inaczej binarny nie będzie w PATH, kiedy AgentsRoom uruchamia.

Nie widzę przycisku do logowania się do ChatGPT lub Claude wewnątrz AgentsRoom

Z założenia. AgentsRoom jest UI na szczycie CLI i nigdy nie obsługuje swoich referencji bezpośrednio. Sign- in odbywa się raz wewnątrz CLI (uruchomić claude lub kod w terminalu), a następnie AgentsRoom używa tej sesji. To sprawia, że AgentsRoom jest bezpieczniejszy niż narzędzia przechwytujące twoje żetony.

Agent utknął na "myślenie"

Sprawdź, czy subskrypcja lub API key jest aktywna dla wybranego dostawcy. Spróbuj uruchomić CLI bezpośrednio w terminalu, aby zobaczyć prawdziwy komunikat błędu: Claude lub OpenAI czasami przepustnica lub wygasnąć sesje cicho.

Brak projektów w pasku bocznym

Upewnij się, że podczas tworzenia projektu wybrałeś prawidłowy folder. Folder musi istnieć na dysku. Przywróć AgentsRoom, jeśli projekt został dodany, ale jeszcze nie widoczny.

Zainstalowałem CLI, ale AgentsRoom nadal mówi "polecenie nie znaleziono"

AgentsRoom dziedziczy swój PATH z Twojej powłoki logowania, a nie z interaktywnego terminala. Zakończ AgentsRoom całkowicie, otwórz nowy terminal, weryfikuj CLI jest do wywołania ze świeżej sesji powłoki (który klaude), a następnie ponownie uruchomić AgentsRoom.