使用 cc-switch 让 Codex 接入第三方模型：DeepSeek、GLM 5.2、Qwen 等模型接入教程

使用 cc-switch 让 Codex 接入第三方模型：DeepSeek、GLM 5.2、Qwen 接入教程

如果你正在搜索 Codex 接入 DeepSeek、Codex 接入 GLM 5.2、Codex 接入 Qwen、Codex 接入 OpenAI 兼容接口、cc-switch 怎么配置，这篇教程会从下载安装到验证结果，完整演示一次。

先说结论：用 cc-switch 给 Codex 接第三方模型，通常有两种方式。

配置写入模式：第三方网关导入或手动创建 provider，让 cc-switch 写入 Codex 配置，Codex 直接请求第三方网关。
Local Routing 模式：Codex 先请求 cc-switch 本地路由，再由 cc-switch 转发到第三方网关，适合需要协议转换、模型映射、日志统计或 failover 的场景。

一、cc-switch 是什么，为什么适合给 Codex 接第三方模型

cc-switch 不是单纯的 Codex 代理。它是一个跨平台桌面管理器，可以统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes 的 provider 配置、切换、本地路由、MCP、Skills 和用量统计。

如果你是第一次接触这些名词，可以先这样理解：

Codex：你正在使用的代码助手。
第三方模型：DeepSeek、GLM、Qwen、Kimi、MiniMax 等非 OpenAI 官方模型，或者聚合网关里提供的模型。
第三方网关：把不同模型统一成 OpenAI 兼容接口的服务。
provider：一组模型服务配置，里面通常包含接口地址、API Key 和模型名。
Local Routing：cc-switch 在本机启动一个路由服务，帮 Codex 转发请求。

两种链路可以理解成下面这样：

flowchart TB
    A[第三方网关导入或手动创建]
    A --> B[cc-switch 写入 Codex 配置]
    B --> C[Codex 直接请求第三方网关]

    D[Codex]
    D --> E[cc-switch Local Routing]
    E --> F[第三方网关]
    F --> G[DeepSeek GLM Qwen Kimi 等模型]

重点记住一句话：能直接写入配置就先直接写入；只有需要协议转换、模型映射或日志转发时，再开 Local Routing。

二、软件下载与安装

1. Codex

本文默认你已经能正常打开 Codex。Codex 官方文档入口：

如果你还没有安装或登录 Codex，先按官方文档完成 Codex CLI、桌面端或 IDE 插件的安装和登录。等 Codex 能正常启动后，再继续配置 cc-switch。

2. cc-switch

cc-switch 官方下载入口：

下载时按你的系统选择：

系统	推荐下载	适合谁
Windows	`.msi` 安装包	大多数 Windows 用户，推荐
Windows	`Portable` 或 `.zip` 包	不想安装，解压即用
macOS	`.dmg` 安装包	大多数 Mac 用户，推荐
Linux	`.deb`	Ubuntu、Debian、Linux Mint 等
Linux	`.rpm`	Fedora、RHEL、CentOS、openSUSE 等
Linux	`.AppImage`	不确定选哪个时用这个

注意：下载页里的版本号和文件名会变化。选最新版，并按自己的系统选择对应安装包即可，不需要死抄本文里的文件名。

安装完成后打开 cc-switch，确认能看到 provider 或应用配置界面。

3. 第三方模型网关

你还需要一个能访问的第三方模型服务。它可以是聚合平台、云厂商模型服务、自建 OpenAI-compatible 网关，或者本地模型服务。

最少准备三个信息：

base_url：接口地址，可以理解成“请求发到哪里”。
api_key：密钥，可以理解成“证明你有权限调用”。
model：模型名，可以理解成“这次要用哪个模型”。

进入后台后，找到接口地址、API Key 和可用模型列表。

如果网关支持“导入到 cc-switch”，优先使用导入入口。点击后，配置会直接进入 cc-switch，比手动复制更不容易填错。

三、接入前先选模式

新手建议按这个顺序来：

网关支持导入到 cc-switch，先用导入。
没有导入入口，就在 cc-switch 手动创建 Codex provider。
只有需要协议转换、模型映射、热切换、日志统计或 failover 时，再启用 Local Routing。

两条链路分别是：

配置写入模式：第三方网关 -> cc-switch 写入配置 -> Codex 直接请求第三方网关
Local Routing：Codex -> cc-switch Local Routing -> 第三方网关或模型服务

很多人一开始会误以为“用了 cc-switch 就必须开本地端口”。这不对。配置写入模式不需要本地监听端口，Local Routing 才需要。

四、方式一：通过 cc-switch 写入 Codex 配置

这是新手最推荐的方式。它不要求 cc-switch 一直作为本地代理运行，只需要让 cc-switch 把 provider 信息写入 Codex 配置文件。

Codex 常见配置文件包括：

~/.codex/auth.json
~/.codex/config.toml

正常情况下不建议新手手改这些文件，优先让 cc-switch 自动写入。

1. 从第三方网关导入

打开第三方网关后台。
找到 API 地址、API Key、模型列表和导入入口。
点击导入到 cc-switch。
在 cc-switch 中确认 Codex provider 已创建或已启用。
回到 Codex 验证模型是否可用。

2. 在 cc-switch 中手动创建

如果网关没有导入按钮，就手动创建：

打开 cc-switch 的 Codex provider 配置界面。
新建 provider。
填写第三方网关的 base_url、api_key 和 model。
保存并启用该 provider。
回到 Codex 验证模型是否可用。

