SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor · 업데이트됨 2026-11-18

Xiaomi MiMo-Code 사용법 및 OpenCode 포크 분석

Xiaomi가 공개한 터미널 코딩 에이전트 MiMo-Code의 정체를 분석합니다. OpenCode를 기반으로 개발된 이 도구의 특징과 설치 명령어 mimo 사용법, 그리고 벤치마크 수치에 숨겨진 실제 성능과 모델 호환성 정보를 상세히 확인해 보시기 바랍니다.

MiMo-Code란 무엇인가?

MiMo-Code는 Xiaomi의 MiMo 팀이 개발하여 2026년 6월 MIT 라이선스로 공개한 터미널 코딩 에이전트입니다. 2026년 6월 10일 자로 작성된 Xiaomi의 출시 문서에는 이미 오픈 소스로 명시되어 있습니다. 이 도구는 셸에서 CLI(명령줄 인터페이스) 도구로 실행됩니다. 프로젝트 내 파일을 읽고 수정하며, 셸 명령을 실행하고, git을 제어하며, 세션 간에 코드베이스에 대한 메모를 유지합니다.

작동 방식은 Claude Code와 동일합니다. 사용자가 평문으로 작업을 설명하면, 에이전트가 설정된 권한 내에서 파일을 수정하고 명령을 실행합니다. 두 가지 중요한 차이점이 있습니다. 첫째, 소스 코드가 공개되어 있어 에이전트가 모델로 전송하는 내용을 정확히 확인할 수 있습니다. 둘째, 에이전트와 모델이 분리되어 있어, 동일한 환경에서 Xiaomi의 모델뿐만 아니라 OpenAI 호환 엔드포인트나 직접 호스팅하는 모델을 선택하여 사용할 수 있습니다.

저장소 이름은 MiMo-Code이며, 설치되는 명령은 mimo입니다. 두 이름 모두 문서에 등장하므로 어느 쪽으로 검색해도 동일한 도구를 찾을 수 있습니다.

MiMo-Code의 유래와 그 중요성

MiMo-Code는 sst 프로젝트의 오픈 소스 터미널 에이전트인 OpenCode를 포크한 것입니다. LICENSE 파일은 원본의 Copyright (c) 2025 opencode 라인을 유지하고 있으며, README에는 해당 관계에 대한 짧은 섹션이 포함되어 있습니다.

이 사실을 알면 그렇지 않으면 불가능해 보이는 점들을 이해할 수 있습니다. 2026년 6월에 처음 출시된 프로젝트가 이미 완성도 높은 TUI(텍스트 사용자 인터페이스), 플러그인 시스템, 다양한 모델 API와 통신하는 프로바이더 추상화, MCP(모델 컨텍스트 프로토콜) 지원, LSP(언어 서버 프로토콜) 통합 기능을 갖추고 있습니다. 이러한 작업은 몇 주 만에 완료될 수 있는 것이 아닙니다. 이는 포크와 함께 제공된 것입니다. Xiaomi가 새롭게 추가한 것은 메모리 계층과 Xiaomi 자체 모델과의 연동입니다.

이미 VPS에서 OpenCode 실행하기를 수행해 보았다면, 내부 코드가 동일하기 때문에 레이아웃과 키 바인딩이 익숙하게 느껴질 것입니다.

"모델과 에이전트가 함께 진화한다"는 말의 실제 의미

이 저장소의 슬로건은 "모델과 에이전트가 함께 진화하는 곳(Where Models and Agents Co-Evolve)"입니다. 이 문구에는 두 가지 별개의 주장이 담겨 있으나, 공개된 세부 정보로 뒷받침되는 것은 그중 하나뿐입니다.

