Налаштуйте свого першого агента

Від свіжої установки до працюючого AI-агента. Дві частини, які найчастіше пропускають новачки, знаходяться на початку: як AgentsRoom пов'язаний з AI CLI, і як увійти в систему.

Як працює AgentsRoom (прочитайте це спочатку)

AgentsRoom: це кабіна. AI CLI (Claude Code, Codex, OpenCode, Antigravity, Aider, Grok Build, Mistral Vibe, Kimi Code): це двигуни. Ви входите в двигуни один раз через їх власну команду, а потім AgentsRoom керує ними візуально. AgentsRoom ніколи не зберігає і не бачить ваші токени, API-ключі або пароль ChatGPT: вони залишаються в безпечному сховищі кожного CLI на вашому комп'ютері.

У AgentsRoom за задумом немає кнопки "Увійти в ChatGPT" або "Увійти в Anthropic". Вхід здійснюється в CLI, який ви встановлюєте на етапі 0 нижче.

Перед початком

✓Windows 10+, macOS 14+ (Sonoma) або сучасна 64-бітна дистрибуція Linux
✓
Встановлено принаймні один AI CLI для кодування (Claude, Codex, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe або Kimi Code)
наприклад, npm install -g @anthropic-ai/claude-code
✓Активна підписка або API-ключ для обраного провайдера

Крок 0: встановіть і увійдіть у свій AI-двигун

Виберіть одного провайдера для початку (ви можете додати більше пізніше). Для кожного: встановіть CLI, запустіть його один раз, щоб увійти, переконайтеся, що він працює. Потім переходьте до кроку 1.

Натисніть на провайдера, щоб розгорнути його кроки налаштування.

Claude (Anthropic)Рекомендовано для нових користувачів

Працює з

Claude Pro, Claude Max або API-ключ Anthropic.

1. Встановіть

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

2. Увійдіть у систему

Запустіть claude один раз у будь-якому терміналі. Відкриється вікно браузера для входу з вашим обліковим записом Anthropic.

3. Перевірте

Запустіть команду встановлення вище, потім запустіть CLI, ввівши його назву в терміналі (наприклад, введіть "claude" і натисніть enter). Ви повинні побачити вітальне повідомлення. Введіть "hello" і натисніть enter: якщо ви отримали відповідь, ви готові використовувати його в AgentsRoom.

Codex (OpenAI / ChatGPT)Використовуйте свій обліковий запис ChatGPT

Працює з

ChatGPT Plus, Pro, Team або Enterprise, або ключ API OpenAI.

1. Встановіть

npm install -g @openai/codex

2. Увійдіть у систему

Запустіть codex один раз у будь-якому терміналі. Відкриється вікно браузера. Увійдіть за допомогою свого облікового запису ChatGPT, того самого, який ви використовуєте на chatgpt.com.

3. Перевірте

Antigravity (Google)Доступний безкоштовний рівень

Працює з

Обліковий запис Google (вхід через браузер). Доступний щедрий безкоштовний рівень.

1. Встановіть

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

2. Увійдіть у систему

Запустіть antigravity один раз у будь-якому терміналі. Відкриється вікно браузера для входу в Google.

3. Перевірте

OpenCodeВикористовуйте свого провайдера

Працює з

Будь-який провайдер, якого ви налаштуєте: Anthropic, OpenAI, OpenRouter та інші.

1. Встановіть

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

2. Увійдіть у систему

Запустіть opencode auth login і дотримуйтесь підказок, щоб додати ключ провайдера.

3. Перевірте

AiderПросунуті користувачі

Працює з

Будь-який провайдер через ключ API (Anthropic, OpenAI, DeepSeek та інші).

1. Встановіть

python -m pip install -U --upgrade-strategy only-if-needed aider-chat

2. Увійдіть у систему

Команда входу відсутня. Встановіть свій ключ API як змінну середовища у профілі оболонки, наприклад: export ANTHROPIC_API_KEY=sk-...

3. Перевірте

Grok Build (xAI)256K контекст

Працює з

Обліковий запис xAI (вхід через браузер) або ключ API Grok для безголового використання.

1. Встановіть

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

2. Увійдіть у систему

Запустіть grok один раз у будь-якому терміналі. Відкриється вікно браузера для входу в xAI. Для безголового використання встановіть змінну середовища GROK_CODE_XAI_API_KEY.

3. Перевірте

Mistral VibeЄвропейські моделі

Працює з

Обліковий запис Mistral (Pro або Team) або ключ API Mistral.

1. Встановіть

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

2. Увійдіть у систему

Запустіть vibe --setup один раз, щоб зберегти свій ключ API Mistral, потім запустіть vibe для початку. Конфігурація зберігається у ~/.vibe/config.toml.

3. Перевірте

Kimi (Moonshot AI)До 1М контексту

Працює з

Обліковий запис Kimi (вхід через браузер) або ключ API платформи Moonshot AI Open Platform.

1. Встановіть

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

2. Увійдіть у систему

Запустіть kimi один раз у будь-якому терміналі, потім введіть /login, щоб увійти з вашим обліковим записом Kimi. Конфігурація зберігається в ~/.kimi-code.

