如何在 Claude 环境中快速接入 MiniMax AI 大模型。主要步骤包括：安装并配置 Claude 基础环境；使用 CC Switch 工具统一管理和切换 API 供应商及模型配置，特别是添加 MiniMax 并启用 M2.7 模型；配置 MCP 以增强模型能力，如网络搜索和图片理解；最后验证配置在终端和 IDEA 中的有效性。整个过程涉及命令行操作、配置文件修改及必要的环境变量设置。
本文总结如何在 Claude 快速接入 MiniMax AI 大模型。
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
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
检查是否安装完成：claude --version
| 命令 | 功能说明 | 示例 |
|---|---|---|
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 |
cc-switch 是一个开源的跨平台桌面工具，专门用来统一管理 AI 编程工具的 API 配置。
CC Switch = AI 编程工具的'遥控器'
你不需要记住 API Key 在哪、配置文件在哪个目录，也不用每次换模型都去手动改 JSON 文件。打开 CC Switch 点一下，所有配置自动生效。
| 功能 | 说明 |
|---|---|
| 供应商管理 | 一键添加/切换 API 供应商（支持 MiniMax、智谱、DeepSeek 等 50+ 内置预设） |
| 模型切换 | 不同场景用不同模型，点一下就能换 |
| MCP 管理 | 统一管理 MCP 服务器配置，一次配置所有 CLI 工具共用 |
| Skills 管理 | 从 GitHub 一键安装 Claude Skills |
| 系统托盘 | 常驻右下角，右键菜单秒切，不用打开主窗口 |
| 多工具支持 | 同时管理 Claude Code、Codex CLI、Gemini CLI、OpenClaw 等 5 种 AI 工具 |
CC Switch 的本质是替你去修改配置文件，只是把它做成了可视化界面。
它把配置保存在 ~/.cc-switch/ 目录下，当你点击'切换'时，它会：
~/.claude/settings.json）为什么 IDEA 插件也能用？
因为 IDEA 里的 CC GUI 插件会读取同一份配置文件（~/.claude/settings.json）。所以你在 CC Switch 里配置好 MiniMax，插件那边自动就能用，根本不需要重复配置。
| 对比项 | CC Switch | Claude Code Router |
|---|---|---|
| 定位 | 配置管理器 | 流量路由器 |
| 作用 | 存储/切换 API Key 和模型 | 在多个 API 之间做负载均衡 |
| 使用场景 | 换账号、换供应商 | 高并发、多 Key 轮询 |
简单说：Router = 代理/分流，Switch = 配置管理。如果你只是个人开发、偶尔切换模型，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 文件 |
打开 CC Switch，点击右上角「+」添加供应商，搜索或选择 MiniMax（v3.8.0 已加入官方预设），填入你的 API Key。
将模型名称全部改为 MiniMax-M2.7。
回到首页，点击'启用'，点击 Enable 激活。
编辑或新增 .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）。
在上一步，配置完 cc-switch 之后，这里就比较简单了，直接在终端，使用 claude 启动就行。 Open your terminal in any project directory and start Claude Code:
cd /path/to/your/project
claude
因为你不配置 MCP，它只会读取训练好的模型数据，如果网上的最新信息，他不一定及时获取到。
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
在 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"}}}}
MCP 服务器是在 Claude 启动时加载的，热重载不支持。即使你修改了配置文件，也必须完全退出 Claude 进程（不是只是关闭窗口），注意，修改配置后需要重启 Idea（如果你有用这个）。
找到正在运行的 Claude 进程
ps aux | grep claude
强制结束进程（用上面查到的 PID）
kill -9 [PID]
按 Ctrl+C 终止当前 Claude 会话 如果配置有更新，最好清一下缓存（可选）
rm -rf ~/.claude/sessions/*
重新启动 Claude
claude
或者更简单，直接按 Ctrl+C 终止当前运行的 Claude 然后重新运行 claude 命令。
进入 Claude Code 后输入 /mcp，能看到 web_search 和 understand_image，说明配置成功。 使用 MCP：
安装插件： 如果是 Claude Code 这个插件，就比较简单了，cc-switch 配置后，Idea 重启后，配置可以拿到，不用做任何配置，直接用就可以。 如果使用的 CC GUI 这个插件，需要做一下配置，输入模型名称和对应的 Api Key（如果没有对应的 MiniMax AI Provider）：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online