가이드· 7 분 소요

Muse Code 1.4의 새 기능: 네이티브 Windows, /model, 스킬 가져오기 등

Muse Code CLI 1.4 시리즈에는 네이티브 Windows 설치 프로그램, 모델 직접 전환, Claude·Codex 스킬 가져오기, 이미지·동영상 기능이 들어갔고, Contributor 모드와 샌드박스에도 눈에 덜 띄는 수정이 있었습니다. 실제로 쓰는 기능별로 묶어서 무엇이 바뀌었는지 정리했습니다.

#changelog#cli#windows#skills#plugins#enterprise

먼저 버전부터 확인하세요

Meta의 공식 변경 로그는 Muse Code 릴리스를 버전 번호순으로 나열하지만 항목에 날짜가 없어서, 어떤 기능이 언제 내 손에 들어왔는지는 페이지만 봐서는 알 수 없습니다. 확실한 방법은 직접 설치본을 확인하는 것입니다:

muse --version

1.4.10보다 낮다면 업데이트하세요. Meta 문서에는 설치 프로그램만 나와 있으므로, 사용 중인 플랫폼의 설치 프로그램을 다시 실행하는 것(다음 섹션 참고)이 가장 간단합니다. 이 가이드는 1.4.2부터 1.4.10까지를 다루며, 릴리스 순서가 아니라 주제별로 변경 사항을 묶었습니다. 항목마다 버전을 표시해 두었으니 내 설치본에 들어 있는지 판단할 수 있습니다.

이제 Windows에 네이티브로 설치됩니다

출시 당시 Windows에서 Muse Code를 쓰려면 WSL2가 필요했습니다. 이제는 그렇지 않으며, 설치 가이드도 두 경로를 모두 다루도록 업데이트했습니다. Meta 문서에는 이제 네이티브 PowerShell 설치 프로그램이 올라와 있습니다:

irm https://dev.meta.ai/install.ps1 | iex

macOS와 Linux의 커맨드는 그대로 curl -fsSL https://dev.meta.ai/install.sh | sh입니다. Windows 설치 프로그램이 언제 나왔는지 Meta가 발표하지는 않았지만, 서드파티 가이드가 2026년 9월 22일에 이미 소개하고 있었습니다.

네이티브 Windows에는 알아 둘 차이가 몇 가지 있습니다.

  • 에이전트가 Bash 대신 PowerShell에서 커맨드를 실행합니다.
  • 샌드박스가 처음 초기화될 때 UAC 프롬프트가 뜰 수 있습니다.
  • 음성 입력은 쓸 수 없습니다.
  • 세션 간 메시징도 쓸 수 없습니다. macOS와 Linux 전용 기능입니다.

WSL2는 여전히 작동합니다. Linux이니까요. Bash 도구나 세션 간 메시징에 의존한다면 WSL2를 계속 쓰세요. 데스크톱 앱과 공식 VS Code 확장은 여전히 없습니다.

모델과 /model

  • 1.4.5: /model <model-id>로 선택 화면을 열지 않고 바로 전환할 수 있습니다. 예: /model muse-wonder-1.0. Muse Wonder가 나온 지금은 특히 유용합니다.
  • 1.4.7: /models 선택 화면에 추론 수준을 고르는 단계가 추가되었습니다.
  • 1.4.4: -c key=value로 한 번의 실행에 한해 설정값을 덮어쓸 수 있습니다. 설정 파일을 고치지 않고 다른 설정을 시험해 볼 때 유용합니다.

세션과 재개

  • 1.4.3: /resume <id-or-name>으로 특정 세션을 다시 열 수 있습니다.
  • 1.4.5: 세션 이름이 자동으로 붙어서, 이름으로 /resume하는 게 실제로 쓸 만해졌습니다.
  • 1.4.7: /goal cancel과 /goal stop으로 실행 중인 목표를 끝낼 수 있습니다.
  • 1.4.8: 서브에이전트가 일하는 모습을 실시간으로 따라갈 수 있습니다.
  • 1.4.2: 백그라운드 Bash 커맨드가 나중에 참조할 수 있는 Work ID를 반환합니다.

muse serve, SDK, 세션 프로토콜

