火山引擎 Agent Plan config.toml 与官方文档不一致 - CC Switch

Quick fix

手动修改 config.toml，将 model_provider 和 section 名改为 volcengine-agent-plan，使用 env_key 认证。

Symptom

报错原文复制

None

Cause

CC Switch 的 `generateThirdPartyConfig()` 通用模板为火山引擎 Agent Plan 预设生成的 `config.toml` 与火山引擎官方接入文档（2026-07 更新）存在多处不一致。主要差异包括：模板使用了 `model_provider = "custom"` 和 `[model_providers.custom]` 部分，而官方要求使用 `model_provider = "volcengine-agent-plan"` 和对应的 section；模板使用 `requires_openai_auth = true` 进行认证，而官方推荐使用 `env_key = "ARK_API_KEY"`；此外，模板还硬编码了 `model_reasoning_effort = "high"` 并添加了 `disable_response_storage = true`，这些在官方文档中均不存在或为可选配置。由于这种不匹配，用户需要手动修正配置文件才能正常使用 Codex。

另外，即使手动修正了配置，CC Switch 的自动拉取模型列表功能仍然无法工作。这是因为该功能依赖于 OpenAI 兼容的 `{base_url}/models` 端点，而火山引擎 Agent Plan API 不提供此接口（返回 404）。火山引擎提供了专用的 `ListArkAgentPlanModel` API，但其使用 IAM 签名认证，与 Agent Plan 的 Bearer Token 认证体系不同，导致 cc-switch 无法直接调用。

Fix

1. 1

   打开 cc-switch 生成的 config.toml 文件，找到火山引擎 Agent Plan 相关的配置部分。

   config.toml

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

2. 2

   确保全局配置中的 model_provider 设置为 volcengine-agent-plan，并添加 model_supports_reasoning_summaries = true。移除 model_reasoning_effort 和 disable_response_storage 等模板默认项。

   config.toml

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

Affected Versions

ToolCodex

Version3.19.2

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #6564火山引擎 Agent Plan 预设模板生成的 config.toml 与官方文档不一致
• #6566火山引擎 Agent Plan 预设生成的 config 与官方文档不一致，且自动拉取模型列表不通

FAQ

为什么我手动修正了 config.toml 后，cc-switch 还是无法自动拉取模型列表？

因为 cc-switch 的自动拉取模型列表功能依赖 OpenAI 兼容的 `/models` 端点，而火山引擎 Agent Plan API 不提供此接口。火山引擎有专用的 `ListArkAgentPlanModel` API，但认证方式不同，目前 cc-switch 尚未支持。

火山引擎 Coding Plan 是否也有同样的问题？

是的，火山引擎 Coding Plan 预设也存在类似的不一致问题，官方文档要求使用 `model_provider = "volcengine-coding-plan"` 和对应的 `env_key`，建议参照 Agent Plan 的修正方式进行手动调整。

相关问题

Auth conflict退出 Claude 官方登录、清理冲突的 ANTHROPIC_* 环境变量，并将 ~/.claude.json 的 hasCompletedOnboarding 设为 true 后重启终端。6 issues mergedANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。4 issues merged我用魔搭是报错 401 token 失效 - Claude Code在 cc-switch 的 Provider 环境变量中添加 ANTHROPIC_MODEL 即可解决 401 报错。该变量不会同步到 settings.json，此为正常设计。2 issues merged