MiniMax M3.1 Flash: configuração no Claude Code, OpenCode e Cline

Para acessar diretamente o MiniMax M3.1 Flash no Claude Code ou no OpenCode, use a API da MiniMax compatível com Anthropic e selecione explicitamente MiniMax-M3.1-Flash; alterar apenas a URL base não seleciona o modelo. No Cline, use a integração nativa com o OpenRouter e selecione o ID atual do modelo nesse provedor. Antes de mudar seu modelo padrão, teste uma tarefa de escopo limitado no repositório: os preços publicados dos tokens justificam avaliar o Flash, mas não determinam o custo de uma correção bem-sucedida.

Informações atualizadas em 2026-10-22.

O que mudou em relação ao MiniMax M3?

O M3.1 Flash está disponível como modelo hospedado; Space Bunny era sua versão anônima anterior. O anúncio de lançamento da MiniMax, de 2026-10-19, confirma essa relação e a disponibilidade da API, enquanto prevê a divulgação dos pesos do modelo para uma etapa posterior. Portanto, uma sessão anterior com o Space Bunny não equivale a uma avaliação controlada da versão final.

Tanto o M3 quanto o M3.1 Flash têm uma janela de contexto de 1,000,000 tokens, somando entrada e saída. As diferenças práticas incluem tarifas publicadas menores e o raciocínio obrigatório no Flash: o M3 permite desativá-lo, enquanto o Flash rejeita essa configuração. O Flash oferece níveis de esforço de low a max, com max como padrão; um esforço maior pode aumentar o raciocínio gerado e a latência.

Comece pelo Flash para explorar um repositório, corrigir um bug de escopo limitado ou escrever testes cujo resultado você consiga verificar. Se sua aplicação exige um modo de resposta sem raciocínio, o M3.1 Flash não atende a esse requisito. Um contexto de um milhão de tokens é um limite de capacidade, não uma franquia de uso incluída.

Quando termina o acesso gratuito?

Escolha como continuará usando o modelo antes de iniciar uma sessão longa. Cada provedor tem sua própria promoção; não existe um único período gratuito compartilhado da MiniMax.

Opção de acesso	Condições publicadas verificadas em 2026-10-22	Como continuar
OpenRouter	Encerramento publicado do acesso gratuito a minimax/minimax-m3.1-flash:free: 2026-10-22 às 12:00 UTC.	O aviso do OpenRouter informa que a variante gratuita será retirada após esse horário; use minimax/minimax-m3.1-flash e adicione saldo para o uso pago.
Ollama Cloud	Encerramento publicado do acesso gratuito: 2026-10-22 às 23:59 UTC; a tag da CLI é minimax-m3.1-flash:cloud.	Confira as tarifas pagas exibidas e suas configurações de cobrança no Ollama. Essa opção executa o modelo na nuvem.
Serviço de modelos hospedados do OpenCode	minimax-m3.1-flash-free aparece como temporariamente gratuito. A documentação não informa um horário exato de encerramento.	Confira a lista atual de modelos ou configure o provedor direto da MiniMax conforme as instruções abaixo.

Os limites publicados pelo OpenRouter para modelos gratuitos são de 20 requisições/minuto e 50/dia, aumentando para 1,000/dia após a compra de pelo menos $10 em créditos. Tentativas que falham também contam para o limite diário. Uma única tarefa de programação pode exigir muitas requisições; o horário de encerramento da promoção não indica se ainda há cota suficiente para uma sessão longa do agente.

Claude Code: configure o endpoint, as credenciais e os aliases de modelo

Use uma chave da MiniMax correspondente à modalidade de cobrança desejada. Crie uma chave padrão com pagamento conforme o uso em API Keys → Create new secret key, na plataforma da MiniMax. Já uma M Plan Subscription Key consome a franquia da assinatura e os pacotes de créditos elegíveis; os dois tipos de chave têm cobranças separadas. Os cálculos de custo apresentados adiante usam a cobrança padrão da API direta.

O exemplo pressupõe que o Claude Code está instalado e que você está no diretório do projeto. Antes de iniciá-lo, remova entradas conflitantes de provedor ou credenciais dos arquivos aplicáveis: ~/.claude/settings.json, .claude/settings.json do projeto e .claude/settings.local.json. A referência de variáveis de ambiente do Claude Code informa que os valores de env nos arquivos de configuração normalmente substituem as mesmas variáveis herdadas do shell; exportar um novo valor não basta quando uma configuração conflitante permanece.