첫 번째 주장은 런타임에 관한 것이며, 이는 문서화되어 있습니다. MiMo-Code는 각 프로젝트마다 영구적인 메모리 저장소를 유지하며, 이는 세션 상태 및 작업 진행 상황과 함께 SQLite 전문 검색(full-text search)으로 지원됩니다. 이를 구동하는 것은 두 개의 슬래시 명령어입니다. /dream는 최근 세션에서 지속적인 지식을 추출하여 프로젝트 메모리에 기록합니다. /distill는 반복되는 절차를 재사용 가능한 기술로 변환합니다. Xiaomi의 자체 엔지니어링 기술 문서에 따르면, Dream은 7일마다, Distill은 30일마다 자동으로 트리거되며 매 세션마다 실행되지는 않습니다. 따라서 모델 파일은 동일하게 유지되더라도 저장소에서 에이전트의 동작은 시간이 지남에 따라 변화합니다. 이 저장소는 스스로 채워지지만, 사용자가 직접 작성하는 지침 파일을 대체하지는 않습니다. 모노레포 환경에서는 단일 루트 파일보다는 패키지당 작은 파일 하나씩 관리하는 것이 좋으며, 에이전트는 자신이 작업 중인 디렉터리에 있는 파일을 불러옵니다. 이러한 파일을 작성하는 것은 절반의 쉬운 과정일 뿐이며, 에이전트가 분명히 명시했다고 생각한 규칙을 무시하고 넘어갈 때 지침이 무시되는 이유는 미스터리하기보다는 기계적인 원인인 경우가 많습니다. 과거 세션에서 추출된 메모리는 에이전트가 프로젝트를 처음부터 다시 학습하지 않게 하는 한 가지 방법일 뿐이며, MCP를 통해 에이전트가 쿼리할 수 있는 저장소의 tree-sitter 맵은 에이전트가 구조를 다시 읽게 만드는 대신 구조를 직접 제공함으로써 동일한 비효율 문제를 다른 측면에서 해결합니다.

두 번째 주장은 학습에 관한 것이며, 이 부분은 주의해서 받아들여야 합니다. Xiaomi는 MiMo-V2.5의 사후 학습(post-training)을 지도 미세 조정(supervised fine-tuning), 대규모 에이전트 강화 학습(RL), 그리고 여러 전문가 교사 모델에서 하나의 학생 모델로의 온-폴리시 증류(on-policy distillation)라는 3단계 파이프라인으로 설명합니다. 에이전트 강화 학습은 모델이 단일 질의응답 쌍이 아닌 다단계 도구 호출 에피소드를 통해 학습되었음을 의미합니다. 이는 사실이며, 모델이 긴 도구 시퀀스 전반에 걸쳐 일관성을 유지하는 이유이기도 합니다. Xiaomi가 아직 발표하지 않은 것은 이 특정 하니스(harness) 내부에서 모델이 최적화되고, 그 하니스가 다시 모델에 반응하여 변화한다는 것을 보여주는 학습 보고서입니다.

따라서 "함께 진화한다"는 말은 두 영역을 모두 소유한 팀의 의지 표명으로 이해해야 합니다. 사용자가 실제로 체감할 수 있는 이점은 더 좁지만 여전히 가치가 있습니다. 도구 스키마와 시스템 프롬프트를 작성하는 사람과 모델을 배포하는 사람이 같기 때문에 서로 잘 맞물려 돌아갑니다. Claude Code는 하니스가 고정된 API 모델의 클라이언트이기 때문에 이런 방식으로 작동할 수 없습니다. Anthropic 또한 에이전트 사용을 위해 모델을 학습시키지만, 하니스 아래에서 모델을 교체할 수는 없습니다.

터미널에서 MiMo-Code 세션이 작동하는 방식

