MiniMax M3.1 Flash: configurar Claude Code, OpenCode y Cline
Configura MiniMax M3.1 Flash con los identificadores y ajustes correctos, continúa con acceso de pago tras las promociones y compara tarifas sin confundir el precio de los tokens con el costo de resolver una tarea de programación.
Índice

Para acceder directamente a MiniMax M3.1 Flash desde Claude Code u OpenCode, usa la API compatible con Anthropic de MiniMax y selecciona explícitamente MiniMax-M3.1-Flash; cambiar solo la URL base no selecciona el modelo. En Cline, usa su integración nativa con OpenRouter y elige el identificador actual del modelo en ese servicio. Antes de cambiar tu modelo predeterminado, prueba una tarea acotada en tu repositorio: las tarifas publicadas justifican evaluar Flash, pero no permiten saber cuánto costará obtener una corrección válida.
Información actualizada al 2026-10-22.
¿Qué cambia frente a MiniMax M3?
M3.1 Flash ya está disponible como modelo alojado; Space Bunny fue su versión anónima anterior. El anuncio de lanzamiento de MiniMax del 2026-10-19 confirma esa relación y la disponibilidad de la API, mientras sitúa la publicación de los pesos del modelo en una fecha posterior. Por eso, una sesión anterior con Space Bunny no equivale a una evaluación controlada de la versión final.
M3 y M3.1 Flash tienen una ventana de contexto de 1,000,000 tokens, contando conjuntamente la entrada y la salida. Entre las diferencias prácticas están las tarifas publicadas más bajas y el razonamiento obligatorio de Flash: M3 permite desactivarlo, mientras que Flash rechaza esa configuración. Flash ofrece niveles de esfuerzo desde low hasta max, con max como valor predeterminado; un esfuerzo mayor puede aumentar el razonamiento generado y la latencia.
Empieza con Flash para explorar un repositorio, corregir un error acotado o escribir pruebas cuyo resultado puedas verificar. Si tu aplicación necesita un modo de respuesta sin razonamiento, M3.1 Flash no cumple ese requisito. Una ventana de un millón de tokens expresa la capacidad de contexto, no una cantidad de uso incluida.
¿Cuándo termina el acceso gratuito?
Decide cómo continuarás antes de iniciar una sesión larga. Cada proveedor ofrece su propia promoción; no existe un único período gratuito compartido por todas las vías de acceso a MiniMax.
| Vía de acceso | Condiciones publicadas comprobadas al 2026-10-22 | Cómo continuar |
|---|---|---|
| OpenRouter | Fin publicado del acceso gratuito a minimax/minimax-m3.1-flash:free: 2026-10-22 a las 12:00 UTC. | El aviso de OpenRouter indica que la variante gratuita se retira después de esa hora; usa minimax/minimax-m3.1-flash y añade saldo para el uso de pago. |
| Ollama Cloud | Fin publicado del acceso gratuito: 2026-10-22 a las 23:59 UTC; la etiqueta de la CLI es minimax-m3.1-flash:cloud. | Comprueba las tarifas de pago que se muestran y los ajustes de facturación de Ollama. Esta vía usa un servicio en la nube. |
| Servicio de modelos alojados de OpenCode | minimax-m3.1-flash-free figura como gratuito por tiempo limitado. La documentación no especifica una fecha y hora exactas de finalización. | Consulta el catálogo actual o configura el proveedor directo de MiniMax descrito más adelante. |
Los límites publicados de OpenRouter para modelos gratuitos son 20 solicitudes/minuto y 50/día; el límite diario aumenta a 1,000 después de comprar al menos $10 en créditos. Los intentos fallidos también cuentan para el límite diario. Una tarea de programación puede requerir muchas solicitudes, así que la fecha de finalización de una promoción no indica si queda cuota suficiente para una sesión larga del agente.
Claude Code: configura el endpoint, las credenciales y los alias
Usa una clave de MiniMax que corresponda al tipo de facturación que quieres. Para obtener una clave estándar de pago por uso, ve a API Keys → Create new secret key en la plataforma de MiniMax. Una M Plan Subscription Key consume el uso incluido en la suscripción y los paquetes de créditos aplicables; los dos tipos de clave tienen una facturación diferente. Los cálculos posteriores usan la facturación estándar de la API directa.
El ejemplo supone que ya instalaste Claude Code y estás en el directorio de tu proyecto. Antes de iniciarlo, elimina las entradas de proveedor o credenciales que entren en conflicto en los archivos que correspondan: ~/.claude/settings.json, .claude/settings.json del proyecto y .claude/settings.local.json. La referencia de variables de entorno de Claude Code indica que los valores de env de los archivos de configuración normalmente reemplazan las mismas variables heredadas de la shell; exportar un valor nuevo no basta si persiste una configuración contradictoria.
En Bash, en macOS, Linux o WSL, ejecuta la primera línea, pega tu clave de MiniMax y pulsa Enter. La entrada queda 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"
Esta configuración sigue la guía de MiniMax para Claude Code, pasando la credencial mediante la shell. Define el modelo principal y los alias de Sonnet, Opus y Haiku. El token se utiliza para la autenticación bearer.
El sufijo [1m] indica a Claude Code que el modelo personalizado admite un contexto de un millón de tokens; Claude Code elimina ese sufijo antes de enviar la solicitud a la API. En otros clientes, conserva el identificador sin sufijo: MiniMax-M3.1-Flash. El valor 524288 corresponde a la ventana de compactación automática recomendada por MiniMax, no a una capacidad menor del modelo.
Dentro de Claude Code, ejecuta:
/status
/model
Confirma el endpoint de MiniMax y que el modelo activo sea M3.1 Flash. Después, en un repositorio que contenga README.md, envía:
Read README.md and summarize the project's purpose in one paragraph. Do not edit files or run commands.
Comprueba que se produzca la acción de lectura del archivo y que la respuesta se base en su contenido. Haz una pregunta de seguimiento sobre una sección concreta del README para comprobar también el uso del historial de conversación. Que el modelo aparezca en el selector solo confirma la selección.
Si la autenticación falla con 401, revisa la cuenta y la región de servicio de la clave, y después busca credenciales contradictorias en la configuración antes de reintentar. Si /status sigue mostrando otro endpoint, resuelve ese conflicto e inicia una sesión nueva.
OpenCode: configura un proveedor directo de MiniMax
Crea un proveedor personalizado para tu clave de pago por uso con el adaptador de Anthropic documentado por MiniMax. Integra esta configuración en ~/.config/opencode/opencode.json y conserva los demás ajustes que necesites.
{
"$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
}
}
}
}
}
}
El /v1 adicional es intencional. Las instrucciones de MiniMax para OpenCode explican que @ai-sdk/anthropic añade /messages a su URL base. Claude Code usa https://api.minimax.io/anthropic; este adaptador usa https://api.minimax.io/anthropic/v1.
OpenCode admite opciones de proveedores personalizados y sustituye {env:MINIMAX_API_KEY} por el valor de la variable en el entorno desde el que se inicia. Si abriste una terminal nueva de Bash, introduce de nuevo la clave y después inicia el modelo:
read -rs MINIMAX_API_KEY && export MINIMAX_API_KEY
opencode --model minimax-direct/MiniMax-M3.1-Flash
Usa /models para confirmar el proveedor y el modelo. Después, repite la lectura del README y la pregunta de seguimiento. Los resultados aparecen en la sesión de terminal.
Si falla la autenticación, comprueba que definiste la variable en la misma terminal desde la que iniciaste OpenCode. Si sigue activo otro proveedor, revisa el archivo opencode.json del proyecto, que puede sobrescribir la configuración global. Ante un error de ruta de la solicitud, revisa conjuntamente el adaptador y su base /anthropic/v1.
Cline: usa la integración nativa con OpenRouter
Conecta Cline con una clave de OpenRouter y selecciona el identificador del modelo en OpenRouter. Su guía oficial de configuración documenta estos pasos para ese proveedor:
- Abre los ajustes de Cline mediante el icono de engranaje.
- Selecciona OpenRouter en API Provider.
- Introduce tu clave de API de OpenRouter en OpenRouter API Key.
- Para continuar con el uso de pago, selecciona
minimax/minimax-m3.1-flash. La fecha y hora publicadas para el fin del acceso promocional con el identificadorminimax/minimax-m3.1-flash:freeson 2026-10-22 a las 12:00 UTC. - Deja sin configurar la URL base personalizada, inicia una conversación nueva y repite la lectura del README y la pregunta de seguimiento.
Revisa la respuesta del modelo y la acción sobre el archivo en el panel de tareas de Cline. Esta vía factura a través de OpenRouter. Su plan Standard añade un 5.5% al comprar créditos; esa comisión se aplica a la compra, no a cada solicitud. Los impuestos aplicables se cobran por separado.
Ante un 429, comprueba la cuota de solicitudes para modelos gratuitos antes de reintentar. Una vez retirado el identificador gratuito, añadir créditos no cambia por sí solo la selección del modelo: debes elegir el identificador base. OpenRouter documenta que la respuesta 404 de un modelo retirado puede contener no endpoints for this model found.
BetterToken: una clave para modelos de varios proveedores
Elige BetterToken si quieres acceder a modelos de varios proveedores con una sola clave y pagar según el uso. Su catálogo de modelos incluye MiniMax-M3.1-Flash con soporte para los endpoints de OpenAI Chat Completions, Anthropic Messages y Responses. MiniMax directo sigue siendo una opción para recibir la facturación del propio proveedor, mientras que OpenRouter ofrece la integración nativa con Cline descrita anteriormente.
Crea una cuenta en BetterToken y después genera tu propia clave de API en la consola. Consulta los precios actuales de BetterToken y las tarifas aplicables a tu cuenta; la tabla de costos de los proveedores directos que aparece más adelante no representa los cargos de BetterToken.
Para Claude Code, usa la URL base compatible con Anthropic documentada por BetterToken: https://bettertoken.ai, sin /v1. Antes de cambiar de proveedor, elimina las entradas de proveedor, credenciales y modelo que entren en conflicto en ~/.claude/settings.json, .claude/settings.json y .claude/settings.local.json. Los valores de env de los archivos de configuración pueden sobrescribir los de la shell.
En Bash, en macOS, Linux o WSL, ejecuta la primera línea, pega tu clave de BetterToken y pulsa Enter; la entrada queda oculta. Después ejecuta los demás 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"
Usa /status y /model para confirmar el endpoint de BetterToken y el modelo seleccionado. Después repite la lectura del README y la pregunta de seguimiento. Ante un 401, comprueba que la clave pertenece a tu cuenta de BetterToken y que ninguna entrada de configuración la reemplaza. Si el endpoint es incorrecto, resuelve el conflicto e inicia una sesión nueva.
- OpenCode: sigue las instrucciones del proveedor personalizado. En
~/.config/opencode/opencode.json, añade el proveedorbettertokenconnpmestablecido en@ai-sdk/openai-compatible,options.baseURLenhttps://www.bettertoken.ai/v1yMiniMax-M3.1-Flashregistrado bajomodels. Ejecuta/connect, elige Other, introduce el identificador de proveedorbettertokeny guarda tu clave de BetterToken. Inicia el cliente conopencode --model bettertoken/MiniMax-M3.1-Flash. - Cline: sigue la configuración de OpenAI Compatible. En los ajustes, selecciona OpenAI Compatible en API Provider, establece Base URL en
https://www.bettertoken.ai/v1, introduce tu clave de API de BetterToken y establece Model enMiniMax-M3.1-Flash. Guarda los cambios y vuelve a cargar Cline.
En ambos clientes, inicia una sesión nueva y repite la lectura del README y la pregunta de seguimiento antes de emprender una tarea larga. Este servicio proporciona acceso mediante API; las cuentas y suscripciones de las herramientas de terceros siguen siendo independientes.
Para los lectores en Rusia, acceder al endpoint de API de BetterToken no requiere una VPN, y BetterToken admite pagos en rublos. Este alcance no cubre sitios web, descargas, inicios de sesión, marketplaces ni actualizaciones de terceros. Consulta en la consola los canales de pago disponibles, las tarjetas admitidas, los importes mínimos, los tipos de cambio, las comisiones y los plazos de liquidación.
¿Cómo interpretar los benchmarks oficiales?
Usa la tabla de benchmarks para elegir tareas de evaluación, sin dar por hecho que Flash superará a tu modelo actual. Estas cuatro filas relevantes proceden de la comparativa publicada por MiniMax:
| Benchmark publicado por el proveedor | 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 obtiene el resultado más alto en la fila de automatización; DeepSeek lo obtiene en estas tres filas de terminal y programación. El resultado de DeepSWE usa mini-SWE-agent 2.4.5 con un límite de contexto de 512K, mientras que NL2Repo usa Claude Code 2.1.233 con 512K. Los resultados corresponden a esas configuraciones de evaluación.
MiniMax también anuncia una velocidad de inferencia en línea casi tres veces mayor y costos de tareas de agentes un 70% inferiores. Trátalos como afirmaciones del proveedor, no como una promesa de que una corrección en tu repositorio terminará tres veces más rápido o costará un 70% menos. La gráfica del lanzamiento no incluye una columna de M3 con la que calcular una diferencia de rendimiento frente a ese modelo.
Compara el precio de los tokens antes que el costo de la tarea
Compara primero cantidades idénticas de tokens facturados y después mide cuánto consume realmente cada modelo para terminar tu tarea. A fecha de 2026-10-22, las tarifas de MiniMax y las tarifas de DeepSeek indican estos precios para sus API directas, en USD por 1 millón de tokens:
| Tarifa de API directa | Entrada sin caché | Entrada en caché | Salida |
|---|---|---|---|
MiniMax-M3.1-Flash | $0.15 | $0.015 | $0.60 |
deepseek-flash, horario punta | $0.30 | $0.006 | $1.20 |
deepseek-flash, horario valle | $0.15 | $0.003 | $0.60 |
DeepSeek asigna actualmente deepseek-flash a DeepSeek-V4.1-Flash-1017. El horario punta comprende 01:00–04:00 y 06:00–10:00 UTC, de lunes a viernes, excepto los festivos oficiales de China; todos los demás períodos corresponden al horario valle.
Para comparar con M3, MiniMax publica tarifas estándar de $0.30 para entrada, $1.20 para salida y $0.06 para entrada en caché en solicitudes con ≤ 512k tokens de entrada. Las tarifas ordinarias de entrada y salida de Flash son la mitad de esas tarifas de M3. La afirmación del lanzamiento sobre el costo total de las tareas no debe utilizarse como un multiplicador universal del precio de los tokens.
Sean u, c y o la entrada sin caché, la entrada en caché y la salida, medidas en millones de tokens facturados:
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
Los siguientes valores son estimaciones del costo de los tokens, no resultados de tareas ejecutadas. Suponen API directas de pago por uso, solicitudes de texto, ninguna herramienta de pago alojada por el proveedor y una cantidad de tokens de salida que incluye el razonamiento facturable. Excluyen los impuestos y las comisiones de pago particulares de cada cuenta; no representan facturas de BetterToken, OpenRouter ni de suscripciones.
| Consumo facturable supuesto | MiniMax | DeepSeek en horario punta | DeepSeek en horario valle |
|---|---|---|---|
| 100,000 tokens de entrada sin caché + 20,000 de salida | $0.02700 | $0.05400 | $0.02700 |
| 10,000 tokens de entrada sin caché + 90,000 recuperados de caché + 20,000 de salida | $0.01485 | $0.02754 | $0.01377 |
Para la segunda fila, el cálculo de MiniMax es 0.01 × $0.15 + 0.09 × $0.015 + 0.02 × $0.60 = $0.01485. Los aciertos de caché supuestos no predicen una tasa de aciertos real. Al calcular el costo completo de una tarea, también debes incluir las solicitudes iniciales que crean la caché y todos los reintentos.
La caché de MiniMax funciona automáticamente a partir de 512 tokens de entrada: factura la entrada nueva a la tarifa normal y los aciertos reales a la tarifa de caché. La caché de DeepSeek también es automática, pero para reutilizarla debe coincidir una unidad completa de prefijo almacenado; los aciertos no están garantizados.
En las respuestas compatibles con Anthropic de MiniMax, input_tokens representa la entrada nueva y cache_read_input_tokens los aciertos de caché. En sus respuestas compatibles con OpenAI, los tokens en caché son un subconjunto de prompt_tokens. Mantén separadas estas dos formas de contabilizar el uso.
En el primer escenario, Flash tiene un costo de tokens inferior al de DeepSeek en horario punta e idéntico en horario valle. En el segundo, DeepSeek ofrece la estimación más baja fuera de las horas punta. Ninguno de los dos cálculos determina qué modelo resulta más barato por corrección completada.
Prueba una tarea con criterios de aceptación antes de cambiar de modelo
Haz que la primera evaluación sea lo bastante pequeña como para verificar tanto el cambio de código como su costo. Usa dos copias limpias del mismo commit, una única descripción de la tarea y la misma versión del cliente, instrucciones del repositorio, acceso a herramientas y prueba de aceptación. Abre conversaciones independientes para que un modelo no herede la investigación del otro.
Registra el modelo seleccionado, el proveedor, los ajustes de razonamiento, la hora de inicio, el tiempo transcurrido, los aciertos de caché, la entrada sin caché, la salida, los reintentos y el cargo total. Incluye todos los intentos necesarios para obtener el resultado aceptado, además de las herramientas de pago y las comisiones de intermediarios. Superar la misma prueba de aceptación es la condición mínima para comparar ambos costos.
Presta especial atención a la configuración de razonamiento. MiniMax Flash no permite desactivarlo; un 400 que contenga requires adaptive thinking requiere eliminar la configuración disabled/none y repetir la comprobación pequeña. Su documentación de API asigna el esfuerzo a output_config.effort en las solicitudes compatibles con Anthropic y a reasoning_effort en las compatibles con OpenAI. Que dos proveedores usen las mismas etiquetas de esfuerzo no significa que realicen la misma cantidad de cómputo.
Evalúa primero Flash para tu tarea acotada de programación cuando predominen los cargos de entrada sin caché y salida durante el horario punta de DeepSeek. Mantén DeepSeek en la comparación si puedes ejecutar el trabajo en horario valle o reutilizas con frecuencia el contexto en caché. Cambia la elección provisional si el otro modelo produce cambios aceptados con menos reintentos, cargos totales inferiores o un tiempo de finalización claramente mejor.