用 CC Switch 一键接入 Codex：把 Ace Data Cloud 配成你的 AI 编程入口

如果你正在使用 Codex CLI 或 VS Code 里的 Codex 扩展，又希望更灵活地切换模型服务商、统一管理 API Token，那么 CC Switch + Ace Data Cloud 是一个很顺手的组合。

Codex 本身通过 ~/.codex/config.toml 中的 model_provider 来决定请求发送到哪里。把它指向 Ace Data Cloud 的 OpenAI Responses 兼容代理后，就可以用统一的 API 入口调用 Codex 支持的模型能力，不需要反复手写 TOML，也不需要在多个配置文件里来回复制 Token。

本文会介绍如何用 CC Switch 图形化配置 Codex，并接入 Ace Data Cloud。

• Codex 集成文档：https://platform.acedata.cloud/documents/codex-integration
• Ace Data Cloud 控制台：https://platform.acedata.cloud/console/applications
• OpenAI 服务文档：https://platform.acedata.cloud/documents/openai

为什么适合用 CC Switch 管理 Codex 配置

CC Switch 是一个开源、跨平台的 AI 编程工具配置管理器，支持 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode 等多种工具。它的核心价值很简单：

• 用图形界面管理不同 AI 服务商配置
• 自动写入 Codex 所需的 config.toml 和 auth.json
• 支持多个 provider 快速切换
• 避免手动维护 TOML 和 JSON 时出现格式错误

对 Codex 来说，CC Switch 主要帮你管理两个文件：

• ~/.codex/config.toml：保存模型、接口协议、服务商地址等配置
• ~/.codex/auth.json：保存 API Key / Token

第一步：在 Ace Data Cloud 获取 API Token

先进入 Ace Data Cloud 控制台申请或查看你的 API Token：

https://platform.acedata.cloud/console/applications

如果还没有登录，平台会引导你注册或登录。首次开通应用通常会有免费额度，可以先用来测试 Codex 是否能正常通过 Ace Data Cloud 调用。

Ace Data Cloud 的特点是把多种 AI 能力统一到一个平台里，既可以管理应用和 Token，也可以查看调用记录、额度消耗和模型服务文档。对于需要在开发工具中稳定接入模型能力的用户来说，这比单独维护多个厂商账号更清晰。

第二步：安装 CC Switch

进入 CC Switch 的 GitHub Releases 页面下载对应系统版本：

https://github.com/farion1231/cc-switch/releases/latest

常见安装方式如下：

• Windows：下载 CC-Switch-v{version}-Windows.msi，也可以使用便携版 zip
• macOS：推荐使用 brew install --cask cc-switch，也可以下载 .dmg
• Linux：可选择 .deb、.rpm 或 .AppImage，Arch 用户也可以使用 paru -S cc-switch-bin

安装完成后打开 CC Switch，就可以开始添加 Ace Data Cloud 作为 Codex 的自定义服务商。

第三步：添加 Ace Data Cloud Provider

CC Switch 内置了很多服务商预设。如果没有看到 Ace Data Cloud，可以选择 Custom 自定义添加。

操作步骤：

1. 在 CC Switch 顶部切换到 Codex 应用
2. 点击右上角 + 添加 Provider
3. 在预设下拉框中选择 Custom
4. 填入 Ace Data Cloud 的接口和 Token

需要填写的关键信息：

• Name：Ace Data Cloud
• Base URL：https://api.acedata.cloud/v1
• API Key / Token：你在 Ace Data Cloud 控制台复制的 Token

CC Switch 会把 Codex 所需配置写入本地文件。对应的 config.toml 可以参考下面的配置：

model_provider = "acedatacloud"
model = "gpt-5"
model_reasoning_effort = "high"

[model_providers.acedatacloud]
name = "Ace Data Cloud"
base_url = "https://api.acedata.cloud/v1"
wire_api = "responses"
requires_openai_auth = true

同时，auth.json 中会保存 API Token：

{
  "OPENAI_API_KEY": "{token}"
}

这里的 {token} 替换为你在 Ace Data Cloud 控制台拿到的真实 Token。

配置字段怎么理解

几个关键字段可以这样理解：