mimo를 실행하면 전체 화면 터미널 인터페이스가 열립니다. 작업을 입력하면 에이전트가 파일을 읽고, 변경 사항을 적용하며, 설정된 권한 내에서 명령을 실행합니다. 기본 빌드 모드 외에도 계획 모드(plan mode)와 작업의 일부를 별도의 에이전트 실행으로 넘기는 하위 에이전트 시스템을 제공합니다. Compose 모드는 2026년 10월 26일 v0.1.16 버전에서 제거되었으며, 그 대체 기능으로 빌드 에이전트의 /compose-next 스킬이 도입되었습니다. Claude Code는 고정된 모드 세트를 전환하는 대신 출력 스타일이 시스템 프롬프트 자체를 재작성하는 방식으로 동일한 수준의 제어를 달성합니다. 또한 에이전트가 이름으로 호출할 수 있는 사전 패키지 절차인 대규모 내장 스킬 세트를 포함합니다. 스킬은 에이전트가 아는 내용뿐만 아니라 작동 방식 자체를 변경할 수 있는데, 이는 작동하는 가장 작은 변경 사항만 유지하도록 에이전트를 제어하는 스킬인 Ponytail의 핵심 개념입니다.

시작하기 전에 알아두어야 할 몇 가지 세부 사항이 있습니다.

  • 빌드 모드는 기본적으로 대부분의 작업을 허용하며, 프로젝트 외부 접근과 같은 특정 작업에 대해서는 확인 메시지를 표시합니다. --dangerously-skip-permissions 플래그는 모든 허용 기반을 추가하지만, 명시적인 ask 및 deny 규칙은 여전히 적용됩니다. 모드 이름 그대로의 기능을 수행하므로, 실수해도 비용이 발생하지 않는 환경에서만 사용하십시오. MiMo-Code는 권한 규칙과 런타임 /skip-permissions 토글도 지원하며, 플래그를 사용하기 전에 자동 모드에서 에이전트가 확인 없이 수행할 수 있는 작업을 비교해 보는 것이 유용합니다.
  • 대화형 터미널 없이도 실행할 수 있습니다. mimo run은 프롬프트를 받아 비대화형으로 실행하며, 이는 스크립트나 CI 작업에 필요한 방식입니다.
  • 설정은 커밋 가능한 파일에 저장됩니다. 프로젝트는 .mimocode/mimocode.jsonc을 읽고, 전역 설정은 ~/.config/mimocode/mimocode.jsonc에 저장됩니다.
  • 저장된 로그인 자격 증명은 Linux의 ~/.local/share/mimocode/auth.json에 위치하므로, 해당 경로를 git이나 공유하는 백업에 포함하지 마십시오. 사용자 지정 공급자 설정에는 일반 텍스트 apiKey가 포함될 수 있으므로, 이를 포함하는 설정 파일을 커밋하지 마십시오.

셸 명령을 실행할 수 있는 에이전트는 사용자에게 셸 권한을 넘겨준 프로그램과 같습니다. 에이전트에게 별도의 머신과 전용 사용자를 할당하십시오. 새로운 에이전트를 테스트하는 가장 안전한 방법은 세션 종료 후 삭제할 수 있는 일회용 VM을 사용하는 것입니다. 잘못된 명령이 실행되더라도 복구 대신 재구축만 하면 되기 때문입니다.

MiMo-Code가 정말로 Claude Code보다 뛰어난가?

Xiaomi의 출시 자료는 특정 주장을 담고 있습니다. 동일한 모델을 두 환경에서 실행했을 때 MiMo-Code가 더 높은 점수를 기록한다는 것입니다. 다음은 공개된 수치입니다.

차트Xiaomi's self-reported harness comparison, same model in both agents
이 차트의 데이터
[
  {
    "tool": "MiMo-Code",
    "swe_bench_pro_pct": 62,
    "terminal_bench_2_pct": 73
  },
  {
    "tool": "Claude Code",
    "swe_bench_pro_pct": 57,
    "terminal_bench_2_pct": 68
  }
]

SWE-bench Pro에서 Xiaomi는 MiMo-Code가 62 퍼센트, Claude Code가 57 퍼센트를 기록했다고 보고했습니다. Terminal Bench 2에서의 수치는 각각 73 퍼센트와 68 퍼센트입니다. 모델을 고정했으므로 약 5포인트의 격차는 모델이 아닌 에이전트 시스템에서 기인한다는 것이 이 주장의 핵심입니다. 이 주장이 의미를 가지려면 에이전트 환경이 실제로 무엇을 다루는지 알아야 합니다. 루프, 도구 정의, 권한 프롬프트, 세션 상태는 두 시스템 간에 차이가 나는 부분이며, 모델 가중치는 동일하게 유지됩니다.

