在 Claude Code 中快速接入 MiniMax 大模型

工作原理

CC Switch 的本质是替你去修改配置文件，只是把它做成了可视化界面。它把配置保存在 ~/.cc-switch/ 目录下，当你点击'切换'时，它会读取你保存的配置并自动写入到各工具的配置文件中（如 Claude Code 的 ~/.claude/settings.json），下次启动工具时自动生效。

IDEA 插件之所以也能用，是因为它读取同一份配置文件，所以在 CC Switch 里配置好 MiniMax，插件那边自动就能用，根本不需要重复配置。

快速上手

安装 CC Switch

添加 MiniMax 配置

打开 CC Switch，点击右上角「+」添加供应商，搜索或选择 MiniMax（v3.8.0 已加入官方预设），填入你的 API Key。

选择与启用模型

将模型名称全部改为 MiniMax-M2.7，回到首页点击'启用'，激活即可。

跳过验证登录

编辑或新增 .claude.json 文件，MacOS & Linux 为 ~/.claude.json，Windows 为用户目录 /.claude.json，新增 hasCompletedOnboarding 参数：

{"hasCompletedOnboarding":true}

验证生效

打开终端，运行 claude，随便问一个问题能回答就说明配置成功了。之后在 IDEA 里用 CC GUI 插件，或者用 Claude Code 插件，也会自动走这个配置。

常见问题

为什么 IDEA 插件读不到配置？

原因通常是 IDEA 自身在启动时缓存了当时的环境变量，Terminal 作为子进程只能继承这份过时的缓存。所以在配置完 cc-switch 或者 Claude MiniMax 模型的配置后，需要退出 Claude 窗口，重新启动 Claude，退出 IDEA，重新加载 AI 相关配置（比如 MCP）。

3. 在 Claude Code 中使用 MiniMax-M2.7 进行 AI 编程

配置完 cc-switch 之后，直接在终端进入项目目录，使用 claude 启动就行：

cd /path/to/your/project
claude

4. 配置 MCP

如果不配置 MCP，模型只会读取训练好的数据，对于网上的最新信息可能无法及时获取。开启 MCP 可以增强联网搜索和图像理解能力。

安装 uvx

macOS / Linux:

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

Windows:

powershell -ExecutionPolicy ByPass -c"irm https://astral.sh/uv/install.ps1 | iex"

验证安装

macOS / Linux:

which uvx

Windows:

(Get-Command uvx).source

MCP 配置文件位置

在终端运行以下命令，将 api_key 替换为您的实际密钥：

claude mcp add-s user MiniMax --envMINIMAX_API_KEY=api_key --envMINIMAX_API_HOST=https://api.minimaxi.com -- uvx minimax-coding-plan-mcp -y

查看配置是否正确，正确的 MCP 配置在 ~/.claude.json 里，格式类似：

{"mcpServers":{"your-server-name":{"command":"node","args":["/path/to/mcp-server.js"],"env":{"API_KEY":"your-key"}}}}

重启生效

MCP 服务器是在 Claude 启动时加载的，不支持热重载。即使修改了配置文件，也必须完全退出 Claude 进程（不是只关闭窗口）。如果使用了 IDEA，也需要重启 IDEA。

如果你是在 IDEA Terminal 里运行的：

ps aux | grep claude
kill -9 [PID]

如果你是在系统终端里运行的：

按 Ctrl+C 终止当前会话，最好清一下缓存：

rm -rf ~/.claude/sessions/*

然后重新启动：

claude

验证 MCP

进入 Claude Code 后输入 /mcp，能看到 web_search 和 understand_image，说明配置成功。

5. IDEA 集成

安装对应插件后，如果是 Claude Code 插件，由于 cc-switch 配置了全局设置，IDEA 重启后即可直接使用，无需额外配置。

如果使用 CC GUI 插件，可能需要输入模型名称和对应的 API Key（如果没有对应的 MiniMax AI Provider 选项）。