MiMo Code + JoinGonka Gateway: Gonka 네트워크 모델 기반 Xiaomi 에이전트

1단계: MiMo Code 설치하기. 프로젝트 README에 나온 공식 방법은 다음과 같습니다:

# macOS and Linux
curl -fsSL https://mimo.xiaomi.com/install | bash

# Windows (PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# via npm, on any system
npm install -g @mimo-ai/cli

스크립트는 바이너리를 ~/.mimocode/bin에 설치하고 셸 프로필을 통해 이 디렉터리를 PATH에 등록합니다(--no-modify-path 플래그로 끌 수 있습니다). 빌드는 Xiaomi 저장소에서 내려받습니다. 다운로드가 진행되지 않으면 npm으로 설치하세요. 동일한 릴리스이며, 두 방법 모두에서 0.1.15가 도착하는 것을 확인했습니다. 확인은 mimo --version으로 합니다.

2단계: 키 발급받기. gate.joingonka.ai/register에서 가입하고 주소를 인증한 뒤, «API 키» 섹션에서 jg- 접두사가 붙은 키를 만드세요. 키 하나와 잔액 하나로 네트워크의 모든 모델을 사용할 수 있습니다.

3단계: 설치 프로그램 실행하기.

npx @joingonka/setup --tool mimo-code

설치 프로그램이 키를 물어봅니다. 명령줄 인수로는 전달되지 않습니다. 그리고 MiMo Code 자체의 프로바이더 마법사와 동일한 두 파일을 작성하되, 전체 카탈로그와 한도가 처음부터 포함됩니다:

• 전역 설정 ~/.config/mimocode/mimocode.jsonc(MiMo Code가 이미 mimocode.json이나 config.json에 쓰고 있다면 그쪽)에 프로바이더 joingonka를 등록합니다: 어댑터 @ai-sdk/openai-compatible, /v1이 붙은 게이트웨이 주소, 컨텍스트 윈도우와 응답 상한, 도구 지원을 갖춘 네트워크의 세 모델.
• 키를 MiMo Code 자체 키 저장소인 ~/.local/share/mimocode/auth.json에 권한 600으로 저장합니다. 설정 파일 자체에는 키가 없으므로 닷파일에 안심하고 보관할 수 있습니다.
• 기본 모델인 model 필드를 DeepSeek V4 Flash로 설정합니다. 단, 선택되지 않았거나 네트워크에서 제거된 모델을 가리키는 경우에만 해당합니다. 다른 전역 설정에서 한 선택을 포함해 여러분이 직접 고른 것은 덮어쓰지 않습니다.
• 이전 파일의 사본을 저장하고, 다른 프로바이더와 키, 주석은 건드리지 않습니다. 파싱할 수 없는 파일은 덮어쓰지 않고 멈춰서 수정할 부분을 알려줍니다.
• 마지막으로 게이트웨이에 실제 요청을 보내 키, 주소, 모델이 수락되었는지 명확히 알려줍니다.

비표준 디렉터리는 설치 프로그램이 알아서 처리합니다: MIMOCODE_HOME, XDG_CONFIG_HOME, XDG_DATA_HOME, MIMOCODE_CONFIG. 다른 기본 모델은 --model 플래그로 지정하며, 축약형은 deepseek, glm, minimax입니다. 닷파일과 서버를 위한 무인 모드도 있습니다:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool mimo-code --non-interactive

MiMo Code가 실행 중이었다면 재시작하세요. 새 프로바이더는 시작할 때 반영됩니다.

설치 프로그램이 하는 일은 전부 직접 손으로 작성할 수 있습니다. 파일은 두 개뿐이고, 각자 맡은 역할이 있습니다. 설정 파일은 프로바이더와 모델을 기술하고, auth.json은 키를 보관합니다. 이 둘을 연결하는 것이 프로바이더 식별자 — joingonka가 두 파일에서 일치해야 합니다. 설정 파일은 ~/.config/mimocode/mimocode.jsonc입니다:

{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "provider": {
    "joingonka": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JoinGonka (Gonka)",
      "options": {
        "baseURL": "https://gate.joingonka.ai/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek V4 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 380000, "output": 32768 }
        },
        "zai-org/GLM-5.3-Flash": {
          "name": "GLM 5.3 Flash (Gonka)",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 390000, "output": 8192 }
        },
        "MiniMaxAI/MiniMax-M2.7": {
          "name": "MiniMax M2.7 (Gonka)",
          "tool_call": true,
          "limit": { "context": 200000, "output": 8192 }
        }
      }
    }
  },
  "model": "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"
}

키는 ~/.local/share/mimocode/auth.json에, 권한 600으로:

{
  "joingonka": { "type": "api", "key": "jg-your-key" }
}

