Minimax M2.5 + Claude Code

TL;DR: Подключаем Minimax M2.5 к Claude Code. Модель с контекстом 204K, extended thinking и ценой $0.30/$1.20 за миллион токенов — одна из самых дешёвых. Настроим алиас mmax для переключения.

Minimax — китайский AI-провайдер, который сделал Anthropic-совместимый API. Их модель MiniMax-M2.5 заточена под кодинг и агентные задачи. Два варианта оплаты: pay-per-token и Coding Plan (подписка от $10/мес, включает image understanding и web search). По цене за токен — дешевле большинства альтернатив.

Что понадобится

• Claude Code (установленный)
• Аккаунт на platform.minimax.io
• Баланс или Coding Plan (от $10/мес)
• Терминал с zsh или bash

Шаг 1. Регистрация и API-ключ

Заходи на platform.minimax.io и создай аккаунт. В разделе «Account Management > API Keys» сгенерируй новый ключ.

Сохрани в ~/.zshrc:

export MINIMAX_API_KEY="вставь-свой-ключ"

Шаг 2. Выбираем тариф

Pay-per-token API:

Coding Plan — подписка с фиксированной ценой. Есть два тира: Standard на обычной M2.5 (~50 TPS, в непиковое время до 100 TPS) и High-Speed на M2.5-highspeed (~100 TPS постоянно).

Standard (M2.5):

High-Speed (M2.5-highspeed):

При годовой оплате экономишь 2 месяца. Все планы включают image understanding и web search MCP.

M2.5 стоит $0.30/$1.20 — дешевле Z.ai ($0.60/$2.20) и примерно на уровне DeepSeek ($0.28/$0.42 вход дешевле, но выход $1.20 vs $0.42 — дороже). DeepSeek выигрывает по цене выхода, Minimax — по контексту (204K vs 128K).

Шаг 3. Настраиваем алиас

Добавь в ~/.zshrc:

mmax() {
  ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic \
  ANTHROPIC_AUTH_TOKEN="$MINIMAX_API_KEY" \
  API_TIMEOUT_MS=3000000 \
  ANTHROPIC_MODEL=MiniMax-M2.5 \
  ANTHROPIC_SMALL_FAST_MODEL=MiniMax-M2.5 \
  ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.5 \
  ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.5 \
  ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.5 \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

API_TIMEOUT_MS=3000000 — Minimax рекомендует большой таймаут (50 минут). На практике столько не нужно, но лучше перестраховаться.

Перезагрузи: source ~/.zshrc.

Для быстрых ответов — highspeed вариант:

mmax-fast() {
  ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic \
  ANTHROPIC_AUTH_TOKEN="$MINIMAX_API_KEY" \
  API_TIMEOUT_MS=3000000 \
  ANTHROPIC_MODEL=MiniMax-M2.5-highspeed \
  ANTHROPIC_SMALL_FAST_MODEL=MiniMax-M2.5-highspeed \
  ANTHROPIC_DEFAULT_SONNET_MODEL=MiniMax-M2.5-highspeed \
  ANTHROPIC_DEFAULT_OPUS_MODEL=MiniMax-M2.5-highspeed \
  ANTHROPIC_DEFAULT_HAIKU_MODEL=MiniMax-M2.5-highspeed \
  CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 \
  claude "$@"
}

Highspeed выдаёт ~100 токенов/сек вместо ~50, но стоит вдвое дороже.

Шаг 4. Проверяем

mmax

Сессия должна открыться. Попробуй попросить объяснить файл или написать функцию.

Шаг 5. Глобальная настройка (альтернатива)

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "ваш-ключ",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Сохрани в ~/.claude/settings.json.

Три переменные ANTHROPIC_DEFAULT_*_MODEL нужны, чтобы переключение моделей через /model в Claude Code тоже использовало Minimax. Без них Claude Code попробует дёрнуть оригинальные модели Anthropic и получит ошибку.

Бонус: Minimax в Cursor

Если пользуешься Cursor, подключить M2.5 тоже просто:

1. Открой Settings → Models → API Keys
2. Включи «Override OpenAI Base URL» и вставь https://api.minimax.io/v1
3. Вставь свой Minimax API-ключ в поле OpenAI API Key
4. Нажми кнопку справа от поля, затем «Enable OpenAI API Key»
5. В разделе Models нажми «View All Models» → «Add Custom Model» → введи MiniMax-M2.5
6. Включи модель и выбери её в чате

Для Cursor используется OpenAI-совместимый эндпоинт (/v1), а не Anthropic-совместимый (/anthropic). Настройки для других инструментов (TRAE, Cline, Roo Code, Kilo Code) — в документации Minimax.

Результат

mmax запускает Claude Code с MiniMax-M2.5, mmax-fast — с highspeed. Контекст 204K, extended thinking работает. Если что-то пошло не так — смотри раздел ниже.

Частые ошибки

Конфликт API-ключей

Если в переменных окружения уже задан ANTHROPIC_AUTH_TOKEN, он перебивает значение из settings.json. Убедись, что нет конфликтов: echo $ANTHROPIC_AUTH_TOKEN. Алиас решает эту проблему, потому что явно задаёт переменные.

Изображения и мультимодальность

Через pay-per-token API Minimax поддерживает только текст — картинки и документы не пройдут. Если у тебя Coding Plan, ситуация лучше: подписка даёт доступ к image understanding и web search MCP. То есть модель сможет анализировать скриншоты и искать в интернете.

stop_sequences и top_k игнорируются

Minimax не поддерживает эти параметры. Обычно это не мешает работе Claude Code, но если видишь странное поведение при остановке генерации — вот причина.

FAQ

Чем Minimax отличается от Z.ai и DeepSeek?

По цене M2.5 ($0.30/$1.20) — между DeepSeek ($0.28/$0.42) и Z.ai ($0.60/$2.20). Контекст: 204K у Minimax, 128K у DeepSeek, 200K у Z.ai. По качеству кодинга сравнивать сложно — зависит от задачи. Я бы попробовал все три на своём проекте и выбрал.

Есть ли бесплатный тариф?

Бесплатного тарифа нет, но Coding Plan Starter за $10/мес — неплохая точка входа.

Minimax — это тот же, что делает HailuoAI?

Да, Minimax — разработчик HailuoAI (генерация видео). Текстовые модели M2.5 — их отдельное направление для разработчиков.

Что ещё почитать

• Claude Code с любой моделью: 10 провайдеров 2026 — обзор всех провайдеров
• Z.ai + Claude Code: GLM-модели за $10/мес — альтернативный провайдер
• Переменные окружения Claude Code — справочник