Skip to content
CC Switch WikiUnofficial Community Wiki

Unkonw coding plan provider - cc-switch Volcengine

Quick fix

Upgrade cc-switch to v3.20.0 or newer, then recreate the Volcengine Agent Plan provider or fix its Base URL.

Symptom

Section titled “Symptom”
Error output
Unkonw coding plan provider

Cause

Section titled “Cause”

In versions before v3.20.0, the `detect_provider` function only matched `volces.com/api/coding` and did not cover the Agent Plan `/api/plan` endpoint, so configuring an Agent Plan was detected as an unknown provider and errored. At the same time, the usage query logic (`query_volcengine`) had a route mapping error or sequential probing problem, so Coding Plan and Agent Plan usage data got confused or the query failed.

v3.20.0 split Agent Plan and Coding Plan into two independent presets, routes to the right query endpoint by Base URL, and relaxed endpoint detection for existing providers with immediate effect.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.20.0 or newer.

  2. Delete the old Volcengine Agent Plan provider in cc-switch and add it again using the new Agent Plan preset, or change the Base URL by hand to the correct endpoint (`https://ark.cn-beijing.volces.com/api/plan`, for example).

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version< 3.20.0
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Launching Claude Code with "open terminal" from the provider list says the model does not exist or I have no permission, while other routes work. Why?
That is expected. Launching that way does not go through cc-switch routing — it starts with a temporary JSON config file.
Should the usage query decide the plan type from the path literal in the Base URL?
From v3.20.0 on, the Agent Plan and Coding Plan presets are split by their real endpoints, and plan usage detection routes correctly by endpoint — no more inverted or confused mapping.
Section titled “Related problems”
usage null - Claude Code Qwen DashScopeUpgrade to cc-switch v3.16.3+, which fixes null streaming usage on the OpenAI-compatible interface automatically.2 issues mergedCodex usage statistics doubled or inflatedUpgrade to v3.19.2 and run "Rebuild Codex Usage" on the usage page to correct historical inflated data.21 issues mergedRestarting the terminal and running gemini asks for an api-key - Gemini CLIUpdate cc-switch for the save-clears-config bug. If it still fails, that is a Gemini CLI read bug — put the environment variables in bash_profile.3 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.