Планы кода MiniMax, использование, API-ключи, BYOK, mcode и mmx

Последнее тестирование и обновление: 25 августа 2026 года

Теперь у MiniMax есть два имени командной строки помимо настольного приложения:

Настольное приложение MiniMax Code это графический локальный агент, изучаемый в ходе этого курса.
CLI MiniMax Code (mcode) это агент, ориентированный на репозиторий, в терминале. Его сессии, цели, поставщики, модели, плагины, использование и команды MCP относятся к среде выполнения MiniMax Code.
CLI платформы MiniMax (mmx) это отдельный инструмент с открытым исходным кодом для терминала для текстовых, поисковых, визуальных, изображений, речи, видео и музыкальных сервисов MiniMax.

API-ключ — это учетные данные, а не четвертый интерфейс. BYOK означает настройку поставщика модели, за которую вы платите или через которую аутентифицируетесь отдельно. A План токенов, кредиты и квоты учетной записи определяют, какой пул использования доступен на данном интерфейсе.

Когда настройка не удается, запишите интерфейс, учетную запись, регион, поставщика, модель, тип учетных данных и квоту перед повторной попыткой. «MiniMax не работает» — недостаточно информации для восстановления.

Один Отчет X от 21 февраля 2026 года описывает использование модели MiniMax через Claude Code для небольших скриптов, настройки окружения, простого DevOps и устранения проблем с дисковым пространством. Это отзыв о совместимости модели MiniMax внутри другого хоста для кодирования, а не доказательство для MiniMax Code на рабочем столе, mcode, или mmx. Это различие именно поэтому таблица интерфейсов ниже имеет значение.

Таблица решений

Работа	Правильная начальная поверхность	Нормальная первая аутентификация	Первый образец
Работа с локальными файлами с визуальными панелями и использованием браузера	Настольное приложение MiniMax Code	Вход через рабочий стол	Видны правильное рабочее пространство и активная модель
Работа с репозиторием из терминала или безголового командного режима	`mcode`	MiniMax OAuth или настроенный API-провайдер в соответствии с текущим CLI-потоком	`/status` показывает предполагаемого провайдера/модель и `mcode exec` сообщает об используемой модели
Вызов MiniMax поиска, визуализации, изображения, речи, видео или музыки из терминала	`mmx`	`mmx auth login` с использованием текущего OAuth/регионального потока или API-ключа	`mmx auth status` и `mmx quota` преуспеть
Использовать собственный ключ MiniMax API внутри рабочего стола	Настройка MiniMax API в рабочем столе	Ключ введен в безопасные настройки модели	Тест соединения пройден
Используйте другого совместимого провайдера на рабочем столе	Настраиваемая модель рабочего стола / BYOK	Базовый URL и ключ провайдера в безопасных настройках	Тест соединения плюс безопасный запрос
Создайте собственное приложение	MiniMax API или API совместимого провайдера	Управление учетными данными на стороне сервера	Один минимальный API вызов с зарегистрированной моделью и использованием

Не устанавливать mmx потому что учебное руководство говорит «MiniMax CLI», не поясняя задачу. Не вставляйте ключ в чат, потому что рабочий стол сообщает о проблеме с планом. Не предполагается, что вход в рабочий стол автоматически аутентифицирует каждый внешний CLI.

Официальное использование MiniMax Code и настройки модели с отображением информации о плане, кредитах, квотах и модели — Настройки использования и модели являются текущим источником информации о действительности плана, кредитах и квотах для конкретной учетной записи.

Официальная форма пользовательской модели MiniMax Code с полями поставщика, модели, контекста, вывода, рассуждений, базового URL и формата API — Возможность BYOK зависит от конфигурации поставщика; MiniMax Code не может сделать так, чтобы поддерживалась неподдерживаемая модель, длина контекста или формат медиа.

Проверяйте использование без заморозки цены во времени

Страница использования MiniMax на рабочем столе может показывать текущий Token Plan, баланс кредитов, использование квоты, данные о подписке или пополнении, счета и записи о входе. Правила выставления счетов и квоты следуют последнему интерфейсу продукта.

Перед крупной задачей зафиксируйте:

Платформа: MiniMax Code desktop / mcode / mmx / API
Вошедшая учетная запись: [REDACTED IDENTIFIER]
Регион: global / mainland China / provider-specific
План или пул кредитов: [CURRENT UI LABEL]
Активный поставщик и модель: [CURRENT LABEL]
Окно использования или квота: [CURRENT UI VALUE]
Планируемые параллельные рабочие процессы: [NUMBER]
Правило остановки: пауза при [THRESHOLD OR WARNING]

Не копируйте скриншоты счетов в публичные уроки или обращения в поддержку без удаления данных о личности, счете, оплате и учетной записи.

MiniMax документирует ежедневные контрольные точки в текущем настольном продукте. Рассматривайте эти числа как правило устаревшего продукта, а не часть основной операционной модели. Страница текущего использования приложения имеет приоритет, если этот урок и пользовательский интерфейс не совпадают.

BYOK в настольной версии

