从 0 到 1：Claude 对接 MiniMax AI 大模型的实操教程（附代码示例）

1 前言

最近AI是一个大时代的进步，下班的地铁路上，都能听到路人聊天在谈论AI Agent，之前是查询AI，然后人工再去执行，现在随着AI Agent成熟，可以自己搜寻解决方案，并且自己执行，这里笔者也把 如何在 Claude 快速接入 MiniMax AI大模型，做一个总结吧！

2 Claude环境准备

2.1 安装 Claude

• macOS, Linux, WSL:

  curl -fsSL https://claude.ai/install.sh | bash

• Windows PowerShell:

  irm https://claude.ai/install.ps1 | iex 或者 winget install Anthropic.ClaudeCode

• Windows CMD:

  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

检查是否按照完成：

claude --version

参考资料：https://code.claude.com/docs/en/setup

2.2 常用命令

3 安装cc-switch

3.1 CC Switch 是什么？

cc-switch 是一个开源的跨平台桌面工具，专门用来统一管理 AI 编程工具的 API 配置。

CC Switch = AI 编程工具的“遥控器”

你不需要记住 API Key 在哪、配置文件在哪个目录，也不用每次换模型都去手动改 JSON 文件。打开 CC Switch 点一下，所有配置自动生效。

3.2 核心功能

3.3 工作原理

CC Switch 的本质是替你去修改配置文件，只是把它做成了可视化界面。

它把配置保存在 ~/.cc-switch/ 目录下，当你点击“切换”时，它会：

1. 读取你保存的配置（API Key、Base URL、模型等）

2. 自动写入到各工具的配置文件中（如 Claude Code 的 ~/.claude/settings.json）

3. 下次启动工具时自动生效

为什么 IDEA 插件也能用？

因为 IDEA 里的 CC GUI 插件会读取同一份配置文件（~/.claude/settings.json）。所以你在 CC Switch 里配置好 MiniMax，插件那边自动就能用，根本不需要重复配置。

3.4 CC Switch vs 其他工具

简单说：Router = 代理/分流，Switch = 配置管理。如果你只是个人开发、偶尔切换模型，CC Switch 完全够用。

3.5 快速上手CC Switch

3.5.1 安装 CC Switch

安装好之后，是这样的：

3.5.2 添加 MiniMax 配置

打开 CC Switch，点击右上角 「+」 添加供应商，搜索或选择 MiniMax（v3.8.0 已加入官方预设），填入你的 API Key（通过这个链接的接口秘钥获取：https://platform.minimaxi.com/user-center/payment/token-plan）

3.5.3 选择要使用的模型

将模型名称全部改为 MiniMax-M2.7

3.5.4 启用模型

回到首页，点击 “启用”，点击 「Enable」 激活

3.5.5 跳过Claude验证login

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

新增 hasCompletedOnboarding 参数

{
  "hasCompletedOnboarding": true
}

3.6 验证生效

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

3.7 常见问题

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

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

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

在上一步，配置完cc-swich之后，这里就比较简单了，直接在终端，使用 claude启动就行，然后就可以愉快的玩耍了。

Open your terminal in any project directory and start Claude Code:

cd /path/to/your/project
claude

参考资料：https://platform.minimaxi.com/docs/token-plan/claude-code

5 配置MCP

因为你不配置MCP，它只会读取训练好的模型数据，如果网上的最新信息，他不一定及时获取到。

5.1 安装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"

其他安装方式可参考 uv 仓库：https://github.com/astral-sh/uv

5.3 验证安装

macOS / Linux

which uvx

Windows

(Get-Command uvx).source

比如mac系统：

5.4 MCP 配置文件位置

在 Claude Code 中使用MCP，在终端运行以下命令，将api_key替换为您的 API Key：

claude mcp add -s user MiniMax --env MINIMAX_API_KEY=api_key --env MINIMAX_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"
      }
    }
  }
}

5.5 必须完全重启 Claude 才能生效

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

5.5.1 如果你是在 IDEA Terminal 里运行的 Claude Code

#找到正在运行的 Claude 进程

ps aux | grep claude

#强制结束进程（用上面查到的 PID）

kill -9 [PID]

5.5.2 如果你是在系统终端（Terminal/iTerm2）里运行的

按 Ctrl+C 终止当前 Claude 会话

如果配置有更新，最好清一下缓存（可选）

rm -rf ~/.claude/sessions/*

重新启动 Claude

claude

或者更简单，直接按 Ctrl+C 终止当前运行的 Claude

然后重新运行 claude 命令

5.6 验证MCP

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

使用MCP：

6 Idea使用AI大模型

安装插件：

如果是Claude Code 这个插件，就比较简单了，cc-switch配置后，Idea重启后，配置可以拿到，不用做任何配置，直接用就可以

如果使用的CC GUI这个插件，需要做一下配置，输入模型名称和对应的Api Key（如果没有对应的 MiniMax AI Provider）：

总结

通过本文的实操教程，我们完成了从“环境准备”到“功能验证”的Claude与MiniMax AI大模型全流程对接：核心在于先明确两者的对接逻辑(通过API接口实现数据交互)，再按“密钥获取→依赖安装→代码编写→调试测试”的步骤逐步推进，其中“参数格式匹配”(如请求体结构、返回值解析)和“权限校验”(API密钥正确配置)是确保对接成功的关键，文中提供的代码示例也已标注关键注释，方便开发者根据自身需求调整。

值得注意的是，对接完成后，开发者可进一步探索“Claude触发MiniMax特定功能”(如文本生成、数据分析)的场景，例如在个人助手项目中，让Claude负责需求理解，MiniMax负责高效响应，从而从而发挥多模型协同的优势。后续若遇到接口更新、功能异常等问题，也可基于本文的实操逻辑，结合官方文档快速排查，真正将大模型对接能力转化为实际项目的价值。