Codex CC Switch 图形化配置教程
内容提要
本文介绍如何用CC Switch图形化工具将Codex接入Ace Data Cloud。先获取API Token，下载安装CC Switch，添加自定义模型提供方，填写名称、接口地址和密钥，生成配置文件。启用后重启Codex即可使用，支持终端和VS Code，并解答常见问题。
延伸解读
为什么选择图形化配置
手写 TOML 配置对新手不友好，容易出错。CC Switch 提供图形界面，自动生成 config.toml 和 auth.json，降低配置门槛。它支持多工具、多提供方管理，可一键切换，适合需要频繁调整配置的用户。
配置要点与常见错误
使用 CC Switch 时，需确保 model_provider 与 [model_providers.acedatacloud] 逐字匹配，且只保留 requires_openai_auth = true，不要混用 env_key。auth.json 中的 Token 必须是当前有效的 Ace Data Cloud Token。若遇 401，按顺序检查这些项。
切换后需重启
与 Claude Code 支持热切换不同，Codex 在切换模型提供方后需要重启 CLI 或终端才能生效。VS Code 扩展与 CLI 共享同一配置文件，因此重启后也会自动生效。
本地路由无需开启
CC Switch 的本地路由功能仅适用于只支持 Chat Completions 协议或非 GPT 模型的提供方。Ace Data Cloud 使用原生 Responses 协议，因此保持 Needs Local Routing 关闭即可，避免不必要的配置。
Q&A
如何使用CC Switch将Codex接入Ace Data Cloud？
首先在Ace Data Cloud控制台获取API Token，然后下载安装CC Switch，添加自定义模型提供方，填写名称、接口地址（https://api.acedata.cloud/v1）和API Token，生成配置文件后启用并重启Codex即可。
CC Switch是什么？
CC Switch是一个开源、跨平台的桌面端配置管理器，用于统一管理Claude Code、Codex、Gemini CLI等多个AI编程工具的模型提供方配置。它基于Tauri 2构建，采用MIT协议，在GitHub上已获得超过11万Star。
在CC Switch中添加Ace Data Cloud时，需要填写哪些字段？
需要填写名称（如Ace Data Cloud）、接口地址（https://api.acedata.cloud/v1）和API Token（从Ace Data Cloud控制台获取）。
为什么在CC Switch中配置Codex时不需要开启本地路由？
因为Ace Data Cloud属于原生Responses协议模型提供方（wire_api = "responses"），而本地路由仅用于只支持OpenAI Chat Completions协议或使用非GPT系列模型名的提供方，所以无需开启。
切换模型提供方后，Codex不生效怎么办？
需要重启Codex或终端，并检查~/.codex/config.toml中model_provider是否指向acedatacloud。
如何验证Codex是否成功接入Ace Data Cloud？
在终端运行命令：codex exec --model gpt-5-mini "Reply with exactly: ADC_Codex_OK" < /dev/null，如果配置正确，应看到回复ADC_Codex_OK。
Codex接入Ace Data Cloud后，如何切换模型？
可以通过修改~/.codex/config.toml中的model字段，或在CC Switch的模型提供方表单中使用Fetch Models按钮自动发现可用模型。常用模型包括gpt-5、gpt-5-mini、gpt-5.5等。
在CC Switch中配置Codex时，遇到401 invalid token错误怎么办？
检查model_provider与配置块名称是否逐字匹配，确保只保留requires_openai_auth = true，不要添加env_key，确认auth.json中的OPENAI_API_KEY是当前有效的Ace Data Cloud Token，删除Header覆盖中的非标准项，并重启相关程序。