기본 모델은 provider/model-id 형식으로 기록합니다. 프로바이더는 첫 번째 슬래시를 기준으로 분리되므로, 자체 슬래시가 들어간 네트워크 식별자는 그대로 적습니다.

키를 둘 수 있는 다른 위치. MiMo Code README에는 설정 파일에 키를 직접 넣는 방법도 소개합니다 — options.apiKey입니다. 작동은 하지만, 그렇게 하면 키를 닷파일과 함께 커밋하기 쉬워지고, 거기에 남아 있는 예전 키가 auth.json의 새 키를 덮어써 버립니다. 그래서 설치 프로그램은 자신의 블록에서 options.apiKey를 제거합니다. 프로젝트의 .mimocode/mimocode.jsonc에는 키를 더더욱 넣지 마세요.

어느 파일이 우선인가. 전역 config.json, mimocode.json, mimocode.jsonc는 이 순서로 병합되며, 뒤에 오는 것이 앞의 것을 덮어씁니다. 최종 결과는 mimo debug config로, 그리고 여러분 시스템의 설정 파일과 키 경로는 mimo debug paths로 확인할 수 있습니다.

파일 없이도 내장된 마법사를 사용하여 공급자를 설정할 수 있습니다. MiMo Code 프로젝트 디렉토리를 처음 열 때 폴더를 신뢰할 것인지 묻는 메시지가 표시됩니다(Yes, I trust this folder). 이를 선택하면 에이전트가 해당 디렉토리의 파일을 읽고, 수정하고, 실행할 수 있는 권한을 얻습니다. 그 후 /connect 명령을 실행하면 Select provider 목록이 나타납니다. 상단에는 Xiaomi MiMo 플랫폼 로그인, Codex 및 Claude Code에서 가져오기 옵션이 있고, 하단에는 공급자 목록이 있으며, 맨 끝에는 + Custom provider가 있습니다. 마법사에서 6가지 질문에 답하게 됩니다:

이번 실행에서 마법사는 제한 없는 모델 하나와 설치 프로그램에는 없는 두 가지 필드(JOINGONKA_API_KEY 변수가 포함된 env 및 options.setCacheKey: true)를 사용하여 공급자 블록을 생성했습니다. 게이트웨이를 통해 작동은 하지만 설정을 보완하는 것이 좋습니다. limit이 없으면 mimo models joingonka 실행 시 1M 토큰 창이 표시됩니다. 마법사를 마친 후 설치 프로그램을 한 번 더 실행하는 것이 가장 간단하며, 그러면 동일한 블록에 제한이 포함된 전체 카탈로그가 추가됩니다.

모델 선택. 설정 파일의 model 필드에서 영구적으로 모델을 선택할 수 있습니다. 인터페이스에서 모델을 변경하려면 /models 명령을 사용하고, 일회성 실행에는 -m 플래그를 사용하세요. MiMo Code가 인식하는 공급자의 모델과 윈도우 크기를 확인하려면 mimo models joingonka를 실행하세요. 여기에는 에이전트가 기록 압축을 시작하는 임계값도 표시됩니다:

joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 — window 380K, compacts at 342K
joingonka/MiniMaxAI/MiniMax-M2.7 — window 200K, compacts at 180K
joingonka/zai-org/GLM-5.3-Flash — window 390K, compacts at 351K

네트워크상의 모든 모델 가격은 동일하므로 선택은 동작 방식에 따라 결정됩니다. mimo run을 통해 단일 작업(파일을 읽고 오류 찾기)을 테스트한 결과는 다음과 같습니다:

DeepSeek V4 Flash가 기본값으로 선택된 이유는 모델 개요에서 확인할 수 있습니다.

먼저 MiMo Code가 프로바이더와 키를 인식하는지 확인하세요:

mimo models joingonka
mimo providers list

첫 번째 명령은 위 예시처럼 컨텍스트 윈도우와 함께 네트워크의 세 가지 모델을 나열합니다. 두 번째는 키 저장소 경로와 joingonka api 줄을 출력합니다. 그다음 단일 실행입니다. 프로젝트 디렉터리에 명백한 버그가 있는 calc.py 파일을 넣으세요 — 예를 들어 변을 곱하는 대신 더해버리는 직사각형 넓이 계산처럼 — 그리고 그것을 찾아달라고 요청하세요:

mimo run "Read the file calc.py in the current project directory and tell me in one sentence whether it has a bug."

출력에는 에이전트와 모델(> build · deepseek-ai/DeepSeek-V4-Flash-0731), 도구 호출(→ Read calc.py), 그리고 잘못된 표현을 지적하는 본질적인 답변이 표시됩니다. --format json 플래그를 사용하면 출력이 이벤트 스트림으로 바뀌고 각 단계에 토큰 카운터가 붙습니다. -m joingonka/<model-id>를 사용하면 다른 모델로 실행할 수 있습니다. 저희 실행에서는 "요청 → 도구 호출 → 결과 → 답변" 사이클을 네트워크의 세 모델 모두 통과했습니다.

