Обновлено:
Как пользоваться Muse Code: от установки до первой задачи
muse в проекте, подтвердите доверие к рабочей области, войдите в аккаунт и введите задачу. Работает в macOS, Linux и Windows. Настройка занимает около 10 минут. Всё, что ниже, — краткое изложение официальной документации Muse Code от Meta, со ссылкой на источник под каждым разделом.- Установите CLI. macOS/Linux: curl -fsSL https://dev.meta.ai/install.sh | sh. Windows (PowerShell): irm https://dev.meta.ai/install.ps1 | iex.
- Проверьте установку. Выполните muse --version.
- Начните сессию в проекте. Запустите muse в каталоге проекта и подтвердите запрос доверия к рабочей области.
- Войдите в аккаунт. Выберите вход через браузер или вставьте API-ключ Meta. Для скриптов и CI задайте переменную окружения META_API_KEY.
- Дайте первую задачу. Введите задачу в поле ввода. Enter добавляет указания к текущему ходу, Alt+Enter ставит их в очередь на следующий ход, Esc отменяет.
Как установить Muse Code (Mac, Linux, Windows)
macOS и Linux
curl -fsSL https://dev.meta.ai/install.sh | shWindows (PowerShell)
irm https://dev.meta.ai/install.ps1 | iexMuse Code работает в Windows нативно, WSL не нужен. Затем проверьте установку:
muse --versionУстанавливайте только с dev.meta.ai. Сторонние сайты «скачать Muse Code» не являются официальными. Смотрите, как безопасно скачать Muse Code, и руководство по установке в Windows.
Источник: Официальная документация
Вход: через браузер или по API-ключу
При первом запуске muse в проекте вас попросят войти. Есть два способа:
- Вход через браузер: открывается браузер, вы подтверждаете сессию и возвращаетесь в терминал.
- API-ключ: вместо этого вставьте API-ключ Meta. Для скриптов и CI экспортируйте его:
export META_API_KEY="<your-key>"Ключ также можно сохранить командой muse auth set. Переменная окружения имеет приоритет над сохранённым ключом, а тот — над сессией браузера. Пользователи Meta Managed Account (MMA) должны использовать API-ключ. Выйти можно командой muse logout.
Какой аккаунт? Muse Code входит через аккаунт Meta. Для подписки на Muse Code нужен аккаунт Meta и связанный с ним аккаунт Meta Model API, а тариф распространяется только на Muse Code. Аккаунт muse.ai — это тот же тип аккаунта Meta, но потребительский тариф Meta Muse не включает Muse Code; на него подписываются отдельно.
Вы не в США? Оплата Muse Code проходит через Meta Model API, который, по словам Meta, «доступен в большинстве стран и территорий, где доступен Meta AI и поддерживается оплата» (поддерживаемые страны). В политике географического использования Meta перечислены территории, где он не предоставляется, в том числе Китай (вместе с Гонконгом и Макао) и Россия. Для читателей из Китая есть проверенный нами обходной путь: 中国如何注册 Muse (с описанием рисков).
Источник: Официальная документация
Запрос доверия к рабочей области и разрешения
При первом запуске в папке Muse Code просит подтвердить доверие к рабочей области. Инструкции проекта (например, AGENTS.md) загружаются только в доверенных рабочих областях. После этого по умолчанию действуют два уровня защиты:
- Подтверждения: безопасные действия выполняются автоматически; рискованные (например, разрушительная
rm -rf) ждут вашего решения. Можно разрешить один раз, разрешать всегда в этой рабочей области или отклонить. - Песочница: команды оболочки выполняются в песочнице ОС (Seatbelt в macOS, bubblewrap в Linux, песочница Windows в Windows), ограниченной вашей рабочей областью и временными папками.
.git,.museи.agentsостаются доступными только для чтения.
| Профиль разрешений | Что делает |
|---|---|
| Ask me | Вы сами проверяете каждое подходящее подтверждение |
| Auto-review (по умолчанию) | Автоматический проверяющий принимает рутинные решения и передаёт остальное вам |
| Read-only | Только чтение файлов; без записи и побочных эффектов |
| Unrestricted | Без подтверждений и без песочницы (то же, что --yolo) |
Доступ к сети по умолчанию — proxy-only (вы подтверждаете каждый адрес); чтобы отключить его полностью, используйте --sandbox-network restricted. Используйте --yolo только в изолированной среде.
Источник: Официальная документация
Запустите первую задачу
Введите задачу и нажмите Enter. Ждать, пока агент закончит, не обязательно: нажмите Enter, чтобы добавить указания к текущему ходу, Alt+Enter, чтобы поставить их в очередь на следующий ход, и Esc, чтобы отменить ход. В поле ввода можно вставлять изображения и ссылаться на них как [Image #N]; Alt+V включает и выключает голосовую диктовку (кроме Windows).
Источник: Официальная документация
Команды Muse Code: шпаргалка
| Команда | Что делает |
|---|---|
/login | Снова открыть варианты входа |
/new, /clear | Начать новую сессию |
/resume | Продолжить одну из прошлых сессий |
/fork, /name | Создать ветку сессии или переименовать её |
/rewind (или Esc Esc) | Вернуться к более раннему сообщению и создать от него ветку |
/compact | Сжать предыдущий контекст в резюме, чтобы освободить токены |
/recap | Показать сводку недавней активности |
/goal | Задать цель, которую агент сохраняет между ходами |
/loop | Повторять промпт с интервалом (например, 10m) или по расписанию cron |
/tasks, /subagents | Следить за фоновой работой и вспомогательными агентами |
/workflows | Отслеживать запуски мультиагентных воркфлоу |
/side | Открыть побочный разговор, не затрагивая основную ветку |
/models, /effort | Сменить модель или уровень рассуждений посреди сессии |
/export transcript | Сохранить читаемую стенограмму (/export trajectory для полных JSON-логов) |
/copy | Скопировать последний ответ |
/settings | Открыть настройки (например, Tools > Workflows) |
Источник: Официальная документация
Правила проекта: AGENTS.md (и CLAUDE.md)
Создайте файл с инструкциями для проекта командой:
muse init # creates AGENTS.md
muse init --dry-run # preview firstMuse Code ищет AGENTS.md, CLAUDE.md, .agents/AGENTS.md и .claude/CLAUDE.md от корня рабочей области до ближайшего .git. Так что если вы уже пользуетесь Claude Code, ваш существующий CLAUDE.mdподойдёт. Пользовательские настройки хранятся в ~/.config/muse/settings.json.
Источник: Официальная документация
Выбор модели и уровня рассуждений
Меняйте модель посреди сессии командой /models или при запуске флагом --model. Уровень рассуждений — от none до ultra (по умолчанию high); меняется командой /effort или флагом --reasoning-effort. Более высокий уровень расходует больше выходных токенов, что важно при оплате за токены (смотрите цены Muse Code).
Источник: Официальная документация
Мультиагентность: субагенты и воркфлоу
Ведущий агент может передавать ограниченные задачи субагентам, при желании каждому в собственном git worktree, чтобы параллельные правки не конфликтовали. Одно дерево агентов по умолчанию запускает до 8 агентов одновременно, можно настроить до 64. Для крупных задач (параллельные аудиты, сравнение подходов, поэтапные миграции) Muse Code может запустить воркфлоу: он координирует дочерних агентов и возвращает один сводный результат. Небольшие и тесно связанные правки оставляйте основному агенту.
Источник: Официальная документация
Отмена неудачного хода: откат
Выполните /rewind или дважды нажмите Esc в пустом поле ввода, выберите более раннее сообщение, и Muse Code откроет от него новую ветку. Исходная сессия сохраняется. Откат меняет только историю разговора: файлы в рабочей области он невозвращает, для этого используйте git.
Источник: Официальная документация
Muse Code в скриптах и CI
muse exec "run the tests and fix any failures" --jsonВ headless-режиме нет интерфейса. Код выхода: 0 при успехе, 1 при сбое и 2 при ошибке использования. Ограничивайте запуски флагом --max-model-steps и аутентифицируйтесь через META_API_KEY.
Источник: Официальная документация
Muse Code в Windows: что отличается
- Команды выполняются в PowerShell, а не в Bash.
- При первом запуске песочница может запросить права администратора.
- Голосовой ввод и обмен сообщениями между сессиями в Windows недоступны.
Источник: Официальная документация
Muse Code в VS Code
В официальной документации нет расширения для VS Code. Откройте встроенный терминал VS Code и запустите muse там. Любое расширение «Muse Code для VS Code» считайте неофициальным.
Лимиты, о которых стоит знать заранее
- Тарифы ограничивают использование 5-часовыми окнами (Everyday Usage: 10-50 промптов каждые 5 часов). Когда лимит исчерпан, можно перейти на более высокий тариф или дождаться его обновления.
- Дешёвый уровень оплаты за токены Contributor разрешает Meta обучаться на ваших промптах и ответах и имеет более низкий лимит запросов.
- Хуки и MCP-серверы работают вне песочницы и системы подтверждений.
Стоимость и тарифы — на странице цен Muse Code. Дальше прочитайте наш обзор Muse Code или сравнение Muse Code vs Claude Code.
Частые вопросы
Как пользоваться Muse?
Если речь о Muse Code: установите CLI, запустите muse в папке проекта, подтвердите доверие к рабочей области, войдите в аккаунт и введите задачу. Если речь о Meta Muse, потребительском чат-ассистенте, — это другой продукт.
Работает ли Muse Code в Windows?
Да, нативно. Установите его из PowerShell командой «irm https://dev.meta.ai/install.ps1 | iex». Команды выполняются в PowerShell вместо Bash, а голосовой ввод и обмен сообщениями между сессиями в Windows недоступны.
Как установить Muse Code на Mac или Linux?
Выполните «curl -fsSL https://dev.meta.ai/install.sh | sh» в терминале, затем проверьте установку командой «muse --version».
Нужен ли API-ключ?
Нет. Можно войти через браузер. API-ключ (META_API_KEY или muse auth set) нужен только для неинтерактивного использования или если у вас Meta Managed Account, который не может входить через браузер.
Можно ли использовать Muse Code в VS Code?
В официальной документации нет расширения для VS Code. Запускайте muse во встроенном терминале VS Code.
Что означает запрос доверия к рабочей области?
Он спрашивает, может ли Muse Code работать в этой папке. Инструкции проекта, такие как AGENTS.md, загружаются только в доверенных рабочих областях. Доверяйте только папкам, содержимое которых вы знаете.
Читает ли Muse Code мой CLAUDE.md?
Да. Он ищет AGENTS.md, CLAUDE.md, .agents/AGENTS.md и .claude/CLAUDE.md от корня рабочей области до ближайшей папки .git. Чтобы создать AGENTS.md, выполните muse init.
Как остановить агента посреди задачи?
Нажмите Esc, чтобы отменить текущий ход. Фоновые процессы продолжают работать; управляйте ими через /tasks.
Можно ли запускать Muse Code в CI?
Да. Используйте headless-режим: muse exec "<prompt>", с --json для вывода в формате JSONL. Код выхода: 0 при успехе, 1 при сбое и 2 при ошибке использования.