MiniMax Code: el agente de terminal open source que compite con Claude Code

Hoy existen muchos harness (herramientas que envuelven a un modelo de IA para que pueda leer archivos, ejecutar comandos y editar código) para distintos modelos. Faltaba uno oficial y dedicado a los modelos de MiniMax, que se han vuelto muy populares para programar por su buena relación entre calidad y precio.

Ese hueco lo llena MiniMax Code (o MCode), el agente de código desarrollado por la propia MiniMax. En este tutorial vas a ver cómo instalarlo, cómo conectarlo a tu suscripción y cómo usar sus funciones más útiles (Plan Mode, permisos, skills, goals, preguntas laterales y plugins) construyendo un e-commerce completo con Next.js, PostgreSQL, Prisma y pagos con Stripe.

Tabla de contenidos

¿Qué es MiniMax Code?

MiniMax Code es un agente de código open source para la terminal, publicado por MiniMax en GitHub con licencia MIT para el código propio. Si has usado herramientas como Claude Code, OpenCode o Codex CLI, la idea es la misma: abres la terminal en tu proyecto, describes lo que quieres y el agente lee archivos, ejecuta comandos, edita código y corre pruebas.

Algunos puntos clave:

  • Funciona con tu cuenta de MiniMax / Token Plan, con una API key de MiniMax o con tu propio proveedor compatible con los formatos de OpenAI o Anthropic (BYOK).
  • Tiene tres modos de uso: la interfaz interactiva (TUI) con mcode, el modo headless con mcode exec para scripts y CI, y ACP con mcode acp para conectarlo a editores compatibles.
  • También existe una app de escritorio para macOS y Windows, pero su código no forma parte del repositorio open source: lo abierto es la terminal, el modo headless y ACP.

En este tutorial nos enfocamos en la terminal, que es la interfaz que la mayoría de desarrolladores va a usar.

Cómo instalar MiniMax Code

MiniMax ofrece un instalador oficial por sistema operativo. No requiere sudo ni permisos de administrador y, si hace falta, prepara una versión compatible de Node.js.

macOS / Linux / WSL:

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

Windows (PowerShell):

irm https://filecdn.minimax.chat/public/install.ps1 | iex

Con npm (si ya tienes Node.js 22.19+, 24.2+, 25 o 26):

npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3

Cierra y vuelve a abrir la terminal, y comprueba la instalación:

mcode --version
mcode --help

Nota: el instalador de un solo comando no es compatible con Alpine Linux (musl). Tienes todos los detalles en la guía de instalación oficial.

Suscripción: el Token Plan de MiniMax

Para usar los modelos de MiniMax desde MCode necesitas el Token Plan, una suscripción mensual con una cuota de uso compartida entre texto, imagen y voz. Es decir, con el mismo plan también puedes generar imágenes y audio.

A la fecha de este artículo, MiniMax lista tres niveles: Plus ($22/mes), Max ($55/mes) y Ultra ($132/mes). El plan Plus equivale aproximadamente a 1.700 millones de tokens al mes del modelo M3, y los planes superiores multiplican esa cuota. La cuota funciona con ventanas de 5 horas y semanales, y la pagas por adelantado al mes o al año (con dos meses gratis en el anual).

Los precios y cuotas cambian con frecuencia. Revisa siempre la página oficial de precios antes de suscribirte.

Desde la consola de MiniMax, en los detalles del plan, también puedes generar o resetear tu Subscription Key, útil si quieres usar la misma suscripción desde otras herramientas como OpenCode.

Iniciar sesión y primeros comandos

Ejecuta mcode y verás la pantalla de bienvenida. Lo primero es iniciar sesión:

/login

Te pedirá elegir la región: China o Global. Si estás fuera de China continental, elige Global; se abrirá el navegador para autorizar la cuenta. (Desde fuera del TUI, el equivalente es mcode login --region global.)

Escribe un "hola" para comprobar que responde y ya tienes tu suscripción conectada. Otros comandos básicos:

Comando Qué hace
/clear (alias de /new) Empieza una sesión nueva
/exit (alias de /quit) Sale de MCode
/status Muestra versión, cuenta, modelo y cuota disponible
/model Busca y selecciona un modelo
/help Lista todos los comandos y atajos de teclado

Un consejo: antes de ejecutar mcode, colócate en la carpeta donde quieres trabajar (por ejemplo cd Desktop), porque el agente usa el directorio actual como contexto y ahí creará el proyecto.

Plan Mode: planificar antes de programar

Por defecto, MCode ejecuta directamente lo que le pides. Si le dices "crea dos archivos Markdown vacíos", los crea al instante.

Para proyectos grandes conviene pedir primero un plan. Presiona Shift + Tab para activar Plan Mode (también puedes usar /plan on). En este modo el agente no escribe código: investiga, te hace preguntas y te presenta un plan para aprobar.

El prompt que usé fue algo así:

Crea un e-commerce utilizando Next.js y PostgreSQL con Prisma, y tests con Vitest.
Incluye catálogo de productos, carrito de compras, checkout integrado con Stripe
y perfiles de usuario con roles admin y usuario.

