1. Windows 上跑 Claude Code为什么卡在 API 这一步Claude Code 是 Anthropic 推出的终端编码助手能在 PowerShell 里直接读文件、改代码、跑命令、做 agent 流程。它默认走官方 Anthropic 接口但长时间编码、调试、读大文件时官方高端模型的成本会让人肉疼。所以很多人想把它接到第三方 Anthropic 兼容接口上用更低成本先把日常开发流程跑起来。小米 MIMO 提供了 Anthropic 兼容接口模型名mimo-v2.5-pro可以作为 Claude Code 的后端。这篇就聚焦 Windows 环境从装 Git、Node.js到装 Claude Code再到把settings.json配成 MIMO 接口最后用命令验证模型是否真的连通。适合想快速跑通第三方模型的开发者也适合之前配过但一直报错的人。我试过在 Windows 11 的 PowerShell 里从零走一遍踩过的坑主要集中在配置文件路径、环境变量名、以及 npm 脚本执行策略这三块。下面按可复制的步骤来命令都能直接粘。2. 前置准备Git、Node.js 与 TaoToken 通道Claude Code 的 npm 安装方式需要 Node.js 18Windows 上还建议装 Git for Windows因为它附带 Git Bash后面用 Claude Code 时体验更接近 Linux/macOS。Git for Windows 下载后一路 next 即可装完在 PowerShell 执行git --version能看到git version 2.54.0.windows.1这类版本号就说明成功。Node.js 去官网下载.msi安装包安装时确认勾选Node.js runtime、npm package manager、Add to PATH。装完重新打开终端node -v npm -v正常会输出v24.16.0和11.13.0这样的版本号。如果 PowerShell 提示npm.ps1 cannot be loaded执行下面这行再重开终端Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned关于 API 通道如果你希望用一个统一 Key 管理多家模型、避免每个平台单独注册和充值可以用 TaoToken 作为统一入口。它的 API 地址是https://taotoken.net/api控制台里可以创建 API Keys文档里有 Anthropic 兼容接入说明。对 Claude Code 来说你只需要把ANTHROPIC_BASE_URL指向对应通道、把ANTHROPIC_AUTH_TOKEN填成你的 Key 即可。模型对话可以在模型对话页直接验证长期编码或 Agent 流程可以看 Coding Plan接入细节在接入文档里。注意不管用哪家通道Key 都不要发给别人也不要提交到 Git 仓库。3. 安装 Claude Code 并定位配置文件打开 PowerShell全局安装npm install -g anthropic-ai/claude-code验证claude --version输出2.x.x (Claude Code)就说明装好了。此时在终端输入claude能进入界面但还不能用因为还没配后端。配置文件位置是用户目录下的.claude.jsonC:\Users\你的用户名\.claude.json在文件资源管理器地址栏输入%USERPROFILE%回车就能看到这个文件。右键选择“在记事本中编辑”。如果之前已经跑过一次claude文件里会有 onboarding 相关内容直接整体覆盖即可。4. 可复制的 settings.json 配置骨架把.claude.json原有内容全部替换为下面这段。注意这是 JSON不能有多余逗号路径里的反斜杠不用转义因为这里没有路径。{ env: { ANTHROPIC_BASE_URL: https://api.xiaomimimo.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-xxxxxxxxxxx, ANTHROPIC_MODEL: mimo-v2.5-pro, ANTHROPIC_DEFAULT_SONNET_MODEL: mimo-v2.5-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: mimo-v2.5-pro, ANTHROPIC_DEFAULT_HAIKU_MODEL: mimo-v2.5-pro }, hasCompletedOnboarding: true }几个字段的作用对照字段作用建议值ANTHROPIC_BASE_URL接口根地址MIMO 的 Anthropic 兼容地址ANTHROPIC_AUTH_TOKEN鉴权 Key你创建的sk-开头 KeyANTHROPIC_MODEL默认模型mimo-v2.5-proANTHROPIC_DEFAULT_SONNET_MODELSonnet 档位映射同上ANTHROPIC_DEFAULT_OPUS_MODELOpus 档位映射同上ANTHROPIC_DEFAULT_HAIKU_MODELHaiku 档位映射同上如果你用 TaoToken 统一通道把ANTHROPIC_BASE_URL换成https://taotoken.net/apiANTHROPIC_AUTH_TOKEN换成在控制台 API Keys 页面创建的 Key模型名按你实际要用的填。这样切换模型时只改一个字段不用动其他配置。获取 MIMO Key 的流程登录小米 MIMO 平台进控制台左侧 API KEY右上角新建拿到sk-开头的密钥替换掉配置里的sk-xxxxxxxxxxx。模型名建议按官方文档保持小写别写成MiMo-V2.5-Pro大小写不一致可能导致 404。注意hasCompletedOnboarding设为true可以跳过首次引导避免它又弹一次登录选择。5. 验证请求与成功结果配置保存后回到 PowerShell进入你的项目目录cd 你的项目目录 claude首次启动会问是否信任当前目录选信任。然后发一句简单指令比如帮我看看当前目录有哪些文件并解释 package.json 的作用如果配置正确Claude Code 会开始调用模型并返回结果。成功时你能看到它读取文件、列出目录、给出解释终端不会卡在“connecting”或直接报 401/404。想更直接验证接口连通性可以用 curl 打一次 Anthropic 兼容的 messages 接口curl.exe -X POST https://api.xiaomimimo.com/anthropic/v1/messages -H x-api-key: sk-xxxxxxxxxxx -H anthropic-version: 2023-06-01 -H content-type: application/json -d {\model\:\mimo-v2.5-pro\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\说一句你好\}]}返回 JSON 里带content字段和文本就说明 Key、地址、模型名三者都对。如果返回 401是 Key 问题返回 404多半是模型名或路径问题返回 400检查 JSON 体格式。6. 本篇常见错排查报错一npm.ps1 cannot be loadedPowerShell 执行策略限制。执行Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned重开终端。报错二claude命令找不到npm 全局目录没进 PATH。执行npm config get prefix看路径把该路径加到系统环境变量 Path 里重开终端。报错三401 UnauthorizedANTHROPIC_AUTH_TOKEN填错、有多余空格、或者 Key 已失效。重新复制 Key确认没有换行。报错四404 model not found模型名大小写或拼写不对。MIMO 用mimo-v2.5-pro全小写。如果你走 TaoToken 通道模型名按文档里列出的写。报错五改了配置不生效Claude Code 可能读的是.claude/settings.json而不是.claude.json不同版本行为有差异。两个位置都放一份相同配置最稳C:\Users\你的用户名\.claude.json和C:\Users\你的用户名\.claude\settings.json。改完完全退出终端再重开。报错六JSON 解析失败记事本保存时可能带了 BOM 或多余逗号。用 VS Code 打开右下角确认是 UTF-8最后一项后面不要有逗号。报错七能进界面但一直转圈网络到接口地址不通或者 BASE_URL 多了/少了/v1。MIMO 的 Anthropic 兼容根地址是https://api.xiaomimimo.com/anthropic不要自己加/v1Claude Code 会拼。排障时优先看终端输出的 HTTP 状态码它比界面上的“出错了”有用得多。接入相关的字段说明可以对照接入文档Key 管理在 API Keys 页面模型连通性想单独验证就去模型对话页发一条消息长期编码和 Agent 流程则看 Coding Plan 的额度与模型说明。7. 把配置固定下来少走回头路最核心的步骤其实就四步装 Git 和 Node.jsnpm install -g anthropic-ai/claude-code编辑配置文件填入 BASE_URL、Key、模型名然后claude启动。真正容易翻车的是配置文件路径和字段名所以建议把.claude.json和.claude\settings.json两份都放上改完彻底重开终端。如果你后面要换模型或换通道只改ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL这三个字段就行其他映射字段跟着模型名一起改。把这份骨架存成自己的模板下次换机器直接复制比重新查文档快得多。
