MiniMax Code: agente MiniMax com sua própria chave via Gonka

O agente tem três pontos de entrada, e os três funcionam igual com um provedor BYOK:

O instalador oficial coloca a versão mais recente em ~/.minimax-code, baixa um Node.js adequado se necessário e não exige permissões 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

Se você já tem Node.js (22.19 ou superior na linha 22, 24.2 ou superior na linha 24, além de 25 e 26), o npm resolve:

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

O comando longo não é à toa: o agente precisa de uma compilação nativa do SQLite, por isso as dependências opcionais e os scripts de instalação devem continuar ativados. Depois de instalar, abra o terminal novamente e confira: mcode --version.

Dentro do TUI vão ser úteis Shift+Tab (modo de planejamento), Alt+M (alternar modos de permissão — Ask, Auto e Full access), @ para referenciar um arquivo e /help com a lista de comandos. O trabalho interrompido é retomado com mcode --continue, e mcode init . cria no projeto o arquivo AGENTS.md com as regras para o agente.

Os dados do usuário — config.yaml, sessões, estado de login — ficam separados do programa, no diretório ~/.minimax (em um perfil nomeado, ~/.minimax-<profile>); a variável MINIMAX_DATA_DIR define outro local.

Chave da JoinGonka. Cadastre-se em gate.joingonka.ai/register: após confirmar o endereço, você recebe 3M tokens grátis na conta. A chave com prefixo jg- é criada no painel, na seção «Chaves de API»; vale a pena gerar uma separada para o agente — assim o tráfego dele aparece em uma linha própria.

Feche o mcode, se estiver em execução, e rode:

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

O instalador vai pedir a chave, salvar uma cópia do config.yaml anterior, acrescentar apenas o próprio bloco e finalizar com uma requisição real ao gateway: chave, endereço e modelo são validados na hora, não na primeira tarefa. Em ~/.minimax/config.yaml vai aparecer o provedor joingonka dentro do ramo custom_provider — é exatamente ali que o mcode guarda endpoints de terceiros:

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

O que vale saber sobre esse bloco:

• O formato de API é declarado explicitamente. Sem o campo api, o mcode considera o provedor compatível com Anthropic; o instalador escolhe openai-completions — o caminho canônico do gateway.
• Cada modelo tem seus próprios limites. Para um modelo desconhecido, o mcode assume uma janela de 200 000 e uma saída de 16 384 tokens; os valores reais da rede são outros, por isso o limit está definido nas três entradas.
• A chave fica no arquivo em texto puro, e o arquivo recebe permissões 600. O mcode também armazena as chaves assim: sua flag --api-key-env lê a variável e grava o valor no config, não uma referência.
• Modelo padrão. A flag --model minimax define o MiniMax M2.7. Sem a flag, o instalador escolhe o DeepSeek V4 Flash para agentes de código — ele tem janela e teto de resposta maiores —, enquanto --model glm usa o GLM-5.3 Flash. Se já houver um modelo de outro provedor selecionado no config, rodar de novo sem --model não vai alterá-lo.
• Perfis. Para um perfil nomeado, rode o instalador com uma variável de ambiente, por exemplo MINIMAX_DATA_DIR=~/.minimax-work.

O pedido de fechar o mcode durante a instalação não é formalidade: o agente reescreve o config.yaml por inteiro a cada salvamento e pode sobrescrever uma edição feita às suas costas.

O mesmo resultado sai com o comando nativo do agente. A chave é passada por variável de ambiente — não tem nada que fazer nos argumentos nem no histórico do 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

A flag --use primeiro valida o primeiro dos modelos listados com uma requisição real e só então salva o provedor e define o modelo como padrão; se falhar, nada é salvo. Uma execução bem-sucedida termina com a linha Provider added and selected: JoinGonka. Do nome, o próprio mcode deduz a chave do provedor — joingonka —, então o instalador rodado depois vai atualizar essa mesma entrada em vez de criar uma segunda.

As flags --context-limit e --output-limit valem para todos os modelos listados no comando, mas os limites dos modelos da rede são diferentes. Por isso é prático usar o comando para criar um modelo e acrescentar os demais no arquivo. Feche o mcode e combine este trecho com o bloco de provedor já existente em ~/.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 }

O terceiro caminho é interativo: dentro do TUI, o comando /model abre o seletor de modelos com a opção + Add 3rd-party provider…, e o /provider gerencia as conexões salvas. O endereço na tela do modelo é editado com Ctrl+E; uma validação malsucedida não salva nada e o rascunho fica disponível para edição.

