Создайте своего первого агента

От новой установки до работающего агента ИИ. Две части, которые большинство новичков пропускают, находятся наверху: как AgentsRoom относится к AI CLIs и как войти в систему.

Как работает AgentsRoom (читайте сначала)

AgentsRoom — кабина пилота. Двигателями являются AI CLI (Claude Code, Codex, OpenCode, Gemini, Aider). Вы входите в двигатели один раз по их собственной команде, а затем AgentsRoom управляет ими визуально. AgentsRoom никогда не хранит и не видит ваши токены, API keys или пароль ChatGPT: они остаются внутри собственного безопасного хранилища CLI на вашем компьютере.

Нет кнопки «Войти в ChatGPT» или «Войти в Anthropic» внутри AgentsRoom по дизайну. Логин живет в CLI, который вы устанавливаете на шаге 0 ниже.

Прежде чем начать

✓macOS 14+ (Sonoma или более поздняя версия)
✓
Установлено по меньшей мере одно кодирование CLI (Claude, Codex, OpenCode, Gemini CLI или Aider)
npm install -g @anthropic-ai/claude-code
✓Активная подписка или API key для выбранного вами провайдера

Шаг 0: установите и войдите в свой движок AI

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

Нажмите на провайдера, чтобы расширить свои шаги настройки.

Claude (Anthropic)Рекомендуется для начинающих пользователей

Работать с

Claude Pro, Claude Max или Anthropic API key.

1.Установка

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

2.Подпишитесь

Беги клод в любой терминал. Окно браузера открывается для входа с вашей учетной записью Anthropic.

3.Проверить

Запустите команду установки выше, затем запустите имя CLI в вашем терминале (например, введите «claude» и нажмите «Enter»). Вы должны увидеть приветственное предложение. Введите «привет» и нажмите «введите»: если вы получите ответ, вы готовы использовать его внутри AgentsRoom.

Codex (OpenAI / ChatGPT)Используйте учетную запись ChatGPT

Работать с

ChatGPT Плюс, Pro, Team или Enterprise или OpenAI API key.

1.Установка

npm install -g @openai/codex

2.Подпишитесь

Запустите кодек один раз в любом терминале. Открывается окно браузера. Войдите в свою учетную запись ChatGPT, ту же, которую вы используете на chatgpt.com.

3.Проверить

OpenCodeПриведите своего поставщика

Работать с

Любой настроенный вами провайдер: Anthropic, OpenAI, OpenRouter и многое другое.

1.Установка

npm install -g opencode-ai

2.Подпишитесь

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

3.Проверить

Gemini CLI (Google)Бесплатный уровень доступен

Работать с

Учетная запись Google (доступен бесплатный уровень) или Gemini API key.

1.Установка

npm install -g @google/gemini-cli

2.Подпишитесь

Беги за Джемини один раз. Окно браузера открывается для входа в систему Google.

3.Проверить

AiderМощные пользователи

Работать с

Любой провайдер через API key (Anthropic, OpenAI, DeepSeek и другие).

1.Установка

pip install aider-chat

2.Подпишитесь

Нет команды входа. Установите API key в качестве переменной среды в профиле оболочки, например: экспорт ANTHROPIC API KEY=sk-...

3.Проверить

Застрял на этом шаге? Смотрите раздел устранения неполадок внизу этой страницы.

Скачать и установить AgentsRoom

Загрузите файл .dmg, откройте его и перетащите AgentsRoom в папку «Приложения». Запустите его из Spotlight или папки Приложения.

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

Создайте свой первый проект

Нажмите кнопку + на боковой панели. Выберите любую папку на вашем компьютере. Именно здесь будут работать ваши агенты. Назовите свой проект и присвоите ему зону.

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

Добавьте первого агента

Внутри вашего проекта нажмите «Добавить агента». Выберите роль (Fullstack - хороший старт), затем поставщика (двигатель, который вы настроили на шаге 0), затем модель (Sonnet рекомендуется для Claude). Опционально напишите начальную подсказку и нажмите Пуск. Терминал открывает и запускает CLI для вас.

Tip: Если терминал выглядит пустым или показывает экран входа, CLI с этапа 0 еще не подписан. Откройте обычный терминал, запустите клод или кодек (или команду вашего провайдера) один раз, заполните вход, а затем вернитесь.

4.4

Смотри, как это работает

Терминал показывает живой выход: каждый файл читается, каждый редактируется. Изменение статуса: мышление, кодирование, выполнение. Вы получаете уведомление macOS, когда оно заканчивается.

Tip: Вы можете запустить несколько агентов одновременно. Каждый получает свой терминал и работает самостоятельно.

Настройка вашей настройки

Редактировать CLAUDE.md непосредственно из AgentsRoom, чтобы дать агентам лучший контекст. Меняйте модели, корректируйте разрешения, настраивайте крючки. Добавьте больше агентов с различными ролями или поставщиками.

Tip: Opus для архитектуры. Sonnet для разработчиков. Haiku для быстрых задач, таких как тесты.

Советы и трюки

1.Используйте Opus для архитектурных решений, Sonnet для ежедневного кодирования, Haiku для быстрых задач

2.Групповые проекты по зонам (рабочие, личные, побочные) для лучшей организации

3.Отредактировать CLAUDE.md от AgentsRoom, чтобы дать агентам лучший контекст проекта

4.Включите уведомления macOS, чтобы вы могли выполнять многозадачную работу во время работы агентов

5.Начните с одного агента на проект, добавьте больше, когда вам будет удобно

Устранение неполадок

Мой агентский терминал выглядит пустым или застрял

В большинстве случаев CLI не регистрируется. Откройте обычный терминал (Terminal.app), запустите только команду CLI (claude, codex, gemini, opencode), заполните вход в браузер, затем вернитесь в AgentsRoom и снова запустите агент. AgentsRoom не имеет собственного экрана входа: аут живет в CLI.

команда не найдена: claude (или codex, gemini и т.д.)

CLI не установлен, или ваша оболочка PATH не видит его. Перезапустите команду установки с шага 0 выше. Если вы используете nvm, установите CLI с той же версией узла, которую вы используете ежедневно, иначе двоичный код не будет в PATH при запуске AgentsRoom.

Я не вижу кнопки для входа в ChatGPT или Claude внутри AgentsRoom

По дизайну. AgentsRoom - это пользовательский интерфейс поверх CLIs и никогда не обрабатывает ваши учетные данные напрямую. Вход осуществляется один раз внутри CLI (запуск клауда или кодекса в терминале), затем AgentsRoom использует этот сеанс. Это то, что делает AgentsRoom более безопасным, чем инструменты, которые перехватывают ваши токены.

Агент застрял на "мышлении"

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

Никаких проектов на боковой панели

Убедитесь, что вы выбрали правильную папку при создании проекта. Папка должна существовать на диске. Перезагрузите AgentsRoom, если проект был добавлен, но еще не виден.

Я установил CLI, но AgentsRoom по-прежнему говорит, что команда не найдена

AgentsRoom наследует свой PATH из вашей оболочки входа, а не из вашего интерактивного терминала. Откажитесь от AgentsRoom полностью, откройте новый терминал, проверьте, что CLI можно вызвать из новой сессии оболочки (которая кладут), а затем перезапустите AgentsRoom.