이 수치들은 벤더가 제공한 데이터로 간주하십시오. Xiaomi가 직접 평가를 수행하고 발표했습니다. Xiaomi는 자사 결과의 한계에 대해 이례적일 정도로 솔직합니다. 해당 보고서에 따르면 이 벤치마크들은 단일 저장소 문제에 대한 일회성(one-shot) 문제 해결 능력을 측정하며, 자체 테스트 결과 약 200회 실행 단계 미만에서는 두 에이전트의 성능이 거의 비슷했습니다. 주장된 이점은 일회성 벤치마크가 다루지 않는 장기 실행 작업에서 나타납니다.

이것이 객관적인 해석입니다. 벤더가 실행한 벤치마크에서 5포인트의 격차가 난다는 것은 해당 도구를 시도해 볼 만한 이유가 됩니다. 하지만 팀이 의존하는 업무 환경을 즉시 전환할 근거는 되지 않습니다.

MiMo-Code 운영 비용

출시 당시 Xiaomi는 등록 없이 사용할 수 있는 MiMo Auto라는 무료 채널을 제공했습니다. 이 채널은 처음부터 기간 한정으로 명시되었으며, Xiaomi의 변경 로그에 따르면 무료 MiMo-V2.5 체험판은 2026년 7월 26일에 종료되었습니다. 해당 채널은 현재 폐쇄되었으므로 유료 액세스를 계획해야 합니다.

Xiaomi 플랫폼의 유료 액세스 비용은 선도적인 제공업체들에 비해 저렴합니다. 2026년 5월 27일부터 적용된 영구적이고 전 세계적으로 동기화된 가격 인하를 통해 MiMo-V2.5-Pro의 가격은 캐시 미스(cache miss) 시 입력 토큰 100만 개당 $0.435, 출력 토큰 100만 개당 $0.87로 책정되었습니다. 동일한 인하 조치로 입력 길이에 따른 별도 요금 체계가 폐지되어, 단일 요금으로 1M 토큰의 전체 컨텍스트 윈도우를 사용할 수 있게 되었습니다. MiMo-V2.5-Pro는 이후 서비스가 종료되었습니다. Xiaomi는 2026년 10월 14일 18:00(UTC+8)부터 해당 요청을 MiMo-V2.6-Pro로 라우팅했으며, MiMo-V2.5-Pro와 MiMo-V2.5는 2026년 10월 21일 10:00(UTC+8)에 완전히 종료되었습니다. 해당 모델 ID는 더 이상 작동하지 않으므로 모든 설정을 MiMo-V2.6-Pro로 변경하십시오. 2026년 11월 17일 기준으로 Xiaomi는 MiMo-V2.6-Pro의 가격을 동일하게 입력 토큰 100만 개당 $0.435, 출력 토큰 100만 개당 $0.87로 명시하고 있으며, 1M 토큰의 컨텍스트 윈도우를 제공합니다. 가격은 변동될 수 있으므로 예산을 계획하기 전에 현재 페이지를 확인하십시오.

다른 방법은 자체 하드웨어를 사용하는 것입니다. MiMo-V2.5 및 MiMo-V2.5-Pro의 가중치는 MIT 라이선스 하에 Hugging Face에 공개되어 있으며, API 서비스 종료로 인해 삭제되지 않았으므로 직접 서버를 운영하는 데 제약은 없습니다. 규모에 대해서는 현실적으로 판단해야 합니다. 100만 토큰의 컨텍스트 윈도우를 가진 모델은 일반적인 VPS에서 처리할 수 있는 작업이 아니며, GPU가 장착된 VPS나 전용 머신이 필요합니다. 더 작은 로컬 모델은 다른 경우이며, LLM을 직접 호스팅하기 위해 VPS에서 Ollama 실행하기와 더 유사합니다.

