MiniMax M2.7 升级指南：少走弯路，就是最大的生产力
之前用 M2.5，联网搜索秒出结果，图像识别也很丝滑。升级到 M2.7 之后——搜索直接崩了。要么"我没有实时数据访问能力"，要么卡一分多钟全是 Error。
第一反应：API Key 坏了？还是被限流了？翻了几个小时文档、调试、怀疑人生……最后发现原因简单到可笑：只改了模型名，没配 MCP。
M2.5 到 M2.7：为什么搜索突然废了？
M2.5 是老架构，内置了简易 search 能力，不依赖外部工具。改个模型名就能跑。
M2.7 是全新 Agent 模式，把搜索升级成了 MCP 工具链。
你没配 MCP，Claude Code 就认为"你没有搜索能力"，直接拒绝。再加上 Anthropic 的 WebFetch 安全机制在拦主流网站，所以一堆失败 fallback。
官方把这两件事藏在不同文档里，升级页面只告诉你改模型名，MCP 配置在另一个页面。坑了 99% 的人。
第一步：正确升级到 MiniMax M2.7
打开配置文件：
open -e ~/.claude/settings.json把内容改成这样（API Key 不变！）：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimax.io/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的完整 Key 在这里",
"ANTHROPIC_MODEL": "MiniMax-M2.7",
"ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7",
"API_TIMEOUT_MS": "3000000"
}
}保存后重启，输入 /model 确认显示 MiniMax M2.7 就 OK 了。
第二步：恢复搜索 + 图像识别（MCP 配置，必须做！）
这是最关键的一步，官方要求必须加。
先安装 uv（只需做一次）：
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.local/bin/env
然后在普通 Terminal 里执行官方 MCP 一键命令：
claude mcp add -s user MiniMax \
--env MINIMAX_API_KEY=sk-你的完整 Key 在这里 \
--env MINIMAX_API_HOST=https://api.minimax.io \
-- uvx minimax-coding-plan-mcp -y
重启 Claude Code，输入：
/mcp看到 MiniMax ✅ connected + web_search 和 understand_image 两个工具 → 恭喜！搜索和图像识别彻底恢复了。
第三步：测试验证
直接问：上海明天天气怎么样？
或者发一张图片让它分析。现在应该秒出结果，不再拒绝。
老司机 Tips
搜索还是慢？
Claude Code 的安全机制在作怪，加一句"请用搜索工具查询"可以加速触发。
API Key 格式错误？
确保复制的是完整 Key，不要漏掉前后缀。
小结
MiniMax M2.7 升级的关键步骤：
- 修改配置文件：更新模型名为 MiniMax-M2.7
- 安装 uv：MCP 工具链依赖
- 配置 MCP：执行 claude mcp add 命令
- 验证连接：/mcp 确认工具已连接
记住：M2.7 必须配 MCP，否则搜索和图像识别都用不了。官方文档藏得深，这篇帮你省掉几小时调试时间。