Claude Code 深度指南：Windows 配置第三方模型（MiniMax）

本指南介绍如何在 Windows 环境下，通过修改 settings.json 配置文件，实现 Claude Code 的第三方模型配置、多模型切换以及默认模型设置。

一、 配置文件位置

Claude Code 的全局配置文件位于：C:\Users\你的用户名\.claude\settings.json

注意：如果文件夹或文件不存在，请手动创建。Windows 用户名建议检查是否含有空格或特殊字符，以免路径解析出错。

二、 核心配置模版 (基于 settings.json)

为了确保兼容性并避免常见的 401 认证错误，建议直接在 env 对象中定义变量。以下是一个典型的配置示例：

关键参数说明：

1. ANTHROPIC_API_KEY: 必须设为空字符串 ""。这是为了强制 Claude Code 放弃官方的 x-api-key 校验方式。
2. ANTHROPIC_AUTH_TOKEN: 填写第三方的 API Key。设置此项后，Claude 会自动切换为 Authorization: Bearer 认证格式。
3. ANTHROPIC_DEFAULT_SONNET_MODEL: 默认模型映射。Claude Code 启动时默认寻找 Sonnet，通过此项可将其强制重定向至指定的第三方模型。

三、 后期添加与切换模型

1. 动态切换模型

如果你在 settings.json 中配置了基础环境（Base URL 和 Token），在 Claude Code 运行过程中，你可以随时通过内置指令切换模型：

• 输入 /model 查看可选模型列表。
• 输入 /model <模型全称> 立即切换，例如：/model gpt-4o。

2. 添加多个模型提供商

如果你有多个不同的 API 来源（如既有 MiniMax 又有 OpenRouter），目前 Claude Code 的环境变量设置通常一次只能指向一个 BASE_URL。

如果你想切换提供商，建议在 settings.json 中准备好备用配置，或者通过 Windows 终端别名（Alias）来快速切换。

四、 设置默认模型

要确保每次启动 Claude Code 时都默认使用特定模型，请检查以下两个设置点：

1. JSON 根层级设置： 在 settings.json 的根部添加 "model": "你的模型名称"。
2. 环境变量映射： 在 env 块中添加：
   • "ANTHROPIC_DEFAULT_SONNET_MODEL": "你的模型名称"
   • "ANTHROPIC_MODEL": "你的模型名称"

五、 常见问题排查

1. 401 Unauthorized 报错

• 现象：提示 login fail。
• 原因：通常是 Windows 系统环境变量中残留了官方的 ANTHROPIC_API_KEY。
• 解决：在系统环境变量设置中删除所有以 ANTHROPIC_ 开头的变量，确保只通过 settings.json 进行管理。

2. 配置不生效

• 解决：修改 settings.json 后，必须彻底关闭并重启当前的终端窗口（PowerShell 或 CMD）。

3. 验证配置

• 启动后输入 /status。
• 确认 Anthropic base URL 是否指向你的第三方地址。
• 确认 Model 是否显示为你设定的默认模型。

{
  "env": {
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_AUTH_TOKEN": "sk-cp-pTJ3igdLIorMffPXmlAJ7Qj3lHqrz5yM2A-TY7BIOZpJkr_PwkizxVbO-7W_n7CoBXxcVt_uAj9NBdPafEET0Tj2Yc_HZMixtkBtZlExFhCyd5r9xAbPvCI",
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.5-highspeed"
  },
  "model": "MiniMax-M2.5-highspeed"
}