MiniMax M3.1 Flash: Claude Code·OpenCode·Cline 설정
정확한 모델 ID와 제공업체 설정으로 MiniMax M3.1 Flash를 연결하고 무료 프로모션 이후의 유료 이용 경로를 준비하세요. 토큰 단가와 실제 코딩 작업을 성공적으로 마치는 데 드는 비용을 구분해 비교합니다.
목차
Claude Code나 OpenCode에서 MiniMax M3.1 Flash를 직접 이용하려면 MiniMax의 Anthropic 호환 API를 사용하고 모델을 MiniMax-M3.1-Flash로 명시적으로 선택하세요. 기본 URL만 변경해서는 모델이 선택되지 않으며, Cline에서는 내장 OpenRouter 연동으로 OpenRouter의 현재 모델 ID를 선택해야 합니다. 기본 모델을 바꾸기 전에는 저장소에서 범위를 좁힌 작업 하나를 먼저 시험해 보세요. 공개된 토큰 단가는 Flash를 평가할 근거가 되지만, 수정 작업을 성공적으로 끝내는 데 드는 비용까지 알려 주지는 않습니다.
아래 정보는 2026-10-22 기준으로 업데이트했습니다.
MiniMax M3와 무엇이 달라졌나요?
M3.1 Flash는 서버에서 제공되는 모델로 이용할 수 있으며, Space Bunny는 그보다 앞서 익명으로 공개된 버전입니다. MiniMax의 2026-10-19 출시 발표는 두 모델의 관계와 API 제공을 확인하면서 모델 가중치는 나중에 공개한다고 설명합니다. 따라서 이전에 Space Bunny로 진행한 세션을 최종 릴리스를 동일한 조건에서 검증한 평가로 볼 수는 없습니다.
M3와 M3.1 Flash 모두 입력과 출력을 합쳐 1,000,000 토큰의 컨텍스트 창을 제공합니다. 실제 선택에 영향을 주는 차이는 낮아진 공개 토큰 단가와 Flash의 필수 추론 모드입니다. M3는 추론 기능인 thinking을 끌 수 있지만 Flash는 이 설정을 거부합니다. Flash의 추론 노력 수준은 low부터 max까지이며 기본값은 max입니다. 수준을 높이면 생성되는 추론 내용과 응답 지연이 늘어날 수 있습니다.
저장소 구조 파악, 범위가 명확한 버그 수정, 결과를 검증할 수 있는 테스트 작성부터 Flash를 사용해 보세요. 애플리케이션에 추론을 끈 응답 모드가 필요하다면 M3.1 Flash는 그 조건을 충족하지 못합니다. 백만 토큰 컨텍스트는 처리 가능한 용량의 한도이며, 요금에 포함된 사용량을 뜻하지 않습니다.
무료 이용은 언제 종료되나요?
긴 세션을 시작하기 전에 무료 프로모션 이후 어떤 경로로 계속 이용할지 정하세요. 각 제공업체의 프로모션은 별개이며 MiniMax 전체에 적용되는 하나의 무료 기간이 아닙니다.
| 이용 경로 | 2026-10-22 기준으로 확인한 공개 조건 | 계속 이용할 때 할 일 |
|---|---|---|
| OpenRouter | minimax/minimax-m3.1-flash:free의 공지된 무료 이용 종료 시각은 2026-10-22 12:00 UTC입니다. | OpenRouter 공지에 따르면 이 시각 이후 무료 변형이 종료됩니다. minimax/minimax-m3.1-flash를 선택하고 유료 사용에 필요한 잔액을 충전하세요. |
| Ollama Cloud | 공지된 무료 이용 종료 시각은 2026-10-22 23:59 UTC이며 CLI 태그는 minimax-m3.1-flash:cloud입니다. | 표시된 유료 요금과 Ollama 계정의 결제 설정을 확인하세요. 이 경로는 클라우드에서 모델을 실행합니다. |
| OpenCode의 호스팅 모델 서비스 | minimax-m3.1-flash-free가 한시적 무료 모델로 등록되어 있습니다. 문서에는 정확한 종료 시각이 없습니다. | 현재 모델 목록을 확인하거나 아래 설명에 따라 MiniMax 직접 연결용 제공업체를 설정하세요. |
OpenRouter의 공개된 무료 모델 제한은 분당 20회, 하루 50회 요청입니다. 크레딧을 최소 $10 구매하면 하루 한도가 1,000회로 늘어납니다. 실패한 시도도 하루 한도에 포함됩니다. 코딩 작업 하나에 여러 요청이 필요할 수 있으므로, 프로모션 종료 시각만으로 긴 에이전트 세션에 충분한 요청 한도가 남아 있는지는 알 수 없습니다.
Claude Code: 엔드포인트, 인증 정보, 모델 별칭 설정
원하는 과금 방식에 맞는 MiniMax 키를 사용하세요. 일반 종량제 키는 MiniMax 플랫폼의 API Keys → Create new secret key에서 만듭니다. M Plan Subscription Key는 구독에 포함된 사용량과 해당되는 크레딧 팩을 소비합니다. 두 키 유형은 과금 방식이 별개이며, 뒤에 나오는 비용 계산은 일반 직접 API 요금을 기준으로 합니다.
아래 예시는 Claude Code가 설치되어 있고 현재 디렉터리가 프로젝트 디렉터리라고 가정합니다. 실행 전에 해당되는 ~/.claude/settings.json, 프로젝트의 .claude/settings.json, .claude/settings.local.json에서 충돌하는 제공업체나 인증 정보 항목을 제거하세요. Claude Code의 환경 변수 문서에 따르면 설정 파일의 env 값은 일반적으로 셸에서 상속한 동일한 환경 변수 값을 덮어씁니다. 충돌하는 설정이 남아 있다면 새 값을 export하는 것만으로는 충분하지 않습니다.
macOS, Linux 또는 WSL의 Bash에서 첫 줄을 실행하고 MiniMax 키를 붙여 넣은 다음 Enter를 누르세요. 입력 내용은 화면에 표시되지 않습니다.
read -rs MINIMAX_API_KEY && export MINIMAX_API_KEY
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$MINIMAX_API_KEY"
export ANTHROPIC_BASE_URL="https://api.minimax.io/anthropic"
export ANTHROPIC_MODEL="MiniMax-M3.1-Flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="524288"
claude --model "$ANTHROPIC_MODEL"이 예시는 MiniMax의 Claude Code 설정 안내를 따르면서 인증 정보는 셸로 전달합니다. 기본 모델과 Sonnet, Opus, Haiku 별칭을 함께 설정하며, 토큰은 bearer 인증에 사용됩니다.
[1m] 접미사는 사용자 지정 모델이 백만 토큰 컨텍스트를 지원한다는 사실을 Claude Code에 알려 줍니다. Claude Code는 API 요청을 보내기 전에 이 접미사를 제거합니다. 다른 클라이언트에서는 접미사 없는 MiniMax-M3.1-Flash ID를 사용하세요. 524288은 MiniMax가 권장하는 자동 컨텍스트 압축 기준이며, 모델 자체의 컨텍스트 사양이 더 작다는 뜻은 아닙니다.
Claude Code 안에서 다음을 실행하세요.
/status
/modelMiniMax 엔드포인트와 활성 M3.1 Flash 모델을 확인하세요. 그런 다음 README.md가 있는 저장소에서 다음 요청을 보내세요.
Read README.md and summarize the project's purpose in one paragraph. Do not edit files or run commands.실제로 파일을 읽는 도구 동작이 발생하는지, 답변이 해당 파일의 내용을 근거로 하는지 확인하세요. README의 특정 부분에 관한 후속 질문도 보내 대화 기록을 사용하는 과정까지 확인하세요. 모델 선택기에 이름이 표시되는 것만으로는 선택되었다는 사실만 알 수 있습니다.
인증이 401로 실패하면 키의 계정과 서비스 리전을 확인하고, 설정에 충돌하는 인증 정보가 없는지 살핀 뒤 다시 시도하세요. /status에 계속 다른 엔드포인트가 표시된다면 설정 충돌을 해결하고 새 세션을 시작하세요.
OpenCode: MiniMax 직접 연결용 제공업체 설정
MiniMax가 문서화한 Anthropic 어댑터로 종량제 키를 사용할 사용자 지정 제공업체를 만드세요. 다음 내용을 ~/.config/opencode/opencode.json에 병합하되, 기존에 필요한 다른 설정은 유지하세요.
{
"$schema": "https://opencode.ai/config.json",
"model": "minimax-direct/MiniMax-M3.1-Flash",
"provider": {
"minimax-direct": {
"npm": "@ai-sdk/anthropic",
"options": {
"baseURL": "https://api.minimax.io/anthropic/v1",
"apiKey": "{env:MINIMAX_API_KEY}"
},
"models": {
"MiniMax-M3.1-Flash": {
"name": "MiniMax-M3.1-Flash",
"limit": {
"context": 524288
}
}
}
}
}
}추가된 /v1은 의도된 설정입니다. MiniMax의 OpenCode 안내에 따르면 @ai-sdk/anthropic은 기본 URL에 /messages를 덧붙입니다. Claude Code에는 https://api.minimax.io/anthropic을 사용하지만, 이 어댑터에는 https://api.minimax.io/anthropic/v1을 사용합니다.
OpenCode는 사용자 지정 제공업체 옵션을 지원하며 {env:MINIMAX_API_KEY}를 실행 환경의 해당 변수 값으로 치환합니다. 새 Bash 터미널을 열었다면 키를 다시 입력한 다음 모델을 실행하세요.
read -rs MINIMAX_API_KEY && export MINIMAX_API_KEY
opencode --model minimax-direct/MiniMax-M3.1-Flash/models로 제공업체와 모델을 확인하고, README 읽기와 후속 질문 검증을 반복하세요. 결과는 터미널 세션에 표시됩니다.
인증에 실패하면 OpenCode를 실행한 바로 그 터미널에 환경 변수가 설정되었는지 확인하세요. 다른 제공업체가 계속 활성화된다면 전역 설정을 덮어쓸 수 있는 프로젝트의 opencode.json을 살펴보세요. 요청 경로 오류가 발생하면 어댑터와 /anthropic/v1 기본 URL을 함께 점검하세요.
Cline: 내장 OpenRouter 연결 사용
OpenRouter 키로 Cline을 연결하고 OpenRouter의 모델 ID를 선택하세요. Cline의 공식 설정 가이드는 이 제공업체에 대해 다음 절차를 안내합니다.
- 톱니바퀴 아이콘을 눌러 Cline 설정을 엽니다.
- API Provider에서 OpenRouter를 선택합니다.
- OpenRouter API Key에 자신의 OpenRouter API 키를 입력합니다.
- 유료로 계속 사용하려면
minimax/minimax-m3.1-flash를 선택합니다. 프로모션용minimax/minimax-m3.1-flash:freeID의 공지된 종료 시각은 2026-10-22 12:00 UTC입니다. - 사용자 지정 기본 URL은 설정하지 않은 채 새 대화를 시작하고, README 읽기와 후속 질문 검증을 반복합니다.
Cline 작업 패널에서 모델 답변과 파일에 대한 도구 동작을 확인하세요. 이 경로는 OpenRouter를 통해 과금됩니다. Standard 플랜은 크레딧을 구매할 때 5.5%를 추가하며, 각 요청에 별도로 이 수수료를 부과하는 방식은 아닙니다. 적용되는 세금은 추가됩니다.
429가 나오면 다시 시도하기 전에 무료 모델의 요청 한도를 확인하세요. 무료 ID가 종료된 뒤에는 크레딧만 추가해도 모델 선택이 바뀌지 않으므로 기본 ID를 직접 선택해야 합니다. OpenRouter 문서에 따르면 제공이 종료된 모델의 404 응답에는 no endpoints for this model found가 포함될 수 있습니다.
BetterToken: 하나의 키로 여러 모델 제공업체 이용
하나의 키로 여러 모델 제공업체를 종량제로 이용하고 싶다면 BetterToken을 선택할 수 있습니다. 모델 카탈로그에는 MiniMax-M3.1-Flash가 OpenAI Chat Completions, Anthropic Messages, Responses 엔드포인트를 지원하는 모델로 등록되어 있습니다. 모델 제공업체에 직접 비용을 지불하려면 MiniMax 직접 연결을, 앞서 설명한 Cline 내장 연결을 사용하려면 OpenRouter를 선택할 수 있습니다.
BetterToken 계정을 만드세요. 그런 다음 콘솔에서 자신의 API 키를 생성하세요. 현재 BetterToken 가격과 계정에 적용되는 요금을 확인해야 합니다. 아래의 직접 제공업체 비용 표는 BetterToken의 청구 금액을 나타내지 않습니다.
Claude Code에서는 문서에 안내된 Anthropic 호환 기본 URL인 https://bettertoken.ai를 사용하며, /v1을 붙이지 않습니다. 전환 전에 ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json에서 충돌하는 제공업체, 인증 정보, 모델 설정을 제거하세요. 설정 파일의 env 값이 셸의 값을 덮어쓸 수 있습니다.
macOS, Linux 또는 WSL의 Bash에서 첫 줄을 실행하고 BetterToken 키를 붙여 넣은 다음 Enter를 누르세요. 입력 내용은 표시되지 않습니다. 그다음 나머지 명령을 실행하세요.
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
unset ANTHROPIC_API_KEY
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_MODEL="MiniMax-M3.1-Flash"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
claude --model "$ANTHROPIC_MODEL"/status와 /model로 BetterToken 엔드포인트와 선택된 모델을 확인한 다음, README 읽기와 후속 질문 검증을 반복하세요. 401이 나오면 자신의 BetterToken 계정 키인지, 설정 파일의 다른 항목이 그 값을 덮어쓰고 있지 않은지 확인하세요. 엔드포인트가 잘못되었다면 충돌을 해결하고 새 세션을 시작하세요.
- OpenCode: 사용자 지정 제공업체 안내를 따르세요.
~/.config/opencode/opencode.json에 제공업체bettertoken을 추가하고npm을@ai-sdk/openai-compatible,options.baseURL을https://www.bettertoken.ai/v1로 설정합니다.models아래에는MiniMax-M3.1-Flash를 등록하세요./connect를 실행하고 Other를 선택한 뒤 제공업체 IDbettertoken을 입력하고 BetterToken 키를 저장합니다.opencode --model bettertoken/MiniMax-M3.1-Flash로 시작하세요. - Cline: OpenAI Compatible 설정 안내를 따르세요. 설정의 API Provider에서 OpenAI Compatible을 선택하고 Base URL을
https://www.bettertoken.ai/v1로 지정합니다. 자신의 BetterToken API 키를 입력하고 Model을MiniMax-M3.1-Flash로 설정하세요. 저장한 뒤 Cline을 다시 로드합니다.
두 클라이언트 모두 긴 작업에 들어가기 전에 새 세션에서 README 읽기와 후속 질문을 다시 확인하세요. 이것은 API 이용 경로이며, 타사 도구의 계정과 구독은 별개입니다.
러시아에서는 VPN 없이 BetterToken API 엔드포인트에 접속할 수 있으며 BetterToken은 루블 결제를 지원합니다. 이 범위에는 타사 웹사이트, 다운로드, 로그인, 마켓플레이스, 업데이트가 포함되지 않습니다. 이용 가능한 결제 수단, 결제 가능한 카드, 최소 금액, 환율, 수수료, 잔액 반영 시간은 콘솔에서 확인하세요.
공식 벤치마크는 어떻게 읽어야 하나요?
벤치마크 표는 직접 평가할 작업을 고르는 데 활용하세요. Flash가 현재 모델보다 낫다고 전제하는 근거로 삼아서는 안 됩니다. 다음 네 항목은 MiniMax가 공개한 비교에서 개발 작업과 관련된 결과를 가져온 것입니다.
| 제공업체가 발표한 벤치마크 | MiniMax M3.1 Flash | DeepSeek-V4.1-Flash-1017 |
|---|---|---|
| Automation-Bench v1.0.6 | 62.8 | 60.5 |
| Terminal Bench 4.0 | 38.1 | 42.3 |
| DeepSWE v1.1 | 73.7 | 77.0 |
| NL2Repo-Bench | 61.2 | 68.2 |
자동화 항목은 MiniMax가 앞서고, 이 표의 터미널·코딩 관련 세 항목은 DeepSeek가 앞섭니다. DeepSWE 결과는 mini-SWE-agent 2.4.5와 512K 컨텍스트 제한을 사용했으며, NL2Repo는 Claude Code 2.1.233과 512K를 사용했습니다. 결과는 해당 평가 환경과 함께 해석해야 합니다.
MiniMax는 온라인 추론 속도가 거의 세 배이며 에이전트 작업 비용이 70% 낮다고도 발표합니다. 이는 제공업체의 주장이지, 자신의 저장소 수정이 세 배 빨리 끝나거나 70% 저렴해진다는 보장은 아닙니다. 출시 비교표에는 M3 열이 없으므로 이 표만으로 M3 대비 벤치마크 차이를 계산할 수 없습니다.
전체 작업 비용보다 먼저 토큰 요금을 비교하세요
먼저 청구되는 토큰 수를 동일하게 맞춰 비교하고, 그다음 각 모델이 실제로 작업을 끝내기까지 소비하는 양을 측정하세요. 2026-10-22 기준 MiniMax 요금표와 DeepSeek 요금표의 직접 API 요금은 다음과 같습니다. 단위는 1백만 토큰당 USD입니다.
| 직접 API 요금 | 캐시 미사용 입력 | 캐시 입력 | 출력 |
|---|---|---|---|
MiniMax-M3.1-Flash | $0.15 | $0.015 | $0.60 |
deepseek-flash, 피크 시간 | $0.30 | $0.006 | $1.20 |
deepseek-flash, 비피크 시간 | $0.15 | $0.003 | $0.60 |
현재 DeepSeek는 deepseek-flash를 DeepSeek-V4.1-Flash-1017에 연결합니다. 피크 시간은 중국 공휴일을 제외한 월요일–금요일의 01:00–04:00 및 06:00–10:00 UTC이며 나머지는 비피크 시간입니다.
M3와 비교하면 MiniMax가 공개한 M3 일반 요금은 입력 토큰이 ≤ 512k인 요청에 대해 입력 $0.30, 출력 $1.20, 캐시 입력 $0.06입니다. Flash의 일반 입력·출력 단가는 이 M3 단가의 절반입니다. 출시 발표의 전체 작업 비용 절감 주장을 모든 토큰 단가에 일괄 적용하는 배수로 사용해서는 안 됩니다.
u, c, o를 각각 캐시 미사용 입력, 캐시 입력, 출력이라고 하고, 단위는 청구된 토큰의 백만 개로 잡으면 다음과 같습니다.
MiniMax = 0.15*u + 0.015*c + 0.60*o
DeepSeek peak = 0.30*u + 0.006*c + 1.20*o
DeepSeek off-peak = 0.15*u + 0.003*c + 0.60*o아래는 토큰 요금 추정치이며 실제 작업을 실행해 얻은 결과가 아닙니다. 직접 종량제 API로 텍스트 요청을 보내고, 제공업체가 호스팅하는 유료 도구는 사용하지 않으며, 출력 수에는 과금되는 추론 토큰이 포함된다고 가정합니다. 계정별 세금과 결제 수수료는 제외되어 있습니다. BetterToken, OpenRouter 또는 구독의 청구서를 나타내는 금액도 아닙니다.
| 가정한 청구 대상 사용량 | MiniMax | DeepSeek 피크 | DeepSeek 비피크 |
|---|---|---|---|
| 캐시 미사용 입력 100,000 + 출력 20,000 | $0.02700 | $0.05400 | $0.02700 |
| 캐시 미사용 입력 10,000 + 캐시 적중 입력 90,000 + 출력 20,000 | $0.01485 | $0.02754 | $0.01377 |
두 번째 행에서 MiniMax 계산은 0.01 × $0.15 + 0.09 × $0.015 + 0.02 × $0.60 = $0.01485입니다. 가정한 캐시 적중량은 실제 적중률의 예측치가 아닙니다. 작업 전체 비용을 계산할 때는 캐시를 처음 만드는 요청과 모든 재시도도 포함해야 합니다.
MiniMax 캐싱은 자동으로 동작하며 입력이 512 토큰 이상인 호출에 적용됩니다. 새 입력은 일반 단가로, 실제 캐시 적중분은 캐시 단가로 과금합니다. DeepSeek 캐싱도 자동이지만, 재사용하려면 저장된 접두부 단위 전체와 일치해야 하며 캐시 적중이 보장되지는 않습니다. 여기서 접두부는 요청 앞부분의 연속된 내용을 뜻합니다.
MiniMax의 Anthropic 호환 응답에서는 input_tokens가 새 입력, cache_read_input_tokens가 캐시 적중분을 나타냅니다. OpenAI 호환 응답에서는 캐시 토큰이 prompt_tokens에 포함된 일부입니다. 두 방식의 사용량 집계 규칙을 구분하세요.
첫 번째 시나리오에서 Flash의 토큰 요금은 DeepSeek 피크 요금보다 낮고 비피크 요금과 같습니다. 두 번째에서는 DeepSeek 비피크 추정치가 더 낮습니다. 어느 계산도 수정 한 건을 완료하는 데 가장 적은 비용이 드는 모델을 결정하지는 못합니다.
기본 모델을 바꾸기 전에 작업 하나를 인수 테스트로 검증하세요
첫 평가는 코드 변경과 청구 금액을 모두 검증할 수 있을 만큼 작게 잡으세요. 같은 커밋의 깨끗한 복사본 두 개를 준비하고, 동일한 작업 설명, 클라이언트 버전, 저장소 지침, 도구 접근 권한, 인수 테스트를 사용하세요. 한 모델이 다른 모델의 조사 내용을 이어받지 않도록 대화도 별도로 시작해야 합니다.
선택한 모델, 제공업체, 추론 설정, 시작 시각, 소요 시간, 캐시 적중량, 캐시 미사용 입력, 출력, 재시도, 총 청구 금액을 기록하세요. 기준을 충족하는 결과를 얻기까지 필요했던 모든 시도와 유료 도구 비용, 중간 서비스 수수료도 포함하세요. 두 비용을 비교하려면 적어도 같은 인수 테스트를 통과해야 합니다.
추론 설정을 특히 확인하세요. MiniMax Flash는 thinking을 끌 수 없습니다. requires adaptive thinking이 포함된 400이 나오면 disabled/none 설정을 제거하고 작은 검증부터 다시 시도하세요. API 문서는 Anthropic 호환 요청의 노력 수준을 output_config.effort에, OpenAI 호환 요청의 수준을 reasoning_effort에 지정합니다. 제공업체별 노력 수준의 이름이 같아도 실제 연산량이 같다는 뜻은 아닙니다.
범위를 좁힌 코딩 작업에서 DeepSeek 피크 시간의 캐시 미사용 입력·출력 요금이 비용의 대부분을 차지한다면 Flash를 먼저 평가하세요. 비피크 시간에 실행할 수 있거나 캐시된 컨텍스트를 반복해서 재사용한다면 DeepSeek도 비교 대상으로 유지하세요. 다른 모델이 기준을 충족하는 변경을 더 적은 재시도, 더 낮은 총 청구액 또는 눈에 띄게 짧은 완료 시간으로 만든다면 초기 선택을 바꾸세요.
