Claude Code × 小米 MiMo 部署指南（Windows）

适用环境：Windows 10/11 + PowerShell 7+ 最后更新：2026-05

目录
#

前置条件
#

在开始之前，你需要准备：

小米 MiMo 账号：在 platform.xiaomimimo.com 注册
付费额度或套餐：账户余额充值，或通过官方"百万亿 Token 创造者激励计划"申请免费套餐
PowerShell 7+（推荐，Windows 自带的 5.x 也可用）
网络可正常访问 api.xiaomimimo.com

⚠️ 关于账号说明 Claude Code CLI 本身属于 Anthropic 产品，但通过配置第三方兼容 API，可以用小米 MiMo 模型替代官方模型。本文介绍的即是这种方式，不需要 Anthropic/Claude 订阅。

详细部署流程
#

第一步：安装 Node.js
#

Claude Code CLI 通过 npm 安装，需要 Node.js 18+。

打开 PowerShell，检查是否已安装：

node --version
npm --version

如果版本低于 18 或未安装，使用 winget 安装：

winget install OpenJS.NodeJS.LTS

安装完成后，完全关闭 PowerShell 并重新打开，让 PATH 生效，然后再次验证版本。

第二步：确认 Git 环境
#

Claude Code 在 Windows 上需要 Git Bash 来执行 shell 命令。

检查 Git 是否已安装：

git --version
where.exe git

如果 Git 已安装，确认 bash.exe 的位置：

Test-Path "C:\Program Files\Git\bin\bash.exe"

返回 True 可跳过安装步骤。如果返回 False，根据 where.exe git 的结果推断实际安装路径，例如 D:\Git\bin\bash.exe。

如果未安装 Git：

winget install Git.Git

⚠️ 如果 winget install Git.Git 失败（退出代码 2），通常是因为你已有 Git 但安装来源不是 winget，不影响使用，继续下一步即可。

如果 Git 不在默认路径，手动指定 bash.exe 位置：

setx CLAUDE_CODE_GIT_BASH_PATH "D:\Git\bin\bash.exe"

将路径替换为你系统的实际路径，设完重启 PowerShell。

第三步：安装 Claude Code CLI
#

npm install -g @anthropic-ai/claude-code

⚠️ 不要使用 sudo 或以管理员身份运行。如果遇到 EACCES 权限错误，参考下方解决方案。

验证安装：

claude --version

如果提示 claude 命令找不到，需要将 npm 全局目录加入 PATH：

npm config get prefix

权限问题解决方案（如遇到）：

mkdir $HOME\.npm-global
npm config set prefix "$HOME\.npm-global"
npm install -g @anthropic-ai/claude-code

第四步：获取小米 MiMo API Key
#

登录 platform.xiaomimimo.com
左侧菜单 → API-Keys → 创建新 Key
复制 Key（sk- 开头的字符串），妥善保存，只显示一次

如果你有免费套餐：

进入订阅管理 / 套餐管理页面，找到你套餐对应的：

专属 API Key（与普通 Key 不同）
专属 Base URL

⚠️ 套餐用户必须使用专属 Key 和专属 Base URL，否则调用会走账户余额，或者报 402 错误。

第五步：配置 MiMo API
#

推荐方式：写入 settings.json（配置可见，便于管理）

编辑文件 C:\Users\你的用户名\.claude\settings.json（不存在则新建）： 需要注意使用token plan和按量付费api调用的BASE_URL是不一样的，具体可以参考 Xiaomi MiMo API Open Platform

{
  "theme": "light",
  "env": {
    "ANTHROPIC_BASE_URL": "https://token-plan-cn.xiaomimimo.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MiMo API Key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2-flash"
  }
}

如果你有专属 Base URL，将 https://api.xiaomimimo.com/anthropic 替换为套餐页面显示的地址。

备选方式：设置系统环境变量

