Skip to content
CC Switch WikiUnofficial Community Wiki

Volcengine Agent Plan Auto-Identify Model List Failed 404 - cc-switch

Quick fix

Manually modify config.toml to match official docs and add models in modelCatalog to bypass 404.

Symptom

Section titled “Symptom”
Error output
CC Switch 的自动识别功能调用 `{base_url}/models` 来获取模型列表，但火山引擎 Agent Plan API **不实现此端点**，返回 404。
English translation

CC Switch's auto-identification feature calls `{base_url}/models` to retrieve the model list, but the Volcengine Agent Plan API **does not implement this endpoint**, returning 404.

Cause

Section titled “Cause”

The Volcengine Agent Plan API does not provide a `/models` interface, causing cc-switch to return a 404 error when attempting to automatically pull the model list by calling `{base_url}/models`. Additionally, the generic preset template `generateThirdPartyConfig()` in cc-switch 3.19.2 generates a `config.toml` inconsistent with Volcengine's official documentation. For example, `model_provider` is incorrectly set to `"custom"` instead of `"volcengine-agent-plan"`, and it does not use the officially recommended authentication method `env_key = "ARK_API_KEY"`.

Fix

Section titled “Fix”

  1. Manually modify Codex's config.toml configuration file to align with Volcengine's official documentation.

    config.toml
    model = "<Model_Name>"
    model_provider = "volcengine-agent-plan"
    model_supports_reasoning_summaries = true
    

    [model_providers.volcengine-agent-plan]
    name = "volcengine-agent-plan"
    base_url = "https://ark.cn-beijing.volces.com/api/plan/v3"
    env_key = "ARK_API_KEY"
    wire_api = "responses"

  2. Since the API does not support automatic pulling, you must manually define the required model list (such as ark-code-latest, deepseek-v4-flash, etc.) in cc-switch's modelCatalog.

Affected Versions

Section titled “Affected Versions”
Toolcc-switch
Version3.19.2
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why can't cc-switch automatically identify the model list for Volcengine Agent Plan?
Because the Volcengine Agent Plan API does not provide the `/models` endpoint, calls to this endpoint by cc-switch will return 404.
Which models does Volcengine Agent Plan support?
Models listed in the official documentation include ark-code-latest, deepseek-v4-flash, deepseek-v4-pro, kimi-k2.6, kimi-k2.7-code, minimax-m2.7, minimax-m3, glm-5.2 (glm-latest), doubao-seed-2.0-code, doubao-seed-2.0-pro, doubao-seed-2.0-lite, and doubao-seed-code.
Section titled “Related problems”
"is not a model this version of Claude Code recognizes" - CC SwitchSet CLAUDE_CODE_MAX_CONTEXT_TOKENS or append [1m] to the model name to define the correct context window size.3 issues mergedInvalid schema: got 'type: null' - Claude CodeUpgrade cc-switch to v3.17.0 or later to fix the missing type field error during OpenAI format conversion.2 issues mergedANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEYOpen `~/.claude/settings.json`, delete the duplicate auth variable so only the one your provider needs remains, save, and restart Claude Code.4 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.