Claude 快速接入 MiniMax AI大模型
文章目录
1 前言
最近AI是一个大时代的进步，下班的地铁路上，都能听到路人聊天在谈论AI Agent，之前是查询AI，然后人工再去执行，现在随着AI Agent成熟，可以自己搜寻解决方案，并且自己执行，这里笔者也把 如何在 Claude 快速接入 MiniMax AI大模型，做一个总结吧！
2 Claude环境准备
2.1 安装 Claude
Windows CMD:
curl-fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd Windows PowerShell:
irm https://claude.ai/install.ps1 | iex 或者 winget install Anthropic.ClaudeCode macOS, Linux, WSL:
curl-fsSL https://claude.ai/install.sh |bash检查是否按照完成：claude --version
参考资料：https://code.claude.com/docs/en/setup
2.2 常用命令
| 命令 | 功能说明 | 示例 |
|---|---|---|
claude | 启动交互模式 | claude |
claude "task" | 执行一次性任务 | claude "fix the build error" |
claude -p "query" | 执行单次查询后退出 | claude -p "explain this function" |
claude -c | 继续当前目录下最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude commit | 创建 Git 提交 | claude commit |
claude --version | 查看当前版本 | claude --version |
/clear | 清除对话历史 | /clear |
/help | 显示可用命令 | /help |
exit 或 Ctrl+C | 退出 Claude Code | exit |
3 安装cc-switch
3.1 CC Switch 是什么？
cc-switch 是一个开源的跨平台桌面工具，专门用来统一管理 AI 编程工具的 API 配置。
CC Switch = AI 编程工具的“遥控器”
你不需要记住 API Key 在哪、配置文件在哪个目录，也不用每次换模型都去手动改 JSON 文件。打开 CC Switch 点一下，所有配置自动生效。
3.2 核心功能
| 功能 | 说明 |
|---|---|
| 供应商管理 | 一键添加/切换 API 供应商（支持 MiniMax、智谱、DeepSeek 等 50+ 内置预设） |
| 模型切换 | 不同场景用不同模型，点一下就能换 |
| MCP 管理 | 统一管理 MCP 服务器配置，一次配置所有 CLI 工具共用 |
| Skills 管理 | 从 GitHub 一键安装 Claude Skills |
| 系统托盘 | 常驻右下角，右键菜单秒切，不用打开主窗口 |
| 多工具支持 | 同时管理 Claude Code、Codex CLI、Gemini CLI、OpenClaw 等 5 种 AI 工具 |
3.3 工作原理
CC Switch 的本质是替你去修改配置文件，只是把它做成了可视化界面。
它把配置保存在 ~/.cc-switch/ 目录下，当你点击“切换”时，它会：
- 读取你保存的配置（API Key、Base URL、模型等）
- 自动写入到各工具的配置文件中（如 Claude Code 的
~/.claude/settings.json） - 下次启动工具时自动生效
为什么 IDEA 插件也能用？
因为 IDEA 里的 CC GUI 插件会读取同一份配置文件（~/.claude/settings.json）。所以你在 CC Switch 里配置好 MiniMax，插件那边自动就能用，根本不需要重复配置。
3.4 CC Switch vs 其他工具
| 对比项 | CC Switch | Claude Code Router |
|---|---|---|
| 定位 | 配置管理器 | 流量路由器 |
| 作用 | 存储/切换 API Key 和模型 | 在多个 API 之间做负载均衡 |
| 使用场景 | 换账号、换供应商 | 高并发、多 Key 轮询 |
简单说：Router = 代理/分流，Switch = 配置管理。如果你只是个人开发、偶尔切换模型，CC Switch 完全够用。
3.5 快速上手CC Switch
3.5.1 安装 CC Switch
| 平台 | 安装方式 |
|---|---|
| Windows | 前往 cc-switch GitHub Releases 页面下载最新版本的安装包 |
| macOS | brew tap farion1231/ccswitch && brew install --cask cc-switch && brew upgrade --cask cc-switch |
| Linux | 下载 .deb 或 .AppImage 文件 |
安装好之后，是这样的：
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 |shWindows
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 --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"}}}}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）：
![阿里开源纯前端浏览器自动化 PageAgent，[特殊字符] 浏览器自动化变天啦？](https://qiniu.meowparty.cn/coder.2023/2026-04-07/cover_1775566121115_b08ba8f346734407aabd5f4afc2df6b8.png)
