Appearance
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,推荐使用更省心的自动导入。
前置准备
开始前请确保:
- 已安装 Codex CLI 工具
- 已在 CodexZH 购买套餐并生成了 API Key
- 已下载并安装 CC-Switch 工具
还没完成?
- Codex 安装教程 - 安装 CLI 工具
- 快速开始 - 购买套餐
方式一:自动导入(推荐)
只要你已经下载安装好 CC-Switch 客户端,就可以从浏览器直接调起它自动导入配置,无需手动填写。
步骤 1:进入控制台一键配置区域
登录 CodexZH 网站,进入 控制台,在「API 密钥管理」中找到 一键配置脚本 区域,点击 「一键导入 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 分组,然后点击右侧的 + 按钮:

步骤 2:填写 codexzh 中转站信息
按照图中教程填写即可:

步骤 3:启用配置
添加成功后,在主界面会看到刚才配置的项目。
点击右侧的 "启用" 按钮,状态变为 "使用中"。

步骤 4:重启 codex
重启终端后,输入 codex 命令,确保配置生效。如果是 VSCode 插件,请重启 VSCode;如果是 Codex App,请重启 App。
如果需要设置用量显示,请参考 CC-Switch 用量显示教程。