Qual formato de API escolher. O gateway aceita os três; só muda o endereço base:

Na nossa execução, os três formatos passaram no teste de conexão.

Três comandos mostram que a integração está funcionando. O primeiro lista os provedores — o ativo vem marcado com um asterisco e a chave mascarada:

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

O segundo faz uma requisição real e, em caso de sucesso, responde Provider available: custom_provider:joingonka; a flag --model testa um modelo específico:

mcode provider test custom_provider:joingonka

O terceiro verifica o mais importante: o trabalho com arquivos. Coloque no diretório um arquivo pequeno com um erro evidente e peça para encontrá-lo:

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

O agente deve chamar sozinho a ferramenta de leitura e responder com objetividade. No nosso teste, os três modelos da rede funcionaram assim; para usar outro modelo em uma única execução, basta passar uma flag como --model custom_provider:joingonka/<model-id>. Com a flag --output-format json, aparece na resposta um campo usage com o número de tokens de entrada e saída — útil para conferir com o painel do gateway: na seção «Uso» dá para ver as requisições por hora e por dia, a divisão por modelos e por chaves.

Se a verificação falhar, o mcode informa o motivo direto na mensagem:

O preço de todos os modelos da rede é o mesmo, então a escolha é uma questão de comportamento. Abaixo estão os limites e como os modelos se comportaram no nosso teste de mcode exec com a mesma tarefa (verificado em 21 de setembro de 2026):

A regra prática é simples. Para tarefas curtas e edições rápidas, escolha o MiniMax M2.7: hoje ele concentra a maior parte da capacidade da rede. Se o raciocínio visível atrapalhar — por exemplo, se um script analisar a saída do exec — ou se você precisar ler um repositório grande e obter uma edição longa, mude para o DeepSeek V4 Flash. Com lógica confusa, o GLM-5.3 Flash pensa melhor.

Trocar de modelo não exige editar o arquivo: na TUI é o comando /model, para uma sessão é mcode -m custom_provider:joingonka/<model-id>, e para uma única execução é mcode exec --model com o mesmo valor. A escolha permanente fica guardada na linha defaultModel. A composição da rede muda com o tempo; a lista atualizada com os limites sempre é devolvida por GET https://gate.joingonka.ai/v1/models.

As ferramentas de agente consomem tokens de forma diferente de um chat: para cada frase sua, o mcode adiciona um prompt de sistema e as descrições de todas as ferramentas, mantendo um diálogo de várias etapas com o modelo. Em nossa execução, a tarefa "ler um arquivo e encontrar o erro" custou cerca de 40 mil tokens, e quase tudo é entrada. Portanto, o preço por token aqui é decisivo.

Através do JoinGonka Gateway, os tokens custam $0.0069 por milhão na entrada e $0.021 por milhão na saída — o preço é igual para todos os modelos da rede e é preenchido nesta página a partir de uma fonte em tempo real. Ordens de grandeza de preços em setembro de 2026: uma tarefa única custa centavos de dólar, um dia de trabalho ativo com 3 a 7 milhões de tokens custa alguns centavos.

O que o BYOK cobre. Seu provedor gerencia as solicitações ao modelo: leitura e edição de código, comandos, subagentes, sessões. A busca integrada, ferramentas de mídia mcode-tools e conectores gerenciados são serviços do próprio fornecedor; eles exigem login na conta e créditos. Suas próprias ferramentas são conectadas independentemente através de servidores MCP no arquivo .mcp.json do projeto.

Permissões. Na TUI, os modos Ask, Auto e Full access são alternados via Alt+M ou pelo comando /permission; no mcode exec, o flag --permission é responsável por isso.

Telemetria. Canais de estatísticas, métricas e diagnóstico no mcode são desativados por padrão e ativados individualmente; as variáveis MCODE_DISABLE_TELEMETRY e DO_NOT_TRACK os desativam todos de uma vez. O gateway, por sua vez, não armazena o conteúdo de prompts ou respostas — apenas os agregados de consumo permanecem nas estatísticas.

Se precisar trabalhar com imagens — capturas de interface, layouts — crie um segundo provedor com um modelo que tenha visão, indicando o flag --support-image ao adicionar: os modelos da rede Gonka são de texto, mas podem haver vários provedores no mcode.

Existem agentes dos próprios laboratórios para as três famílias de modelos da rede: ao lado do MiniMax Code estão o DeepSeek Harness e o ZCode da Z.ai, autores do GLM. Todos os três se conectam ao mesmo gateway com a mesma chave.