MiMoCode는 Xiaomi MiMo 팀이 공개한 오픈소스 AI 코딩 에이전트다. 터미널에서 동작하며 코드 읽기·쓰기, 명령어 실행, Git 관리를 처리한다. Claude Code와 유사한 포지셔닝이지만, SQLite FTS5 기반 영구 메모리 시스템을 통해 세션이 종료되어도 프로젝트 컨텍스트가 유지된다는 점이 핵심 차별점이다.
MiMo Auto 채널을 기본 탑재해 계정 없이 즉시 시작할 수 있으며, OpenAI 호환 API를 추가해 다른 LLM 프로바이더를 연결할 수도 있다.
영구 메모리 시스템
세션이 끊겨도 컨텍스트가 유지되는 메모리 레이어를 네 가지 파일로 구성한다:
| 파일 | 역할 |
|---|---|
MEMORY.md | 프로젝트 지식, 규칙, 아키텍처 결정 사항 |
checkpoint.md | 체크포인트 서브에이전트가 자동 관리하는 세션 상태 스냅샷 |
notes.md | 에이전트 임시 메모 공간 |
tasks/<id>/progress.md | 태스크별 진행 로그 |
세션이 재개될 때 메모리를 자동 주입하므로 프로젝트 컨텍스트를 처음부터 다시 설명할 필요가 없다. 토큰 예산 내에서 중요도 순으로 주입량을 조절하는 예산 주입(budgeted injection) 방식을 쓴다.
3가지 에이전트 모드
| 에이전트 | 권한 | 용도 |
|---|---|---|
| build | 전체 도구 권한 | 기본 모드, 개발 작업 |
| plan | 읽기 전용 | 코드 탐색, 솔루션 설계 |
| compose | 오케스트레이션 | 스펙 기반 개발, 스킬 구동 워크플로 |
Tab으로 에이전트를 전환하고, 시스템이 필요에 따라 서브에이전트를 자동 생성한다.
태스크 트리 시스템
트리 구조로 태스크를 관리한다 (T1, T1.1, T1.2, …). 체크포인트 시스템과 자동 연동되어 세션 재개 시 태스크 진행 상황이 복원된다.
설치
# npm으로 설치
npm install -g @mimo-ai/cli
# 또는 원라인 인스톨러
curl -fsSL https://mimo.xiaomi.com/install | bash첫 실행 시 4가지 설정 중 하나를 선택한다:
- MiMo Auto — 익명 채널, 무설정 (기간 한정 무료)
- Xiaomi MiMo Platform — OAuth 로그인
- Import from Claude Code — 기존 Claude Code 인증을 1단계로 마이그레이션
- Custom Provider — OpenAI 호환 API 직접 연결
Claude Code와의 비교
| 항목 | MiMoCode | Claude Code |
|---|---|---|
| 기반 모델 | MiMo Auto 또는 커스텀 프로바이더 | Claude (Fable, Sonnet 등) |
| 영구 메모리 | SQLite FTS5, 자동 체크포인트 | CLAUDE.md (수동 관리) |
| 라이선스 | 오픈소스 | 비공개 |
| 무료 시작 | MiMo Auto로 가능 | Pro 구독 필요 |
| 마켓플레이스 | 미지원 (현재) | 스킬/플러그인 마켓 |
누가 쓰면 좋을까
- Claude Code 대안을 찾는 개발자: 오픈소스 AI 코딩 에이전트가 필요한 경우
- 긴 프로젝트 작업자: 세션 간 컨텍스트 유지가 중요한 복잡한 코드베이스 작업
- Xiaomi MiMo 모델 사용자: MiMo V2.5 Pro와 통합된 환경을 원하는 경우
관련 문서
- mimo — Xiaomi MiMo V2.5 Pro 언어 모델 (MiMoCode의 기반 모델 중 하나)
- claude-code-harness — Claude Code에 구조화된 워크플로를 추가하는 도구
참고 자료
- XiaomiMiMo/MiMo-Code — GitHub 공식 저장소
- MiMo Code 공식 사이트