MiMo-Code는 다른 공급업체와도 연결할 수 있습니다. 기존 Claude Code 로그인을 마이그레이션하거나, OpenAI 계정을 연결하거나, 다른 공급업체의 API 키를 입력하거나, OpenAI 호환 엔드포인트와 통신할 수 있습니다. 연결하기 전에 소비자 구독 약관을 확인하십시오. 공급업체 약관에 따라 구독 플랜을 사용할 수 있는 클라이언트가 결정되며, 다른 공급업체의 CLI는 지원되지 않을 수도 있기 때문입니다.

Claude Code에서 전환해야 합니까?

이미 Claude Code 비용을 지불하고 있고 정상적으로 작동한다면, 전환할 필요가 없습니다. 2026년 11월 13일에 릴리스되었으며 2026년 11월 17일 기준으로도 최신 버전인 0.1.17 버전이 그 신뢰할 수 있는 지표입니다. Semantic Versioning 체계에서 0.1.x 버전 번호는 불안정성을 허용한다는 의미이지, 릴리스가 호환성을 깨뜨리거나 설정 형식을 변경한다는 것을 확정하는 것은 아닙니다. 팀이 의존하는 도구를 업그레이드하기 전에 릴리스 노트를 확인하십시오.

다음 네 가지 상황에서는 MiMo-Code를 진지하게 고려해 볼 만합니다.

  • 비용이 문제인 경우입니다. Xiaomi의 토큰 가격은 최첨단 모델 제공업체보다 훨씬 낮으며, 에이전트 자체는 무료입니다.
  • 하네스를 읽어야 하는 경우입니다. 오픈 소스는 프롬프트와 도구 정의를 직접 검사할 수 있음을 의미하며, 이는 보안 검토나 감사 시 중요합니다.
  • 에이전트와 모델을 별도로 구매하여, 하나를 변경할 때 다른 하나까지 강제로 변경하지 않기를 원하는 경우입니다.
  • 코드가 네트워크를 벗어나서는 안 되는 경우입니다. 오픈 웨이트 모델을 사용하면 협상 없이도 자체 호스팅 백엔드를 구축할 수 있습니다.

Cursor와 Copilot은 비교 대상이 다릅니다. 두 도구는 에디터 내부에서 작동하지만, MiMo-Code는 터미널에서 작동합니다. 이러한 차이는 어떤 벤치마크 점수보다도 작업 방식에 더 큰 영향을 미치며, Claude Code와 Cursor, Codex 및 Copilot의 비교에서 해당 트레이드오프를 자세히 다룹니다.

이미 임대 중인 VPS에서 MiMo-Code 실행하기

터미널 에이전트는 서버에서 실행해야 합니다. 에이전트는 세션을 몇 시간 동안 유지해야 하며, 안정적인 네트워크가 필요하고, 노트북 덮개를 닫아도 계속 작동해야 합니다. 작업 방식은 다른 터미널 에이전트와 동일합니다. tmux를 사용하여 VPS에서 코딩 에이전트 실행하기에서 설명한 것처럼, 작은 서버에 장기 실행 세션을 두고 어디서든 다시 접속하는 방식입니다. 해당 서버에서 두 개 이상의 에이전트가 작동하게 되면, Claude Code는 한 세션에서 다른 세션으로 텍스트를 직접 전달할 수 있어 tmux 창 사이에서 수동으로 출력을 옮길 필요가 없습니다.

전용 권한 없는 사용자를 생성하고, 유일한 사본이 아닌 저장소의 복제본을 가리키도록 설정하십시오. 에이전트의 접근 범위는 실행되는 계정의 권한으로 제한되며, 이는 프롬프트가 잘못되었을 때 작동하는 유일한 제어 수단입니다.

