Claude Code에서 샤오미 MiMo-V2-Pro 및 StepFun Step 3.5 Flash 무료 모델 연동

1. 개요

Claude Code를 Anthropic 공식 모델 외 대안으로 활용하는 두 가지 방식을 소개합니다:

• 샤오미 MiMo-V2-Pro: 고성능 코드 생성 모델, 100만 토큰 컨텍스트, 유료 API 기반
• StepFun Step 3.5 Flash (무료): OpenRouter 경로로 호출되는 완전 무료 모델, 256K 컨텍스트, 에이전트 워크플로우 최적화

두 방식 모두 Claude Code의 Anthropic 호환 API 설정 기능을 활용합니다.

2. 사전 준비

• Node.js 18 이상: node --version 명령으로 버전 확인
• Claude Code 글로벌 설치:

npm install -g @anthropic-ai/claude-code

• 설정 파일 편집용 텍스트 에디터

파트 1: 샤오미 MiMo-V2-Pro (유료/API 방식)

3. MiMo API 키 발급

1. 샤오미 대규모 언어 모델 콘솔에 접속
2. "새 API Key 생성" 클릭, 이름 입력 후 생성
3. 생성된 키 복사 (sk-xxxxxxxxxxxxxx 형식), 안전하게 보관

⚠️ 주의: MiMo API는 유료 서비스입니다. 첫 주 무료 체험은 OpenCode Zen 모드에 한정되며, Claude Code의 API 호출에는 적용되지 않습니다. 사용 전 계정 잔액을 확인하세요.

4. Claude Code MiMo 연동 설정

4.1 로그인 단계 우회

사용자 홈 디렉터리에 .claude.json 파일 생성 또는 수정:

• Windows: %USERPROFILE%\.claude.json
• macOS/Linux: ~/.claude.json

내용 입력:

{
  "hasCompletedOnboarding": true
}

4.2 모델 및 환경변수 지정

.claude/settings.json 파일 생성 또는 수정:

• Windows: %USERPROFILE%\.claude\settings.json
• macOS/Linux: ~/.claude/settings.json

다음 구성 입력 (ANTHROPIC_AUTH_TOKEN을 실제 키로 교체):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xiaomimimo.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "실제_샤오미_API_키",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2-pro"
  }
}

모델명은 반드시 mimo-v2-pro (소문자)로 입력해야 합니다.

5. 실행 및 확인

프로젝트 디렉터리에서 claude 실행 후 /model 입력 시 mimo-v2-pro가 표시되면 정상입니다.

파트 2: StepFun Step 3.5 Flash (완전 무료)

6. StepFun Step 3.5 Flash 선택 이유

• 비용 제로: OpenRouter를 통한 호출로 어떤 요금도 발생하지 않음
• 우수한 성능: 256K 컨텍스트, 초당 92+ 토큰 처리 속도, 코드 생성 및 에이전트 작업 특화
• 국내 접속 가능: OpenRouter가 국내에서 직접 접속 가능, 알리페이 충전 지원 (무료 모델은 충전 불필요)

7. OpenRouter API 키 획득

1. OpenRouter에 접속하여 가입/로그인
2. 우측 상단 프로필 → API Keys → Create API Key 클릭
3. 생성된 키 복사 (sk-or-v1-xxxxxxxx 형식), 보관

무료 모델은 충전 없이 사용 가능합니다. OpenRouter 신규 가입자에게는 일정량의 무료 크레딧이 제공되며, 무료 모델의 일일 호출 한도는 계정 신뢰도에 따라 결정됩니다. 소액 충전(예: $5)으로 무료 모델 할당량을 크게 늘릴 수 있습니다.

8. Claude Code StepFun 3.5 Flash 연동

방법 A: 일회성 임시 사용 (테스트용)

터미널에서 환경변수 설정 후 Claude Code 실행:

Windows CMD:

set ANTHROPIC_BASE_URL=https://openrouter.ai/api
set ANTHROPIC_AUTH_TOKEN=sk-or-v1-본인의키
set ANTHROPIC_API_KEY=
claude --model stepfun/step-3.5-flash:free

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://openrouter.ai/api"
$env:ANTHROPIC_AUTH_TOKEN="sk-or-v1-본인의키"
$env:ANTHROPIC_API_KEY=""
claude --model stepfun/step-3.5-flash:free

macOS/Linux:

ANTHROPIC_BASE_URL="https://openrouter.ai/api" \
ANTHROPIC_AUTH_TOKEN="sk-or-v1-본인의키" \
ANTHROPIC_API_KEY="" \
claude --model stepfun/step-3.5-flash:free

방법 B: 영구 적용 (설정 파일 수정)

~/.claude/settings.json (또는 Windows 경로) 편집:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-or-v1-본인의키",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "stepfun/step-3.5-flash:free",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "stepfun/step-3.5-flash:free",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "stepfun/step-3.5-flash:free",
    "ANTHROPIC_MODEL": "stepfun/step-3.5-flash:free"
  }
}

⚠️ 모델명에 :free 접미사가 반드시 포함되어야 합니다. 그렇지 않으면 OpenRouter가 유료 채널로 라우팅할 수 있습니다.

9. StepFun 모델 적용 확인

Claude Code 실행 후 /model 입력 시 stepfun/step-3.5-flash:free가 표시되어야 합니다. /status 입력으로 API 엔드포인트 등 정보를 확인할 수 있습니다. 대화 테스트 시 어떤 비용도 발생하지 않습니다.

10. 자주 발생하는 문제와 해결

11. 추가 참고

• MiMo-V2-Pro 무료 체험: 첫 주 무료는 OpenCode Zen 모드 전용, Claude Code API 호출에는 해당 없음
• 무료 모델 권장: StepFun Step 3.5 Flash는 현재 Claude Code에서 사용 가능한 최고의 무료 대안으로, 성능이 우수하고 완전 무료
• 데이터 프라이버시: OpenRouter는 해외 플랫폼으로 데이터가 해외로 전송됩니다. 민감한 프로젝트는 규정 준수 여부를 검토하세요.