让 Claude Code 跑 MiMo-v2.5-pro
踩坑全记录 / Troubleshooting Guide

2026-05-28 · 乾茂 · 一次真实的故障排查实战

📋 背景 / Background

🏗️ 最终架构 / Final Architecture

🕳️ 踩坑记录 / Pitfalls

坑 #1：代理做了多余的格式转换

✅ 解决方案 / Solution:

改用 MiMo 的原生 Anthropic 端点，代理只做模型名替换：

# Before: 格式转换（丢失 tools）
openai_body = convert_anthropic_to_openai(body)
resp = await client.post(DEEPSEEK_URL, json=openai_body, ...)

# After: 原样转发（保留 tools）
body["model"] = "mimo-v2.5-pro"
resp = await client.post(MIMO_ANTHROPIC_URL, json=body, ...)

坑 #2：CC 不认自定义模型名

✅ 解决方案 / Solution:

不要在 CC 端指定模型名。让 CC 显示默认的 "Opus 4.7"，由代理在转发时替换模型名。CC 不知道实际跑的是 MiMo。

# PowerShell PROFILE — 不加 --model flag
function claude {
    $env:ANTHROPIC_API_KEY = ***"MIMO_DIDI_KEY", "User")
    $env:ANTHROPIC_BASE_URL = "http://localhost:8899"
    Set-Location D:\CherryAI_Workspace
    claude.exe   # 不加 --model
}

坑 #3：MiMo 降价重置导致 Key 失效

坑 #4：代理进程卡死不报错

✅ 解决方案 / Solution:

# 检查代理是否真能响应 / Check if proxy actually responds
$resp = Invoke-RestMethod -Uri "http://localhost:8899/v1/messages" `
  -Method POST -Headers @{"x-api-key"=$key; "anthropic-version"="2023-06-01"} `
  -Body $body -TimeoutSec 15

# 如果超时，重启代理 / If timeout, restart proxy
Stop-Process -Name python -Force
Start-Process python -ArgumentList "-u","D:\CherryAI_Workspace\proxy\anthropic_deepseek_proxy.py"

⚙️ 完整配置步骤 / Full Setup Guide

Step 1：环境变量 / Environment Variables

# 设置 MiMo API Key（系统级，永久生效）
[Environment]::SetEnvironmentVariable("MIMO_DIDI_KEY", "你的key", "User")
[Environment]::SetEnvironmentVariable("MIMO_BASE_URL", "https://token-plan-cn.xiaomimimo.com", "User")

Step 2：代理脚本 / Proxy Script

核心逻辑只有 10 行：

# anthropic_deepseek_proxy.py 核心 / Core logic
MIMO_ANTHROPIC_URL = "https://token-plan-cn.xiaomimimo.com/anthropic/v1/messages"
MODEL = "mimo-v2.5-pro"

@app.post("/v1/messages")
async def messages_endpoint(request: Request):
    body = await request.json()
    body["model"] = MODEL  # 只替换模型名 / Only replace model name
    resp = await client.post(MIMO_ANTHROPIC_URL, json=body, headers={...})
    return JSONResponse(resp.json())

Step 3：PowerShell PROFILE

# $PROFILE 内容 / Content of $PROFILE
$env:ANTHROPIC_API_KEY = ***"MIMO_DIDI_KEY", "User")
$env:ANTHROPIC_BASE_URL = "http://localhost:8899"

function claude {
    $env:ANTHROPIC_API_KEY = ***"MIMO_DIDI_KEY", "User")
    $env:ANTHROPIC_BASE_URL = "http://localhost:8899"
    claude.exe
}

Step 4：开机自启 / Auto-start on Boot

# 创建 VBS 脚本放到启动文件夹
# Create VBS script in Startup folder
Set objShell = CreateObject("WScript.Shell")
objShell.Run "python -u D:\CherryAI_Workspace\proxy\anthropic_deepseek_proxy.py", 0, False

✅ 验证清单 / Verification Checklist

🔍 故障排查速查表 / Quick Troubleshooting

💰 成本对比 / Cost Comparison

MiMo 降价后价格和 DeepSeek 持平，但有小米硬件生态加持。配合本方案，CC 可以用 MiMo 的价格享受 Claude 级别的工具调用能力。

📝 总结 / Summary