为什么同样的 API 在 Roo Code 插件能用，在 cc-switch 打开的终端就报模型问题？

可能是模型名称、供应商兼容性或请求路径不一致。先确认 cc-switch 中配置的模型名与供应商实际支持的模型一致，再用实际请求验证，不要只依赖模型测试。

模型测试报 max_tokens value 1 is below minimum allowed 2 怎么办？

这是模型测试参数与部分第三方供应商不兼容导致的。维护者说明模型测试功能不可靠，应以实际请求为准；测试失败不一定代表模型不可用。

OpenCode 中 variants 为什么变成了 options.variants？

旧版 cc-switch UI 会把 variants 错误写入 options 下。升级到 v3.12.3 或更高版本后，OpenCode 的 model variants 会放到顶层以正确显示。

模型切换会不会覆盖 setting.json 里的其他配置？

有用户反馈旧行为会替换整个 setting.json，导致 env 以外的配置无法共享。后续版本提供了通用配置/同步配置功能用于保留共享配置。

There's an issue with the selected model - CC Switch

Quick fix

检查 cc-switch 中模型名与供应商配置，模型测试功能不可靠，请以实际请求为准。

Symptom

报错原文

● There's an issue with the selected model  (claude-sonnet-4-5-20250929). It may not exist or you may not

Cause

该集群包含多个与模型切换/模型配置相关的问题。最典型的是切换或接入第三方 API 后，Claude Code 提示所选模型不存在或不可用；同一 API 在其他工具中可用，但在 cc-switch 接入的终端中报错。该问题通常与模型名称、供应商兼容性、代理或模型测试结果不可靠有关。维护者说明模型测试功能难以适配所有供应商，测试结果仅供参考，应以实际请求为准。另有变体：模型测试因 max_tokens value 1 is below minimum allowed 2 失败；v3.12.0 便携版模型测试只显示变量名；测试提示出现未替换的 {{providerName}} 和 {{message}} 占位符；编辑供应商时模型字段无法删除或 UI 显示空白；OpenCode 中 variants 被错误写入 options 下；模型切换会整体替换 setting.json，导致 env 外配置无法共享。

Fix

确认所选模型名称与供应商实际支持的模型一致，避免使用供应商不支持或已降级的模型名。
不要仅依赖 cc-switch 的模型测试按钮；如果测试失败但实际调用可用，请以实际请求结果为准。
3
如果使用 OpenCode 并需要配置思考强度，升级到 v3.12.3 或更高版本；旧版本会把 variants 错误放到 options 下，正确位置应为 models.<model_id>.variants。
OpenCode 配置文件
```
"models": {
  "gpt-5.2": {
    "variants": {
      "low": {
        "reasoningEffort": "low"
      }
    }
  }
}
```
如果看到 {{providerName}}检查失败：{{message}}，升级到 v3.12.1 或更高版本；该 i18n 占位符问题已在 v3.12.1 修复。
如果模型切换导致 setting.json 中 env 以外的配置丢失，使用 cc-switch 的通用配置/同步配置功能，避免整文件被替换覆盖。

Affected Versions

Tool未知

Version未知

Platforms未知

Source Issues

本页汇总自 8 个真实 issue

FAQ

为什么同样的 API 在 Roo Code 插件能用，在 cc-switch 打开的终端就报模型问题？: 可能是模型名称、供应商兼容性或请求路径不一致。先确认 cc-switch 中配置的模型名与供应商实际支持的模型一致，再用实际请求验证，不要只依赖模型测试。
模型测试报 max_tokens value 1 is below minimum allowed 2 怎么办？: 这是模型测试参数与部分第三方供应商不兼容导致的。维护者说明模型测试功能不可靠，应以实际请求为准；测试失败不一定代表模型不可用。
OpenCode 中 variants 为什么变成了 options.variants？: 旧版 cc-switch UI 会把 variants 错误写入 options 下。升级到 v3.12.3 或更高版本后，OpenCode 的 model variants 会放到顶层以正确显示。
模型切换会不会覆盖 setting.json 里的其他配置？: 有用户反馈旧行为会替换整个 setting.json，导致 env 以外的配置无法共享。后续版本提供了通用配置/同步配置功能用于保留共享配置。

There's an issue with the selected model - CC Switch

Symptom

Cause

Fix

Affected Versions

Source Issues

FAQ

相关问题