Horizon: подключение собственного персонажа к Codex или Claude Code

Нужны Node.js 22 или новее, установленный Horizon и Codex/Claude Code.
Клиент Horizon остаётся запущенным на компьютере игрока. Учётная запись
сервера не получает прав администратора.

1. Зайдите на сервер и выполните обычный /login.
2. В Horizon включите Agent Control: настройки Horizon → AI Agent.
3. В чате сервера выполните /ai link и скопируйте одноразовый код.
4. В терминале выполните:

   node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs pair --server https://80.240.18.46 --code КОД

Если horizon-ctl не найден автоматически, укажите его файл:

   node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs pair --server https://80.240.18.46 --code КОД --ctl /ПУТЬ/horizon-ctl

Для нестандартного control socket добавьте --socket /ПУТЬ/К/СОКЕТУ.

5. Подключите MCP к нужному приложению:

   node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs install --client both

Можно выбрать --client codex или --client claude. Существующая запись
horizon-player не перезаписывается. Перезапустите приложение агента, если
новый MCP не появился в текущей сессии.

Альтернатива — ручная настройка MCP:

   codex mcp add horizon-player -- node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs mcp --agent codex
   claude mcp add --scope user horizon-player -- node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs mcp --agent claude

На Windows, если автоматическая установка не запускает npm-обёртки .cmd,
выполните эти ручные команды в PowerShell. Пути с пробелами заключите в кавычки.

6. Попросите агента: «Подключись к моему персонажу через horizon-player,
вызови begin_control и осмотрись. После задачи вызови end_control».

Сначала сервер проверит, что подключён именно привязанный персонаж.
После подтверждения появится метка Codex или Claude. Метка сообщает
заявленный тип управляющего клиента; она не является сертификатом провайдера.
Одновременно персонажем управляет один агент. Простое обнаружение MCP-инструментов
не включает управление и не меняет действия человека.

Инструменты позволяют читать состояние, передвигаться, добывать и ставить
блоки, пользоваться инвентарём и получать снимок экрана. Доступ выдаётся
только после begin_control. Читы, серверная консоль и доступ к локальным
файлам через MCP не предоставляются.

Остановка: попросите end_control или выполните /ai off в игре.
Отозвать привязку на сервере: /ai revoke.
Проверить локальную настройку:
   node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs status
Отозвать привязку и удалить локальные данные:
   node /ПОЛНЫЙ/ПУТЬ/horizon-agent.mjs unlink

Файл привязки хранит секретный токен. Не пересылайте его другим игрокам.
macOS: ~/Library/Application Support/horizon-agent-link/profile.json
Linux: ~/.config/horizon-agent-link/profile.json (или XDG_CONFIG_HOME)
Windows: %LOCALAPPDATA%/horizon-agent-link/profile.json

Привязку можно хранить отдельно через --config /ПОЛНЫЙ/ПУТЬ/profile.json;
одинаковый --config нужно использовать при pair, install, status и unlink.