시작하기

mu는 두 가지로 쓸 수 있어요. 필요한 것을 모두 담은 데스크톱 앱과 mu 명령줄이에요. 둘은 계정, 설정, 세션, 교훈을 함께 쓰기 때문에, 한쪽에서 시작한 작업을 다른 쪽에서 이어 갈 수 있어요.

데스크톱 앱

1. Releases에서 여러분의 시스템에 맞는 빌드를 내려받거나, 시스템을 알아서 골라 주는 홈 페이지에서 내려받으세요.

   시스템	파일
   macOS, Apple 실리콘	mu-<version>-mac-arm64.dmg
   macOS, Intel	mu-<version>-mac-x64.dmg
   Windows x64 / Arm	mu-<version>-win-x64.exe / mu-<version>-win-arm64.exe
   Linux x64 / Arm (Debian, Ubuntu)	mu-<version>-linux-amd64.deb / mu-<version>-linux-arm64.deb

   릴리스 페이지의 SHA256SUMS에 모든 파일의 체크섬이 있어요. macOS 빌드는 Apple의 서명과 공증을 받았어요. Windows 빌드는 아직 코드 서명이 없어서 처음 실행할 때 SmartScreen이 경고를 띄워요. 추가 정보를 누른 다음 실행을 누르세요.

2. 앱을 여세요. 처음 실행하면 설정 가이드가 모델, 권한 모드, 판정기, 시작의 네 단계를 안내해요.

   • 모델. API 키를 붙여 넣으면 mu가 키의 형식으로 서비스를 알아보고(DeepSeek, Kimi, Qwen, GLM, SiliconFlow, OpenRouter, OpenAI, Anthropic, Google Gemini, xAI 등) 요청 하나로 확인해요. ChatGPT, Claude, Grok, Google 구독으로 로그인할 수도 있어요. 키가 틀렸거나, 잔액이 없거나, 지원하지 않는 지역이거나, 연결이 안 되면 각각 어떻게 하면 되는지 알려 줘요.
   • 권한. Jev 승인이 미리 선택되어 있어요. 권한과 안전을 보세요.
   • 판정기. 키가 없으면 무료 Jev가 답해요. 언제든 다시 와서 바꿀 수 있어요.
   • 시작. mu가 Claude Code나 Codex 대화를 찾으면 가져오기를 제안해요.

3. 폴더를 고르고 대화를 시작하세요.

따로 설치할 것은 없어요. Node.js도 필요 없고, 처음 시작할 때 아무것도 내려받지 않아요. 새 릴리스가 나오면 앱이 그 버전과 크기를 알려 주고, 여러분이 동의한 뒤에만 내려받고, 다시 시작할 때 설치해요.

명령줄

npm i -g mu-agent      # Node.js 22.19 이상
mu setup               # 모델 연결, 판정기 선택
mu                     # 현재 디렉터리에서 세션 시작

mu setup은 중국어나 영어로 한 단계씩 물어요. 건너뛰면, 모델 없이 처음 mu를 실행할 때 지금 설정할지 한 번 물어요. 스크립트용으로는 mu setup --help가 대화형이 아닌 형식을 보여 줘요. 키는 표준 입력에서 읽고, 명령줄 인수로는 절대 받지 않아요.

해 볼 만한 것:

세션 안에서 /status는 판정기, 판정 지점별 모드, 최근 판정을 보여 주고, /help는 모든 명령어를 나열해요. 전체 목록은 명령줄 페이지에 있어요.

첫 작업

프로젝트 폴더를 열고, 하고 싶은 일을 평소 말투로 말하세요. 그다음에 일어나는 일:

1. Jev가 먼저 메시지를 읽고 여러 단계 작업 · 무거운 구성 같은 한 줄 판정을 보여 줘요. 1초도 채 걸리지 않아요. 건너뛰려면 Esc를 누르세요.
2. 모델이 일해요. 긴 도구 출력은 모델에 닿기 전에 걸러져요. Jev 승인 모드에서는 프로젝트 밖의 명령이 승인을 기다려요.
3. 다 했다고 하면 mu는 그 작업을 검증한 것이 있는지 확인하고, 없으면 한 번 짚어 줘요.

조건이 충족될 때까지 계속하게 하려면 목표 모드를 쓰세요: /goal all tests in packages/api pass.

판정기

mu는 세션의 일상적인 질문을 작고 빠른 판정기에게 물어요. 따로 설정할 필요는 없어요. Jev 키가 없으면 OpenCode Zen의 무료 Jev가 답하고, mu가 하루에 한 번 그 사실을 알려 줘요. 직접 가진 키, 로컬 판정기, 다른 모델을 쓰려면 판정기를 보세요.

모든 판정 지점은 처음부터 판정을 반영하고, 판정은 모두 기록돼요. /status, mu ledger, 앱의 판정 탭에서 볼 수 있어요. 판정기를 믿기 전에 지켜보고 싶다면 판정 지점들을 섀도 모드로 두세요. 질문과 기록은 그대로 하지만, 아무것도 바꾸지 않아요.

{ "modes": { "default": "shadow" } }

이 내용은 ~/.mu/agent/mu.json에 넣어요. /mu mode default shadow는 현재 세션에서만 같은 일을 해요.

파일 위치

Windows에서 ~는 사용자 폴더(%USERPROFILE%)예요.