从零开始手把手教你Claude快速接入MiniMax AI大模型教程

文章目录

• 1 前言
• 2 Claude环境准备
• • 2.1 安装 Claude
  • 2.2 常用命令
• 3 安装cc-switch
• • 3.1 CC Switch 是什么？
  • 3.2 核心功能
  • 3.3 工作原理
  • 3.4 CC Switch vs 其他工具
  • 3.5 快速上手CC Switch
  • • 3.5.1 安装 CC Switch
    • 3.5.2 添加 MiniMax 配置
    • 3.5.3 选择要使用的模型
    • 3.5.4 启用模型
    • 3.5.5 跳过Claude验证login
  • 3.6 验证生效
  • 3.7 常见问题
• 4 在 Claude Code 中使用 MiniMax-M2.7 模型进行 AI 编程
• 5 配置MCP
• • 5.1 安装uvx
  • 5.3 验证安装
  • 5.4 MCP 配置文件位置
  • 5.5 必须完全重启 Claude 才能生效
  • • 5.5.1 如果你是在 IDEA Terminal 里运行的 Claude Code
    • 5.5.2 如果你是在系统终端（Terminal/iTerm2）里运行的
  • 5.6 验证MCP
• 6 Idea使用AI大模型

1 前言

最近AI的发展势头确实猛，连下班地铁上都能听到陌生人在聊AI Agent。以前是问一句AI，然后等人去执行；现在Agent成熟了，能自己搜方案、自己动手。借着这股热潮，这里整理了一份在Claude里快速接入MiniMax模型的实践指南，希望能帮到有需要的朋友。

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 配置。简单说，你不需要记住 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-switch，后续就简单了。直接在终端里用 claude 启动，然后就可以愉快地玩耍了。打开终端，进入项目目录：

cd /path/to/your/project
claude

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

5 配置MCP

如果不配置 MCP，Claude 只会读取训练好的模型数据，网上的最新信息不一定能及时获取到。所以这一步不能跳过。

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

比如 macOS 系统：

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 命令。

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 的话）。