Установка среды выполнения агента

Предиктор Икс работает с любыми инструментами программирования на базе ИИ, установленными на вашем компьютере. На этой странице показано, как установить каждый из 12 поддерживаемых инструментов, чтобы демон мог их обнаружить.

Среда выполнения (runtime) в Предиктор Икс — это демон на вашем компьютере, сопряженный с одним из инструментов программирования на базе ИИ, который демон обнаружил в вашей переменной PATH. Если на этапе настройки «Подключение среды выполнения» отображается сообщение No supported tools detected (Инструменты не найдены), это означает, что демон просканировал PATH и не нашел ни одного из 12 поддерживаемых инструментов. Установите один (или несколько) из инструментов, перечисленных ниже, затем вернитесь к этому шагу и запустите повторное сканирование — среда выполнения появится в течение нескольких секунд.

Эта страница является дополнением к следующим материалам:

Демон и среды выполнения — как работает обнаружение
Матрица инструментов для ИИ-программирования — возможности каждого инструмента (возобновление сессии, MCP, выбор модели)

Сервер Предиктор Икс никогда не видит ваши API-ключи или сами инструменты. Всё, что описано ниже — установка, аутентификация, доступ к моделям — происходит исключительно на вашем локальном компьютере. Если что-то не работает, проблема почти всегда локальна.

Перед началом

Два обязательных условия для каждого инструмента ниже:

Демон Предиктор Икс должен быть запущен. Либо выполните команду predictorx daemon start после установки CLI Предиктор Икс, либо используйте настольное приложение Предиктор Икс, которое запускает демона автоматически. Без запущенного демона инструменты не будут обнаружены.
Бинарный файл инструмента должен быть доступен в PATH. Демон вызывает каждый инструмент по имени (см. столбец Daemon looks for в каждом разделе). Если команда which <name> не находит его в вашем терминале, демон также его не найдет. После установки откройте новый терминал (или перезапустите демона), чтобы изменения в PATH вступили в силу.

После установки инструмента перезапустите демона:

predictorx daemon restart

Или просто перезапустите настольное приложение. Демон повторно сканирует PATH при каждом запуске.

12 поддерживаемых инструментов

Список от наиболее часто используемых к менее распространенным. Выберите те, для которых у вас уже есть учетные данные — вам не обязательно иметь все 12.

Claude Code (Anthropic)

Наиболее полная интеграция. Поддерживается возобновление сессии, MCP, и инструмент учитывает поле mcp_config у агентов (см. матрицу).


Имя для демона	`claude`
Установка	Следуйте официальному руководству на claude.com/claude-code. Стандартный способ — установка npm-пакета `@anthropic-ai/claude-code` (требуется Node.js 18+).
Аутентификация	Запустите `claude` один раз и следуйте процессу входа в CLI, либо установите переменную `ANTHROPIC_API_KEY`.
Примечания	Рекомендуемый выбор для новых пользователей.

Codex (OpenAI)

Транспорт JSON-RPC 2.0 с более тонкими настройками контроля доступа. Конфигурация MCP записывается в файл $CODEX_HOME/config.toml для каждой задачи. Возобновление сессии работает через thread/resume сервера приложений Codex; устаревшие или отсутствующие потоки возвращаются к новому потоку.


Имя для демона	`codex`
Установка	Следуйте официальному руководству на github.com/openai/codex. Стандартный способ — установка npm-пакета `@openai/codex`.
Аутентификация	`codex login` (через браузер) или использование `OPENAI_API_KEY`.

Cursor (Anysphere)

Аналог CLI для редактора Cursor. Возобновление сессии работает в текущих релизах Cursor Agent: Предиктор Икс считывает session_id из событий stream-json и передает его обратно с помощью --resume <id>.


Имя для демона	`cursor-agent`
Установка	Установите редактор Cursor, затем CLI согласно их документации на docs.cursor.com. Имя бинарного файла — `cursor-agent`, а не `cursor`.
Аутентификация	Выполните вход через редактор Cursor; CLI повторно использует эту сессию.

GitHub Copilot

Маршрутизация моделей осуществляется через вашу подписку GitHub — инструмент не выбирает модель самостоятельно; GitHub решает, какая модель вам доступна.


Имя для демона	`copilot`
Установка	См. документацию GitHub CLI на github.com/github/copilot-cli.
Аутентификация	Вход в GitHub через браузер в CLI.
Примечания	Требуется активная подписка GitHub Copilot для учетной записи.

Gemini (Google)

Поддерживает серии Gemini 2.5 и 3. Нет возобновления сессии, нет MCP — подходит для одноразовых задач.


Имя для демона	`gemini`
Установка	Следуйте официальному руководству на github.com/google-gemini/gemini-cli. Стандартный способ — установка npm-пакета `@google/gemini-cli`.
Аутентификация	`gemini` предложит войти в Google-аккаунт или установить `GEMINI_API_KEY`.

