MiniMax Code: agente MiniMax con tu propia clave a través de Gonka

El agente tiene tres puntos de entrada, y los tres funcionan igual con un proveedor BYOK:

El instalador oficial coloca la versión más reciente en ~/.minimax-code, descarga un Node.js adecuado si hace falta y no requiere permisos de administrador:

# macOS / Linux / WSL
curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

# Windows (PowerShell)
irm https://filecdn.minimax.chat/public/install.ps1 | iex

Si ya tienes Node.js (22.19 o superior en la línea 22, 24.2 o superior en la línea 24, y también 25 y 26), npm te sirve:

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

El comando largo no es casualidad: el agente necesita una compilación nativa de SQLite, así que las dependencias opcionales y los scripts de instalación deben permanecer activados. Tras instalar, abre el terminal de nuevo y comprueba: mcode --version.

Dentro del TUI te resultarán útiles Shift+Tab (modo de planificación), Alt+M (alternar modos de permisos — Ask, Auto y Full access), @ para referenciar un archivo y /help con la lista de comandos. El trabajo interrumpido se retoma con mcode --continue, y mcode init . crea en el proyecto el archivo AGENTS.md con las reglas para el agente.

Los datos del usuario — config.yaml, sesiones, estado de sesión — viven aparte del programa, en el directorio ~/.minimax (para un perfil con nombre, ~/.minimax-<profile>); la variable MINIMAX_DATA_DIR define otra ubicación.

Clave de JoinGonka. Regístrate en gate.joingonka.ai/register: tras confirmar tu dirección recibirás 3M tokens gratis en la cuenta. La clave con prefijo jg- se crea en el panel, en la sección «Claves de API»; conviene generar una aparte para el agente — así su tráfico aparecerá en una línea propia.

Cierra mcode si está en ejecución y ejecuta:

npx @joingonka/setup --tool minimax-code --model minimax

El instalador pedirá la clave, guardará una copia del config.yaml anterior, añadirá únicamente su propio bloque y terminará con una petición real al gateway: la clave, la dirección y el modelo se validan al instante, no en la primera tarea. En ~/.minimax/config.yaml aparecerá el proveedor joingonka dentro de la rama custom_provider, que es justo donde mcode aloja los endpoints de terceros:

custom_provider:\n  joingonka:\n    name: JoinGonka\n    kind: custom\n    enabled: true\n    api: openai-completions\n    options:\n      apiKey: jg-your-key\n      baseURL: https://gate.joingonka.ai/v1\n      authMode: api-key\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        name: MiniMax M2.7 (Gonka)\n        limit:\n          context: 200000\n          output: 8192\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        name: DeepSeek V4 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 380000\n          output: 32768\n      zai-org/GLM-5.3-Flash:\n        name: GLM 5.3 Flash (Gonka)\n        reasoning: true\n        limit:\n          context: 390000\n          output: 8192\ndefaultModel: custom_provider:joingonka/MiniMaxAI/MiniMax-M2.7

Lo que conviene saber sobre este bloque:

• El formato de API se declara explícitamente. Sin el campo api, mcode asume que el proveedor es compatible con Anthropic; el instalador elige openai-completions, la ruta canónica del gateway.
• Cada modelo tiene sus propios límites. A un modelo desconocido, mcode le asigna una ventana de 200 000 y una salida de 16 384 tokens; los valores reales de la red son distintos, por eso limit está definido en las tres entradas.
• La clave se guarda en el archivo en texto plano, y el archivo recibe permisos 600. mcode también almacena así sus claves: su flag --api-key-env lee la variable y escribe el valor en la configuración, no una referencia.
• Modelo por defecto. El flag --model minimax establece MiniMax M2.7. Sin el flag, el instalador elige DeepSeek V4 Flash para agentes de código, ya que tiene mayor ventana y techo de respuesta, mientras que --model glm usa GLM-5.3 Flash. Si ya hay un modelo de otro proveedor seleccionado en la configuración, volver a ejecutar sin --model no lo modificará.
• Perfiles. Para un perfil con nombre, ejecuta el instalador con una variable de entorno, por ejemplo MINIMAX_DATA_DIR=~/.minimax-work.

La petición de cerrar mcode durante la instalación no es un formalismo: el agente reescribe config.yaml por completo cada vez que guarda y puede sobrescribir una edición hecha a sus espaldas.

El comando nativo del agente produce el mismo resultado. La clave se pasa mediante una variable de entorno: no tiene nada que hacer en los argumentos ni en el historial del shell:

# read the key without echo\nread -s JOINGONKA_API_KEY\nexport JOINGONKA_API_KEY\n\nmcode provider add --name JoinGonka \\\n  --base-url https://gate.joingonka.ai/v1 \\\n  --api-format openai-completions \\\n  --model MiniMaxAI/MiniMax-M2.7 \\\n  --api-key-env JOINGONKA_API_KEY \\\n  --context-limit 200000 --output-limit 8192 --use

El flag --use primero verifica con una petición real el primero de los modelos listados y solo entonces guarda el proveedor y lo establece como modelo por defecto; si falla, no se guarda nada. Una ejecución exitosa termina con la línea Provider added and selected: JoinGonka. Del nombre, mcode deduce por sí mismo la clave del proveedor, joingonka, así que el instalador ejecutado después actualizará esa misma entrada en lugar de crear una segunda.

