Running MiniMax M2.5 Locally with Claude Code

TL;DR: Once you have MiniMax M2.5 running locally (see previous post), here's how to connect Claude Code to it.

If you've got MiniMax M2.5 running via the setup guide, connecting Claude Code is straightforward.

Basic Configuration

Edit your ~/.claude.settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<your-server>:8080",
    "ANTHROPIC_AUTH_TOKEN": "any-placeholder-value",
    "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_SUBAGENT_MODEL": "MiniMax-M2.5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Replace <your-server> with your inference server's address.

With Agent Teams and Hooks

If you use agent teams, skills, or hooks:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "ANTHROPIC_BASE_URL": "http://<your-server>:8080",
    "ANTHROPIC_AUTH_TOKEN": "local",
    "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_SUBAGENT_MODEL": "MiniMax-M2.5",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$HOME/.claude/hooks/skill-activation-prompt.sh"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$HOME/.claude/hooks/skill-verification-guard.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|MultiEdit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "$HOME/.claude/hooks/post-tool-use-tracker.sh"
          }
        ]
      }
    ]
  },
  "skipDangerousModePermissionPrompt": true
}

Next Steps

1. Start Claude Code with your configuration
2. If prompted, log out and log back in to clear any warnings
3. You're running entirely on local hardware

This gives you a local, private inference endpoint that works with Claude Code - useful for analyzing sensitive codebases without cloud dependencies.

Resources

• MiniMax M2.5 Setup for DGX Spark (GitHub)
• Claude Code Documentation