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

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

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

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

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

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

✓Windows 10+, macOS 14+ (Sonoma) или современный 64-битный дистрибутив Linux
✓
Установлен хотя бы один CLI для AI-кодинга (Claude, Codex, GitHub Copilot CLI, Cursor или любой из 15 других CLI-агентов, которые поддерживает AgentsRoom)
curl -fsSL https://claude.ai/install.sh | bash
✓Активная подписка или API key для выбранного вами провайдера

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

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

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

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

Работает с

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

1. Установка

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

2. Вход

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

3. Проверка

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

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

Работает с

ChatGPT Plus, Pro, Team или Enterprise либо OpenAI API key.

1. Установка

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Вход

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

3. Проверка

Antigravity CLI (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/v2/install | bash

2. Вход

Запустите opencode и добавьте ключ провайдера или подписку OpenCode Go командой /connect.

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. Проверка

CursorВаш редактор, в терминале

Работает с

Аккаунт Cursor. Ваш текущий тариф покрывает CLI; на бесплатном тарифе доступен меньший набор моделей.

1. Установка

curl https://cursor.com/install -fsS | bash

2. Вход

Запустите cursor-agent login, чтобы войти через браузер. Конфигурация хранится в ~/.cursor.

3. Проверка

Kimi (Moonshot AI)Контекст до 1M

Работает с

Аккаунт 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. Проверка

FreebuffКлюч не нужен

Работает с

Не нужна. Сервис бесплатный и финансируется текстовой рекламой, которая показывается между ходами.

1. Установка

npm install -g freebuff

2. Вход

Запустите freebuff в своём проекте. Есть команда freebuff login, если вы хотите привязать аккаунт Codebuff.

3. Проверка

oh-my-piБолее 60 бэкендов

Работает с

То, за что вы уже платите: он входит в Anthropic, OpenAI, Google, xAI, Z.ai, DeepSeek и другие сервисы или принимает обычный ключ API.

1. Установка

curl -fsSL https://omp.sh/install | sh

2. Вход

Запустите omp один раз, затем используйте /login, чтобы подключить провайдера. Конфигурация хранится в ~/.omp.

3. Проверка

Pi (Earendil)Минималистичный и расширяемый

Работает с

То, за что вы уже платите: Pi входит в Anthropic, OpenAI, Google, GitHub Copilot и многие другие сервисы или принимает обычный ключ API.

1. Установка

curl -fsSL https://pi.dev/install.sh | sh

2. Вход

Запустите pi один раз, затем используйте /login, чтобы подключить провайдера. Конфигурация хранится в ~/.pi/agent.

3. Проверка

DevinОдин тариф, много моделей

Работает с

Тариф Devin или Windsurf, включая бесплатный. Одна и та же подписка покрывает Claude, GPT, Gemini и SWE-модели Cognition.

1. Установка

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

2. Вход

Запустите devin auth login, чтобы войти через браузер. Конфигурация хранится в ~/.config/devin.

3. Проверка

Command CodeВыбирайте открытые и проприетарные модели

Работает с

Аккаунт Command Code или API-ключ COMMAND_CODE_API_KEY. Доступ к моделям и лимиты использования зависят от вашего аккаунта у провайдера.

1. Установка

npm install -g command-code@latest

2. Вход

Выполните command-code login для входа или задайте COMMAND_CODE_API_KEY в переменных окружения. Затем запустите command-code в своём проекте.

3. Проверка

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

Работает с

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

1. Установка

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

2. Вход

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

3. Проверка

Muse Code (Meta)Muse Spark в вашем терминале

Работает с

Аккаунт Meta с доступом к Muse Code или API-ключ META_API_KEY. Доступ и лимиты использования определяет Meta.

1. Установка

curl -fsSL https://dev.meta.ai/install.sh | sh

2. Вход

Выполните muse login для входа или задайте META_API_KEY в переменных окружения. Затем запустите muse в своём проекте.

3. Проверка

AiderДля опытных пользователей

Работает с

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

1. Установка

command -v uv >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install --python 3.12 aider-chat

2. Вход

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

3. Проверка

Amp (Sourcegraph)Режимы, а не модели

Работает с

Аккаунт Amp (вход через браузер) или токен AMP_API_KEY.

1. Установка

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

2. Вход

Запустите amp login один раз в любом терминале, чтобы войти. Настройки хранятся в ~/.config/amp.

3. Проверка

MiniMax Code (MiniMax)Модели серии M

Работает с

Аккаунт MiniMax (вход через браузер) или API-ключ MiniMax.

1. Установка

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

2. Вход

Выполните в терминале mcode login --region global (или mcode login для аккаунта из материкового Китая). Конфигурация находится в ~/.minimax.

3. Проверка

ZCode (клиент от сообщества)Модели GLM, не от Z.ai

Работает с

Тариф Z.ai или BigModel либо API-ключ. Этот клиент от сообщества не выпускается и не одобрен Z.ai.

1. Установка

npm install -g zcode-app-cli@latest

2. Вход

Запустите zcode один раз в терминале, затем введите /login, чтобы войти с аккаунтом Z.ai или BigModel. Требуется Node.js 22.19 или новее. Конфигурация находится в ~/.zcode.

3. Проверка

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

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

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

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

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

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

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.

command not found: claude (или codex, antigravity и т.д.)

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

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

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

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

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

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

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

Я установил CLI, но AgentsRoom по-прежнему пишет "command not found"

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