火山引擎 Agent Plan 自动识别模型列表失败 404 - cc-switch

Quick fix

手动修改 config.toml 匹配官方文档，并在 modelCatalog 中手动添加模型列表以绕过 404 错误。

Symptom

报错原文复制

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

Cause

火山引擎 Agent Plan API 本身不提供 `/models` 接口，导致 cc-switch 尝试调用 `{base_url}/models` 自动拉取模型列表时返回 404 错误。此外，cc-switch 3.19.2 的通用预设模板 `generateThirdPartyConfig()` 生成的 `config.toml` 与火山引擎官方文档不一致，例如 `model_provider` 错误地设为 `"custom"` 而非 `"volcengine-agent-plan"`，且未使用官方推荐的 `env_key = "ARK_API_KEY"` 认证方式。

Fix

1. 1

   手动修改 Codex 的 config.toml 配置文件，使其与火山引擎官方文档保持一致。

   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. 2

   由于 API 不支持自动拉取，需在 cc-switch 的 modelCatalog 中手动定义所需的模型列表（如 ark-code-latest、deepseek-v4-flash 等）。

Affected Versions

Toolcc-switch

Version3.19.2

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #6563火山引擎 Agent Plan: 自动识别模型列表失败（API 不支持 /models 端点）
• #6565火山引擎 Agent Plan 预设模板与官方文档不一致，且自动拉取模型列表不通

FAQ

为什么 cc-switch 无法自动识别火山引擎 Agent Plan 的模型列表？

因为火山引擎 Agent Plan API 不提供 `/models` 端点，cc-switch 调用该端点会返回 404。

火山引擎 Agent Plan 支持哪些模型？

官方文档列出的模型包括 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、doubao-seed-code。

相关问题

is not a model this version of Claude Code设置环境变量 CLAUDE_CODE_MAX_CONTEXT_TOKENS 或在模型名后追加 [1m] 以指定正确的上下文窗口大小。3 issues mergedInvalid schema: got 'type: null'升级 cc-switch 至 v3.17.0 或更高版本，以修复 OpenAI 格式转换时缺失 type 字段导致的报错。2 issues mergedANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。4 issues merged