Используйте BYOK, когда вы намеренно хотите, чтобы MiniMax Code для настольных ПК обращался к поставщику модели через ваши собственные учетные данные. Текущие настройки поддерживают имя поставщика, базовый URL, API ключ, формат API, ID модели, окно контекста, максимальное количество токенов вывода и уровень рассуждений.

Безопасный рабочий процесс BYOK

Подтвердите официальный базовый URL провайдера и поддерживаемый формат API.
Создайте наименее привилегированные учетные данные, которые поддерживает провайдер.
Вводите их только в защищенные настройки модели MiniMax Code.
Установите точный идентификатор модели из документации провайдера.
Не превышайте лимиты контекста или вывода, поддерживаемые провайдером.
Запустите встроенный тест подключения.
Выполните одну безопасную подсказку и проверьте активного провайдера/модель.
Проверьте на панели управления провайдера запрос и стоимость.

Тест подключения (smoke test)

Возвратите точно: BYOK_CONNECTION_OK
Не используйте инструменты, не читайте файлы рабочей области, не просматривайте, не создавайте файлы и не продолжайте после
одного ответа.

Успешный тест соединения подтверждает базовую аутентификацию и совместимость. Он не подтверждает вызов инструментов, работу с визуальными данными, длинный контекст, стоимость или надежность в производстве.

`mcode`: CLI агента кодирования

Журнал изменений MiniMax Code имеет отдельную CLI ветку выпуска. Включенные в текущую документацию функции включают интерактивные сессии, цели, провайдеров и модели, плагины, управление MCP, просмотры контекста и использования, очередность инструкций и выполнение без интерфейса через mcode exec.

Если mcode уже установлен через текущий официальный установщик MiniMax Code CLI, начните с:

mcode --help

В интерактивной mcode сессии текущие записи журнала изменений документируют:

/status
/provider
/model
/context
/usage

Использовать /provider и /model для проверки или тестирования настроенного провайдера и выбора модели. Используйте /context и /usage для проверки контекста сессии и использования. MiniMax говорит, что вывод в формате JSON от mcode exec включает фактическую используемую модель, что полезно для журналов аудита.

Не используйте старую mavis команду из обходного решения сообщества как текущую mcode настройку. Не угадывайте команду установщика из загрузки с рабочего стола. Следуйте текущему официальному установщику CLI и журналу изменений для вашей платформы.

`mmx`: отдельный репозиторий CLI платформы

Официальный MiniMax-AI/cli публикует mmx команду через mmx-cli пакет и требует Node.js 18 или новее. Его цель — прямой доступ к возможностям платформы MiniMax, а не работа агента репозитория.

Текущие официальные команды установки и проверки включают:

npm install -g mmx-cli
mmx аутентификация вход
mmx аутентификация статус
mmx квота

Поток входа может использовать текущий путь OAuth Global или Mainland China либо путь с API-ключом. Предпочтите интерактивный документированный поток вместо того, чтобы помещать ключ напрямую в историю командной строки. Никогда не вставляйте реальный ключ в урок или скриншот команды.

Безопасный текст и проверки поиска:

mmx текст чат --сообщение "Ответьте точно MMX_TEXT_OK"
mmx поиск "Официальная документация MiniMax"

Другие документированные семьи команд включают:

mmx видение photo.jpg
mmx изображение "Бумажный метеорологический прибор на однотонном фоне"
mmx речь синтезировать --текст "Привет" --выход hello.mp3
mmx видео сгенерировать --подсказка "Волны океана на закате"
mmx музыка сгенерировать --подсказка "Жизнерадостная инструментальная музыка" --тексты "[инструментальная]"

Генерация медиа может расходовать квоту, занимать время и создавать файлы или размещенные задания. Не используйте эти примеры в качестве первого теста аутентификации. Проверьте mmx quota, текущие цены, местоположение вывода и правила содержания перед созданием.

Сценарий для новичка: выберите одно соединение и подтвердите его.

Вы хотите работать с репозиторием из терминала. Вы также увидели демонстрацию зрения. mmx Задача репозитория не требует понимания изображений или генерации медиа, поэтому вашим основным интерфейсом является mcode, не mmx.

Используйте эту рабочую таблицу:

Работа
Просмотрите один локальный репозиторий из терминала и представьте отчет только для чтения.

Выбранная поверхность
mcode, потому что это работа агента, ориентированная на репозиторий.

Provider/model
[ЗНАЧЕНИЕ ПОКАЗАНО КОМАНДОЙ /status]

Путь к учетным данным
[MiniMax OAuth или настроенный провайдер; здесь секрет не копируется]

Проверка квоты
[ЗНАЧЕНИЕ ПОКАЗАНО КОМАНДОЙ /usage]

Границы
Только для чтения. Запрещены редактирование, установка, фиксация, отправка, сетевые инструменты, изменения плагинов или MCP.

Доказательство
- /status показывает предполагаемого провайдера и модель;
- /usage записывается;
- отчёт указывает проверяемый путь;
- статус Git не изменён.

