Unkonw coding plan provider cc-switch 火山引擎

Quick fix

升级 cc-switch 至 v3.20.0 及以上版本，并重建或修改火山引擎 Agent Plan 供应商的 Base URL。

Symptom

报错原文复制

Unkonw coding plan provider

Cause

在 v3.20.0 之前的版本中，`detect_provider` 函数仅匹配了 `volces.com/api/coding`，未覆盖 Agent Plan 的 `/api/plan` 端点，导致配置 Agent Plan 时被识别为未知供应商并报错。同时，用量查询逻辑（`query_volcengine`）存在路由映射错误或顺序探测问题，导致 Coding Plan 和 Agent Plan 的用量数据混淆或查询失败。

v3.20.0 版本已将 Agent Plan 与 Coding Plan 拆分为两套独立预设，并按 Base URL 正确路由到对应的查询接口，对存量供应商的端点检测也已放宽并立即生效。

Fix

1. 1

   升级 cc-switch 至 v3.20.0 或更高版本。

2. 2

   在 cc-switch 中删除旧的火山引擎 Agent Plan 供应商并重新添加（使用新的 Agent Plan 预设），或手动将 Base URL 修改为正确的端点（如 `https://ark.cn-beijing.volces.com/api/plan`）。

Affected Versions

Toolcc-switch

Version< 3.20.0

PlatformsWindows

Source Issues

本页汇总自 4 个真实 issue

• #4197从供应商列表中通过“打开终端”启动claude code时无法正常工作，但其他途径启动正常
• #4808火山Agentplan baseUrl问题
• #6070火山引擎用量查询功能异常
• #6448火山方舟用量查询按 Base URL 路由且映射相反

FAQ

从供应商列表中通过“打开终端”启动 Claude Code 时提示模型不存在或无权限，但其他途径正常？

这是预期行为。通过该方式启动时不会走 cc-switch 的路由功能，而是以临时 JSON 配置文件启动。

用量查询应该依赖 Base URL 中的路径字面量来判断套餐类型吗？

在 v3.20.0 及之后版本中，Agent Plan 与 Coding Plan 预设已按各自真实端点拆分，套餐用量检测按端点正确路由，不再出现映射相反或混淆的问题。

相关问题

usage null - Claude Code Qwen DashScope升级到 cc-switch v3.16.3+，自动修复 OpenAI 兼容接口流式用量为 null 的问题。2 issues mergedCodex 用量统计被双倍放大或虚增升级到 v3.19.2 并在用量页执行「重建 Codex 用量」以修正历史虚增数据。21 issues merged重启终端，执行gemini，提示需要输入api-key - Gemini CLI更新 cc-switch 修复保存清空 bug；若仍无效则是 Gemini CLI 官方读取 bug，需将环境变量写入 bash_profile。3 issues merged