MiniMax M Plan 또는 Token Plan 한도 소진: 사용 창을 확인하고 코딩을 계속하는 방법

MiniMax 기반 코딩 도구가 갑자기 멈췄다고 해서 도구와 키를 무작정 바꾸지 마세요. 먼저 M Plan 사용 창이 소진됐는지, 일시적인 rate limit인지, 계정이 유지 중인 Token Plan인지, 또는 잘못된 종류의 키를 설정했는지를 확인해야 합니다. 원인을 알아야 리셋을 기다릴지, 적용 가능한 Credits를 쓸지, 남은 텍스트 코딩 작업만 별도 pay-as-you-go API로 옮길지 결정할 수 있습니다.

먼저 이 표로 원인을 구분하세요

보이는 현상	먼저 확인할 항목	우선 조치
콘솔에서 5시간 창 또는 주간 창의 잔여량이 없음	플랜 이름과 각 창의 종료 시각	해당 리셋을 기다리거나 Credits가 그 기능에 적용되는지 확인
잔여량은 있지만 연속 요청 후 호출이 막힘	요청 빈도, 동시 실행 수, 피크 시간의 동적 제한	빈도나 동시 실행 수를 줄이고 나중에 재시도
계정에 여전히 Token Plan이 표시됨	기존 구독 유지 여부와 M Plan 업그레이드 여부	유지 플랜 공지를 따르고 M Plan 규칙 전체를 그대로 적용하지 않음
키를 바꾼 뒤 계정 잔액이 차감됨	Subscription Key인지 pay-as-you-go API key인지	키 혼용을 중단하고 원하는 과금 경로로 다시 설정
텍스트 코딩을 즉시 계속해야 함	별도 과금을 허용할 수 있고 M Plan 전용 혜택이 필요 없는지	자체 키, endpoint, Model ID를 쓰는 독립 provider 설정

클라이언트에서 비슷한 오류로 보이더라도 원인은 다를 수 있습니다. 안전한 순서는 플랜과 사용 창, 키 유형, 마지막으로 provider 전환입니다.

M Plan의 5시간 창과 7일 주간 창은 독립적입니다

MiniMax의 M Plan usage rules는 사용량이 두 개의 창에서 자동으로 리셋된다고 설명합니다.

• 텍스트, 이미지, 오디오 등 비디오가 아닌 모델은 5시간 창과 7일 주간 창 모두에 잔여량이 있어야 합니다.
• 비디오 모델은 주간 창만 적용되고 5시간 창은 적용되지 않습니다.
• 두 창은 첫 사용 시 시작됩니다. 창이 끝나면 해당 tier의 전체 한도로 복원되고, 다음 사용이 새 창을 시작합니다.
• 두 창은 따로 리셋됩니다. 5시간 창이 복원돼도 주간 사용량은 초기화되지 않습니다.
• 남은 사용량은 다음 창이나 다음 결제 주기로 이월되지 않습니다.

따라서 5시간을 기다렸는데도 다시 쓸 수 없는 상황은 이상이 아닐 수 있습니다. 주간 창이 여전히 소진 상태일 수 있기 때문입니다. 반대로 사용량이 남아 있어도 일시적인 rate limit으로 호출이 막힐 수 있습니다.

지원 도구들은 같은 M Plan 사용량을 공유합니다

M Plan은 클라이언트마다 별도 한도를 주지 않습니다. MiniMax Code 사용량과 같은 Subscription Key로 연결한 지원 도구의 사용량은 모두 같은 M Plan 한도에 계산됩니다.

Claude Code에서 OpenCode로 옮기거나 새 세션을 열거나 같은 Subscription Key를 다른 도구에 넣어도 새 한도가 생기지 않습니다. MiniMax usage page에서 플랜, 사용 창, Credits, 기록을 확인하세요. MiniMax CLI에서는 다음 명령도 사용할 수 있습니다.

mmx quota

이 명령은 M Plan 사용량과 남은 quota를 보여 줍니다. 코딩 에이전트의 일반적인 오류 문구만으로 원인을 추측하는 것보다 정확합니다.