Durante la planificación, el agente me preguntó el alcance (MVP, estándar o listo para producción) y dónde guardar las imágenes. Al elegir "listo para producción", el plan incluyó extras como lista de deseos, impuestos, multimoneda, multi-idioma, cupones, inventario y reembolsos.

Lo importante es revisar el plan antes de aprobarlo. En mi caso proponía Next.js 15 y Server Actions, así que elegí la opción de añadir contexto y le pedí:

Usa Next.js 16 y no uses Server Actions, crea una API.

El agente reescribió el plan con esos cambios y, al aceptarlo, empezó a implementarlo por fases. La primera versión funcional le tomó unos 16 minutos, con base de datos real, credenciales de prueba y panel de administración.

Modos de permisos

Por defecto el agente pide confirmación antes de acciones como búsquedas web o comandos de terminal. Para no aprobar cada paso, usa /permission:

Modo Comportamiento
/permission ask Pide confirmación en cada acción
/permission auto Aprueba lo rutinario y pregunta si el riesgo es alto
/permission full Omite las comprobaciones de permisos

Yo usé Full access para que avanzara sin interrupciones. Úsalo solo en proyectos donde entiendas los riesgos, porque el agente podrá ejecutar comandos sin preguntarte.

Skills: darle más contexto al agente

La primera versión funcionaba, pero la interfaz era bastante genérica. Aquí entran los skills: instrucciones reutilizables (un archivo SKILL.md) escritas por otros desarrolladores que el agente carga cuando las necesita.

Con /skills puedes listar los skills disponibles: los que vienen integrados en MCode (revisión de código, investigación, despliegue, documentación, etc.) y los que tienes instalados a nivel de usuario.

Para instalar skills adicionales usé skills.sh, el directorio de skills mantenido por Vercel, junto con su CLI npx skills. Instalé dos:

1. interface-design, pensado para mejorar el diseño de dashboards, paneles de administración y apps SaaS:

npx skills add https://github.com/dammyjay93/interface-design --skill interface-design

2. playwright-cli, de Microsoft, que permite al agente abrir el navegador, navegar, rellenar formularios y tomar capturas:

npx skills add https://github.com/microsoft/playwright-cli

En el instalador elige instalarlo de forma global para que MCode lo detecte. Después, vuelve a MCode, recarga la configuración y comprueba con /skills que aparecen.

Para probar Playwright le pedí:

Usando Playwright CLI, prueba el login en modo headed.

El modo headed abre el navegador visible, así puedes ver cómo el agente identifica los campos, escribe el correo y la contraseña y envía el formulario.

Goals: tareas largas que iteran solas

Podría pedir el rediseño página por página, pero para eso existe /goal: mantiene un objetivo activo durante varios turnos y el agente sigue iterando hasta cumplirlo.

/goal Reimplementa todas las interfaces usando shadcn/ui y rediseña completamente
todas las páginas existentes. Por cada modificación, revisa con Playwright CLI que
el diseño esté completo y funcional; si no, corrige. El goal termina cuando todas
las páginas estén completamente rediseñadas.

Comandos útiles para gestionar el goal:

Comando Qué hace
/goal pause Pausa el objetivo
/goal resume Lo reanuda
/goal edit Edita el objetivo
/goal clear Lo elimina
/goal budget=50K Limita los tokens a gastar (budget=clear quita el límite)

En mi caso el proceso tardó alrededor de 40 minutos y tuve que reanudarlo una vez porque la tarea en segundo plano se detuvo a los ~30 minutos. El resultado fue una interfaz mucho más usable que la primera versión: mismo modelo, pero con mejores pautas gracias a los skills. Aun así, conviene revisar detalles (en mi caso, un footer mal ubicado y algunos productos sin imagen).

Datos reales, testing E2E y Stripe

Llenar productos con imágenes reales

Para que el catálogo no tuviera imágenes en blanco, le pedí un scraping básico:

Haz un scraping básico para llenar datos de productos reales con imágenes relacionadas
a estos productos ficticios, y añade imágenes para cada galería de producto.

El agente buscó imágenes en internet y las asignó a cada producto y galería. Hizo un trabajo decente, aunque a veces falla la correspondencia, así que revisa el resultado.

Si usas imágenes de internet en un proyecto real, asegúrate de tener derechos de uso o usa bancos de imágenes con licencia libre.

Testing end-to-end del flujo de compra

Con el mismo skill de Playwright pedí probar todo el flujo:

Usando Playwright CLI, haz testing de todo el flujo de compra de un usuario nuevo,
desde que elige los productos hasta que paga.

El agente generó una lista de tareas, abrió el navegador, detectó que añadir al carrito requiere iniciar sesión, se registró y avanzó. El reporte indicó que el flujo se rompía en el paso 8 de 10: el pago, porque aún no había configurado Stripe. Justo lo esperado.

Configurar Stripe con su CLI

Le pregunté qué variables necesitaba y me indicó instalar el Stripe CLI y autenticarme. Tras instalarlo:

stripe login

