invalid_authentication_error 测试失败 - cc-switch

Quick fix

升级 cc-switch 至最新版本以修复自定义用量查询脚本中 {{apiKey}} 变量解析失败的问题，或临时将变量替换为真实的 API Key 硬编码。

Symptom

报错原文复制

测试失败: HTTP 401 Unauthorized : {"error":{"message":"Invalid Authentication","type":"invalid_authentication_error"}}

Cause

在 cc-switch 中配置 Kimi 等供应商的自定义用量查询脚本时，点击“测试脚本”会报 401 认证错误。这是因为早期版本中用量查询脚本的变量解析存在缺陷，无法正确识别和替换 {{apiKey}} 或 {{baseUrl}} 等模板变量，导致发送给官方接口的 Authorization Header 无效。该问题仅影响测试脚本路径，实际查询路径可能表现正常。官方已在后续版本中修复了变量解析逻辑，支持多种别名和带空格的写法。

Fix

1. 1

   升级 cc-switch 至 v3.15.0 或更高版本（如 v3.16.0），以获取修复后的变量解析引擎，现支持 {{apiKey}}、{{ apiKey }}、{{api_key}} 等常见写法。

2. 2

   若暂时无法升级，请在测试脚本的 headers 中将 {{apiKey}} 临时替换为真实的 API Key 字符串进行硬编码测试。

   // test.js
   headers: {
     Authorization: 'Bearer {{apiKey}}',
     Authorization: 'Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx',
      'User-Agent': 'cc-switch/1.0',
   }

Affected Versions

Toolcc-switch

Version< 3.15.0

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #2623配置用量查询-自定义-点击测试脚本
• #2954配置用量查询报错，变量解析导致 401，硬编码正常

FAQ

为什么把 {{apiKey}} 换成真实的 Key 就能测试成功？

因为早期版本的 cc-switch 在“测试脚本”功能中存在变量解析 bug，无法正确替换模板变量，导致请求因缺少认证而返回 401。硬编码绕过了变量解析过程。

测试脚本报错，但回到主页却能正常看到余额，这是为什么？

测试脚本路径和实际查询路径的代码表现不一致。虽然测试脚本的变量解析失败，但实际查询路径的变量解析可能是正常的，因此主页能成功获取并刷新余额。

相关问题

API Error: 401 authentication_error检查 API Key 字段、Base URL、Key 类型与 cc-switch 版本，确保 Claude Code 实际读取到有效凭证。7 issues mergedBash(...) Waiting... Claude Code降级 Claude Code 至 v2.1.104 或 v2.0.64（需管理员权限），或切换至阿里云百炼等兼容 provider，因 Nvidia 模型无法正确解析 tool use 格式。1 issues mergedis not a model this version of Claude Code设置环境变量 CLAUDE_CODE_MAX_CONTEXT_TOKENS 或在模型名后追加 [1m] 以指定正确的上下文窗口大小。3 issues merged