Muse Code CLI 명령어 모음: 슬래시 명령어, 플래그, 단축키 총정리

Muse Code는 터미널 프로그램이고, 거의 모든 일을 muse 명령으로 처리합니다. 이 페이지에는 CLI 1.4.13 기준 Meta 문서에 나온 명령어, 플래그, 슬래시 명령어, 단축키를 모았습니다. 쓰고 있는 버전에서 지원하는 전체 목록은 세션에서 /help를, 단축키는 /keymap을 입력하면 볼 수 있습니다.

설치, 로그인, 버전 확인

명령어	설명
curl -fsSL https://dev.meta.ai/install.sh | sh	macOS 또는 Linux에 설치
irm https://dev.meta.ai/install.ps1 | iex	Windows(PowerShell)에 설치
muse --version	설치된 버전 표시
muse	현재 디렉터리에서 세션 시작. 처음 실행하면 로그인도 진행
muse auth set	브라우저 대신 API 키 저장
/login	세션 안에서 로그인 방법 선택 화면 다시 열기
muse logout	저장된 브라우저 세션과 키 삭제
muse usage	요금제 사용량이 얼마나 남았는지 표시
/upgrade	Accounts Center를 열어 요금제 변경

Muse Code는 스스로 업데이트됩니다. 업데이트, 문제 해결, 제거 방법은 설치 가이드에서 다룹니다.

세션 슬래시 명령어

명령어	설명
/help	이 워크스페이스에서 쓸 수 있는 명령어 전체 목록
/new	터미널 스크롤백은 남겨 두고 새 세션 시작
/clear	스크롤백까지 지우고 새 세션 시작
/resume	이 워크스페이스의 이전 세션을 골라 이어 하기
/resume --last	가장 최근 세션 이어 하기
/name [name]	세션 이름 확인 또는 설정
/fork	가장 최근의 안정된 지점에서 새 세션으로 분기
/rewind	내가 보낸 이전 메시지에서 분기
/side [prompt] 또는 /btw <prompt>	메인 대화를 흐트러뜨리지 않고 곁가지 대화 열기
/compact	앞부분 컨텍스트를 요약해 공간 확보
/recap	최근 작업 내용 요약
/copy	마지막 응답 복사
/export transcript	대화를 .txt 파일로 저장
/export trajectory	전체 세션 로그를 JSON으로 저장

계획, 목표, 에이전트

명령어	설명
/plan	계획을 세우고 승인할 때까지 구현을 기다림
/grill	계획이 버틸 때까지 집요하게 검증
/goal <objective>	에이전트가 향할 목표 설정. /goal pause, /goal resume, /goal edit, /goal clear로 관리
/loop <cadence> <prompt>	프롬프트를 일정 간격(10m)이나 cron 표현식으로 반복
/workflows	멀티 에이전트 워크플로 실행을 관리하는 컨트롤 룸 열기
/subagents	실행 중이거나 끝난 서브에이전트 표시
/tasks	백그라운드 작업 서랍 열기
/stop	백그라운드 작업과 터미널 취소

/plan, /grill, /goal을 어떻게 엮어 쓰는지는 내장 스킬 글에서 설명합니다.

모델과 추론

명령어 또는 플래그	설명
/model <model-id>	모델 바로 전환. 예: /model muse-wonder-1.0
/models	모델 선택 화면 열기
/effort	세션의 추론 강도 설정
--model <id>	실행할 때 모델 지정
--reasoning-effort <level>	none, minimal, low, medium, high(기본값), xhigh, max, ultra
/settings	설정 화면. 요금제의 Model → Contributor 모드도 여기 있음
--contributor-mode on|off	한 번의 실행에만 Contributor 모드 덮어쓰기

추론 토큰은 출력으로 청구되니 max와 ultra는 어려운 문제에만 쓰세요. 추론 강도를 ultra로 설정하면 그것만으로 멀티 에이전트 워크플로가 시작되기도 합니다.

키보드 단축키

