Muse Code 시작하기: 설치부터 첫 머지까지
Meta의 터미널 코딩 에이전트는 셋업이 의도적으로 미니멀합니다. 커맨드 하나, 브라우저 로그인 한 번이면 내 저장소 안에서 멀티 에이전트 세션을 굴릴 수 있습니다. 천천히 짚어볼 가치가 있는 지점까지 포함해 전체 경로를 정리했습니다.
커맨드 하나, 바이너리 하나
Muse Code는 macOS와 Linux용 베타로 제공되며, 설치는 한 줄이면 끝납니다:
curl -fsSL https://dev.meta.ai/install.sh | bash스크립트가 muse 바이너리를 PATH에 올려놓으며, muse --version으로 설치를 확인할 수 있습니다. 원격 스크립트를 bash로 바로 파이프하는 방식은 어떤 벤더든 편의성과 맞바꾸는 트레이드오프이므로, 신중한 팀이라면 먼저 스크립트를 내려받아(curl -fsSL https://dev.meta.ai/install.sh -o install.sh) 내용을 읽어본 뒤 실행하는 편이 좋습니다. 의도적으로 빠진 것도 눈여겨볼 만합니다. IDE 플러그인도, 데스크톱 앱도 없습니다. 일부 경쟁 에이전트와 달리 Muse Code는 설계부터 터미널 전용입니다.
사람은 브라우저 인증, 머신은 API 키
처음 muse를 실행하면 브라우저가 열리면서 dev.meta.ai에서 Meta 개발자 계정으로 로그인하게 됩니다. 이후 인증 정보가 로컬에 캐시되므로 세션마다 다시 로그인할 필요는 없습니다. 접근 권한과 과금 모두 Muse Spark 모델을 직접 서빙하는 바로 그 Meta Model API 계정 하나로 처리됩니다.
CI 파이프라인, 스크립트, 헤드리스 머신에서는 브라우저를 건너뛰면 됩니다. Model API 대시보드에서 키를 만들고(API keys → Create API key) MODEL_API_KEY로 내보내세요. 키 형식은 LLM|{numeric_id}|{secret} 모양입니다. 환경 변수나 시크릿 매니저에 보관하고, 코드에는 절대 넣지 마세요.
첫 태스크는 루프를 증명하는 것으로
아무 git 저장소에나 cd해서 muse를 실행하세요. 에이전트가 로컬 컨텍스트를 읽고 태스크 루프를 열면, 원하는 결과를 평범한 문장으로 설명하면 됩니다. 거창한 리팩터링부터 시작하고 싶은 유혹은 참는 게 좋습니다. Muse Code의 성격을 가장 빨리 파악하는 방법은 작고 검증 가능한 태스크입니다. “parseDate 함수에 빠진 테스트를 추가하고 통과하는지 확인해줘” 같은 것 말이죠.
몇 분 안에 이 제품을 정의하는 분업 구조를 목격하게 됩니다. 워커 에이전트가 변경 초안을 만들고, 리뷰어 에이전트가 백그라운드에서 그것을 비평하며, 테스트가 실제로 실행됩니다. 이 워커-리뷰어 패턴은 모든 태스크에서 기본으로 켜져 있습니다. Meta가 이 제품을 멀티 에이전트 옵션이 아니라 “기본이 멀티 에이전트”라고 설명하는 이유입니다.
첫날 익혀둘 비용 레버 두 개
Muse Spark는 추론 모델입니다. 답하기 전에 생각하고, 그 사고 토큰은 출력으로 과금됩니다. /effort 커맨드로 추론 강도를 조절할 수 있어서, 단순한 이름 변경에 깊은 숙고 비용을 낼 필요가 없고 까다로운 동시성 버그에는 충분한 사고를 배정할 수 있습니다. 두 번째로, 상시 적용되는 규칙 — 톤, 형식, 컨벤션 — 은 시스템 메시지에 한 번 넣어두면 되고, 프롬프트마다 반복할 필요가 없습니다. 이 둘만 지키면 첫날 사용 요금은 심심할 만큼 평온하게 유지됩니다. 그게 바로 원하는 상태죠.
다음 단계
루프가 손에 익으면, 세 가지 내장 스킬이 더 큰 작업에 구조를 잡아줍니다. /plan은 태스크를 승인 게이트가 걸린 계획으로 바꾸고, /grill은 그 계획이 버틸 때까지 스트레스 테스트를 걸며, /goal은 설정한 목표를 향해 에이전트를 계속 밀어붙입니다. 자세한 내용은 번들 스킬 포스트에서 다뤘고, 전체 레퍼런스는 문서에 있습니다.