비공식 가이드입니다. Meta와 관련이 없습니다.
MuseAICode
한국어

최종 업데이트:

Muse Code 사용법: 설치부터 첫 작업까지

빠른 시작 명령어 하나로 설치하고, 프로젝트에서 muse를 실행하고, 작업 공간을 신뢰하고, 로그인한 뒤 작업을 입력하세요. macOS, Linux, Windows에서 작동하며 설정에는 10분 정도 걸립니다. 아래 내용은 모두 Meta의 공식 Muse Code 문서를 요약한 것이며, 각 섹션 아래에 출처 링크를 달았습니다.
  1. CLI 설치. macOS/Linux: curl -fsSL https://dev.meta.ai/install.sh | sh. Windows(PowerShell): irm https://dev.meta.ai/install.ps1 | iex.
  2. 설치 확인. muse --version를 실행합니다.
  3. 프로젝트에서 세션 시작. 프로젝트 디렉터리 안에서 muse를 실행하고, 작업 공간 신뢰 확인을 승인합니다.
  4. 로그인. 브라우저 로그인을 선택하거나 Meta API 키를 붙여 넣습니다. 스크립트와 CI에서는 META_API_KEY 환경 변수를 설정합니다.
  5. 첫 작업 맡기기. 입력창에 작업을 입력합니다. Enter는 진행 중인 턴에 지시를 추가하고, Alt+Enter는 다음 턴으로 대기열에 넣으며, Esc는 취소합니다.

Muse Code 설치 방법(Mac, Linux, Windows)

macOS 및 Linux

curl -fsSL https://dev.meta.ai/install.sh | sh

Windows(PowerShell)

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

Muse Code는 Windows에서 네이티브로 실행되므로 WSL이 필요 없습니다. 그다음 설치를 확인하세요:

muse --version

설치는 dev.meta.ai에서만 하세요. 서드파티 "Muse Code 다운로드" 사이트는 공식이 아닙니다. Muse Code를 안전하게 다운로드하는 방법과 Windows 설치 가이드를 참고하세요.

출처: 공식 문서

로그인: 브라우저 또는 API 키

프로젝트에서 처음 muse를 실행하면 로그인하라는 안내가 나옵니다. 방법은 두 가지입니다:

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에 따르면 이 API는 "Meta AI를 사용할 수 있고 결제가 지원되는 대부분의 국가 및 지역에서 이용 가능"합니다(지원 국가). Meta의 지역별 이용 정책에는 제공되지 않는 지역이 나와 있으며, 여기에는 중국(홍콩, 마카오 포함)과 러시아가 포함됩니다. 중국 독자를 위한 우회 방법(위험 포함)은 저희가 테스트한 中国如何注册 Muse에서 볼 수 있습니다.

출처: 공식 문서

작업 공간 신뢰 확인과 권한

어떤 폴더에서 처음 실행하면 Muse Code가 작업 공간을 신뢰할지 묻습니다. 프로젝트 지침(AGENTS.md 등)은 신뢰한 작업 공간에서만 불러옵니다. 그 이후에는 두 겹의 안전장치가 기본으로 켜져 있습니다:

권한 프로필동작
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읽기 쉬운 대화 기록 저장(전체 JSON 로그는 /export trajectory)
/copy마지막 응답 복사
/settings설정 열기(예: Tools > Workflows)

출처: 공식 문서

프로젝트 규칙: AGENTS.md(및 CLAUDE.md)

다음 명령으로 프로젝트 지침 파일을 만듭니다:

muse init            # creates AGENTS.md
muse init --dry-run  # preview first

Muse Code는 작업 공간 루트에서 가장 가까운 .git까지 AGENTS.md, CLAUDE.md, .agents/AGENTS.md, .claude/CLAUDE.md를 찾습니다. 그래서 이미 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으로 되돌리세요.

출처: 공식 문서

스크립트와 CI에서 Muse Code 실행하기

muse exec "run the tests and fix any failures" --json

헤드리스 모드에는 UI가 없습니다. 성공하면 0, 실패하면 1, 사용법 오류는 2로 종료됩니다. 실행 범위는 --max-model-steps로 제한하고, 인증에는 META_API_KEY를 사용하세요.

출처: 공식 문서

Windows에서 Muse Code: 달라지는 점

출처: 공식 문서

VS Code에서 Muse Code 사용하기

공식 문서에는 VS Code 확장 프로그램이 나와 있지 않습니다. VS Code의 통합 터미널을 열고 그곳에서 muse를 실행하세요. "VS Code용 Muse Code" 확장 프로그램은 모두 비공식으로 간주하세요.

시작하기 전에 알아둘 한도

비용과 플랜은 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"로 설치합니다. 명령은 Bash 대신 PowerShell에서 실행되며, Windows에서는 음성 입력과 세션 메시징을 사용할 수 없습니다.

Mac이나 Linux에 Muse Code를 설치하려면 어떻게 하나요?

터미널에서 "curl -fsSL https://dev.meta.ai/install.sh | sh"를 실행한 다음 "muse --version"로 확인합니다.

API 키가 필요한가요?

아니요. 브라우저로 로그인할 수 있습니다. API 키(META_API_KEY 또는 muse auth set)는 비대화형으로 사용할 때나, 브라우저 로그인을 쓸 수 없는 Meta Managed Account를 사용하는 경우에만 필요합니다.

VS Code에서 Muse Code를 쓸 수 있나요?

공식 문서에는 VS Code 확장 프로그램이 나와 있지 않습니다. VS Code의 통합 터미널에서 muse를 실행하세요.

작업 공간 신뢰 확인은 무슨 뜻인가요?

Muse Code가 이 폴더에서 작업해도 되는지 묻는 것입니다. AGENTS.md 같은 프로젝트 지침은 신뢰한 작업 공간에서만 불러옵니다. 내용을 알고 있는 폴더만 신뢰하세요.

Muse Code가 제 CLAUDE.md를 읽나요?

네. 작업 공간 루트에서 가장 가까운 .git 폴더까지 AGENTS.md, CLAUDE.md, .agents/AGENTS.md, .claude/CLAUDE.md를 찾습니다. AGENTS.md를 만들려면 muse init을 실행하세요.

작업 도중에 에이전트를 멈추려면 어떻게 하나요?

Esc를 누르면 현재 턴이 취소됩니다. 백그라운드 프로세스는 계속 실행되므로 /tasks로 관리하세요.

CI에서 Muse Code를 실행할 수 있나요?

네. 헤드리스 모드를 사용합니다: muse exec "<prompt>", JSONL 출력이 필요하면 --json을 붙입니다. 성공하면 0, 실패하면 1, 사용법 오류는 2로 종료됩니다.