이 프로젝트는 두 가지 방식으로 배포됩니다. HTTPS를 통해 제공되는 셸 설치 프로그램과 Node.js가 설치된 모든 머신을 위한 @mimo-ai/cli라는 이름의 npm 패키지입니다. v0.1.16 버전부터 npm 패키지는 제한적인 지원만 제공하는 단순한 런처로 변경되었으므로, Xiaomi는 네이티브 설치 프로그램을 권장합니다. 중요한 서버라면 설치 프로그램을 다운로드하여 내용을 검토한 후 실행하십시오. 해당 서버에 설치할 만한 다른 도구들에 대한 전체적인 내용은 셀프 호스팅 AI 에이전트 모음을 참조하십시오.

FAQ

MiMo-Code는 무료입니까?

에이전트는 MIT 라이선스를 따르는 오픈 소스이므로 누구나 코드를 읽고 수정할 수 있습니다. 비용이 발생하는 부분은 에이전트가 사용하는 모델입니다. Xiaomi는 출시 당시 MiMo Auto라는 기간 한정 무료 채널을 제공했으나 2026년 7월 26일부로 MiMo-Code의 무료 사용 기간을 종료했으므로 유료 사용을 계획해야 합니다. 2026년 5월 27일 영구적인 가격 인하를 통해 MiMo-V2.5-Pro의 가격은 캐시 미스 시 입력 토큰 100만 개당 $0.435, 출력 토큰 100만 개당 $0.87로 책정되었습니다. Xiaomi는 2026년 10월 21일 MiMo-V2.5-Pro 서비스를 종료했으며, 후속 모델인 MiMo-V2.6-Pro는 2026년 11월 17일 기준으로 동일한 요금이 적용됩니다. 또한 MiMo-Code를 OpenAI 호환 엔드포인트에 연결하여 다른 공급업체에 비용을 지불하고 사용할 수도 있습니다.

MiMo-Code와 OpenCode는 같은 것입니까?

MiMo-Code는 OpenCode의 포크로 시작되었으며 여전히 핵심 코드를 공유합니다. 터미널 인터페이스, 플러그인 시스템, 공급자 추상화 및 MCP 통합 기능은 모두 해당 코드베이스에서 가져온 것이며, 저장소의 LICENSE 파일에 OpenCode 저작권 문구가 유지되고 있습니다. Xiaomi는 여기에 SQLite 전문 검색 기반의 영구 메모리 계층, 서브 에이전트 오케스트레이션, /compose-next 전달 기술, 그리고 자사 모델에 대한 직접 접근 기능을 추가했습니다. OpenCode를 알고 있다면 MiMo-Code의 작동 방식 대부분을 이미 알고 있는 셈입니다.

Xiaomi 모델 대신 Claude나 GPT 모델을 MiMo-Code와 함께 사용할 수 있습니까?

네, 가능합니다. 최초 설정 시 기존 Claude Code 로그인 정보를 마이그레이션하거나, OpenAI 계정을 연결하거나, 다른 공급업체의 API 키를 입력할 수 있습니다. 또한 ~/.config/mimocode/mimocode.jsonc에서 OpenAI 호환 엔드포인트를 수동으로 설정할 수 있습니다. 소비자 구독 서비스의 약관은 공급업체가 클라이언트의 구독 플랜 사용 가능 여부를 결정하므로, 연결하기 전에 해당 약관을 확인하십시오.

MiMo-Code를 메인 머신에서 실행해도 안전합니까?

셸 명령을 실행할 수 있는 모든 에이전트와 동일하게 취급해야 합니다. 빌드 모드에서는 기본적으로 대부분의 작업을 허용하며, 특정 작업 시에는 사용자에게 확인을 요청합니다. --dangerously-skip-permissions은 명시적인 ask 및 deny 규칙을 유지하면서 모든 작업을 허용하는 기반을 추가합니다. 가급적 권한이 제한된 전용 사용자 계정으로 실행하고, 저장소를 복제한 환경에서 사용하며, 필요시 삭제하고 재구축할 수 있는 머신에서 실행하는 것을 권장합니다. 에이전트의 영향 범위는 실행 중인 계정의 권한으로 제한되므로 해당 계정의 권한을 최소한으로 유지하십시오.

이 글이 도움이 되었나요?