M2 for AI Coding Tools

​

Get an API Key

​

Coding Plan API Key

Visit the Account/Coding Plan page, get your Coding Plan API Key for use in coding tools.

​

Platform API Key

1. Visit the MiniMax Developer Platform
2. Click the “Create new secret key” button and enter a project name to create a new API key.
3. After creation, the system will display the API key. Be sure to copy and save it securely. The key is shown only once and cannot be viewed again.

​

Use MiniMax-M2 in Claude Code (Recommended)

​

Install Claude Code

​

Configure MiniMax API

1. Edit or create the Claude Code configuration file located at ~/.claude/settings.json. In this file, add or update the env field as shown below. Set MINIMAX_API_KEY to the API key obtained from the MiniMax Developer Platform.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<MINIMAX_API_KEY>",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "MiniMax-M2",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2"
  }
}

2. After completing the configuration, navigate to your working directory and run the claude command in the terminal to start using Claude Code. After startup, select Trust This Folder to allow it to access the files in your folder as shown below:

3. You can now start using Claude Code for development.

​

Use M2 in Claude Code Extension for VS Code

1. Install Claude Code Extension for VS Code

2. After installation, click Settings

3. Configure the model to MiniMax-M2

• In Settings - Claude Code: Selected Model, enter MiniMax-M2

• Click Edit in settings.json, modify claude-code.selectedModel to MiniMax-M2 in the configuration file.

4. Configure the environment variables

• If Claude Code is already installed, please refer to the Claude Code Configuration to configure the environment variables.
• If Claude Code is not installed, click Edit in settings.json

• Then modify claude-code.environmentVariables to following settings.

"claudeCode.environmentVariables": [
        {
            "name": "ANTHROPIC_BASE_URL",
            "value": "https://api.minimax.io/anthropic"
        },
        {
            "name": "ANTHROPIC_AUTH_TOKEN",
            "value": "<MINIMAX_API_KEY>"
        },
        {
            "name": "API_TIMEOUT_MS",
            "value": "3000000"
        },
        {
            "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
            "value": "1"
        },
        {
            "name": "ANTHROPIC_MODEL",
            "value": "MiniMax-M2"
        },
        {
            "name": "ANTHROPIC_SMALL_FAST_MODEL",
            "value": "MiniMax-M2"
        },
        {
            "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
            "value": "MiniMax-M2"
        },
        {
            "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
            "value": "MiniMax-M2"
        },
        {
            "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
            "value": "MiniMax-M2"
        }
    ],

​

Use MiniMax-M2 in Cursor

​

Install Cursor

1. Download and install Cursor from the Cursor website.
2. Open Cursor, click the “Settings” button in the top-right corner to enter the settings page.
3. Click the “Sign in” button to log in to your Cursor account.

​

Configure MiniMax API

1. Click “Models” in the left sidebar to open the model configuration page.
2. Expand the “API Keys” section and configure the API information:
   • Enable “Override OpenAI Base URL”;
   • Enter the MiniMax base URL: https://api.minimax.io/v1
3. Paste the API key obtained from the MiniMax Developer Platform into the OpenAI API Key field.
4. Click the button on the right side of the “OpenAI API Key” field.

5. Click the “Enable OpenAI API Key” button in the pop-up window to complete verification.

6. In the Models section, click the “View All Models” button, and then click the “Add Custom Model” button.

7. Enter the model name “MiniMax-M2”, then click the “Add” button.

8. Enable the newly added “MiniMax-M2” model.
9. Select the “MiniMax-M2” model in the chat panel and start using “MiniMax-M2” for development.

​

Use MiniMax-M2 in Cline

​

Install Cline

1. Open VS Code, click the Extensions icon in the left activity bar, and search for “Cline”.
2. Click the “Install” button to add the extension. After installation, you may need to restart VS Code.

3. Once installed, the Cline icon will appear in the left activity bar.

​

Configure MiniMax API

1. Click Use your own API key to open Cline’s configuration page.
2. Under API Provider, select MiniMax.
3. In MiniMax Entrypoint, select “api.minimax.io” to set the MiniMax service endpoint.
4. In MiniMax API Key, enter the API key from the MiniMax Developer Platform.
5. Click Let’s go!, then click Done in the top-right corner to save the configuration.

6. Enable the “Edit” option box in “Auto-approve” section and start using “MiniMax-M2” for development.

​

Use MiniMax-M2 in Roo Code