터미널이 아니라 직접 만든 도구에서 Muse Code를 구동한다면, 1.4 작업의 대부분이 여기에 들어갔습니다:

  • 1.4.2: muse serve가 여러 워크스페이스 루트를 받고 --provider, --model 플래그를 지원합니다. 같은 릴리스에서 muse voice transcribe도 추가되었습니다.
  • 1.4.5: muse serve가 최대 256개 세션을 유지합니다.
  • 1.4.6: 플러그인과 마켓플레이스를 세션 프로토콜로 쓸 수 있게 되었고, muse serve에 Auto-review 리뷰어가 생겼습니다.
  • 1.4.9: --disable-request-user-input을 쓰면 무인 실행 중에 에이전트가 답변을 기다리며 멈추지 않습니다. 또한 MCP 호출에 도구 호출 ID가 포함됩니다.

플러그인, 스킬, 훅

  • 1.4.3: 플러그인 관리가 기본으로 켜집니다.
  • 1.4.4: MCP 설정에서 환경 변수를 참조할 수 있어서, 시크릿을 설정 파일 밖에 둘 수 있습니다.
  • 1.4.5: Claude나 Codex 스킬을 가져올 수 있습니다. 다른 에이전트용으로 이미 스킬을 만들어 두었다면 다시 작성할 필요가 없습니다. Muse Code에 기본으로 들어 있는 스킬은 번들 스킬 가이드에서 다룹니다.
  • 1.4.6: 새 훅 PostToolBatch와 StopFailure가 추가되었습니다.
  • 1.4.8: --preset empty로 기본 제공 도구 없이 에이전트를 시작할 수 있습니다. 범위를 좁게 잡은 플러그인을 위한 깨끗한 바탕입니다.

이미지, 동영상, 그리고 /blender

  • 1.4.4: 턴에 동영상을 첨부할 수 있습니다.
  • 1.4.7: 이미지 모델을 쓸 수 있는 환경에서는 에이전트가 이미지를 생성하고 편집할 수 있습니다.
  • 1.4.10: /blender가 참고 이미지를 편집 가능한 Blender 장면으로 재구성하고, Computer Use에 필요한 도구 호출 수가 줄었습니다.

안전과 권한

릴리스 노트에서 건너뛰기 쉽지만 알아 둘 가치가 있는 항목들입니다:

  • 1.4.6: 구독자는 Contributor 모드가 기본으로 켜집니다. 플랜 사용량을 더 주는 대신, Meta가 사용자의 콘텐츠를 향후 모델 훈련에 쓸 수 있습니다. 받아들이기 어렵다면 /settings에서 끄세요. 끄면 사용 한도가 줄어듭니다. Contributor vs Standard를 참고하세요.
  • 1.4.6: find -exec와 find -delete 승인이 더 안전해졌습니다.
  • 1.4.8: Contributor 모드를 끈 뒤에도 백그라운드 요청이 이를 쓸 수 있던 버그가 수정되었습니다. 이전 1.4 빌드에서 옵트아웃했다면 업데이트하세요.
  • 1.4.8: 강제할 수 없는 권한 프로필은 실행 시점에 거부됩니다.
  • 1.4.10: 샌드박스가 더 이상 저장된 설정을 읽거나 바꿀 수 없습니다.

엔터프라이즈 설정

  • 1.4.3: 기업 TLS 프록시 뒤에 있는 네트워크를 위해 ca_bundle과 시스템 인증서 저장소 사용을 지원합니다.
  • 1.4.4: session_retention_days로 세션 보관 기간을 정할 수 있습니다.

1.4.8의 권한 프로필 검사와 1.4.10의 샌드박스 변경까지 합치면, 관리형으로 배포할 때는 1.4.10을 최소 버전으로 잡는 게 합리적입니다.

업데이트해야 할까?

네. 위 변경 사항 중 두 가지는 프라이버시와 안전 관련 수정(1.4.8의 Contributor 모드 버그와 1.4.10의 샌드박스 제한)이고, /model로 Wonder에 바로 전환하는 것 같은 새 기능들도 최신 빌드를 전제로 합니다. muse --version을 실행해 보고, 뒤처져 있다면 설치 프로그램을 다시 실행한 뒤, muse --help로 내 버전이 지원하는 정확한 커맨드를 확인하세요. 릴리스 소식은 저희 변경 로그 페이지에서 계속 추적합니다. 처음 써 본다면 시작 가이드부터 보세요.

계속 읽기