跳到主要内容
Claude 接入 MiniMax AI 大模型配置教程 | 极客日志
Shell / Bash Node.js AI
Claude 接入 MiniMax AI 大模型配置教程 介绍如何在 Claude Code 环境中接入 MiniMax AI 大模型。主要步骤包括安装 Claude 环境、使用 CC Switch 工具管理 API 配置、添加 MiniMax 模型并启用、配置 MCP 服务器以支持联网搜索等功能，最后验证在终端和 IDE 中的使用情况。
霸天 发布于 2026/4/6 更新于 2026/5/22 1 前言
随着 AI Agent 成熟，本文总结如何在 Claude 快速接入 MiniMax AI 大模型。
2 Claude 环境准备
2.1 安装 Claude
Windows CMD:
curl-fsSL https:
Windows PowerShell:
irm https:
macOS, Linux, WSL:
curl-fsSL https:
检查是否安装完成：
claude --version
参考资料：https://code.claude.com/docs/en/setup
2.2 常用命令
命令 功能说明 示例 claude启动交互模式 claudeclaude "task"执行一次性任务 claude "fix the build error"claude -p "query"执行单次查询后退出 claude -p "explain this function"claude -c继续当前目录下最近的对话 claude -cclaude -r恢复之前的对话 claude -rclaude commit创建 Git 提交 claude commitclaude --version查看当前版本 claude --version/clear清除对话历史 /clear/help显示可用命令 /helpexit 或 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 里的 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-switchLinux 下载 .deb 或 .AppImage 文件
3.5.2 添加 MiniMax 配置 打开 CC Switch，点击右上角 「+」 添加供应商，搜索或选择 MiniMax （v3.8.0 已加入官方预设），填入你的 API Key（通过官方平台获取接口密钥）。
3.5.3 选择要使用的模型
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 自身在启动时缓存了当时的环境变量，Terminal 作为子进程只能继承这份'过时的缓存'。所以在配置完 cc-switch 或者 Claude MiniMax 模型的配置后，需要退出 Claude 窗口，重新启动 Claude，退出 Idea，重新加载 AI 相关配置（比如 MCP）。
4 在 Claude Code 中使用 MiniMax-M2.7 模型进行 AI 编程 在上一步，配置完 cc-switch 之后，这里就比较简单了，直接在终端，使用 claude 启动就行，然后就可以愉快的玩耍了。
在任意项目目录下打开终端并启动 Claude Code:
cd /path/to/your/project claude
5 配置 MCP 因为你不配置 MCP，它只会读取训练好的模型数据，如果网上的最新信息，他不一定及时获取到。
5.1 安装 uvx powershell -ExecutionPolicy ByPass -c"irm https://astral.sh/uv/install.ps1 | iex"
5.3 验证安装
5.4 MCP 配置文件位置 在 Claude Code 中使用 MCP，在终端运行以下命令，将 api_key 替换为您的 API Key：
claude mcp add - s user MiniMax
注意，查看配置是否正确，正确的 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
5.5.2 如果你是在系统终端（Terminal/iTerm2）里运行的 rm-rf ~/.claude/sessions/*
或者更简单，直接按 Ctrl+C 终止当前运行的 Claude
5.6 验证 MCP 进入 Claude Code 后输入 /mcp，能看到 web_search 和 understand_image，说明配置成功。
6 Idea 使用 AI 大模型 如果是 Claude Code 这个插件，就比较简单了，cc-switch 配置后，Idea 重启后，配置可以拿到，不用做任何配置，直接用就可以
如果使用的 CC GUI 这个插件，需要做一下配置，输入模型名称和对应的 Api Key（如果没有对应的 MiniMax AI Provider）：
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
随机西班牙地址生成器 随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
