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 升级的关键步骤：

1. 修改配置文件：更新模型名为 MiniMax-M2.7
2. 安装 uv：MCP 工具链依赖
3. 配置 MCP：执行 claude mcp add 命令
4. 验证连接：/mcp 确认工具已连接

记住：M2.7 必须配 MCP，否则搜索和图像识别都用不了。官方文档藏得深，这篇帮你省掉几小时调试时间。