키	설명
에이전트 작업 중 Enter	방향 조정: 실행 중인 턴에 입력 추가
Alt+Enter	다음 턴에 보낼 입력을 대기열에 추가
Esc	현재 턴 중단
프롬프트가 비어 있을 때 Esc	마지막으로 대기열에 넣은 지시 취소
대기 중 Esc Esc	되감기
Ctrl+C	중단(프롬프트가 비어 있을 때) 또는 입력 지우기
Alt+V(Mac은 Option+V)	음성 입력 시작·중지(Windows 미지원)

에이전트가 확인 질문을 하면 숫자 키로 선택지를 고르고, Space로 다중 선택을 켜고 끄고, Tab으로 메모를 덧붙이고, Enter로 제출합니다.

헤드리스 실행: muse exec

플래그	설명
muse exec "<prompt>"	작업 하나를 끝까지 실행하고 종료
--json	JSONL 이벤트를 stdout으로 출력
--prompt-file <path>	파일에서 프롬프트 읽기
--max-model-steps <n>	실행 한 번에 할 수 있는 작업량 제한
--session-id <uuid>	이전 세션을 비대화식으로 이어 하기
--no-session-log	세션 로그 남기지 않기
muse export --session <uuid> --out run.json	세션 내보내기

종료 코드는 0이 턴 완료, 1이 실패 또는 취소(단계 제한에 걸린 경우 포함), 2가 사용법 오류, 130/143이 인터럽트로 인한 중단입니다. 0이 나왔다고 코드가 맞다는 뜻은 아니니 테스트는 꼭 돌리세요. CI에서는 META_API_KEY로 인증합니다. 예시는 API 키 가이드에 있습니다.

권한과 샌드박스

플래그	설명
--approval-mode on-request	기본값. 위험한 셸 명령은 검토를 위해 멈춤
--approval-mode untrusted	허용 규칙이 없는 것은 모두 검토를 위해 멈춤
--approval-mode never	승인 확인 없음. 샌드박스는 그대로 적용
--approval-judge off	내장 판정기 대신 모든 승인 판단을 나에게 넘김
--disable-approval	승인은 건너뛰고 샌드박스는 유지
--disable-sandbox	승인은 유지하고 샌드박스는 해제
--yolo	승인 없음, 샌드박스 없음, 워크스페이스 신뢰. 버려도 되는 컨테이너에서만
--sandbox-network <mode>	proxy-only(기본값), restricted, unrestricted
--trust-workspace	첫 실행 확인 없이 폴더 신뢰

세션은 Auto-review 프로필로 시작합니다. 나머지는 Ask me, Read-only, Unrestricted이며, 각각 무엇을 허용하는지는 문서에서 설명합니다.

스킬, MCP, 프로젝트 설정

명령어	설명
muse init	프로젝트용 AGENTS.md 작성(--dry-run으로 미리 보기)
muse skills list	설치된 스킬 목록
muse skills install ./my-skill --scope user	스킬 설치
muse skills import --from claude	Claude Code 스킬 가져오기(Codex는 --from codex)
/migrate	Claude Code나 Codex의 메모리와 MCP 설정 가져오기
/mcp	연결된 MCP 서버와 도구 표시
muse mcp login <server>	원격 MCP 서버에 로그인
muse config status	실제로 적용 중인 설정 표시
/theme	터미널 테마 전환

파일 위치

• 설정: ~/.config/muse/settings.json. 기본 권한 프로필, MCP 서버, 훅, 세션 보관 기간 등.
• 프로젝트 지침: AGENTS.md. Muse Code는 CLAUDE.md, .agents/AGENTS.md, .claude/CLAUDE.md도 읽습니다.
• 프로젝트 스킬과 메모리: 저장소 안의 .agents/skills/와 .agents/memory/.
• 프로젝트 훅: .muse/hooks.json. 폴더를 신뢰한 뒤에만 불러옵니다.

Muse Code가 처음이라면 시작 가이드부터 읽고, 이 페이지는 탭에 열어 두세요.