OpenCode (SST)

Агент с открытым исходным кодом. Динамически обнаруживает доступные модели из собственного файла конфигурации — подходит пользователям, желающим использовать свой каталог моделей. Потребляет поле mcp_config агента через OPENCODE_CONFIG_CONTENT.


Имя для демона	`opencode`
Установка	Следуйте руководству на opencode.ai или репозиторию github.com/sst/opencode. Обычно устанавливается через скрипт или npm.
Аутентификация	Настройте провайдеры моделей согласно документации OpenCode (Anthropic, OpenAI и др.).

Kiro CLI (Amazon)

Транспорт ACP-over-stdio. Возобновление сессии работает через session/load протокола ACP; конфигурация MCP передается через mcpServers; навыки копируются в .kiro/skills/.


Имя для демона	`kiro-cli`
Установка	См. документацию Kiro на kiro.dev. Имя файла — `kiro-cli`, а не `kiro`.
Аутентификация	На основе учетной записи AWS; следуйте процессу onboarding Kiro.

Kimi (Moonshot)

Агент на протоколе ACP, ориентированный на китайский рынок. Конфигурация MCP передается через mcpServers; навыки находятся в .kimi/skills/ (автоматическое обнаружение).


Имя для демона	`kimi`
Установка	Следуйте руководству на github.com/MoonshotAI/kimi-cli.
Аутентификация	API-ключ Moonshot, настроенный согласно документации поставщика.

Hermes (Nous Research)

Агент на протоколе ACP. Возобновление сессии работает, конфигурация MCP передается через mcpServers. Путь внедрения навыков — стандартный .agent_context/skills/.


Имя для демона	`hermes`
Установка	См. репозиторий github.com/NousResearch.
Аутентификация	Согласно документации поставщика.

OpenClaw

Оркестратор агентов CLI с открытым исходным кодом. Конфигурация MCP материализуется через оболочку конфигурации задач Предиктор Икс. Модель привязана на уровне агента (openclaw agents add --model) — её нельзя переопределить для отдельной задачи, и вы не можете передать --model или --system-prompt из Предиктор Икс.


Имя для демона	`openclaw`
Установка	См. проект github.com/openclaw-org/openclaw.
Аутентификация	Настройте базовый провайдер моделей согласно документации OpenClaw.

Pi (Inflection AI)

Минималистичный агент. Возобновление сессии необычное — ID для возобновления является путь к файлу сессии на диске, а не строковый ID.


Имя для демона	`pi`
Установка	См. документацию CLI на pi.ai.
Аутентификация	Согласно документации поставщика.

Antigravity (Google)

CLI Antigravity от Google (agy). Работает с сервисом Antigravity и моделями Gemini. Возобновление сессии через --conversation <id>, который демон извлекает из лог-файла CLI. Выбор модели осуществляется внутри CLI Antigravity — Предиктор Икс отключает выбор модели для этого провайдера. Навыки записываются в .agents/skills/.


Имя для демона	`agy`
Установка	Следуйте руководству на antigravity.google/docs/cli-overview. Запустите `agy install` для настройки PATH и псевдонимов оболочки.
Аутентификация	Запустите `agy` интерактивно для входа в Google-аккаунт или используйте десктопное приложение.
Примечания	CLI выводит текст в stdout, а не структурированный поток событий; промежуточные сообщения и ответ транслируются в Предиктор Икс как текст.

После установки

Убедитесь, что бинарный файл находится в PATH. Откройте новый терминал и выполните which <name> (например, which claude). Если путь найден, демон его увидит. Если нет, исправьте переменную PATH.
Перезапустите демона. predictorx daemon restart или перезапуск приложения.
Проверьте страницу Runtimes. В пользовательском интерфейсе Предиктор Икс на странице Runtimes должна появиться строка для комбинации «рабочая область × инструмент». Если статус "offline", см. раздел об ошибках подключения.
Вернитесь к onboarding. Шаг «Connect a runtime» автоматически обнаружит новую среду в течение нескольких секунд.

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

which находит файл, а демон — нет. Демон был запущен со старым PATH. Перезапустите его.
Бинарный файл есть, но запуск не удается. Запустите --version или --help для инструмента в терминале — проверьте наличие авторизации и истекших токенов.
Страница Runtimes показывает строку, но задачи завершаются ошибкой. Проверьте логи: predictorx daemon logs -f.

Для более широкого списка симптомов см. Руководство по устранению неполадок.

Демон и среды выполнения — принципы работы, Heartbeat и обработка офлайн-состояния
Матрица ИИ-инструментов — различия в функциональности
Создание и настройка агентов — выбор инструментов и запуск задач