Appearance
CC-Switch 一键配置【推荐配置方式】
CC-Switch 可一键配置 Codex CLI，无需手动编辑配置文件。支持快速切换多个渠道，同时提供 Claude Code、Codex、Gemini 的 MCP 和 Skills 可视化配置。
CC-Switch 下载地址
下载：https://github.com/farion1231/cc-switch/releases
注意：请下载安装包版本，不要下载压缩包（zip）版本。
- Windows 选
.exe/.msi安装包，macOS 选.dmg，装完在系统里能看到 CC-Switch 这个应用。- 压缩包（zip）解压后是绿色免安装版，没有向系统注册，浏览器点「一键导入 CC Switch」时无法调起软件，自动导入会没有任何反应。
- 如果你已经解压并打开了 zip 版但导入不了，请卸载/删掉它，重新下载安装包版本安装一次即可。
为什么推荐 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 的 API 配置。
在弹出的窗口中确认信息无误后，点击 「应用」（启用） 即可。
如果浏览器提示「是否打开 CC Switch」，请选择允许打开。
若点击后没有任何反应，常见有两种原因：
- 装的是压缩包（zip）版：绿色免安装版没有向系统注册，浏览器调不起来。请改用
.exe/.msi/.dmg安装包重新安装。- 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 用量显示教程。