Los flags --context-limit y --output-limit aplican a todos los modelos listados en el comando, pero los límites de los modelos de la red son distintos. Por eso es práctico usar el comando para crear un modelo y añadir el resto al archivo. Cierra mcode y combina este fragmento con el bloque de proveedor ya existente en ~/.minimax/config.yaml:

custom_provider:\n  joingonka:\n    models:\n      MiniMaxAI/MiniMax-M2.7:\n        limit: { context: 200000, output: 8192 }\n      deepseek-ai/DeepSeek-V4-Flash-0731:\n        limit: { context: 380000, output: 32768 }\n      zai-org/GLM-5.3-Flash:\n        limit: { context: 390000, output: 8192 }

La tercera vía es interactiva: dentro del TUI, el comando /model abre el selector de modelos con la opción + Add 3rd-party provider…, y /provider gestiona las conexiones guardadas. La dirección en la pantalla del modelo se edita con Ctrl+E; una verificación fallida no guarda nada y el borrador queda para seguir editándolo.

Qué formato de API elegir. El gateway acepta los tres, solo cambia la dirección base:

En nuestra ejecución, los tres formatos superaron la prueba de conexión.

Tres comandos demuestran que la integración funciona. El primero lista los proveedores: el activo aparece marcado con un asterisco y la clave enmascarada:

mcode provider list
* custom_provider:joingonka   active   jg-a****9f3c

El segundo lanza una petición real y, si tiene éxito, responde Provider available: custom_provider:joingonka; el flag --model comprueba un modelo concreto:

mcode provider test custom_provider:joingonka

El tercero verifica lo más importante: el trabajo con archivos. Coloca en el directorio un archivo pequeño con un error evidente y pídele que lo encuentre:

mcode exec "Read calc.py and tell me in one sentence whether it has a bug."

El agente debe invocar por sí mismo la herramienta de lectura y responder con fundamento. En nuestra prueba así funcionaron los tres modelos de la red; para usar otro modelo en una sola ejecución se indica con un flag como --model custom_provider:joingonka/<model-id>. Con el flag --output-format json aparece en la respuesta un campo usage con el número de tokens de entrada y salida, útil para contrastarlo con el panel de la pasarela: en la sección «Uso» se ven las solicitudes por horas y por días, el desglose por modelos y por claves.

Si la comprobación falla, mcode indica el motivo directamente en el mensaje:

Todos los modelos de la red tienen el mismo precio, así que la elección va de comportamiento. Abajo están los límites y cómo se comportaron los modelos en nuestra prueba de mcode exec con la misma tarea (verificado el 21 de septiembre de 2026):

La regla práctica es sencilla. Para tareas cortas y ediciones rápidas, elige MiniMax M2.7: ahora mismo concentra la mayor parte de la capacidad de la red. Si el razonamiento visible estorba —por ejemplo, si un script analiza la salida de exec— o necesitas leer un repositorio grande y obtener una edición larga, cambia a DeepSeek V4 Flash. Con lógica enrevesada piensa mejor GLM-5.3 Flash.

Cambiar de modelo no exige tocar el archivo: en la TUI es el comando /model, para una sesión es mcode -m custom_provider:joingonka/<model-id> y para una sola ejecución es mcode exec --model con el mismo valor. La elección permanente se guarda en la línea defaultModel. La composición de la red cambia con el tiempo; el listado actualizado con los límites siempre lo devuelve GET https://gate.joingonka.ai/v1/models.

Las herramientas de agente consumen tokens de forma distinta a un chat: por cada frase suya, mcode añade un prompt del sistema y las descripciones de todas las herramientas, manteniendo un diálogo multietapa con el modelo. En nuestra ejecución, la tarea "leer un archivo y encontrar el error" costó unos 40 mil tokens, y casi todo es entrada. Por tanto, el precio por token es decisivo aquí.

A través de JoinGonka Gateway, los tokens cuestan $0.0069 por millón en la entrada y $0.021 por millón en la salida; el precio es igual para todos los modelos de la red y se rellena en esta página desde una fuente en tiempo real. Magnitudes de precios a septiembre de 2026: una tarea única cuesta centavos de dólar, un día de trabajo activo de 3 a 7 millones de tokens cuesta algunos centavos.

Qué cubre BYOK. Su proveedor gestiona las solicitudes al modelo: lectura y edición de código, comandos, subagentes, sesiones. La búsqueda integrada, las herramientas multimedia mcode-tools y los conectores gestionados son servicios del proveedor; requieren inicio de sesión en la cuenta y créditos. Sus propias herramientas se conectan independientemente mediante servidores MCP en el archivo .mcp.json del proyecto.

Permisos. En la TUI, los modos Ask, Auto y Full access se cambian con Alt+M o con el comando /permission; en mcode exec, el flag --permission se encarga de esto.

Telemetría. Los canales de estadísticas, métricas y diagnóstico en mcode están desactivados por defecto y se activan individualmente; las variables MCODE_DISABLE_TELEMETRY y DO_NOT_TRACK los desactivan todos a la vez. El gateway, por su parte, no guarda el contenido de los prompts ni las respuestas; solo se mantienen los agregados de consumo en las estadísticas.

Si necesita trabajar con imágenes —capturas de interfaz, maquetas—, cree un segundo proveedor con un modelo que tenga visión, indicando el flag --support-image al añadirlo: los modelos de la red Gonka son de texto, pero en mcode puede haber varios proveedores.

Existen agentes de los propios laboratorios para las tres familias de modelos de la red: junto a MiniMax Code están DeepSeek Harness y ZCode de Z.ai, autores de GLM. Los tres se conectan a un mismo gateway con la misma clave.