No Bash no macOS, Linux ou WSL, execute a primeira linha, cole sua chave da MiniMax e pressione Enter. A entrada fica oculta.

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"

Esse exemplo segue a configuração da MiniMax para o Claude Code, fornecendo a credencial pelo shell. Ele define o modelo principal e os aliases Sonnet, Opus e Haiku. O token é usado na autenticação Bearer.

O sufixo [1m] informa ao Claude Code que o modelo personalizado aceita um contexto de um milhão de tokens; o Claude Code remove esse sufixo antes de enviar a requisição à API. Nos demais clientes, mantenha o ID sem sufixo, MiniMax-M3.1-Flash. O valor 524288 é a janela de compactação automática recomendada pela MiniMax, não uma especificação de contexto menor para o modelo.

Dentro do Claude Code, execute:

/status
/model

Confirme o endpoint da MiniMax e o modelo M3.1 Flash ativo. Em seguida, em um repositório que contenha README.md, envie:

Read README.md and summarize the project's purpose in one paragraph. Do not edit files or run commands.

Verifique se houve uma ação de leitura do arquivo e se a resposta se baseia no conteúdo dele. Faça uma pergunta adicional sobre uma seção específica do README para também testar o histórico da conversa. A presença do modelo no seletor confirma apenas a seleção.

Se a autenticação falhar com 401, confira a conta e a região de serviço da chave, depois procure credenciais conflitantes nas configurações antes de tentar novamente. Se /status ainda mostrar outro endpoint, resolva o conflito de configuração e inicie uma nova sessão.

OpenCode: configure um provedor direto da MiniMax

Crie um provedor personalizado para sua chave com pagamento conforme o uso, utilizando o adaptador Anthropic documentado pela MiniMax. Mescle esta configuração em ~/.config/opencode/opencode.json, preservando as demais configurações necessárias.

{
  "$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
          }
        }
      }
    }
  }
}

O /v1 adicional é intencional. As instruções da MiniMax para o OpenCode explicam que @ai-sdk/anthropic acrescenta /messages à URL base. O Claude Code usa https://api.minimax.io/anthropic; esse adaptador usa https://api.minimax.io/anthropic/v1.

O OpenCode aceita opções de provedores personalizados e substitui {env:MINIMAX_API_KEY} pelo valor do ambiente de inicialização. Se você abriu um novo terminal Bash, informe a chave novamente e inicie o modelo:

read -rs MINIMAX_API_KEY && export MINIMAX_API_KEY
opencode --model minimax-direct/MiniMax-M3.1-Flash

Use /models para confirmar o provedor e o modelo, depois repita a leitura do README e a pergunta adicional. Os resultados aparecem na sessão do terminal.

Se a autenticação falhar, confirme que a variável foi definida no terminal que iniciou o OpenCode. Se o provedor errado continuar ativo, examine o opencode.json do projeto, que pode substituir a configuração global. Se o erro estiver no caminho da requisição, confira em conjunto o adaptador e sua URL base com /anthropic/v1.

Cline: use a conexão nativa com o OpenRouter

Conecte o Cline com uma chave do OpenRouter e selecione o identificador do modelo nesse provedor. O guia oficial de configuração documenta este procedimento:

1. Abra as configurações do Cline pelo ícone de engrenagem.
2. Em API Provider, escolha OpenRouter.
3. Insira sua chave de API do OpenRouter em OpenRouter API Key.
4. Para continuar com o uso pago, selecione minimax/minimax-m3.1-flash. O horário de encerramento publicado para o ID promocional minimax/minimax-m3.1-flash:free é 2026-10-22 às 12:00 UTC.
5. Deixe a URL base personalizada sem configuração, inicie uma nova conversa e repita a leitura do README e a pergunta adicional.

Leia a resposta do modelo e confira a ação sobre o arquivo no painel de tarefas do Cline. Essa opção é cobrada pelo OpenRouter. Seu plano Standard acrescenta 5.5% na compra de créditos, em vez de cobrar essa taxa a cada requisição; os impostos aplicáveis são adicionais.

Se receber 429, verifique a cota de requisições dos modelos gratuitos antes de tentar novamente. Após a retirada do ID gratuito, adicionar créditos não altera a seleção do modelo: selecione o ID base. O OpenRouter documenta que a resposta 404 de um modelo descontinuado pode conter no endpoints for this model found.

BetterToken: uma chave para modelos de vários fornecedores

