如果你正在搜索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 Routingcc-switch在本机启动一个路由服务帮 Codex 转发请求。两种链路可以理解成下面这样第三方网关导入或手动创建cc-switch 写入 Codex 配置Codex 直接请求第三方网关Codexcc-switch Local Routing第三方网关DeepSeek GLM Qwen Kimi 等模型重点记住一句话能直接写入配置就先直接写入只有需要协议转换、模型映射或日志转发时再开 Local Routing。二、软件下载与安装1. Codex本文默认你已经能正常打开 Codex。Codex 官方文档入口建议自行搜索无法添加外链2. cc-switchcc-switch官方下载入口建议自行搜索无法添加外链下载时按你的系统选择系统推荐下载适合谁Windows.msi安装包大多数 Windows 用户推荐WindowsPortable或.zip包不想安装解压即用macOS.dmg安装包大多数 Mac 用户推荐Linux.debUbuntu、Debian、Linux Mint 等Linux.rpmFedora、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 RoutingCodex - 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 Routingcc-switch能看到这次请求。第三方网关后台有对应调用记录或余额变化。如果这个测试能成功说明最小链路已经跑通。后面再切 DeepSeek、GLM 5.2、Qwen 或其他模型本质上就是换 provider 或换模型名。如果这个测试能成功说明最小链路已经跑通。后面再切 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 MappingModel ID填上游真实模型名。Display Name填你希望在 Codex/model里看到的名字。Context Window按上游实际上下文长度填写。十、接入检查清单Codex 可以正常启动。cc-switch已安装并能打开界面。第三方网关的base_url正确。第三方网关的api_key正确。上游model名称确认无误。网关支持导入时已尝试导入到cc-switch。没有导入入口时已在cc-switch手动创建 Codex provider。配置写入模式下Codex 配置已经被正确写入。Local Routing 模式下Codex Routing已开启。Local Routing 模式下cc-switch已监听本地端口。最小测试请求可以成功返回。启用 Local Routing 时日志中能看到 Codex 请求。十一、FAQ1. 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 这类系统优先选.debFedora、RHEL、CentOS、openSUSE 这类系统优先选.rpm不确定时可以选.AppImage。