MiMo Code API 키 설정 — 터미널 코딩 에이전트 가이드

MiMo Code (샤오미 터미널 AI 코딩 에이전트 / MiMoCode CLI)는 **/connect**를 통해 타사 LLM에 연결합니다. APIMaster.ai는 https://apimaster.ai/v1에서 OpenAI 호환 API를 제공합니다. **사용자 정의 제공자(Custom provider)**를 추가하고 API 키로 설정하면 구성 파일을 수동으로 편집하지 않고도 Claude, GPT, DeepSeek 및 기타 마켓플레이스 모델을 호출할 수 있습니다.

이 가이드에서 다루는 내용: 설치 → mimo 실행 → /connect 마법사 → 제공자 ID / 기본 URL / API 키 → 모델 ID → 테스트 채팅.

먼저 API 키를 받으세요. 키는 MiMo Code 내에서만 붙여넣고 채팅이나 스크린샷에 절대 공유하지 마세요.

---

필수 조건

1. 최신 터미널 (MiMo Code 설치 가이드 참조).
2. MiMo Code CLI 설치.
3. 콘솔에서 APIMaster API 키.

---

1단계 — MiMo Code 설치

macOS / Linux:

curl -fsSL https://mimo.xiaomi.com/install | bash

Windows:

npm install -g @mimo-ai/cli

자세한 내용은 설치 및 실행을 참조하세요.

---

2단계 — 실행 및 /connect 실행

mimo

MiMo Code 내에서 **/connect**를 실행하거나 /con을 입력하고 Connect provider를 선택하세요.

---

3단계 — 기타 제공자 → 사용자 정의 제공자

1. Select provider에서 Other providers를 선택하세요(샤오미 공식 또는 MiMo Auto 무료 채널 제외).
2. Connect a provider에서 + Custom provider를 선택하세요.

---

4단계 — 6단계 마법사

단계	필드	값
1/6	제공자 ID	apimaster
2/6	표시 이름	apimaster 또는 APIMaster.ai
3/6	기본 URL	https://apimaster.ai/v1 (/v1 포함)
4/6	API 키	귀하의 APIMaster 키
5/6	첫 번째 모델 ID	예: gpt-5.4 또는 claude-sonnet-4-6 (마켓플레이스 ID)

각 단계를 제출하려면 Enter를 누르고, 취소하려면 Esc를 누르세요.

---

5단계 — 추가 모델 추가 (선택 사항)

apimaster 제공자 메뉴에서 + Add model을 사용하여 추가 ID(gpt-5.5, claude-opus-4-8, …)를 추가하세요.

사용할 모델을 선택하세요(예: gpt-5.4). **Connect provider ctrl+a**를 사용하면 제공자를 전환할 수 있습니다.

---

6단계 — 테스트 채팅

상태 표시줄에 모델이 표시되는지 확인하고(예: Build · gpt-5.4), hello를 보내 정상 응답을 확인하세요.

---

문제 해결

문제	해결 방법
connect를 찾을 수 없음	mimo 내에서 실행하고 /를 입력하여 명령어 목록 보기
MiMo Code에서 API 키 변경	/connect 다시 실행하거나 apimaster 제공자 편집
401 / 잘못된 키	콘솔에서 키를 다시 복사하세요
Base URL 오류	https://apimaster.ai/v1을 정확히 사용하세요
어떤 모델 ID를 사용할까요?	마켓플레이스 ID와 일치시키세요. 예: gpt-5.4, claude-sonnet-4-6
모델 응답 없음	마켓플레이스 모델 ID와 일치시키고 API 연결 테스트 시도

---

관련 항목

• 에이전트 개요 · OpenAI 호환 가이드
• MiMo Code 설치