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

# 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

# Interactive menu (recommended)
mhelper

# First-time setup wizard
mhelper init

# Check configuration status
mhelper doctor

Interactive Menu

? 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

Auto-Configuration (writes config files)

| 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 | ✅ |

Manual Configuration (shows instructions)

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

MCP Server Configuration

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:

lang: en_US          # en_US, es_ES, zh_CN
region: global       # global or china
api_key: <your-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

Configure Claude Code with MiniMax M2.1

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

Result in ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>",
    "ANTHROPIC_MODEL": "MiniMax-M2.1"
  }
}

Configure MCP for multiple agents

mhelper
# Select: Configure MCP server → (select agents)

Result adds MiniMax MCP server with web_search and understand_image tools.

Check what's configured

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

For MCP tools

# Install uvx (required for MCP server)
curl -LsSf https://astral.sh/uv/install.sh | sh

Get API Key

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
📧 [email protected]

License

MIT