Skip to content

CC-Switch 一键配置【推荐配置方式】

CC-Switch 可一键配置 Codex CLI,无需手动编辑配置文件。支持快速切换多个渠道,同时提供 Claude Code、Codex、Gemini 的 MCP 和 Skills 可视化配置。

CC-Switch 下载地址

下载:https://github.com/farion1231/cc-switch/releases

为什么推荐 CC-Switch?

  • 图形化界面,无需手动编辑配置文件
  • 一键切换不同 API 提供商
  • 支持多个 API Key 管理
  • 保存配置,随时切换

两种配置方式

CodexZH 提供两种方式将配置接入 CC-Switch:

  • 方式一:自动导入(推荐) —— 在控制台点击「一键导入 CC Switch」,浏览器自动调起 CC-Switch 并填好配置,你只需点击「应用」即可,无需手动输入任何内容。
  • 方式二:手动配置 —— 在 CC-Switch 中手动点击 + 新建配置并填写中转站信息。

如果你已经下载安装了 CC-Switch,推荐使用更省心的自动导入


前置准备

开始前请确保:

  1. 已安装 Codex CLI 工具
  2. 已在 CodexZH 购买套餐并生成了 API Key
  3. 已下载并安装 CC-Switch 工具

还没完成?


方式一:自动导入(推荐)

只要你已经下载安装好 CC-Switch 客户端,就可以从浏览器直接调起它自动导入配置,无需手动填写。

步骤 1:进入控制台一键配置区域

登录 CodexZH 网站,进入 控制台,在「API 密钥管理」中找到 一键配置脚本 区域,点击 「一键导入 CC Switch」 按钮:

一键导入 CC Switch

找不到按钮?请确认你已在「一键配置脚本」分组下,该区域同时提供「下载 Mac/Linux 脚本」「下载 Windows 脚本」和「一键导入 CC Switch」三个选项。


步骤 2:在 CC-Switch 中应用配置

点击按钮后,浏览器会自动调起本机已安装的 CC-Switch 客户端,并自动填入 CodexZH 的中转站配置。

在弹出的窗口中确认信息无误后,点击 「应用」(启用) 即可。

如果浏览器提示「是否打开 CC Switch」,请选择允许打开。若没有任何反应,说明 CC-Switch 客户端尚未安装或未启动,请先完成下载安装。


步骤 3:重启 codex

重启终端后,输入 codex 命令,确保配置生效。如果是 VSCode 插件,请重启 VSCode;如果是 Codex App,请重启 App。


方式二:手动配置

如果自动导入不可用,或你希望手动管理配置,可以按以下步骤在 CC-Switch 中手动填写。

步骤 1:打开 CC-Switch

启动 CC-Switch 软件,点击 codex 分组,然后点击右侧的 + 按钮:

CC-Switch 初始界面


步骤 2:填写 codexzh 中转站信息

按照图中教程填写即可:

填写中转站信息


步骤 3:启用配置

添加成功后,在主界面会看到刚才配置的项目。

点击右侧的 "启用" 按钮,状态变为 "使用中"

启用配置


步骤 4:重启 codex

重启终端后,输入 codex 命令,确保配置生效。如果是 VSCode 插件,请重启 VSCode;如果是 Codex App,请重启 App。


如果需要设置用量显示,请参考 CC-Switch 用量显示教程