config 与官方文档不一致，且自动拉取模型列表不通 - Codex

Quick fix

按官方规范修改 config.toml 并设置 ARK_API_KEY；Codex 可恢复使用，但自动拉取模型列表仍需 CC Switch 适配。

Symptom

报错原文复制

手动按官方文档修正后 Codex 可正常使用，但 CC Switch 的自动拉取模型列表功能仍然不通。

Cause

CC Switch 3.19.2 的火山引擎 Agent Plan 预设复用了通用模板，生成的 provider 标识、TOML section、名称和认证方式均与官方规范不一致。模板使用 `requires_openai_auth = true`，而官方配置要求通过 `env_key = "ARK_API_KEY"` 认证，并要求启用 `model_supports_reasoning_summaries`。

这是两个相关但不能由同一修改完全解决的问题：手动修正 `config.toml` 并设置 `ARK_API_KEY` 后，Codex 桌面端可以正常使用；但 CC Switch 依赖 `{base_url}/models` 自动拉取模型，而 Agent Plan API 的该端点返回 404。官方的 `ListArkAgentPlanModel` 又使用 IAM HMAC-SHA256 签名，不能直接使用 Agent Plan 的 Bearer Token，因此自动拉取仍需 CC Switch 单独适配。

Fix

1. 1

   将火山引擎 Agent Plan 的 provider 配置改为官方文档所示格式，并把 `<Model_Name>` 替换为实际使用的模型名。

   config.toml

   model_provider = "custom"
   model = "ark-code-latest"
   model_reasoning_effort = "high"
   disable_response_storage = true
   model = "<Model_Name>"
   model_provider = "volcengine-agent-plan"
   model_supports_reasoning_summaries = true
   
   [model_providers.custom]
   name = "ark_agentplan"
   [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"
   requires_openai_auth = true

2. 2

   设置 `ARK_API_KEY` 环境变量；Issue 报告确认，完成配置修正后 Codex 桌面端可正常使用。

3. 3

   不要把配置修正视为自动模型列表问题的完整解决方案；Agent Plan 的 `/models` 端点返回 404，当前仍需等待 CC Switch 为其模型查询方式增加专门适配。

Affected Versions

ToolCodex

Version受影响版本：CC Switch 3.19.2

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

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

FAQ

（暂无 FAQ）

相关问题

Auth conflict退出 Claude 官方登录、清理冲突的 ANTHROPIC_* 环境变量，并将 ~/.claude.json 的 hasCompletedOnboarding 设为 true 后重启终端。6 issues merged我用魔搭是报错 401 token 失效 - Claude Code在 cc-switch 的 Provider 环境变量中添加 ANTHROPIC_MODEL 即可解决 401 报错。该变量不会同步到 settings.json，此为正常设计。2 issues mergedauth 已变为 {}，API Key 丢失 - cc-switch Codex编辑当前生效的 Codex 供应商并保存时，若本机 ~/.codex/auth.json 缺失，DB 中的 auth.OPENAI_API_KEY 会被 live 空配置整体覆盖清空；避免直接保存或手动补回 key。1 issues merged