Отклонённый путь
mmx, потому что его команды platform media/search не выполняют работу repository-agent.

Параллельная работа и ограничения использования

Вкл 3 июля 2026 г.Один пользователь MiniMax Code v3.0.47 сообщил о быстром разветвлении верификатора/сессии с последующими повторными попытками после достижения лимита Token Plan. Этот отчёт является датированным наблюдением, а не оценкой распространённости или гарантией относительно текущего релиза.

Оперативный отклик заключается в ограничении параллельных ролей, проверке использования перед началом, остановке при первом уведомлении о квоте и избегании «повторять до успеха». Параллельные работники могут расходовать лимит быстрее, чем предполагает один видимый чат.

Граница безопасности

Храните учетные данные только в поддерживаемых безопасных настройках или путях управления секретами.
Никогда не размещайте ключи в подсказках, репозиториях, навыках, памяти, скриншотах, истории командной оболочки, служебных заявках или сгенерированных примерах.
Проверьте регион и тип учетных данных; глобальная сессия OAuth, аккаунт в Континентальном Китае, ключ плана Token и API-ключ по принципу оплаты по мере использования могут быть несовместимы.
Запишите активного провайдера и модель. Знакомый интерфейс не доказывает, что ответила ожидаемая модель.
Установите правило остановки расходов или использования перед параллельной работой или генерацией медиа.
Отозвать учетные данные, которые появились в чате, журналах, на скриншотах или в системе контроля версий.
BYOK отправляет содержимое задачи на настроенного поставщика на условиях этого поставщика.
Отображение квоты является свидетельством наличия разрешенного лимита, но не разрешением использовать его на несвязанную задачу.

Устранение неполадок

Симптом	Вероятная причина	Восстановление
Рабочий стол работает, но `mcode` не работает	CLI является отдельным, не установлен, или не находится в PATH	Используйте текущий официальный установщик CLI; перезапустите оболочку; выполните `mcode --help`
`mmx` открывается, но невозможно увидеть сессии репозитория	`mmx` является платформенным CLI, а не CLI агента кодирования	Использовать `mcode` для сессий репозитория и `mmx` для вызовов возможностей платформы
`mmx auth status` не показывает активной аутентификации	Вход не был завершен, неверный регион или учетные данные истекли	Запустите официальную интерактивную `mmx auth login` поток для правильного региона
Тест подключения BYOK не прошел	Базовый URL, ключ, идентификатор модели, формат API или сеть неверны	Сравните каждое поле с текущей документацией провайдера и протестируйте после исправления
Подключение прошло, но инструменты не работают	Модель/провайдер не поддерживает ожидаемый инструмент или формат	Проверьте возможности провайдера; не предполагаете, что функции десктопа переносятся в BYOK
Использование растет быстрее, чем ожидалось	Параллельные агенты, повторные попытки, длинный контекст, инструменты или медиа-задачи потребляют больше	Остановите активную работу, проверьте историю использования/сессий, уменьшите масштаб работы и добавьте жесткую остановку
Активная модель неясна	Провайдер или модель изменились между сессиями	Проверьте настройки модели на десктопе или `mcode /status`; зафиксируйте фактически использованную модель
Ключ был вставлен в команду терминала	Он может оставаться в истории оболочки или записях процессов	Отозовите его, очистите через поддерживаемые платформой шаги и переключитесь на безопасный способ входа

FAQ

Является `mcode` то же самое, что `mmx`?

Нет. mcode является CLI агента кодирования MiniMax Code. mmx является отдельным CLI платформы MiniMax для текста, поиска, визуальных данных, изображений, речи, видео и музыки.

Мне нужен какой-либо из этих CLI для этого курса на настольном компьютере?

Нет. MiniMax Code для настольного компьютера — это основной путь. CLI являются необязательными интерфейсами для работы в терминале.

Включает ли мой план токенов все запросы API или CLI?

Не предполагаете этого. Проверьте текущий план, тип учетных данных, выбранный интерфейс и документацию по квотам для вашей учетной записи.

Дешевле ли BYOK?

Не автоматически. Стоимость, кэширование, повторные попытки, контекст, длина вывода и тарифы провайдера определяют результат. Измеряйте на репрезентативной задаче.

Могу ли я использовать один и тот же API-ключ в чате, на рабочем столе и `mmx`?

Никогда не вставляйте ключ в чат. Работоспособность одного учетного данных в разных поддерживаемых настройках зависит от его типа, региона и провайдера. Используйте безопасный процесс настройки каждого продукта.

Какую команду следует выполнить первой после установки `mmx`?

Запуск mmx auth login, затем mmx auth status и mmx quota. Используйте небольшую проверку текста перед любой генерацией медиа.

Как доказать, какая модель `mcode` использовано?

Осмотреть /status в интерактивной сессии. Для работы без интерфейса MiniMax документирует фактическую модель в JSON-выводе из mcode exec.

Официальные источники

Что дальше

Диагностика сбоя без раскрытия секретов в L15: Устранение неполадок, обновления, журналы и обратная связь.