• model_provider：默认使用的服务商名称，需要和下方 provider 配置对应
• model：默认模型，可以先使用 gpt-5，也可以根据需要切换为更轻量的模型
• model_reasoning_effort：推理强度，常见值包括 low、medium、high
• base_url：Ace Data Cloud 的 OpenAI 兼容接口地址，填写 https://api.acedata.cloud/v1
• wire_api：Codex 使用的协议类型，这里应设置为 responses
• requires_openai_auth：设为 true 后，Codex 会从 auth.json 读取认证信息

这里不需要打开 CC Switch 的 Local Routing。Ace Data Cloud 提供的是 OpenAI Responses 兼容入口，Codex 可以直接通过 wire_api = "responses" 访问。

第四步：启用并切换 Provider

添加完成后，在 Codex provider 列表中找到 Ace Data Cloud，点击 Enable 即可启用。也可以从系统托盘菜单里快速切换不同服务商。

需要注意的是，Codex 通常需要重启 CLI 或终端后配置才会生效。切换 provider 后，如果发现还是旧配置，可以先关闭当前终端，再重新打开执行 Codex。

在终端和 VS Code 中使用

CC Switch 只负责写入配置，Codex 本身仍然需要单独安装。

• 终端 CLI：安装并运行 codex，进入交互界面后可以输入 /model 查看当前 provider
• VS Code 扩展：安装 OpenAI Codex 官方扩展，扩展会复用 ~/.codex/config.toml 中的配置

Ace Data Cloud 也提供了更完整的 Codex 配置教程：

• Codex 终端配置教程：https://platform.acedata.cloud/documents/codex-terminal-integration
• Codex VS Code 配置教程：https://platform.acedata.cloud/documents/codex-vscode-integration

验证配置是否成功

可以在终端中执行下面的命令：

codex exec --model gpt-5-mini "Reply with exactly: ADC_Codex_OK"

如果配置正确，会看到类似输出：

ADC_Codex_OK

如果没有生效，可以检查：

• 是否已经重启 Codex 或终端
• ~/.codex/config.toml 中的 model_provider 是否为 acedatacloud
• base_url 是否是 https://api.acedata.cloud/v1
• auth.json 中是否写入了正确的 API Token

如何切换模型和查看用量

Ace Data Cloud 的 OpenAI 服务支持多个模型，常见选择包括：

• gpt-5：适合作为默认模型
• gpt-5-mini：更轻量，适合日常快速任务
• gpt-5.5、gpt-5.5-pro：适合更高要求的复杂任务

完整模型和计费信息可以查看 Ace Data Cloud OpenAI 服务文档：

https://platform.acedata.cloud/documents/openai

用量和额度可以在控制台查看：

• 应用列表与余额：https://platform.acedata.cloud/console/applications
• 调用记录与扣费明细：https://platform.acedata.cloud/console/usages

常见问题

切换后没有生效怎么办？

先重启 Codex / 终端，再检查 ~/.codex/config.toml 中的 model_provider 是否指向 acedatacloud。

能否切回官方 OpenAI 登录？

可以。CC Switch 支持配置多个 provider，你可以添加 OpenAI Official，也可以继续保留 Ace Data Cloud 配置，需要时切换即可。

配置数据保存在哪里？

CC Switch 自身数据通常保存在 ~/.cc-switch/cc-switch.db，Codex 实际读取的配置则在 ~/.codex/config.toml 和 ~/.codex/auth.json。

小结

用 CC Switch 接入 Ace Data Cloud 后，Codex 的配置流程会更直观：

• 不用手写复杂 TOML
• 可以在图形界面中管理 Token 和 provider
• Codex CLI 与 VS Code 扩展可以复用同一套配置
• Ace Data Cloud 控制台可以统一查看应用、额度、调用记录和模型文档

如果你正在尝试把 AI 编程工具接入更稳定、可管理的模型服务，Ace Data Cloud + CC Switch 是一个值得尝试的方案。

相关链接：

• Ace Data Cloud 平台：https://platform.acedata.cloud/
• Codex 集成文档：https://platform.acedata.cloud/documents/codex-integration
• OpenAI 服务文档：https://platform.acedata.cloud/documents/openai
• CC Switch 项目：https://github.com/farion1231/cc-switch