Навыки
В Just Run слово навык обозначает две разные точки расширения. Плагин Just Run добавляет навыки, которые управляют Just Run из вашего Claude Code или Codex. Навыки песочницы устанавливаются внутрь песочницы для Claude Code, запущенного в гостевом окружении.
У них разные места установки, учетные данные и жизненные циклы. Установка одного не устанавливает другое.
Навыки плагина и навыки песочницы
| Навык плагина | Навык песочницы | |
|---|---|---|
| Потребитель | Claude Code или Codex на вашем компьютере | Claude Code внутри песочницы Just Run |
| Кто устанавливает | Менеджер плагинов Claude Code или Codex из маркетплейса Just Run | Асинхронная подготовка песочницы после загрузки |
| Место установки | Ваш профиль Claude Code или домашний каталог Codex | ~/.claude/skills/ для пользователя песочницы по умолчанию |
| Источник | Плагин Just Run: шесть навыков и подключение к MCP | SKILL.md, написанный вручную, удаленный источник или результат поиска skills.sh |
| Авторизация | Вход по OAuth в ваш аккаунт Just Run | Не выдает дополнительных прав платформы; установка выполняется внутри песочницы |
Плагин Just Run для Claude Code и Codex
Один плагин подключает Claude Code или Codex к MCP управления платформой Just Run и добавляет шесть навыков для частых задач. Вы описываете задачу в чате, навык ассистент выбирает сам.
claude plugin marketplace add ──► claude plugin install ──► /mcp → Authenticate
│
«опубликуй эту папку как сайт» ────────┴──► skill ──► MCP just-run
Установка и вход
Claude Code
Нужен Claude Code 2.1.292 или новее. В терминале:
claude plugin marketplace add https://platform.just-run.app/plugins/marketplace.json
claude plugin install just-run@just-run
Внутри сессии Claude Code то же делают команды /plugin marketplace add … и
/plugin install just-run@just-run.
Затем запустите claude, выполните /mcp, выберите сервер plugin:just-run:just-run и пункт
Authenticate. В браузере откроется вход в Just Run; после согласия Claude
Code работает с вашим аккаунтом. Создавать и вставлять токен не нужно, переменные окружения и
локальные помощники плагину не нужны.
Подключение появится в разделе Токены веб-интерфейса Just Run, там его можно отозвать. Оно продлевается, пока Claude Code им пользуется, истекает после 30 дней без использования и не позже чем через 90 дней после согласия; после этого войдите снова.
Публичная страница Кодинг-ассистенты в веб-интерфейсе показывает эти
команды для установки, с которой она открыта, с переключателем между Claude Code
и Codex. Другая установка Just Run
(on-prem, тестовый стенд) отдает свой маркетплейс по адресу
<ее адрес>/plugins/marketplace.json, и плагин из него подключается к ней.
Чтобы направить установленный плагин на другой адрес, выполните
claude plugin configure just-run и задайте base_url без завершающего /.
Codex
Нужны Codex CLI 0.159 или новее и git в PATH: Codex забирает плагин как
Git-репозиторий. Windows не проверялся, приложение Codex desktop еще
проверяется. В терминале:
codex plugin marketplace add https://platform.just-run.app/plugins/codex.git
codex plugin add just-run@just-run
codex mcp login just-run
Вход: codex mcp login just-run открывает страницу входа Just Run в браузере;
после входа начните новый сеанс Codex. Другая установка
Just Run (on-prem, тестовый стенд) отдает свой репозиторий по адресу
<ее адрес>/plugins/codex.git, и плагин из него подключается к этой установке.
Настройки base_url в Codex нет: адрес берется оттуда, откуда плагин
установлен. Чтобы держать две установки рядом, задайте каждой свой
CODEX_HOME.
Навыки
| Навык | Что делает |
|---|---|
run-task | Разово выполняет команду, скрипт или ноутбук в песочнице и возвращает вывод и файлы с результатом |
automate-task | Создает и обслуживает автоматизации по расписанию cron и по вебхуку: проверка, изменение, пауза, удаление |
publish-site | Публикует готовый статический сайт — HTML или уже собранную папку — по публичной ссылке, обновляет по той же ссылке, откатывает и удаляет |
host-mcp-server | Разворачивает MCP-сервер из каталога Just Run или официального реестра MCP и дает команду для подключения |
manage-telegram-bot | Пишет, разворачивает и обслуживает Telegram-бота: обновление, статус и логи, задания по расписанию, пересоздание, удаление |
troubleshoot | Выясняет по состоянию, событиям и логам, почему песочница, сайт, автоматизация или сервер Hosted MCP работают не так, и исправляет в рамках вашей просьбы |
Навык включается сам, когда запрос ему подходит; в Claude Code /just-run:<skill>
запускает его явно. В Codex навыки называются just-run:<skill>. Все инструменты MCP
Just Run доступны и напрямую, без навыка.
publish-site пока не собирает проекты: соберите проект локально и опубликуйте
готовую папку.
Публичный GET /v1/skills/catalog и MCP-инструмент skills_catalog отдают
версию плагина, адрес маркетплейса, команды установки (Claude Code и Codex) и
список навыков. См.
справочник REST API.
Навык — это инструкции, а не граница прав. Он действует с правами аккаунта, под которым вы вошли, поэтому проверяйте, что он собирается создать, открыть наружу или удалить. Токены ботов и другие учетные данные храните в секретах, а не в чате.
Обновление и удаление
Плагин выходит вместе с релизом Just Run. В Claude Code, чтобы получить новую
версию, выполните claude plugin marketplace update just-run, затем
claude plugin update just-run@just-run и перезапустите Claude Code; удалить
плагин — claude plugin uninstall just-run@just-run (или в /plugin внутри
Claude Code). В Codex выполните
codex plugin marketplace upgrade; удалить плагин можно командой
codex plugin remove just-run@just-run. Удаление плагина не удаляет то, что его
навыки создали в вашем аккаунте.
Ограниченная сеть
Облачная сессия Claude Code или локальная песочница может пропускать исходящие
запросы только к разрешенным доменам. Добавьте в этот список хост Just Run
(platform.just-run.app для публичного сервиса): он нужен и для установки
плагина, и для каждой операции, потому что навыки работают через MCP-сервер на
этом хосте.
Навыки песочницы
Навыки песочницы относятся к созданию песочницы, а не к плагину Just Run.
Добавляйте их в форму создания песочницы в веб-интерфейсе,
пресет шаблона, REST skills[] или MCP
sandbox_create.
inline content ───────┐
remote source ────────┼──► create sandbox ──► async `skills` step
skills.sh selection ──┘ │
└──► ~/.claude/skills/
Схема создания принимает:
| Источник | Поведение |
|---|---|
content с необязательным name | Записывает содержимое напрямую как <name>/SKILL.md; при одновременном url приоритет у content |
url или сокращенная запись репозитория | Выполняет skills add <source> -y внутри песочницы |
| Поиск skills.sh в веб-интерфейсе | Преобразует выбранный результат в удаленный источник для того же установщика внутри песочницы |
Если запись, введенная вручную, не содержит имя, компонент подготовки создает
custom-skill-<index>. Удаленная установка поддерживает форматы источников,
которые принимает CLI skills в выбранном шаблоне.
Маршрут поиска во внешнем skills.sh требует вошедшего пользователя Just Run. Его результаты не входят в плагин Just Run и не проверяются Just Run.
Результат подготовки
Навыки устанавливаются после запуска VM. Поэтому успешное создание песочницы может
вернуться при provisioning.status: in_progress. Перед использованием
установленного навыка дождитесь терминального состояния подготовки.
Ошибки отдельных навыков песочницы считаются некритичными предупреждениями: они не
удаляют песочницу, а шаг skills может завершиться как ready с
предупреждениями. Проверяйте шаги подготовки, даже если сама песочница работает,
а сводный статус подготовки — ready.
После подготовки навыки песочницы становятся обычными файлами конкретной песочницы. Они сохраняются вместе с ее файловой системой при остановке и возобновлении, но не становятся записями каталога уровня аккаунта.
Безопасность источников и учетных данных
Считайте каждый навык песочницы — введенный вручную или удаленный — кодом и инструкциями, доступными агенту внутри гостя:
- проверяйте источник и используйте стабильную ревизию, когда важна воспроизводимость;
- ожидайте сетевые запросы из песочницы при удаленной установке;
- используйте токены репозиториев с минимально необходимыми правами для приватных источников;
- не встраивайте секреты в
SKILL.mdили URL источников; - передавайте учетные данные, нужные при выполнении, через секреты и настройки окружения песочницы.
Установщик внутри песочницы передает удаленной установке только поддерживаемые
переменные окружения с токенами Git, например GITHUB_TOKEN, GH_TOKEN,
GITLAB_TOKEN и GL_TOKEN. Эти учетные данные остаются частью периметра
безопасности песочницы.
Точки входа
| Способ | Система навыков | Для чего |
|---|---|---|
| Публичный веб-интерфейс → Кодинг-ассистенты | Плагин | Команды установки и список навыков |
GET /v1/skills/catalog, MCP skills_catalog | Плагин | Версия плагина, маркетплейс и навыки в машинном виде |
GET /plugins/marketplace.json | Плагин | Маркетплейс, из которого устанавливает Claude Code |
GET /plugins/codex.git/info/refs, /HEAD, /objects/… | Плагин | Git-репозиторий только для чтения, из которого устанавливает Codex |
| Форма Новая песочница → Навыки | Песочница | Искать, добавить удаленный источник или ввести содержимое вручную |
REST/MCP, создание песочницы, skills[] | Песочница | Устанавливать навыки вместе с новой песочницей |
REST /v1/skills/search | Песочница | Поиск с аутентификацией во внешнем каталоге skills.sh |
Подробнее о навыках
- Поиск навыков песочницы — skills.sh и прямые источники.
- Добавление навыков в песочницу — подготовка при создании и статус.
- Источники и версии — содержимое, введенное вручную, ссылки на удаленные источники и воспроизводимость.
- Безопасность и разрешения — доверие, учетные данные и границы выполнения.
- Справочник REST API — каталог, поиск и схемы создания песочницы.