Abre la URL que te muestra, confirma el código de emparejamiento y el CLI queda autorizado para el entorno de pruebas (sandbox). Después basta con decirle al agente:

Stripe CLI está autenticado, completa lo que falta.

Para ayudarle más, también puedes pegar tus claves de prueba (publicable y secreta) desde el dashboard de Stripe.

Para comprobarlo manualmente: añade productos al carrito, registra una dirección, ve al checkout y usa la tarjeta de prueba de Stripe 4242 4242 4242 4242 con cualquier fecha futura y CVC. El pago se procesa, vuelves a la tienda y la orden aparece en tu perfil.

Subir el proyecto a GitHub con gh

Lo mismo aplica a GitHub. Instala el GitHub CLI y autentícate:

gh auth login

Sigue las preguntas, copia el código que aparece en la terminal, pégalo en el navegador y autoriza. A partir de ahí el agente puede usar gh por ti:

Sube este proyecto a GitHub y colócalo como repo privado.

Y luego, si quieres:

Conviértelo a un repo público.

Todo sin entrar a la interfaz web de GitHub. Este patrón (instalar un CLI, autenticarte una vez y dejar que el agente lo use) es de lo más útil de trabajar con agentes de terminal.

Preguntas laterales con /btw

Mientras el agente trabaja en una tarea, puedes hacer una pregunta sin interrumpirla con /btw (alias /side):

/btw ¿Existe una carpeta docs para documentación?

Se abre una conversación lateral que hereda el contexto de la sesión principal, mientras la tarea original sigue corriendo. Con Ctrl + / cambias entre la vista principal y la lateral. Las herramientas que modifican archivos en la conversación lateral siempre piden confirmación, incluso en modo Full access.

Plugins, MCP, sesiones y otros comandos

  • /settings: configura la interfaz de la terminal (por ejemplo, modo pantalla completa o scroll).
  • /plugins: explora, instala y habilita plugins del marketplace oficial, como integraciones con Notion, Linear o Figma. Ten en cuenta que un plugin puede añadir solo skills; para conectarte de verdad al servicio puede que necesites configurar su MCP.
  • /mcp: revisa la configuración de servidores MCP. Puedes pedirle al agente algo como "configura el MCP de Notion"; tras habilitarlo, reinicia la sesión.
  • mcode --continue: reanuda la última sesión del directorio actual. mcode --session abre el selector de sesiones.
  • /sessions (alias /resume): busca y navega entre sesiones anteriores.
  • Skills como comandos: los skills instalados también aparecen como comandos con su propio nombre, para invocarlos directamente.
  • /help: muestra todos los comandos y atajos de teclado disponibles.

Novedad: MiniMax M3.1-Flash-Preview

El 27 de septiembre de 2026 MiniMax lanzó M3.1-Flash-Preview, un modelo de texto orientado a desarrollo del día a día (corregir bugs, implementar features) disponible dentro de MiniMax Code y en el Token Plan. Puedes seleccionarlo con /model. Al ser una preview, MiniMax aún no ha publicado benchmarks ni detalles técnicos completos.

Conclusión

MiniMax Code es fácil de usar y, combinado con Plan Mode, skills, goals y herramientas de terminal como Stripe CLI, GitHub CLI y Playwright, permite construir un proyecto completo sin estar guiando al agente en cada paso. En este tutorial generamos un e-commerce funcional con base de datos real, rediseño con shadcn/ui, testing end-to-end y pagos con Stripe.

Mi recomendación: pruébalo en tus propios proyectos y evalúa si se adapta a tu flujo de trabajo, sobre todo si buscas una alternativa open source y económica a otros agentes de código.

Enlaces útiles:

Preguntas frecuentes

¿MiniMax Code es gratis?

La herramienta es open source (licencia MIT para el código propio) y se instala gratis. Para usar los modelos de MiniMax necesitas un Token Plan o una API key de pago, aunque también puedes conectar tu propio proveedor compatible con OpenAI o Anthropic.

¿MiniMax Code funciona en Windows?

Sí. Tiene instalador oficial para Windows vía PowerShell, además de macOS, Linux y WSL.

¿Qué diferencia hay entre Plan Mode y los modos de permisos?

Son independientes. Plan Mode (Shift + Tab) decide si el agente planifica antes de ejecutar. Los modos de permisos (ask, auto, full) deciden si te pide confirmación antes de cada acción.

¿Puedo usar skills de Claude Code en MiniMax Code?

Los skills siguen el formato estándar SKILL.md, y el CLI npx skills de skills.sh los instala para distintos agentes. Al instalarlos de forma global, MCode los detecta y aparecen en /skills.

¿Qué es un goal en MiniMax Code?

Un objetivo que el agente mantiene activo a lo largo de varios turnos, iterando hasta cumplirlo. Se gestiona con /goal y permite pausar, reanudar, editar y limitar el presupuesto de tokens.

¿Tienes dudas o quieres ver otro ejemplo? Déjalo en los comentarios del video. Y si necesitas ayuda con tu proyecto, en fazt.dev puedes reservar asesorías personalizadas.