_이 기사는 Medium에 먼저 게시되었습니다: [https://medium.com/@r3dtuxedo/free-until-thursday-claude-code-codex-and-opencode-on-minimax-m3-1-flash-41292135b0da]
참고: 아래 설명된 무료 프로모션은 종료되었습니다 (2026년 10월 22일까지 진행됨). 설정 단계는 유료 MiniMax API 및 Ollama Cloud 가격에도 여전히 적용됩니다.
제 Claude Code 설정의 업그레이드: 95% 저렴해진 비용, 1M 컨텍스트, 이미지 입력, M2.7 대비 절반 가격, 그리고 무료 기간 전에 시도할 수 있는 세 가지 복사-붙여넣기 설정
요약 (TL;DR)
- MiniMax M3.1 Flash는 2026년 10월 19일에 출시되었습니다. 이는 Ollama Cloud에서 2026년 10월 22일 목요일 23:59 UTC까지 무료입니다 (이는 베를린 시간으로 2026년 10월 23일 금요일 01:59입니다).
- OpenRouter의
:free 변형은 더 일찍 종료됩니다: 2026년 10월 22일 12:00 UTC (베를린 시간 14:00).
- 무료 기간 이후, 목록 가격은 1M 토큰당 입력 $0.15 / 출력 $0.60 / 캐시된 입력 $0.015입니다. 이는 제가 MiniMax-M2.7에 지불했던 금액의 절반입니다.
- 하나의 명령어로 Claude Code를 이 모델에 적용할 수 있습니다:
ollama launch claude --model minimax-m3.1-flash:cloud. Codex 및 OpenCode 설정은 아래에 있습니다.
- 기계 작업자(mechanical worker) 작업을 위해 사용하십시오. 계획 및 검토를 위한 프론티어 모델을 유지하십시오.
올해 초 저는 Claude Code 비용을 최대 95% 절감하는 방법에 대해 글을 썼습니다. 이 글은 MiniMax의 Anthropic 호환 엔드포인트를 통해 Claude Code를 MiniMax-M2.7로 연결했으며, 두 개의 쉘 함수인 claudecode와 claudeminimax를 사용했습니다. 또한 oh-my-claudecode와 어떻게 페어링할 수 있는지에 대해서도 다루었습니다.
그 설정은 여전히 아이디어로는 작동하지만, 그 아래의 모델이 교체되었습니다. MiniMax는 10월 19일에 M3.1 Flash를 출시했으며, Ollama가 이를 약 72시간 동안 무료로 제공하고 있습니다. 만약 비용을 지불하지 않고 실제 작업에 저렴한 백엔드를 테스트해보고 싶었다면, 지금이 바로 그 기회입니다.
이 글은 무엇이 변경되었는지, 세 개의 에이전트를 어떻게 연결하는지, 그리고 여전히 작동하지 않는 부분은 무엇인지 다룹니다.
M2.7에서 M3.1 Flash로 변경된 사항
헤드라인의 주장은 MiniMax에서 비롯되었으며 Ollama 페이지에도 반복됩니다: 이전 세대 대비 추론 속도가 "거의 3배 빠르고" "사용 비용이 70% 감소"했습니다. MiniMax에 따르면 출력은 초당 200 토큰 이상에 달할 수 있으며, 중앙값은 170을 상회합니다. OpenRouter가 무료 엔드포인트에 대해 공개한 통계는 지난 3일 동안 평균 약 76토큰/초를 보였습니다. 부하가 걸린 상태에서의 무료 출시 엔드포인트는 공정한 속도 테스트가 아니지만, 200을 기준으로 계획하지 마십시오.
Bar chart of list prices per 1M tokens: Opus 5.5 $4/$20, Sonnet 5.5 $2/$10, MiniMax-M2.7 $0.30/$1.20, MiniMax M3.1 Flash $0.15/$0.60
Anthropic의 현재 목록 가격(가격 책정 문서)과 비교했을 때, M3.1 Flash의 출력은 Sonnet 5.5 ($10)보다 94% 저렴하며 Opus 5.5 ($20)보다 97% 저렴합니다. 토크나이저는 공급업체마다 다르며, 더 오래 생각하는 모델일수록 더 많은 토큰을 사용하므로, 이를 작업당 가격이 아닌 토큰당 가격으로 간주해야 합니다.
벤치마크 (주의 사항 포함)
MiniMax는 DeepSWE v1.1에서 73.7%, OSWorld V2에서 61.7%, Agents' Last Exam에서 29.6%, BankerToolBench에서 76.2%, CyberGym에서 82%를 기록했다고 주장합니다. 이는 MiniMax 자체의 수치입니다.
독립적인 수치들은 더 혼재되어 있습니다. Artificial Analysis(OpenRouter에서 확인 가능)에 따르면, 이 모델은 지능 지수(Intelligence Index)에서 351개 중 21위로 42.7점을 받았으며 Claude Haiku 5.5 바로 아래 수준입니다. 또한 AA-Omniscience의 환각 방지율(non-hallucination rate)에서는 280개 중 256위에 해당하는 7.2%를 기록했습니다. 즉, M3.1 Flash가 모르는 것이 있을 때, 보통은 답변을 지어내는 경향이 있습니다. VentureBeat의 기사도 같은 점을 지적합니다. 마지막에 제시된 조언을 읽으실 때 이 점을 염두에 두시기 바랍니다.
세 가지 설정 방법
[Diagram: Claude Code, Codex CLI and OpenCode each route either to Ollama (local or ollama.com) or to the MiniMax API, both reaching MiniMax M3.1 Flash]
경로는 두 가지가 있습니다. Ollama는 마감일까지 무료이며, 무료 Ollama 계정이 필요합니다. 반면, MiniMax API는 유료 경로로 이후에도 계속 작동합니다. 절대 실제 키를 커밋하는 설정 파일에 붙여넣지 마십시오. 키는 환경 변수(environment)나 비밀 관리자(secrets manager)에 보관하십시오.
1. Claude Code
옵션 A: ollama launch (Ollama의 Claude Code 문서에서 안내하는 가장 빠른 방법):
ollama launch claude --model minimax-m3.1-flash:cloud
-- 뒤에 오는 모든 내용은 Claude Code로 전달되며, --yes는 스크립트의 프롬프트를 건너뜁니다:
ollama launch claude --model minimax-m3.1-flash:cloud --yes -- -p "summarize this repo"
옵션 B: 환경 변수(environment variables). 로그인된 로컬 Ollama를 통해 사용할 경우:
ANTHROPIC_AUTH_TOKEN=ollama \
ANTHROPIC_API_KEY="" \
ANTHROPIC_BASE_URL=http://localhost:11434 \
...
또는 로컬 설치 없이 Ollama의 클라우드에 직접 연결할 수도 있습니다. 클라우드 호출 시에는 :cloud 접미사 없이 호스팅된 이름만 사용합니다.
Ollama는 Claude 설정 파일이 셸 변수를 재정의할 수 있다고 알려줍니다. 실제로 어떤 엔드포인트를 사용하고 있는지 확인하려면 Claude Code 내부에서 /status를 실행하세요.
옵션 C: MiniMax 직접 사용, 업데이트된 claudeminimax. 이것은 첫 번째 기사의 함수이며, MiniMax의 Claude Code 가이드에서 모델 이름과 변수를 업데이트한 것입니다. [1m] 접미사와 512K 자동 압축 창(auto-compact window)은 MiniMax의 권장 사항입니다.
# ~/.zshrc: reads MINIMAX_API_KEY from your env or secrets manager
function claudeminimax(){
export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
...
어쨌든 이전 함수를 업데이트해야 합니다. MiniMax의 Anthropic SDK 페이지에는 이제 해당 엔드포인트에서 MiniMax-M3.1-Flash와 MiniMax-M3만 지원한다고 나열되어 있습니다. 이 함수는 exec으로 끝나기 때문에 변수가 세션과 함께 소멸되므로, 새 셸에서 단순하게 claude를 실행하는 것이 Anthropic 방식으로 돌아갑니다. 또한 MiniMax의 문서는 설정 마법사(npx -y mmx-cli@latest agent setup)도 제공하여 사용자 대신 ~/.claude/settings.json 파일을 작성해 줍니다. 환경 변수가 이 파일을 재정의한다는 것을 기억하세요.
2. Codex CLI
Ollama의 Codex 문서에는 런처(launcher)에 대한 내용도 포함되어 있습니다:
ollama launch codex # pick minimax-m3.1-flash:cloud in the model picker
또는 Codex의 내장된 Ollama 제공업체를 통한 수동 경로가 있습니다:
codex --oss -m minimax-m3.1-flash:cloud
한 가지 주의할 점이 있습니다: Ollama의 모델 페이지에는 이 모델에 대해 Claude Code, OpenCode, Hermes, 그리고 OpenClaw가 앱으로 나열되어 있지만, Codex는 그렇지 않습니다. Codex도 동일한 런처를 통해 작동해야 하지만, 이 조합은 테스트된 사례가 적으므로 작은 작업부터 시작하세요.
유료 경로의 경우, 이것은 MiniMax 자체의 Codex 설정입니다. 저는 인라인(inline)의 experimental_bearer_token을 Codex에서 문서화된 env_key로 교체하여 키가 파일에 포함되지 않도록 했습니다:
~/.codex/config.toml
model = "MiniMax-M3.1-Flash"
model_provider = "minimax"
...
MiniMax의 문서에는 /model에 추론 수준(reasoning levels)을 추가하는 선택적 모델 카탈로그도 포함되어 있습니다. "none" 노력 수준은 추가하지 마세요: M3.1 Flash는 항상 생각하며, API는 400 오류를 반환합니다.
3. OpenCode
Ollama의 모델 페이지에는 다음 한 줄 명령어가 제공됩니다:
ollama launch opencode --model minimax-m3.1-flash:cloud
이 명령어는 인라인 설정으로 OpenCode를 시작하고 ~/.config/opencode/opencode.json 파일을 건드리지 않습니다 (Ollama OpenCode 문서). MiniMax 직접 연결의 경우, /connect (또는 opencode auth login)을 사용하고 MiniMax를 선택한 다음 /models에서 MiniMax-M3.1-Flash를 선택하세요. 만약 현재 버전에서 해당 모델이 아직 목록에 없다면, MiniMax의 OpenCode 페이지에는 추가해야 할 모델 블록이 표시됩니다:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
...
(minimax-coding-plan은 MiniMax의 구독 키를 위한 제공자(provider)입니다. 종량제(Pay-as-you-go) 키는 OpenCode의 일반 MiniMax 제공자를 통해 사용됩니다.)
여전히 문제가 되는 부분과 주의사항 (Caveats)
무료 등급은 제한적입니다. Ollama의 무료 플랜(Free plan)은 동시 요청을 하나만 허용합니다. 그 이상의 요청은 대기열에 추가되며, 대기열이 가득 차면 거부됩니다. Claude Code가 여러 병렬 서브 에이전트(subagents)로 퍼져나가는 것은 느리게 느껴질 것입니다. Pro는 3개의 동시 요청을 허용하고 Max는 10개를 허용합니다. 무료 계정이 이 모델을 무료 기간 동안 사용하기 위해 구매한 크레딧이 필요한지는 확인할 수 없었습니다. Ollama의 가격 책정 페이지에 따르면 Free는 "스타터 모델(starter models)"을 커버하며, 나머지 기능은 크레딧으로 잠금 해제되므로 계정을 확인하세요. OpenRouter의 :free 엔드포인트도 속도 제한(rate-limited)이 걸려 있습니다.
Anthropic 프롬프트 캐싱 의미론(semantics) 부재. Ollama의 Anthropic 호환성 페이지는 cache_control 프롬프트 캐싱을 지원하지 않는다고 명시하며, 이는 tool_choice, 토큰 카운팅, PDF 문서 블록 및 배치(batches)도 마찬가지입니다. 웹 검색 기능 역시 완전히 지원되지 않습니다. Ollama와 MiniMax는 캐시된 입력 가격($0.015)을 제시하지만, 이 캐싱 방식은 Claude Code가 사용하는 방식이 아닙니다.
추론 과정(Thinking)은 항상 켜져 있으며 기본값은 최대입니다. MiniMax의 API는 thinking: disabled를 400 에러로 거부합니다. 기본값을 max로 설정할 경우, 모델은 많은 추론 토큰을 소모할 수 있습니다. 한 r/MiniMax_AI 사용자는 M3.1 Flash가 M2.7보다 더 빨리 플랜 제한에 도달했다고 보고했습니다. 간단한 작업의 경우, 낮은 노력 수준(lower effort level)을 시도해 보세요. 이것이 얼마나 절약되는지는 측정하지 않았습니다.
비밀 정보 보호. 오늘 날짜 r/ollama 스레드에서는 모델이 요청받지 않은 상태에서 .env 파일을 읽는다는 보고가 있었습니다. 이는 한 사용자의 보고이지만, 거부 규칙(deny rules)을 추가하는 것은 저렴합니다. Claude Code는 settings.json 파일에서 이를 지원합니다:
{ "permissions": { "deny": ["Read(./.env)", "Read(./.env.*)"] } }
데이터 처리. Ollama의 출시 이메일에는 M3.1 Flash가 “미국에 호스팅되며 데이터 보존이 없다(zero data retention)”고 명시되어 있습니다. 가격 책정 페이지에서는 모델들이 주로 미국에서 실행되지만, 용량 확보를 위해 유럽으로 라우팅될 수 있다고 합니다. 또 다른 r/ollama 스레드에서는 가중치(weights)가 아직 공개되지 않은 모델을 실제로 서비스하는 추론 제공업체(inference provider)가 무엇인지 묻고 있습니다. 저는 이에 대한 답변을 보지 못했습니다.
마감 기한 이후. 10월 22일 23:59 UTC에 Ollama는 사용 크레딧에서 1M 토큰당 $0.15 / $0.60를 청구하기 시작합니다. 설정 파일에서 변경해야 할 것은 없습니다. OpenRouter에서는 :free 변형이 12:00 UTC 이후 폐지되므로, minimax/minimax-m3.1-flash로 전환해야 합니다. Ollama 없이 동일한 가격을 유지하려면 위에서 제시된 MiniMax-direct 설정을 사용하세요. Claude로 돌아가려면 새 셸(shell)을 열고 일반적인 claude를 실행하거나, 평소 프로필에 맞춰 codex/opencode를 실행하세요.
제가 실제로 사용할 방법
전체 워크플로우를 통째로 옮기지 마세요. M3.1 Flash는 저렴한 작업자(cheap worker)로 취급하세요:
- 다음 작업을 맡기세요: 테스트 스캐폴딩(test scaffolding), 기계적 리팩토링(mechanical refactors), 파일 전반의 이름 변경(renames across files), 명확한 사양을 갖춘 마이그레이션(migrations with a clear spec), 린트 수정(lint fixes), 로그 분류(log triage), 문서 초안 작성(first drafts of docs), UI 버그 스크린샷 (현재 이미지를 수용합니다).
- 프론티어 모델(frontier model)에 맡기세요: 기획(planning), 아키텍처 결정(architecture decisions), 보안 관련 변경 사항(security-sensitive changes), 그리고 M3.1 Flash가 작성한 모든 내용의 최종 검토(final review).
