================================================================================
            Claude Code 接入小米 MiMo 大模型 — 问题总结与解决方案
================================================================================

一、背景

--------

CC Switch接入小米MIMO大模型时报错404，粘贴后一键解决方法。
Claude Code 是 Anthropic 官方 CLI 工具，默认使用 Claude 模型。但通过修改
环境变量，可以将其后端切换到其他支持 Anthropic 兼容协议的模型，比如小米 MiMo。

小米 MiMo（MiMo-V2.5 系列）于 2026 年 4 月发布，提供 Anthropic 兼容接口，
可直接接入 Claude Code 使用。

二、常见报错：404 Not Found

----------------------------
现象：Claude Code 启动后请求返回 404，接口不存在。

原因分析：

  1. Base URL 拼写错误（最常见）

     - 误写：https://token-plan-cn.xiaomimimo.com/anthropic/v1/messages
     - 正确：https://token-plan-cn.xiaomimimo.com/anthropic
     - Claude Code 会自动拼接 /v1/messages，手动加会导致路径重复 → 404

  2. 模型名称大小写问题

     - 小米官方页面显示 MiMo-V2.5-Pro（大写）
     - API 调用必须用全小写：mimo-v2.5-pro
     - 大写会报错

  3. Key 类型与 URL 不匹配

     - Token Plan Key（tp- 开头）→ 用 Token Plan 地址
     - 按量付费 Key（sk- 开头）→ 用按量付费地址
     - 两者不能混用

  4. 协议选择错误

     - Claude Code 必须用 Anthropic 兼容接口（/anthropic）
     - 不能用 OpenAI 兼容接口（/v1）

三、解决方案

------------

步骤 1：编辑配置文件

  文件路径：C:\Users\张亮亮\.claude\settings.json

步骤 2：替换 env 配置为以下内容（直接粘贴，一键配置）：

  "env": {
    "ANTHROPIC_BASE_URL": "https://token-plan-cn.xiaomimimo.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的小米API Key（tp-开头）",
    "ANTHROPIC_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5-pro",
    "CLAUDE_CODE_SIMPLE": "1",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }

步骤 3：退出当前 Claude Code 会话，重新开终端启动 claude

四、额外避坑指南

-----------------
  - 不要用 /effort 命令，会触发 reasoning_content 问题导致 400 报错
  - 不要用 claude -c 恢复旧会话，每次新开干净会话
  - 如果 400 报错 messages[1].role = system，说明 Claude Code 版本太新
    可尝试回退：npm install -g @anthropic-ai/claude-code@<旧版本>
  - 确保环境变量中没有残留的旧 Anthropic 官方变量

五、小米 API 相关信息

----------------------
  注册地址：https://platform.xiaomimimo.com/
  Token Plan（中国）：https://token-plan-cn.xiaomimimo.com/anthropic
  Token Plan（新加坡）：https://token-plan-sgp.xiaomimimo.com/anthropic
  按量付费：https://api.xiaomimimo.com/anthropic

  可用模型：
    - mimo-v2.5-pro    最强旗舰，1.1M 上下文，MoE 架构
    - mimo-v2.5        高性价比，原生多模态 Agent
    - mimo-v2-flash    轻量快速版，性价比最高
    - mimo-v2-pro      Agent 旗舰基座

  定价参考（2026）：
    - MiMo-V2-Flash   输入 $0.10/M  输出 $0.30/M
    - MiMo-V2.5       输入 $0.14/M  输出 $0.28/M
    - MiMo-V2.5-Pro   输入 $0.65/M  输出 $0.65/M

六、其他接入工具（备用）

------------------------
  - CC-Switch：GUI 一键切换多个模型，支持 Claude Code/Cursor/Cline
    https://github.com/farion1231/cc-switch
  - coding-proxy：Python 透明代理，支持故障转移
    安装：uv add coding-proxy
  - cc2go：Python 轻量代理，自带 Web 管理界面
    安装：pip install cc2go
  - claude-proxy：Node.js 代理，支持小米/DeepSeek/Qwen 等
    安装：npx @sunflower0305/claude-proxy

================================================================================
  整理时间：2026-06-08
  参考来源：LINUX DO、CSDN、什么值得买、80aj.com 等社区讨论
================================================================================