3. Перевірте

Застрягли на цьому кроці? Дивіться розділ усунення несправностей внизу цієї сторінки.

Завантажте та встановіть AgentsRoom

Завантажте інсталятор для вашої операційної системи: .dmg для macOS, .exe для Windows або AppImage для Linux. Відкрийте його, дотримуйтесь кроків встановлення, потім запустіть AgentsRoom.

Tip: AgentsRoom автоматично перевіряє наявність оновлень. Ви будете повідомлені, коли нова версія стане доступною.

Створіть свій перший проект

Натисніть кнопку + на бічній панелі. Виберіть будь-яку папку на вашому комп'ютері. Тут ваші AI агенти будуть працювати. Назвіть ваш проект і призначте його до зони.

Tip: Кожен проект відповідає реальній папці. Агенти запускають CLI обраного вами провайдера в цьому каталозі, так само, як ви б робили це в терміналі.

Додайте свого першого агента

У вашому проекті натисніть Додати агента. Виберіть роль (Fullstack - хороший початок), потім провайдера (двигун, який ви налаштували на кроці 0), потім модель (Sonnet рекомендується для Claude). За бажанням напишіть початковий запит і натисніть Запустити. Термінал відкриється і запустить CLI за вас.

Tip: Якщо термінал виглядає порожнім або показує екран входу, CLI з кроку 0 ще не увійшов. Відкрийте звичайний термінал, запустіть claude або codex (або команду вашого провайдера) один раз, завершіть вхід, потім поверніться.

Спостерігайте за роботою

Термінал показує живий вивід: кожен файл, що читається, кожне редагування. Зміни статусу: обмірковування, кодування, завершено. Ви отримуєте сповіщення на робочому столі, коли це закінчиться.

Tip: Ви можете запускати кілька агентів одночасно. Кожен отримує свій власний термінал і працює незалежно.

Налаштуйте свою конфігурацію

Редагуйте CLAUDE.md безпосередньо з AgentsRoom, щоб надати агентам кращий контекст. Змініть моделі, налаштуйте дозволи, конфігуруйте хуки. Додайте більше агентів з різними ролями або провайдерами.

Tip: Opus для архітектури. Sonnet для розробки. Haiku для швидких завдань, таких як тести.

Поради та хитрощі

1.Використовуйте Opus для архітектурних рішень, Sonnet для щоденного кодування, Haiku для швидких завдань

2.Групуйте проекти за зонами (Робота, Особисте, Побічні проекти) для кращої організації

3.Редагуйте CLAUDE.md з AgentsRoom, щоб надати агентам кращий контекст проекту

4.Увімкніть сповіщення на робочому столі, щоб ви могли виконувати кілька завдань одночасно, поки агенти працюють

5.Почніть з одного агента на проєкт, додавайте більше, коли будете готові

Усунення несправностей

Мій термінал агента виглядає порожнім або завис

Зазвичай CLI не увійшов у систему. Відкрийте свій термінал (Terminal на macOS, PowerShell або Windows Terminal на Windows, ваш емулятор терміналу на Linux), запустіть команду CLI окремо (claude, codex, antigravity, opencode), завершіть вхід у браузері, потім поверніться до AgentsRoom і знову запустіть агента. AgentsRoom не має власного екрану входу: авторизація відбувається в CLI.

команду не знайдено: claude (або codex, antigravity, тощо)

CLI не встановлено, або ваш shell PATH не бачить його. Повторно запустіть команду встановлення з кроку 0 вище. Якщо ви використовуєте nvm, встановіть CLI з тією ж версією Node, яку ви використовуєте щодня, інакше бінарний файл не буде в PATH, коли AgentsRoom запускається.

Я не бачу кнопки для входу в ChatGPT або Claude всередині AgentsRoom

Так задумано. AgentsRoom є інтерфейсом поверх CLI і ніколи не обробляє ваші облікові дані безпосередньо. Вхід здійснюється один раз всередині CLI (запустіть claude або codex у терміналі), потім AgentsRoom використовує цю сесію. Це робить AgentsRoom безпечнішим, ніж інструменти, які перехоплюють ваші токени.

Агент завис на "обмірковуванні"

Перевірте, чи активна ваша підписка або API ключ для обраного постачальника. Спробуйте запустити CLI безпосередньо у вашому терміналі, щоб побачити справжнє повідомлення про помилку: Claude або OpenAI іноді обмежують або завершують сесії без попередження.

У боковій панелі не відображаються проєкти

Переконайтеся, що ви вибрали дійсну папку при створенні проєкту. Папка повинна існувати на диску. Перезапустіть AgentsRoom, якщо проєкт був доданий, але ще не видно.

Я встановив CLI, але AgentsRoom все ще каже "команду не знайдено"

AgentsRoom успадковує свій PATH від вашої оболонки входу, а не від вашого інтерактивного терміналу. Повністю закрийте AgentsRoom, відкрийте новий термінал, перевірте, чи CLI викликається з нової сесії оболонки (which claude), потім знову запустіть AgentsRoom.