MiniMax M2.1 Coding Helper

A CLI tool to configure MiniMax M2.1 model in AI coding tools. Similar to @z_ai/coding-helper but for MiniMax.

``
┌─────────────────────────────────────────────────────────────┐
│ MiniMax M2.1 Coding Helper │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌──────────────────────────────┐ │
│ │ mhelper │─────▶│ Configure Coding Tools │ │
│ └─────────────┘ │ • Claude Code, Cursor │ │
│ │ │ • Cline, Kilo Code, Roo │ │
│ │ │ • Droid, OpenCode, Crush │ │
│ │ │ • Zed, Neovim, Aider... │ │
│ │ └──────────────────────────────┘ │
│ │ │
│ │ ┌──────────────────────────────┐ │
│ └─────────────▶│ Configure MCP Servers │ │
│ │ • web_search │ │
│ │ • understand_image │ │
│ │ For 14+ AI agents │ │
│ └──────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
`

Features

- 🔧 Auto-Configuration - Automatically writes config files for supported tools
- 🗑️ Uninstall - Remove MiniMax configuration from any tool
- 🌐 MCP Server - Configure web_search & understand_image tools for 14+ agents
- 🩺 Health Check - See what's configured at a glance
- 🌍 Multi-language - English, Español, 中文
- 📍 Multi-region - Global (api.minimax.io) and China (api.minimaxi.com)

Installation

`bash


npm

npm install -g minimax-coding-helper

pnpm

pnpm add -g minimax-coding-helper

From source

git clone https://github.com/user/minimax-coding-helper
cd minimax-coding-helper
pnpm install && pnpm build
npm link
`

Usage

`bash


Interactive menu (recommended)

mhelper

First-time setup wizard

mhelper init

Check configuration status

mhelper doctor
`

$3

`
? What would you like to do?
❯ 🔧 Configure coding tool
🌐 Configure MCP server
🗑️ Remove configuration
─────────────
🌍 Change language
📍 Change region
🔑 Change API key
🩺 Health check
─────────────
❌ Exit
`

Supported Tools

$3

| Tool | Config File | Status |
|------|-------------|--------|
| Claude Code | ~/.claude/settings.json | ✅ |
| Droid | ~/.factory/config.json | ✅ |
| OpenCode | ~/.config/opencode/opencode.json | ✅ |
| Continue | ~/.continue/config.json | ✅ |
| Crush | ~/.config/crush/crush.json | ✅ |
| Codex CLI | ~/.codex/config.toml | ✅ |
| Zed | ~/.config/zed/settings.json | ✅ |

$3

| Tool | Notes |
|------|-------|
| Cursor | GUI configuration |
| Cline | VS Code extension (M2.1 coming soon, use M2) |
| Kilo Code | VS Code extension |
| Roo Code | VS Code extension |
| TRAE | GUI configuration |
| Windsurf | GUI configuration |
| Grok CLI | Environment variables (not recommended) |
| Aider | Environment variables |
| Neovim | avante.nvim / codecompanion.nvim |

$3

Configure MiniMax MCP tools (web_search, understand_image) for multiple agents:

| Agent | Config File | Format |
|-------|-------------|--------|
| Claude Code | ~/.claude.json | mcpServers |
| Cursor | ~/.cursor/mcp.json | mcpServers |
| Kiro | ~/.kiro/settings/mcp.json | mcpServers |
| Amazon Q | ~/.aws/amazonq/mcp.json | mcpServers |
| Droid | ~/.factory/mcp.json | mcpServers |
| Grok | ~/.grok/mcp.json | mcpServers |
| Copilot CLI | ~/.copilot/mcp-config.json | mcpServers |
| Kilocode | ~/.kilocode/mcp.json | mcpServers |
| Gemini | ~/.gemini/antigravity/mcp_config.json | mcpServers |
| Warp | ~/.config/warp/mcp.json | mcpServers |
| Claude Desktop | ~/.config/Claude/claude_desktop_config.json | mcpServers |
| Zed | ~/.config/zed/settings.json | context_servers |
| VS Code | ~/.config/Code/User/settings.json | chat.mcp.servers |
| Crush | ~/.config/crush/crush.json | mcp (type: stdio) |

Configuration

Config stored at ~/.minimax-helper/config.yaml:

`yaml
lang: en_US # en_US, es_ES, zh_CN
region: global # global or china
api_key:
`

API Endpoints

| Region | Anthropic API | OpenAI API |
|--------|---------------|------------|
| Global | https://api.minimax.io/anthropic | https://api.minimax.io/v1 |
| China | https://api.minimaxi.com/anthropic | https://api.minimaxi.com/v1 |

Examples

$3

`bash
mhelper


Select: Configure coding tool → Claude Code → Install/Configure


`

Result in ~/.claude/settings.json:
`json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
"ANTHROPIC_AUTH_TOKEN": "",
"ANTHROPIC_MODEL": "MiniMax-M2.1"
}
}
`

$3

`bash
mhelper


Select: Configure MCP server → (select agents)


`

Result adds MiniMax MCP server with web_search and understand_image tools.

$3

`bash
mhelper doctor
`

Output:
`
🩺 Checking configuration...

✓ API Key: Configured
✓ Region: global
✓ Language: en_US

📊 Configured tools:

✓ Claude Code
✓ Droid
✓ MCP (Claude Code)
✓ MCP (Cursor)

Base URL (Anthropic): https://api.minimax.io/anthropic
Base URL (OpenAI): https://api.minimax.io/v1
`

Prerequisites

$3

`bash


Install uvx (required for MCP server)


curl -LsSf https://astral.sh/uv/install.sh | sh
`

$3

1. Visit MiniMax Platform
2. Subscribe to Coding Plan (optional, for better rates)
3. Create API key
4. Run mhelper init`

Documentation

- MiniMax M2.1 for AI Coding Tools
- MiniMax MCP Guide
- MiniMax Tool Use & Interleaved Thinking

Author

Alfonso de la Guarda
📧 alfonso@gmail.com

License

MIT