CC-Switch 是一款跨平台的 AI 模型 API 渠道管理工具，作用是统一转发与代理各家大模型的接口请求，适配 Codex、Claude Code 等 AI 编程工具。它要解决的问题很具体：Codex 客户端默认支持的模型范围有限，想改用 DeepSeek，直接在客户端里改配置行不通，需要中间加一层转发。本文把 CC-Switch 接入 DeepSeek 并让 Codex 生效的完整过程拆成九项待办，每项都给出对应操作与自检标准，Windows、macOS、Linux 用户均可对照执行。
一、全流程检查清单
配置过程共九项，建议按顺序推进，每完成一项确认一项：
| 序号 | 待办事项 | 自检标准 | 对应章节 |
|---|---|---|---|
| 1 | 申请 DeepSeek API Key | 拿到 sk- 开头的字符串 |
第二章 |
| 2 | 下载 CC-Switch 安装包 | 安装包格式与系统匹配 | 第三章 |
| 3 | 完成 CC-Switch 安装 | 能正常打开主界面 | 第四章 |
| 4 | 新建 API 渠道 | 渠道列表出现新条目 | 第五章 |
| 5 | 选择 DeepSeek 供应商 | 接口参数自动填入 | 第五章 |
| 6 | 填写并保存 API Key | 提示保存成功 | 第五章 |
| 7 | 开启本地路由两个开关 | 总开关与 Codex 开关均为开启 | 第六章 |
| 8 | 激活 DeepSeek 渠道 | 界面显示当前激活为 DeepSeek | 第七章 |
| 9 | 重启 Codex 并测试调用 | 能返回模型回复 | 第八章 |
二、第 1 项：申请 DeepSeek API Key
在 DeepSeek 官方平台申请，格式为 sk- 开头的专属字符串。
API Key 属于账户私有凭证，必须由使用者本人申请。不要使用来源不明的密钥，不要分享给他人，也不要写进任何公开的配置示例。密钥填错或缺失会直接导致调用失败，这一步建议提前完成，不要等装完软件再临时去找。
三、第 2 项：下载 CC-Switch 安装包
CC-Switch 安装包下载：https://gitee.com/yjaz2026/cc-switch
下载前先确认安装包格式与自己的系统匹配：
| 系统 | 可用格式 |
|---|---|
| Windows | MSI 安装程序 / 便携版压缩包 |
| macOS | ZIP 压缩包 / Homebrew |
| Linux | deb 包 / rpm 包 / AppImage |
建议核对下载页面的版本号与项目来源，确认拿到的是最新版本再安装。
四、第 3 项：安装 CC-Switch
Windows 系统
双击 MSI 安装程序，跟随向导点下一步。安装路径可以自定义，建议避开 C 盘，省些系统盘空间。装完勾选桌面快捷方式，直接启动软件。
拿到便携版的话，解压后双击主程序即可打开，不需要执行安装流程。
macOS 系统
命令行方式，打开终端执行：
brew tap farion1231/ccswitch && brew install --cask CC-Switch
手动方式，解压 ZIP 包，把程序拖入"应用程序"文件夹。
Linux 系统
Debian / Ubuntu 系统执行：
sudo apt install ./CC-Switch-*.deb
Fedora 系统执行：
sudo dnf install ./CC-Switch-*.rpm
AppImage 文件添加执行权限后直接运行。
三个平台装完后情况一致：首次打开 CC-Switch 无需注册登录，直接进入主界面就能开始配置。
五、第 4–6 项：接入 DeepSeek 渠道
第 4 项：新建 API 渠道
在软件顶部导航栏找到并点击 OpenAI 图标入口。所有大模型渠道的配置都在这个模块内完成。
查看软件右上角，点击 【+】新增按钮，弹出渠道创建配置窗口。
自检：渠道列表中出现新建的条目，即表示这一步完成。
第 5 项：选择 DeepSeek 供应商
在新增渠道页面的预设供应商下拉列表中选中【DeepSeek】。选中后软件会自动匹配 DeepSeek 模型的基础接口参数，接口地址不需要手动填写。
自检：接口地址一栏已自动填入内容，无需自己补。
第 6 项：填写并保存 API Key
向下滚动页面，找到 API Key 专属输入框。这一项是核心必填项，默认空白。
把申请好的密钥完整粘贴进去，保存前逐项核对：
| 核对项 | 说明 |
|---|---|
| 无多余空格 | 复制时容易带上首尾空格，粘贴后手动看一眼 |
| 无字符缺失 | 密钥较长，确认没有漏字符 |
| 未过期、未注销 | 确认该 Key 在 DeepSeek 后台状态正常 |
确认无误后，点击页面底部的【保存】按钮。
自检：点击保存后界面提示保存成功，渠道配置即写入完成。
六、第 7 项：开启本地路由开关
这是整套配置中最容易漏掉的一步。大量 Codex 调用失败的案例，根源都在本地路由没开——渠道和密钥再正确，路由不开，API 也无法转发，客户端会完全无响应。
返回主界面进入设置功能模块，找到本地路由选项，把两个开关都打开：
| 开关 | 作用 | 状态 |
|---|---|---|
| 路由总开关 | 全局转发总入口，关闭后所有模型渠道失效 | 开启 |
| Codex 专属开关 | 单独适配 Codex 客户端的转发权限 | 开启 |
开启后软件自动保存，不需要手动确认。日常使用中保持两个开关处于开启状态，避免误触关闭。
自检：两个开关都显示为开启状态，且下次打开软件时仍然保持开启。
七、第 8 项：激活 DeepSeek 渠道
回到 CC-Switch 主界面的渠道列表，找到刚建好的【DeepSeek】渠道并点击选中。
确认界面显示当前激活渠道为 DeepSeek，不要停留在默认渠道或其他模型渠道上，否则前面的配置不会生效。
自检：渠道名称旁显示激活标记，且界面明确标注当前渠道为 DeepSeek。
八、第 9 项：重启 Codex 并测试
Codex 不会自动识别新的代理路由，必须重启才能读到配置。
- 完全退出 Codex 客户端，后台进程一并关闭，避免残留进程影响配置加载。
- 重新打开 Codex 客户端，软件会自动读取本地 CC-Switch 的路由代理参数。
- 发起一次调用测试，确认能正常返回模型回复。
自检：调用有回复内容，即表示可以通过 DeepSeek API 使用代码生成、代码调试、项目重构、BUG 修复等功能。
九、配置完成后的整体验证
九项做完，对着下面这张表整体确认一遍：
| 检查位置 | 正常状态 | 异常状态 |
|---|---|---|
| 渠道列表 | DeepSeek 渠道处于选中 | 停留在默认渠道 |
| 本地路由页 | 两个开关都开启 | 任一开关关闭 |
| 调用测试 | 能返回回复内容 | 长时间无响应或直接报错 |
| API Key | 后台显示正常、有额度 | 提示无效、过期或额度耗尽 |
| 软件重启后 | 配置仍然保留 | 配置丢失需重新填写 |
五项都对得上，链路就通了。哪一项对不上，按下表定位。
十、报错排查对照
| 现象 | 原因 | 处理 |
|---|---|---|
| 提示 API Key 无效、认证失败 | 密钥填错、格式异常或已失效 | ①检查是否完整复制，首尾有无空格、有无缺字符；②确认该 Key 未在后台删除或过期；③重新创建一个新 Key，替换后重新保存 |
| Codex 无响应、调用无反馈 | 本地路由未开或 Codex 转发权限未打开 | 进入设置 → 本地路由，核对两个开关均为开启。开启后无需重复保存，直接测试 |
| 配置全做完仍连不上模型 | 渠道未激活、配置未保存或客户端未重启 | 按序执行：切换 DeepSeek 渠道 → 手动保存 → 重启 CC-Switch → 彻底重启 Codex → 重新测试 |
| 切换渠道后仍调用原模型 | 客户端未重新读取配置 | 完全退出 Codex（含后台进程）后重新打开 |
| 点开软件找不到设置入口 | 界面版本差异 | 在主界面逐个查看顶部导航与侧边栏，本地路由位于设置模块内 |
| 关掉软件再打开，配置没了 | 配置未成功保存 | 回到渠道配置页重新点一次保存按钮，确认提示保存成功后再退出 |
十一、常见问题
CC-Switch 支持哪些系统？
Windows、macOS、Linux 均有对应安装包，三个平台的配置流程完全一致。
首次打开需要注册账号吗？
不需要。装完直接进主界面就能开始配置。
DeepSeek 的 API Key 从哪里获取？
DeepSeek 官方平台申请，属于账户私有凭证，不要使用来源不明的密钥，也不要分享给他人。
为什么渠道和密钥都对，Codex 还是没反应？
优先查本地路由。路由总开关与 Codex 专属开关必须同时开启，缺一个都无法转发。
配置完必须重启 Codex 吗？
必须。Codex 不会自动识别新的代理路由，需要完全退出（含后台进程）后重新打开。
改完配置需要重新保存吗？
本地路由开关开启后自动保存，不需要手动确认；渠道参数的改动要点保存按钮才生效。
多个客户端能共用一个渠道吗？
CC-Switch 本身支持多模型渠道切换，某个客户端能否调用，取决于该客户端专属开关是否开启。
换电脑后要重新配置吗？
要。渠道配置保存在本地，换设备后需重新安装并走一遍本文流程。
配置一次之后日常还要做什么？
配置只需做一次。日常使用若要在多个模型渠道之间切换，在 CC-Switch 主界面点选对应渠道即可，不用再动 Codex 的设置。
十二、配置流程速查
申请 DeepSeek API Key → 下载并安装 CC-Switch → 新建 DeepSeek 渠道 → 粘贴并保存密钥 → 开启本地路由两个开关 → 激活 DeepSeek 渠道 → 重启 Codex → 按验证表确认生效。
整个流程里有两处最容易出问题：本地路由的两个开关，以及 API Key 的填写。这两处确认清楚，再按顺序重启客户端，多数调用异常都能自行解决。本文的九项检查清单可以直接当作操作对照表使用，完成一项勾一项，避免中途遗漏。操作中遇到其他问题，欢迎在评论区留言交流。