配置写入模式下，请求链路是：

Codex -> 第三方网关 -> DeepSeek / GLM 5.2 / Qwen / 其他模型

五、方式二：什么时候需要 Local Routing

下面这些情况再考虑 Local Routing：

上游只支持 OpenAI Chat Completions 协议。
需要把 Codex 的 Responses 请求转换成上游能接受的格式。
需要给 DeepSeek、GLM、Kimi、MiniMax、Qwen 等模型配置 Model Mapping。
需要通过 cc-switch 做 provider 热切换、日志统计、Usage 或 failover。

在 Codex provider 中，相关开关通常叫 Needs Local Routing。选择 DeepSeek、Kimi、GLM、MiniMax 这类 Chat Completions preset 时，cc-switch 通常会自动配置这个开关和模型映射表；手动创建 provider 时，需要按上游协议判断是否打开。

开启 Local Routing 后，Codex 配置里的 base_url 通常会指向本地路由地址：

base_url = "http://127.0.0.1:15721/v1"

这个地址的意思是：Codex 不再直接请求第三方网关，而是先把请求发给本机的 cc-switch，再由 cc-switch 转给第三方网关。

六、如何启动 Local Routing

如果你走的是配置写入模式，这一节可以跳过。只有启用了 Local Routing，才需要启动本地监听。

按 cc-switch 官方手册，操作路径通常是：

打开 cc-switch。
进入 Settings -> Advanced -> Proxy Service。
启动 Proxy / Routing Service。
进入 Settings -> Advanced -> Routing Service -> App Routing。
打开 Codex Routing。
回到 Codex provider 列表，确认当前启用的是目标第三方网关。

启动后检查：

本地服务地址是否正常显示，例如 http://127.0.0.1:15721。
Codex Routing 是否已经开启。
当前 Codex provider 是否正确。
请求日志和统计里是否能看到 Codex 请求。

七、验证 Codex 是否接入成功

第一次验证不要直接跑长任务。先发一个最短请求：

Reply with exactly: ok

重点看三件事：

Codex 能成功返回结果。
如果启用了 Local Routing，cc-switch 能看到这次请求。
第三方网关后台有对应调用记录或余额变化。

如果这个测试能成功，说明最小链路已经跑通。后面再切 DeepSeek、GLM 5.2、Qwen 或其他模型，本质上就是换 provider 或换模型名。

八、常见报错与排障

1. 401 Unauthorized

通常是密钥问题，优先检查：

api_key 是否填错。
密钥前后是否混入空格。
上游是否要求特殊 Header。
当前启用的 Codex provider 是否正确。

2. 404 Not Found

通常是地址或模型名问题，优先检查：

base_url 是否多写或少写 /v1。
是否误用了 Full URL Mode。
模型名是否真实存在。
Local Routing 模式下，Codex 是否已经指向 http://127.0.0.1:15721/v1。

3. 400 Bad Request

通常是协议或参数不兼容，常见原因：

上游不支持某些请求参数。
上游只支持 Chat Completions，但当前没有开启 Needs Local Routing。
工具调用、流式输出或响应格式字段不兼容。
模型上下文长度或能力不支持当前任务。

排查顺序固定成三步：

先看 Codex 是否发出请求
如果启用了 Local Routing，再看 cc-switch 是否成功转发
最后看上游是否接受并返回

九、几个容易填错的配置

1. base_url

很多服务要求写到 /v1，有些服务只要求根路径。按网关文档填写。如果开启 Full URL Mode，要确认你填的是完整请求地址。

2. model

不要凭感觉写模型名。能通过 /v1/models 获取模型列表时，优先用 cc-switch 的 Fetch Models 功能拉取。

3. Model Mapping

需要 Local Routing 时，建议认真配置 Model Mapping：

Model ID 填上游真实模型名。
Display Name 填你希望在 Codex /model 里看到的名字。
Context Window 按上游实际上下文长度填写。

十、接入检查清单

十一、FAQ

1. Codex 可以接入 DeepSeek、GLM 5.2、Qwen 吗？

可以。前提是上游通过 cc-switch 能写入配置，或能通过 Local Routing 正常转接。OpenAI 兼容接口通常最省事。

2. 不开启 Local Routing，需要让 cc-switch 监听端口吗？

通常不需要。配置写入模式下，cc-switch 主要负责修改 Codex 配置文件；运行时请求是 Codex 直接发到第三方网关。

3. 第三方网关支持导入到 cc-switch，还要手动配置吗？

优先用导入。没有导入入口时，再在 cc-switch 中手动创建 provider。两种方式最终都是让 cc-switch 写入 Codex 配置。

4. 什么时候必须开启 Needs Local Routing？

当上游只支持 Chat Completions，或者需要 cc-switch 做协议转换、模型映射、热切换、日志统计、failover 时，就需要考虑打开 Needs Local Routing。

5. Windows 用户下载哪个 cc-switch 文件？

大多数 Windows 用户下载 .msi 安装包。如果你不想安装到系统里，可以下载带 Portable 或 .zip 的包，解压后运行。

6. Linux 用户下载哪个 cc-switch 文件？

Ubuntu、Debian、Linux Mint 这类系统优先选 .deb；Fedora、RHEL、CentOS、openSUSE 这类系统优先选 .rpm；不确定时可以选 .AppImage。