介绍如何在 Claude Code 环境中接入 MiniMax AI 大模型。主要步骤包括安装 Claude 环境、使用 CC Switch 工具管理 API 配置、添加 MiniMax 模型并启用、配置 MCP 服务器以支持联网搜索等功能，最后验证在终端和 IDE 中的使用情况。
随着 AI Agent 成熟，本文总结如何在 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 启动就行，然后就可以愉快的玩耍了。
在任意项目目录下打开终端并启动 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"
其他安装方式可参考 uv 仓库：https://github.com/astral-sh/uv
macOS / Linux
which uvx
Windows
(Get-Command uvx).source
例如 mac 系统：
在 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