세 번째 확인은 게이트웨이 쪽입니다: 관리 화면의 "사용량" 섹션에서 요청이 "모델별" 내역에 표시되고, "키별" 블록에서는 마지막 요청 시간이 갱신됩니다.

문제가 발생하면 진단은 보통 메시지에서 바로 읽을 수 있습니다:

에이전트 도구는 일반 채팅과 다른 방식으로 토큰을 소비합니다. MiMo Code는 사용자의 각 문구에 시스템 프롬프트, 도구 설명, 에이전트 서비스 컨텍스트를 추가하며 작업은 여러 단계로 진행됩니다. 이번 실행에서 모델에 대한 각 요청은 22,000~25,000개의 입력 토큰을 포함했고, '파일을 읽고 오류를 찾는' 2단계 작업에 약 45,000~50,000개의 토큰이 소요되었으며, 거의 대부분이 입력 토큰이었습니다. 따라서 토큰 단가가 여기서 결정적인 역할을 합니다.

JoinGonka Gateway를 통한 토큰 가격은 입력 100만 토큰당 $0.0069, 출력 100만 토큰당 $0.021입니다. 이 가격은 네트워크의 모든 모델에 동일하게 적용되며, 이 페이지에서 실시간 소스를 통해 가져옵니다.

오른쪽 추정치는 2026년 9월 가격 기준입니다. 참고로 MiMo Code에서 모델을 사용하는 일반적인 결제 방법은 다음과 같습니다:

MiMo Code 내 게이트웨이 모델에 대한 자체 비용 평가는 0입니다. 기록에 cost 필드가 없으며 --format json 이벤트에서 "cost": 0으로 표시되기 때문입니다. 실제 소비량과 잔액은 관리 페이지의 '사용량' 및 '빌링(Billing)' 섹션에서 확인하세요.

권한. MiMo Code 인터페이스는 위험한 작업에 대해 확인을 요청하지만, mimo run은 확인할 대상이 없으므로 프로젝트 외부 접근 요청을 자동으로 거부합니다. 신뢰할 수 있는 일회성 환경을 위해 --dangerously-skip-permissions 플래그(또는 MIMOCODE_DANGEROUSLY_SKIP_PERMISSIONS=1 환경 변수)가 있으며, 이는 명시적으로 금지되지 않은 모든 작업을 허용하므로 컨테이너나 샌드박스 안에서만 사용하십시오. 인터페이스에서는 /skip-permissions 명령어로 세션 동안 비슷한 모드를 활성화할 수 있습니다.

에이전트. 기본적으로 build는 전체 도구 모음으로 작동하고, plan은 읽기 및 분석만 수행하며, compose는 사양에서 검증된 코드까지의 과정을 실행합니다. 이들은 Tab 키로 전환합니다.

긴 컨텍스트. 컨텍스트 윈도우 제한에 도달하면 MiMo Code는 최신 체크포인트, 프로젝트 메모리 및 최신 메시지로부터 컨텍스트를 재구성합니다. 임계값은 limit.context로부터 계산됩니다. 더 일찍 압축하려면 모델별로 /context-limit 명령어를 사용하십시오.

Xiaomi 계정 연동. 음성 입력(/voice)은 MiMo 플랫폼 모델로 음성을 인식하며 로그인 후에 이용 가능합니다. 코드, 명령어, 서브 에이전트는 연결된 공급자를 통해 작동하므로 로그인 없이도 실행할 수 있습니다.

이미지. 네트워크 모델은 텍스트 기반입니다. /modalities에는 텍스트만 남기고, 스크린샷은 시각 기능이 있는 모델을 가진 다른 공급자를 설정하십시오.

MiMo Code와 OpenCode는 설정이 다른 형제 프로젝트입니다. 각각 고유한 디렉터리와 파일을 가지고 있으므로 한쪽 설정이 다른 쪽에 전달되지 않습니다:

버전. 프로젝트는 자주 업데이트되므로 재현성을 위해 버전을 고정하십시오: npm install -g @mimo-ai/[email protected] 또는 curl -fsSL https://mimo.xiaomi.com/install | bash -s — --version 0.1.15.

네트워크가 지원하는 패밀리의 연구소에서도 에이전트를 제공합니다. MiniMax Code는 벤더인 MiniMax M2.7 모델로 작동하며, DeepSeek와 GLM의 저자인 Z.ai도 자체 에이전트를 보유하고 있습니다. 이들은 모두 하나의 키로 동일한 게이트웨이에 연결됩니다.