Escolha o BetterToken se quiser acessar modelos de vários fornecedores com pagamento conforme o uso e uma única chave. Seu catálogo de modelos lista MiniMax-M3.1-Flash com suporte aos endpoints OpenAI Chat Completions, Anthropic Messages e Responses. O acesso direto à MiniMax continua sendo uma opção para cobrança pelo próprio fornecedor, enquanto o OpenRouter oferece a conexão nativa com o Cline descrita acima.

Crie uma conta no BetterToken e depois gere sua própria chave de API no console. Confira os preços atuais do BetterToken e as tarifas aplicáveis à sua conta; a tabela de custos diretos dos fornecedores apresentada abaixo não representa a cobrança do BetterToken.

No Claude Code, use a URL base compatível com Anthropic documentada pelo BetterToken: https://bettertoken.ai, sem /v1. Antes de mudar de provedor, remova entradas conflitantes de provedor, credenciais e modelo de ~/.claude/settings.json, .claude/settings.json e .claude/settings.local.json. Os valores de env nos arquivos de configuração podem substituir os definidos no shell.

No Bash no macOS, Linux ou WSL, execute a primeira linha, cole sua chave do BetterToken e pressione Enter; a entrada fica oculta. Depois, execute os demais comandos:

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"

Use /status e /model para confirmar o endpoint do BetterToken e o modelo selecionado, depois repita a leitura do README e a pergunta adicional. Se receber 401, verifique se a chave pertence à sua conta do BetterToken e se nenhuma entrada nas configurações a substitui. Se o endpoint estiver errado, resolva o conflito e inicie uma nova sessão.

• OpenCode: siga as instruções para um provedor personalizado. Em ~/.config/opencode/opencode.json, adicione o provedor bettertoken, com npm definido como @ai-sdk/openai-compatible, options.baseURL como https://www.bettertoken.ai/v1 e MiniMax-M3.1-Flash registrado em models. Execute /connect, escolha Other, informe o ID de provedor bettertoken e salve sua chave do BetterToken. Inicie com opencode --model bettertoken/MiniMax-M3.1-Flash.
• Cline: siga a configuração OpenAI Compatible. Nas configurações, escolha OpenAI Compatible em API Provider, defina Base URL como https://www.bettertoken.ai/v1, informe sua chave de API do BetterToken e defina Model como MiniMax-M3.1-Flash. Salve e recarregue o Cline.

Nos dois clientes, inicie uma nova sessão e repita a leitura do README e a pergunta adicional antes de uma tarefa longa. Trata-se de acesso à API; contas e assinaturas de ferramentas de terceiros continuam separadas.

Para quem está na Rússia, o acesso ao endpoint de API do BetterToken não exige VPN, e o BetterToken aceita pagamentos em rublos. Isso não abrange sites de terceiros, downloads, logins, marketplaces ou atualizações. Confira no console os meios de pagamento disponíveis, cartões elegíveis, valores mínimos, taxas de câmbio, tarifas e prazos de crédito do saldo.

Como interpretar os benchmarks oficiais?

Use a tabela de benchmarks para escolher tarefas de avaliação, sem presumir que o Flash superará seu modelo atual. Estas quatro linhas relevantes vêm da comparação publicada pela MiniMax:

Benchmark divulgado pelo fornecedor	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

A MiniMax fica à frente na linha de automação; o DeepSeek lidera nessas três linhas de terminal e programação. O resultado de DeepSWE na tabela usa mini-SWE-agent 2.4.5 com limite de contexto de 512K, enquanto o NL2Repo usa Claude Code 2.1.233 com 512K. Os resultados estão vinculados a essas configurações de avaliação.

A MiniMax também anuncia inferência online quase três vezes mais rápida e custos 70% menores em tarefas de agentes. Trate esses números como afirmações do fornecedor, não como uma promessa de que a correção no seu repositório terminará três vezes mais rápido ou custará 70% menos. A tabela de lançamento não inclui uma coluna do M3 que permita calcular a diferença de desempenho em benchmarks em relação a ele.

Compare a cobrança por tokens antes do custo da tarefa

Primeiro, compare quantidades idênticas de tokens faturados; depois, meça o que cada modelo realmente consome para concluir sua tarefa. Em 2026-10-22, as tarifas da MiniMax e as tarifas do DeepSeek informam estes preços de API direta, em USD por 1 milhão de tokens:

Tarifa da API direta	Entrada sem cache	Entrada em cache	Saída
MiniMax-M3.1-Flash	$0.15	$0.015	$0.60
deepseek-flash, horário de pico	$0.30	$0.006	$1.20
deepseek-flash, fora do pico	$0.15	$0.003	$0.60

