> ## Content Index
> Fetch the complete content index at: https://matveev.tech/llms.txt
> Use this file to discover other available public pages before exploring further.

# Minimax M2.5 + Claude Code
- URL: https://matveev.tech/minimax-claude-code-setup/
- Published: 2026-02-18T14:33:23.000Z
- Updated: 2026-02-25T12:16:41.000Z
- Description: Подключаем Minimax M2.5 к Claude Code — $0.30/MTok, 204K контекст, extended thinking и алиас mmax.
- Author: Pavel Matveev
- Tags: Claude Code, Claude, Dev Tools, Гайд, LLM

**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). По цене за токен — дешевле большинства альтернатив.

![Страница модели MiniMax M2.5 — бенчмарки и возможности](https://matveev.tech/content/images/2026/02/minimax-m25-model-page.jpg)

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

- Claude Code (установленный)
- Аккаунт на [platform.minimax.io](https://platform.minimax.io/?ref=matveev.tech)
- Баланс или Coding Plan (от $10/мес)
- Терминал с zsh или bash

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

Заходи на [platform.minimax.io](https://platform.minimax.io/?ref=matveev.tech) и создай аккаунт. В разделе «Account Management > API Keys» сгенерируй новый ключ.

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

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

```

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

Pay-per-token API:

| Модель                 | Input | Output | Cache Read | Скорость  |
| ---------------------- | ----- | ------ | ---------- | --------- |
| MiniMax-M2.5           | $0.30 | $1.20  | $0.03      | \~50 tps  |
| MiniMax-M2.5-highspeed | $0.60 | $2.40  | $0.03      | \~100 tps |
| MiniMax-M2.1           | $0.30 | $1.20  | $0.03      | \~50 tps  |

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

Standard (M2.5):

| План    | Цена/мес | Цена/год | Промптов за 5 ч |
| ------- | -------- | -------- | --------------- |
| Starter | $10      | $100     | \~100           |
| Plus    | $20      | $200     | \~300           |
| Max     | $50      | $500     | \~1 000         |

High-Speed (M2.5-highspeed):

| План  | Цена/мес | Цена/год | Промптов за 5 ч |
| ----- | -------- | -------- | --------------- |
| Plus  | $40      | $400     | \~300           |
| Max   | $80      | $800     | \~1 000         |
| Ultra | $150     | $1 500   | \~2 000         |

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

![Страница Coding Plan на платформе Minimax — тарифы Standard и High-Speed](https://matveev.tech/content/images/2026/02/minimax-coding-plan-pricing.jpg)

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`:

```bash
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 вариант:

```bash
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\. Проверяем

```bash
mmax

```

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

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

```json
{
  "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 — настройка Claude Code с M2.5](https://matveev.tech/content/images/2026/02/minimax-claude-code-docs.jpg)

## Бонус: 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](https://platform.minimax.io/docs/guides/text-ai-coding-tools?ref=matveev.tech).

## Результат

`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](https://matveev.tech/claude-code-alternative-providers-2026/) — обзор всех провайдеров
- [Z.ai + Claude Code: GLM-модели за $10/мес](https://matveev.tech/zai-claude-code-setup/) — альтернативный провайдер
- [Переменные окружения Claude Code](https://matveev.tech/claude-code-environment-variables/) — справочник