rate limit과 사용량 소진은 다른 문제입니다

MiniMax는 usage limit과 request rate limit을 별도의 제어로 다룹니다. 짧은 시간에 너무 많은 요청을 보내거나 동시 실행 수가 높거나 피크 시간의 동적 제한에 걸리면 잔여량이 있어도 호출이 일시적으로 차단될 수 있습니다.

요청 빈도와 동시 실행 수를 낮춘 뒤 조금 후에 다시 시도하세요. 짧은 제한만 보고 Credits를 구매하거나 플랜을 업그레이드하거나 키를 바꾸지 마세요. 콘솔에서 5시간 또는 주간 창이 실제로 소진됐다고 표시될 때만 한도 소진 대응으로 넘어가야 합니다.

M Plan인지 유지 중인 Token Plan인지 확인하세요

M Plan 출시 후 Token Plan은 신규 구매가 중단됐지만 기존 구독자는 플랜을 유지하거나 M Plan으로 업그레이드할 수 있었습니다. 따라서 계정에 표시되는 이름이 중요합니다.

• Plan Details가 M Plan이면 독립 사용 창, 공유 사용량, Credits 규칙을 적용합니다.
• 여전히 Token Plan이면 Existing Token Plan subscribers를 열어 유지 구독과 자동 갱신 상태를 확인합니다.
• 업그레이드는 되돌릴 수 없습니다. 공식 공지에 따르면 Token Plan으로 돌아갈 수 없고, 이후에는 새 M Plan tier의 모델, 한도, 혜택, 갱신 조건이 적용됩니다.

오래된 글이나 저장된 설정만 보고 현재 계정 규칙을 추정하지 마세요. 먼저 Plan Details에 실제로 표시된 이름과 상태를 확인하세요.

한도가 실제로 소진됐다면 의존성에 따라 선택하세요

1. 구독 전용 기능이 필요하면 올바른 리셋을 기다리세요

작업이 M Plan 전용 모델, MiniMax Code 멤버십 기능, 같은 Subscription Key 경로에 의존한다면 기다리는 것이 가장 명확합니다. 5시간 창, 주간 창, 또는 둘 다 소진됐는지 확인하고 콘솔의 종료 시각에 맞추세요.

기다리는 동안 불필요한 파일을 컨텍스트에서 빼고, 범위를 좁힌 새 세션을 준비하고, 큰 작업을 검증 가능한 단계로 나눌 수 있습니다. 리셋이 빨라지지는 않지만 다음 창의 소비량을 줄이는 데 도움이 됩니다.

2. Credits가 있다면 적용 범위를 확인하세요

먼저 M Plan에 포함된 사용량이 소진됩니다. 한도에 도달하면 사용 가능한 Credits가 적격 추가 사용량을 처리할 수 있지만, Credit packs는 지원하는 모델과 기능에만 적용됩니다.

Usage page에서 Credits 잔액, 만료일, 필요한 기능의 적용 여부를 확인하세요. Credits가 있다는 사실만으로 모든 작업을 계속할 수 있는 것은 아닙니다.

3. 텍스트 코딩을 지금 계속해야 한다면 별도 종량제 경로를 쓰세요

M Plan 전용 혜택이 필요 없는 텍스트 작업은 독립 API provider로 계속할 수 있습니다. 해당 provider의 키와 과금이 따로 적용됩니다. 이 경로는 M Plan 창을 리셋하지 않고, Credits나 MiniMax Code 혜택도 옮기지 않습니다.

MiniMax 자체도 표준 pay-as-you-go API key와 Subscription Key를 구분하며 서로 바꿔 쓸 수 없습니다. 외부 provider에도 같은 원칙을 적용해 해당 provider의 키, Base URL, 정확한 Model ID만 사용하세요.

예시: BetterToken으로 OpenCode에 독립 경로 만들기