O DeepSeek atualmente associa deepseek-flash a DeepSeek-V4.1-Flash-1017. Os horários de pico são 01:00–04:00 e 06:00–10:00 UTC, de segunda a sexta-feira, exceto feriados nacionais chineses; todos os demais períodos ficam fora do pico.

Para comparação com o M3, a MiniMax publica tarifas padrão de $0.30 para entrada, $1.20 para saída e $0.06 para entrada em cache em requisições com ≤ 512k tokens de entrada. As tarifas normais de entrada e saída do Flash são metade dessas tarifas do M3. A afirmação do lançamento sobre a redução agregada do custo de tarefas não deve ser aplicada como um multiplicador universal do preço dos tokens.

Considere u, c e o como entrada sem cache, entrada em cache e saída, respectivamente, medidas em milhões de tokens faturados:

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

Os valores a seguir são estimativas de cobrança por tokens, não resultados de tarefas executadas. Eles pressupõem APIs diretas com pagamento conforme o uso, requisições de texto, nenhum uso de ferramentas pagas hospedadas pelo provedor e contagens de saída que incluem o raciocínio faturado. Excluem impostos e tarifas de pagamento específicos da conta; não representam faturas do BetterToken, do OpenRouter ou de assinaturas.

Volume faturado considerado	MiniMax	DeepSeek no pico	DeepSeek fora do pico
100,000 tokens de entrada sem cache + 20,000 de saída	$0.02700	$0.05400	$0.02700
10,000 tokens de entrada sem cache + 90,000 de entrada com acerto de cache + 20,000 de saída	$0.01485	$0.02754	$0.01377

Na segunda linha, o cálculo da MiniMax é 0.01 × $0.15 + 0.09 × $0.015 + 0.02 × $0.60 = $0.01485. Os acertos de cache considerados são uma premissa, não uma previsão da taxa de acerto. As requisições iniciais que criam o cache e todas as novas tentativas também precisam entrar no custo da tarefa completa.

O cache da MiniMax é automático, aplica-se a partir de 512 tokens de entrada e cobra a entrada nova pela tarifa normal e os acertos efetivos pela tarifa de cache. O cache do DeepSeek também funciona automaticamente, mas o reaproveitamento exige correspondência com uma unidade completa de prefixo persistida; os acertos não são garantidos.

Nas respostas da MiniMax compatíveis com Anthropic, input_tokens representa a entrada nova e cache_read_input_tokens representa os acertos de cache. Nas respostas compatíveis com OpenAI, os tokens em cache são um subconjunto de prompt_tokens. Mantenha essas convenções de contabilização separadas.

No primeiro cenário, o Flash tem cobrança por tokens menor que a tarifa de pico do DeepSeek e igual à tarifa fora do pico. No segundo, o DeepSeek apresenta a menor estimativa fora do pico. Nenhum desses cálculos estabelece qual modelo custa menos por correção concluída.

Execute uma tarefa de aceitação antes de mudar o modelo padrão

Faça uma primeira avaliação pequena o suficiente para verificar tanto a alteração no código quanto sua cobrança. Use duas cópias limpas do mesmo commit, a mesma descrição de tarefa, versão do cliente, instruções do repositório, acesso a ferramentas e teste de aceitação. Inicie conversas separadas para que um modelo não herde a investigação do outro.

Registre o modelo selecionado, provedor, configurações de raciocínio, horário de início, tempo decorrido, acertos de cache, entrada sem cache, saída, novas tentativas e cobrança total. Inclua todas as tentativas necessárias para chegar ao resultado aceito, além de ferramentas pagas e taxas de intermediários. Passar no mesmo teste de aceitação é a condição mínima para comparar os dois custos.

Preste atenção especial à configuração de raciocínio. O MiniMax Flash não permite desativá-lo; um 400 contendo requires adaptive thinking exige remover a configuração disabled/none e repetir a verificação pequena. Sua documentação de API associa o esforço a output_config.effort nas requisições compatíveis com Anthropic e a reasoning_effort nas compatíveis com OpenAI. Nomes de esforço iguais entre fornecedores não significam a mesma quantidade de computação.

Avalie primeiro o Flash em uma tarefa de programação de escopo limitado quando as cobranças por entrada sem cache e saída durante o horário de pico do DeepSeek predominarem. Mantenha o DeepSeek na comparação quando o trabalho puder ocorrer fora do pico ou reutilizar repetidamente o contexto em cache. Inverta a escolha provisória se o outro modelo produzir alterações aceitas com menos tentativas, menor cobrança total ou tempo de conclusão significativamente melhor.