DeepSeek Harness 教程
按顺序阅读,循序渐进掌握相关 AI 工具与实战方法。
本文介绍如何通过 CC Switch,让 Codex 能够使用第三方模型,比如 DeepSeek、Qwen、ZLM 等模型。
CC Switch 是一款免费开源的跨平台桌面工具,可以让你在 Codex 等 AI 编程助手中一键切换第三方 API 提供商,从而以更低的成本使用 AI 编程能力。
本文基于 CC Switch v3.16.0(最好安装最新版本),介绍如何为 Codex 配置 DeepSeek 作为后端 API,其他模型也可以参考这个配置。
除了官方API接口外,我们也可以通过Coding Plan/Token Plan套餐直接接入DeepSeek、Kimi、GLM、Doubao、MiniMax等主流大模型,无需单独购买各家API。
CC Switch 在你的本机启动一个代理服务,把 Codex 发出的请求透明地转发到你指定的后端(比如 DeepSeek),然后把响应再回传给 Codex。
整个转发过程完全透明,对于 Codex 来说,它仍然认为自己正在访问 OpenAI 官方接口,而实际上,请求已经被 CC Switch 转发到了你指定的第三方模型服务。
在开始配置之前,请确保你已满足以下条件:
| 条件 | 说明 |
|---|---|
| Codex 已安装 | 通过 https://openai.com/zh-Hans-CN/codex/ 下载安装 |
| DeepSeek API Key | 前往 platform.deepseek.com 注册并获取 |
| 操作系统 | Windows 10+、macOS 12+ 或主流 Linux 发行版 |
安装包下载地址为 https://github.com/farion1231/cc-switch/releases/latest,拉到页面底部,可以看到各个平台的下载链接:
根据你的操作系统选择对应的安装方式。
| 发行版 | 推荐格式 | 安装方式 |
|---|---|---|
| Ubuntu / Debian / Linux Mint / Pop!_OS | .deb |
sudo dpkg -i CC-Switch-*.deb 或 sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL / CentOS / Rocky Linux | .rpm |
sudo rpm -i CC-Switch-*.rpm 或 sudo dnf install ./CC-Switch-*.rpm |
| openSUSE | .rpm |
sudo zypper install ./CC-Switch-*.rpm |
| Arch Linux / Manjaro | .AppImage |
添加执行权限后直接运行,或使用 AUR |
| 其他发行版 / 不确定 | .AppImage |
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |
macOS 版本已通过公证,可直接使用 Homebrew 安装:
# 使用 Homebrew 安装 CC Switch(已公证版本) brew install --cask cc-switch
从 GitHub Releases 下载 .msi 安装包,双击运行即可。
# 安装 CC Switch deb 包 sudo dpkg -i CC-Switch-*.deb
安装完成后启动 CC Switch,主界面会出现在桌面或系统托盘。
更多 CC Switch内容参考:https://ccswitch.io/zh/docs
在 CC Switch 中添加 DeepSeek 作为 API 提供商,让 Codex 的请求可以转发到 DeepSeek。
操作步骤如下:
切换到 DeepSeek,系统会提示我们开启路由,我们可以点击左上角的设置按钮进入设置页面开启:
点击路由设置菜单,开启路由:
然后选择 Codex:
接下来你重新打开 Codex,就可以看到 DeepSeek 的模型标志了:
DeepSeek V4 提供两个版本,适用场景不同。选择合适的模型可以在成本和能力之间取得平衡。
| 模型 | 特点 | 适用场景 |
|---|---|---|
| flash | 速度快、成本低 | 日常代码补全、简单问答 |
| pro | 能力强,支持推理内容 | 复杂架构设计、多步推理 |
在 CC Switch 的提供商编辑界面,可以随时修改使用的模型,修改后立即生效,无需重启 Codex。
确认 CC Switch 的 Local Routing 处于运行状态(绿色图标)。
如果刚安装,可能需要重启终端让环境变量生效。
在 CC Switch 中关闭 Local Routing 接管,或切换到官方 OpenAI 提供商,Codex 会自动使用原始配置。
CC Switch 是本地应用,所有配置存储在本机。API Key 不会上传到任何服务器。
| 资源 | 地址 |
|---|---|
| CC Switch 官网 | ccswitch.io |
| GitHub 仓库 | github.com/farion1231/cc-switch |
| v3.15.0 发布说明 | Releases |
| DeepSeek 平台 | platform.deepseek.com |