BetterToken은 M Plan 충전 수단이 아니라 별도 API provider의 예시입니다. 2026년 10월 10일 기준 BetterToken의 현재 모델 카탈로그에는 정확한 ID MiniMax-M3가 있으며, OpenCode 가이드는 OpenAI-compatible Base URL https://www.bettertoken.ai/v1을 사용합니다.

MiniMax 모델 문서는 MiniMax-M3.1-Flash-Preview가 현재 M Plan과 MiniMax Code에서만 제공된다고 설명합니다. 이 preview ID를 외부 provider 설정에 그대로 복사하지 말고, 그 provider의 현재 카탈로그에 있는 정확한 ID를 사용하세요.

키를 섞지 않고 설정하기

1. BetterToken 계정에서 BetterToken API key를 만듭니다. MiniMax Subscription Key를 붙여 넣지 마세요.
2. OpenCode에서 /connect를 실행하고 Other를 선택한 뒤 provider id를 bettertoken으로 지정하고 자격 증명 입력창에 BetterToken 키를 입력합니다.
3. 프로젝트 루트에 opencode.json을 만들거나 전역 파일 ~/.config/opencode/opencode.json을 수정합니다.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/MiniMax-M3",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax-M3"
        }
      }
    }
  }
}

4. OpenCode를 다시 시작하고 bettertoken/MiniMax-M3를 선택한 뒤 짧은 코딩 질문을 보냅니다.
5. 정상 응답이 오면 독립 API 경로가 설정된 것입니다. MiniMax 구독 한도가 복구되거나 이동했다는 뜻은 아닙니다.

전체 설정은 BetterToken OpenCode 가이드를 참고하고, 저장 전에 현재 모델 카탈로그에서 ID를 다시 확인하세요.

독립 경로가 실패하면 계층별로 확인하세요

• 인증 실패: /connect를 다시 실행하고 MiniMax Subscription Key가 아니라 BetterToken 키를 입력했는지 확인합니다.
• endpoint 오류: Base URL을 정확히 https://www.bettertoken.ai/v1로 두고 /chat/completions를 추가하지 않습니다.
• 모델을 찾을 수 없음: 대소문자와 전체 ID를 확인합니다. 해당 필드에 MiniMax-M3와 bettertoken/MiniMax-M3를 사용합니다.
• 설정이 반영되지 않음: OpenCode를 다시 시작하고 프로젝트의 opencode.json이 전역 파일을 덮어쓰는지 확인합니다.
• 기존 MiniMax 도구가 계속 막힘: 예상된 경계입니다. 별도 provider는 MiniMax의 사용 창, Credits, 구독 상태를 바꾸지 않습니다.

시간을 가장 많이 낭비하는 다섯 가지 실수

1. 일시적인 rate limit을 quota 소진으로 판단하기. 잔여량이 있으면 동시 실행 수를 줄이고 다시 시도하세요.
2. 5시간 리셋만 기다리기. 비디오가 아닌 모델은 주간 창에도 잔여량이 필요합니다.
3. 같은 Subscription Key를 여러 도구로 옮기기. 지원 도구들은 같은 M Plan 사용량을 공유합니다.
4. Subscription Key와 pay-as-you-go API key를 섞기. 혜택과 과금 경로가 다릅니다.
5. MiniMax-M3.1-Flash-Preview를 외부 공통 Model ID로 보기. 외부 도구에는 provider의 현재 카탈로그에 있는 정확한 ID가 필요합니다.

실제 작업 순서

콘솔이나 mmx quota로 플랜과 남은 사용 창을 확인하세요. rate limit만 문제라면 빈도와 동시 실행 수를 낮추세요. 사용량이 소진됐다면 구독 전용 기능이 필요할 때는 리셋을 기다리고, 적격 작업에는 Credits를 쓰며, 텍스트 코딩 중단을 피해야 할 때는 별도 pay-as-you-go provider를 설정하세요.

키를 무작정 바꿔 가며 해결하려 하지 마세요. M Plan 또는 유지 중인 Token Plan, Subscription Key, 표준 pay-as-you-go key, 외부 provider key를 명확히 분리해야 오진과 잘못된 계정 과금을 피할 수 있습니다.