micuapi

Appearance

Claude Code · Windows 配置教程 ​

可以自己照着做，也可以让豆包带你做

复制教程给豆包，让它一次指导一个步骤。

豆包打不开链接时，使用「复制完整教程」。纯文字教程 ↗

先完成一步，再继续下一步。已经完成的安装步骤可以跳过。

配置资料核对日期：2026-09-13。分组和模型可能调整，当前可用情况以 米醋模型广场 为准。

这份教程会帮你完成什么 ​

安装并连接米醋 API，最后发送一条消息确认可以使用。所有 API Key 示例都是占位值 sk-xxx，实际 Key 只在你自己的软件中填写。

要填写的内容本教程使用的值
工具Claude Code
系统Windows
令牌分组vip_1_max_enterprise
Base URLhttps://www.micuapi.ai
模型在 CC Switch 中留空，使用 Claude 默认模型

1. 安装并打开工具 ​

右键开始按钮，打开「终端」或「Windows PowerShell」。先从 Git for Windows 安装 Git，安装后重新打开终端。

powershell
git --version

执行安装命令：

powershell
irm https://claude.ai/install.ps1 | iex

关闭并重新打开终端，再检查版本：

powershell
claude --version

完成标志：版本检查能显示版本号，没有「找不到命令」的提示。

2. 准备米醋 API Key ​

先看模型广场，再创建密钥。 打开 米醋模型广场，确认分组 vip_1_max_enterprise 当前支持的模型；后面填写 model 时，直接复制该页面显示的完整模型名称，避免写错模型导致调用失败。

如果模型广场或创建 API Key 页面看不到国外模型，请先开启代理（魔法），并启用 TUN（网卡模式），再刷新页面。 仅浏览器代理可能无法加载完整列表。

  1. 登录 米醋站点，进入令牌管理页面。
  2. 新建或编辑一个令牌，分组选择 vip_1_max_enterprise。
  3. 关闭「模型限制」，限制可调用模型有时会引发未知异常。
  4. 保存并复制 API Key，稍后填入本机的软件。

本教程使用 Claude 模型。如果你购买的是 vip_2_cc，实际调用的是 GPT 模型，请按 CC Switch 分组说明 选择该分组允许的 GPT 模型。

完成标志：手中有一个对应分组的 API Key，令牌的模型限制已关闭。

3. 用 CC Switch 填写配置 ​

使用前看一眼：先查模型，再配置 ​

第一步：打开 米醋模型广场，先查看你准备使用的分组支持哪些模型。 设置 model 时请复制该分组显示的完整模型名称，避免模型名称写错或分组不支持导致调用失败。

看不到国外模型时，先开代理（魔法），并启用 TUN（网卡模式），再刷新模型广场和 API Key 创建页面。 仅开启浏览器代理可能无法加载完整分组或模型列表。

CC Switch 使用前，先确认这三项 ​

优选域名无需开启代理（魔法）。如果主站域名无法访问，请开启代理并启用 TUN（网卡模式）；部分地区还需要开启全局模式。

  1. 关闭路由模式。CC Switch 的路由模式有时会掩盖真实错误，配置和排障时请先关闭。
  2. 不要点击 CCS 的「检测」。米醋不接受 Claude Code / Codex 的 CCS 检测请求。保存并启用配置后，直接打开 Claude Code 或 Codex，发送一条消息验证。
  3. 更新 CCS，使用 Micu 预设。将 CC Switch 更新到最新版本，在 CCS 中选择对应框架和 Micu 预设，再填写 API Key。不要依赖米醋站点的「直接导入 CC Switch」功能。

CC Switch 路由模式开关示意，使用前请关闭

如果出现 401 Unauthorized，且报错地址是 api.openai.com/v1/responses，也可能是旧会话的问题。先新开会话测试。新会话正常时，右键原会话 → 分叉 → 创建聊天分支。如果新会话也报错，再完全退出 ChatGPT / Codex，用最新版 CCS 的 Micu 预设重新配置模型和供应商。详见 配置或旧会话导致 401 的排查步骤。

请求地址仍为 OpenAI 官方端点时的 401 错误示例

从 CC Switch 发布页 下载适合 Windows 的版本并安装。

CC Switch 简称 ccs；Claude Code 简称 cc，两者是不同的软件。

  1. 打开 CC Switch，点击「添加配置」。
  2. 框架选择 Claude Code。
  3. 在预设供应商中选择 Micu，Base URL 会自动填入。
  4. 把第 2 步准备的 API Key 填入对应输入框。
  5. 模型留空，使用 Claude 默认模型。
  6. 保存或点击「添加」，并确认已启用这个配置。
  7. 重新打开终端。

CC Switch 中选择 Micu 预设供应商

确认 Base URL 是 https://www.micuapi.ai。Claude Code 的地址不带 /v1。

完成标志：CC Switch 已启用 Micu 配置，工具已重新打开。

4. 发一条消息验证 ​

在终端执行：

powershell
claude

如果出现工作目录信任提示，确认目录后按界面操作，再发送：请只回复「配置成功」。

完成标志：收到正常回复，没有 API Key 无效、模型不可用或连接失败的报错。

没成功时，先看这里 ​

你看到的现象先做什么
找不到命令关闭并重新打开终端，再检查版本；Windows 下确认打开的是本教程指定的终端。
API Key 无效 / 401检查 Key 是否复制完整、是否过期，确认已启用正确的 Micu 配置。不要把完整 Key 发到聊天里。
模型不可用检查令牌分组、模型名称和模型限制；以本教程的配置表和模型广场为准。
403 block先确认使用官方客户端和正确分组，第三方客户端另见完整手册的外接说明。
连接失败 / 一直等待换一个可用网络，检查代理；记录完整错误文字，不要同时修改多个设置。

以前登录过 Claude 官方账号 ​

如果米醋配置没有生效，先在终端执行 claude auth logout 退出旧账号，再用 CC Switch 重新启用 Micu 配置。不要同时混用官方 OAuth 登录和米醋 API Key。

CC Switch 不可用时：手动配置 ​

这是备用方式。已有配置时先备份，只合并下面涉及的字段，不要整份覆盖原文件。保存后重新打开工具。

配置文件：C:\Users\<USERNAME>\.claude\settings.json。

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.micuapi.ai",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

把占位值 sk-xxx 替换成你自己的 API Key。

配好了，接下来 ​

可以开始使用，也可以进入 Claude Code 详细手册 查看更多配置。后续报错请保留错误原文、系统和工具版本，按 报错手册 排查。

米醋工作室

Copyright © 2026 micuapi.ai