setx ANTHROPIC_BASE_URL "https://api.xiaomimimo.com/anthropic"
setx ANTHROPIC_AUTH_TOKEN "你的MiMo API Key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "mimo-v2.5-pro"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "mimo-v2.5-pro"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "mimo-v2-flash"

设完后关闭并重开 PowerShell（setx 对当前窗口不生效）。

两种方式二选一。如果都设了，环境变量优先级更高。

第六步：启动并验证
#

进入你的项目目录（不要在 C:\Windows\System32 下运行）：

cd D:\你的项目目录
claude

检查启动界面：

界面左下角应显示 mimo-v2.5-pro 而非 Opus 4.7，说明已成功切换到小米 MiMo。

关闭 Thinking 模式（必须）：

在 Claude Code 界面中按 Tab 键，切换直到显示 Thinking off。MiMo 目前不支持 Claude Code 的思维链功能，开启会导致报错。

健康检查：

/doctor

发条消息测试：

你是什么模型？

确认返回内容正常，部署完成 ✅

简化流程（速查）
#

适合已有 Node.js 和 Git 环境的快速部署。

npm install -g @anthropic-ai/claude-code

claude --version

编辑 C:\Users\你的用户名\.claude\settings.json，写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.xiaomimimo.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的MiMo API Key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2-flash"
  }
}

cd D:\你的项目
claude

常见问题
#

报错	原因	解决
`claude: command not found`	npm 全局目录不在 PATH	把 `npm config get prefix` 返回的路径加入用户 PATH
`Claude Code on Windows requires git-bash`	Git 不在默认路径	`setx CLAUDE_CODE_GIT_BASH_PATH "D:\Git\bin\bash.exe"`
`winget install Git.Git` 失败（退出码 2）	已有 Git 但来源非 winget	无需处理，Git 可正常使用
`403 Request not allowed`	API Key 错误或 OAuth 残留	检查 Key，在 Claude Code 里运行 `/logout` 再重试
`402 Insufficient account balance`	账户余额不足，或套餐用户用了错误的 Key/URL	充值账户，或在套餐页面找专属 Key 和 Base URL
`model not found`	模型名拼写错误	去平台文档确认最新模型名称
Thinking 相关报错	Thinking 模式开启	按 Tab 键切换到 `Thinking off`
配置写了但未生效	用了 `setx` 但没重开 PowerShell	完全关闭并重新打开 PowerShell

注意事项
#

API Key 安全

不要将 Key 提交到 Git 仓库
不要在公开场合（截图、对话、论坛）粘贴完整 Key
如果 Key 意外泄露，立即去平台撤销并重建
settings.json 里有明文 Key，不要把这个文件提交到公开仓库

套餐用户注意

使用免费套餐或付费套餐时，必须使用套餐页面提供的专属 Base URL 和专属 Key，否则会：

报 402（账户余额不足）
消耗普通账户余额而非套餐额度

模型能力限制

MiMo 接入 Claude Code 时有一些功能不完整：

不支持 Thinking（扩展思维链）模式，启动后必须关闭
Tool use（工具调用）行为可能和原生 Claude 有差异
复杂多步骤 Agent 任务效果因模型而异，遇到问题多重试

工作目录

始终在你的项目目录下启动 claude，不要在 C:\Windows\System32 等系统目录下运行，否则 Claude 无法正确理解你的项目上下文。

配置优先级

环境变量（setx）优先级高于 settings.json。建议二选一，避免混用导致配置不清晰。推荐统一用 settings.json，清掉环境变量。

本文基于 Claude Code v2.1.139 + 小米 MiMo API 实际部署经验整理。

目录#

前置条件#

详细部署流程#

第一步：安装 Node.js#

第二步：确认 Git 环境#

第三步：安装 Claude Code CLI#

第四步：获取小米 MiMo API Key#

第五步：配置 MiMo API#

第六步：启动并验证#

简化流程（速查）#

常见问题#

注意事项#