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

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

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

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

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

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

✓Windows 10+, macOS 14+ (Sonoma) или современный 64-битный дистрибутив Linux
✓
Установлено по меньшей мере одно кодирование CLI (Claude, Codex, OpenCode, Gemini CLI, Aider, Grok Build или Mistral Vibe)
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.Проверить

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

Работать с

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

1.Установка

pip install aider-chat

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

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

3.Проверить

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

Работать с

Аккаунт xAI (вход через браузер) или Grok API key для headless-использования.

1.Установка

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

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

Запустите grok один раз в любом терминале. Откроется окно браузера для входа в xAI. Для headless-использования вместо этого задайте переменную среды GROK_CODE_XAI_API_KEY.

3.Проверить

Mistral VibeЕвропейские модели

Работать с

Аккаунт Mistral (Pro или Team) либо ключ Mistral API.

1.Установка

uv tool install mistral-vibe

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

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

3.Проверить

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

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

Скачайте установщик для своей операционной системы: .dmg для macOS, .exe для Windows или AppImage для Linux. Откройте его, выполните шаги установки, затем запустите AgentsRoom.

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 в macOS, PowerShell или Windows Terminal в Windows, ваш эмулятор терминала в Linux), запустите команду 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.