17一起AI

【工具技巧】Codex+CC-switch使用国产大模型教程

博客文章#大模型阅读 1,230
【工具技巧】Codex+CC-switch使用国产大模型教程

Codex 桌面客户端 + CC-switch 使用国产 DeepSeek 模型教程

背景

最近 OpenAI 推出的 Codex 桌面客户端（Codex App）火了起来，它把 AI 编程助手集成到图形界面里，点点鼠标就能让 AI 写代码、改 Bug、解释项目。但 Codex 默认调用的是 OpenAI 的模型，对国内用户来说访问不太方便，使用成本也比较高。

本文介绍一种更接地气的方案：Codex 桌面客户端 + cc-switch，让 Codex 走国产的 DeepSeek 大模型。

效果

配置完成后：

  • 你可以正常打开 Codex 桌面客户端；
  • 客户端里的 AI 对话、代码补全等功能实际调用的是 DeepSeek 模型（例如 deepseek-chat 或 deepseek-reasoner）；
  • 不需要一直开着VPN挂着国外网络，只要 DeepSeek API 能访问即可；

具体方法

1. 下载 & 安装 Codex 桌面客户端

Codex 桌面客户端支持 macOS 和 Windows（具体以官方发布为准）。

  1. 访问 OpenAI Codex 官方页面 官方下载页面或应用商店下载安装包：
  2. 根据自己的系统下载对应版本：
    • macOS：下载 .dmg 安装包，双击后拖到“应用程序”文件夹。
    • Windows：下载 .exe 或 .msi 安装包，双击按向导安装。
  3. 安装完成后，从“应用程序”或“开始菜单”启动 Codex。

2. 登录 Codex 桌面客户端

首次打开 Codex 客户端，会提示登录。

Codex 客户端通常支持两种登录方式：

方式一：使用 ChatGPT / OpenAI 账号登录（需要翻墙）

  1. 在登录界面选择“使用 OpenAI 账号登录”。
  2. 客户端会弹出浏览器窗口，让你用 OpenAI / ChatGPT 账号授权。
  3. 授权完成后，客户端自动进入主界面。

注意：这种方式需要开启VPN科学上网工具并且IP非中国大陆地区，才能正常访问 OpenAI。

方式二：使用 API Key 登录

  1. 在登录界面选择“使用 API Key 登录”或“自定义 API 设置”。
  2. 先填入一个占位 API Key（例如 sk-cc-switch），后续会改成指向 cc-switch 本地服务。
  3. 稍等片刻之后，Codex正常打开

3. 下载 & 安装 cc-switch

cc-switch 是一个 GitHub 上的开源项目，具体方法为：

3.1 访问 GitHub

打开浏览器，访问GitHub地址https://github.com/farion1231/cc-switch

备注：Github有时会被墙，如果打不开的话，请开启VPN科学上网工具。

3.2 下载对应的安装包

进入仓库后，点击右侧的 Releases，找到最新版本。

根据自己的系统下载对应的安装包：

系统 推荐下载文件
macOS .dmg, 例如 CC-Switch-v3.16.4-macOS.dmg
Windows .msi, 例如 CC-Switch-v3.16.4-Windows.msi

3.3 安装对应的软件

macOS 安装
  1. 下载 .dmg 后双击，按提示拖到“应用程序”文件夹即可。
Windows 安装
  1. 下载 .msi 后双击安装，按照提示选择相应的安装路径，完成安装。

4. 配置 cc-switch

cc-switch 安装好后，需要进行两项核心配置：指定 DeepSeek API Key，以及开启对 Codex 客户端请求的路由。

4.1 配置模型（DeepSeek）

  1. 注册 DeepSeek 账号并获取 API Key

    • 访问 DeepSeek 开放平台。
    • 注册/登录账号。
    • 进入“API Keys”页面，点击“创建 API Key”。
    • 复制生成的 Key（通常是 sk- 开头）。

  2. 在 cc-switch 中配置 DeepSeek API Key

    • 启动 cc-switch
    • 点击 右上角的 + 号
    • 选择 Deepseek 供应商，并填入上一步获取的API Key
    • 保存配置后，启用 Deepseek

4.2 开启 cc-switch 的路由功能

cc-switch 的核心作用是把 Codex 客户端发向 OpenAI 的请求“拦截”并转发到 DeepSeek。所以，需要开启路由功能，具体方法：

  • 点击 cc-switch 的设置按钮
  • 在路由Tab下，开启 本地路由

5. 重启 Codex 客户端并验证

  • 完成上述配置后，重启 Codex 桌面客户端。

  • 在客户端里打开一个项目或新建对话，输入一个中文问题，例如：输入"你好"

  • 如果客户端正常响应，并且在 cc-switch 的路由里能看到成功率，说明配置成功。

常见问题： 1、提示API-KEY无效，请检查Deepseek的API-key，确认无误后重启Codex。 2、cc-switch的路由未生效，请确认路由中的相关功能都开启，同时重启Codex。 3、如果想使用原有的ChatGPT账号，只需要在CC-swtich中重新启用OpenAI Official即可。

小结

通过 Codex 桌面客户端 + cc-switch + DeepSeek，你可以在图形界面里享受 Codex 的编程辅助能力，同时调用国产、便宜的 DeepSeek 模型。整个流程可以概括为：

  1. 安装 Codex 桌面客户端；
  2. 用 API Key 方式完成 Codex 登录；
  3. 下载并安装 farion1231/cc-switch；
  4. 在 cc-switch 中填入 DeepSeek API Key，启动本地路由；
  5. 重启客户端验证。