​

Install Roo Code

1. Open VS Code, click the Extensions icon in the left activity bar, and search for “Roo Code”.
2. Click the “Install” button to add the extension. After installation, you may need to restart VS Code.

​

Configure MiniMax API

1. Click Settings to go to the configuration page.

2. Under API Provider, select MiniMax.
3. In MiniMax Entrypoint, select “api.minimax.io”.
4. In MiniMax API Key, enter the API key from the MiniMax Developer Platform.
5. Click Save and then Done in the top-right corner to save the configuration.

6. Start using “MiniMax-M2” for development.

​

Use MiniMax-M2 in Grok CLI

​

Install Grok CLI

1. Use npm to install the Grok CLI globally:

npm install -g @vibe-kit/grok-cli

​

Configure MiniMax API

1. Set the base URL and API key using environment variables. Use the API key obtained from the MiniMax Developer Platform as the value for MINIMAX_API_KEY.

export GROK_BASE_URL="https://api.minimax.io/v1"  
export GROK_API_KEY="<MINIMAX_API_KEY>"

2. Start the Grok CLI with a specified model: MiniMax-M2

grok --model MiniMax-M2

​

Use MiniMax-M2 in Codex CLI

​

Install codex

npm i -g @openai/codex

​

Configure MiniMax API

1. Add the following configuration to the .codex/config.toml file:

[model_providers.minimax]
name = "MiniMax Chat Completions API"
base_url = "https://api.minimax.io/v1"
env_key = "MINIMAX_API_KEY"
wire_api = "chat"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 10
stream_idle_timeout_ms = 300000

[profiles.m2]
model = "codex-MiniMax-M2"
model_provider = "minimax"

2. Set the API key using environment variables in the current terminal session for security reasons. Use the API key obtained from the MiniMax Developer Platform as the value for MINIMAX_API_KEY.

export MINIMAX_API_KEY="<MINIMAX_API_KEY>"

3. Start the Codex CLI with the specified profile.

codex --profile m2

​

Use MiniMax-M2 in Droid

​

Install Droid

curl -fsSL https://app.factory.ai/cli | sh

irm https://app.factory.ai/cli/windows | iex

​

Configure MiniMax API

1. Use following command to edit the configuration file located at ~/.factory/config.json. Set MINIMAX_API_KEY to the API key obtained from the MiniMax Developer Platform.

cat ~/.factory/config.json
{
    "custom_models": [
        {
            "model_display_name": "MiniMax-M2",
            "model": "MiniMax-M2",
            "base_url": "https://api.minimax.io/anthropic",
            "api_key": "<MINIMAX_API_KEY>",
            "provider": "anthropic",
            "max_tokens": 16384
        }
    ]
}

2. Navigate to your project and start interactive session

cd /path/to/your/project
droid

3. Enter /model, select the “MiniMax-M2” model and use it in Droid.

​

Use MiniMax-M2 in OpenCode

​

Install OpenCode

• Use curl to install the OpenCode

curl -fsSL https://opencode.ai/install | bash

• Use npm to install the OpenCode

npm i -g opencode-ai

​

Configure MiniMax API

1. Edit or create the OpenCode configuration file located at ~/.config/opencode/opencode.json. In this file, add or update the env field as shown below. Set MINIMAX_API_KEY to the API key obtained from the MiniMax Developer Platform.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "minimax": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://api.minimax.io/anthropic/v1",
        "apiKey": "<MINIMAX_API_KEY> (Optional)"
      },
      "models": {
        "MiniMax-M2": {
          "name": "MiniMax-M2"
        }
      }
    }
  }
}

opencode auth login

2. Navigate to your project and start interactive session

cd /path/to/your/project

opencode

3. Enter /models, select the “MiniMax-M2” model and use it in OpenCode

​

Troubleshooting

​

API Error

API Error: Cannot read properties of undefined (reading 'map')

1. Ensure the API host is set correctly to: https://api.minimax.io
2. Confirm that you have replaced <MINIMAX_API_KEY> with your API key from MiniMax Developer Platform..
3. If you are using Claude Code or Droid, clear the environment variable: ANTHROPIC_AUTH_TOKEN
4. If you are using Claude Code in VS Code or Cursor, please make sure to set the model to MiniMax-M2. For more details, see: Using M2 in Claude Code for VS Code
5. Reached the rate limit, please wait and try again later.

​

Recommended Reading