免费运行Codex:用CC Switch接入DeepSeek等国产大模型
🚀 30+款热门AI模型一站整合,DeepSeek/GLM/Qwen 随心用,限时 5 折。 👉 点击领海量免费额度
Codex 是 OpenAI 推出的 AI 智能体,起初专注于编程开发,现已进化为一个功能强大的通用智能体。它不仅能进行对话、编写代码,还能读取本地文件、修改项目、浏览网页、调用外部工具,甚至自动化操作浏览器和桌面应用,对新手非常友好。然而,其默认仅支持 OpenAI 自家的模型,使用门槛和成本较高。
今天要解决的问题是:如何让 Codex 免费或低成本地运行起来,并接入像 DeepSeek 这样性价比更高的国产大模型。核心方案是借助一个名为CC Switch的开源工具,它充当“协议翻译官”,让 Codex 能够无缝使用 DeepSeek 等模型的 API。整个过程无需复杂配置,通过图形界面点几下即可完成,实现国内直连、速度快、费用低的目标。
本文将带你完成从零开始的完整部署与接入流程。你会了解到整个方案的核心优势、详细的图文配置步骤、功能验证方法,以及可能遇到的常见问题与解决方案。无论你是想体验 Codex 的强大功能,还是寻求更经济高效的 AI 开发助手方案,这篇教程都值得一试。
1. 核心能力速览
在开始动手之前,我们先通过下表快速了解本方案的核心特性和要求,帮助你判断是否适合你的环境。
| 能力项 | 说明 |
|---|---|
| 核心目标 | 实现 Codex 桌面端本地运行,并接入 DeepSeek API,替代昂贵的 OpenAI 服务。 |
| 关键工具 | CC Switch:开源免费的协议转换与路由管理工具。 |
| 硬件门槛 | 无特殊要求。主要依赖网络访问和 DeepSeek API 调用,本地仅运行轻量级客户端和路由工具。 |
| 费用成本 | DeepSeek API 调用费用极低(约为 GPT-4o 的十分之一),且支持国内支付方式。 |
| 启动方式 | Codex 和 CC Switch 均提供图形化安装包,双击安装,点击启动。 |
| 主要功能 | 保留 Codex 所有原生功能:智能对话、代码编写与调试、文件操作、网页浏览、自动化任务等。 |
| 模型支持 | 通过 CC Switch,可灵活切换 DeepSeek、Kimi、智谱 GLM、XiaoMi MiMo 等多个国内大模型。 |
| 数据安全 | 请求数据通过 CC Switch 代理在国内流转,无需经过海外服务器。 |
| 适合场景 | 开发者、学生、技术爱好者寻求低成本、高性能、数据可控的 AI 编程与自动化助手。 |
2. 为什么需要 CC Switch?协议不兼容详解
很多人的第一反应是:直接在 Codex 的设置里把 API 地址改成 DeepSeek 的不就行了吗?答案是:不行。这正是整个方案的技术核心所在,理解它能帮你更好地排查问题。
Codex 作为 OpenAI 的产品,其底层通信协议是专用的OpenAI Responses API。这个 API 的端点路径通常是/v1/responses,其请求格式、响应结构、流式输出方式以及工具调用(Function Calling)的机制,都是 OpenAI 自定义的一套标准。
而 DeepSeek、通义千问等绝大多数国产乃至国际上的开源模型,提供的是业界更通用的OpenAI Chat Completions API兼容接口。这个接口的端点是/v1/chat/completions,虽然也源自 OpenAI,但其消息格式(messages数组)和功能特性与 Responses API 存在显著差异。
简单来说,两者是两套不同的“语言”。如果强行把 DeepSeek 的地址填进 Codex,Codex 用 Responses API 的“语言”去请求,DeepSeek 服务器完全听不懂,自然会返回404 Not Found或400 Bad Request错误,导致模型列表都无法加载。
CC Switch 的作用就是充当“同声传译”。它在你的本地电脑上启动一个代理服务(默认http://127.0.0.1:15721)。当 Codex 发出请求时:
- Codex 以为自己在和
api.openai.com对话,但实际上请求被 CC Switch 拦截。 - CC Switch 将 Codex 的 Responses API 请求,“翻译”成 DeepSeek 能理解的 Chat Completions API 请求,并转发给 DeepSeek。
- 收到 DeepSeek 的回复后,CC Switch 再将其“翻译”回 Codex 能理解的 Responses API 格式,返回给 Codex。
这样,Codex 和 DeepSeek 都觉得自己在和“原生”的伙伴对话,实现了无缝对接。CC Switch 支持多种 AI 工具(如 Claude Code, Gemini CLI),是一个统一的模型路由管理平台。
3. 环境准备与软件下载
开始配置前,请确保准备好以下环境和账号。
3.1 基础环境要求
- 操作系统:Windows 10/11, macOS 或 Linux。本教程以 Windows 为例,其他系统操作逻辑类似。
- 网络连接:需要能够正常访问互联网,用于下载软件和后续调用 DeepSeek API。首次启动 Codex 时,可能需要短暂访问其官方服务进行初始化。
- 磁盘空间:预留约 500MB - 1GB 空间用于安装两个客户端。
3.2 关键账号准备:DeepSeek API Key
这是本方案的成本核心,你需要一个 DeepSeek 平台的账号并获取 API Key。
- 注册与实名:访问 DeepSeek 开放平台 ,使用手机号注册账号,并完成实名认证(这是国内平台的常规要求)。
- 充值:在平台账户中充值。即使使用免费模型,也可能需要小额充值(如10元)来激活 API 调用权限,防止滥用。DeepSeek 的 API 定价非常低廉,少量充值足以支持长期个人使用。
- 创建 API Key:登录后,在平台左侧菜单找到「API Keys」页面,点击「创建新的密钥」。妥善保存生成的这串字符,它只会显示一次。
3.3 软件下载
你需要下载两个软件:
Codex 桌面客户端:
- 来源:OpenAI 官网。请注意访问官网可能需要特定的网络条件。
- 地址:
https://openai.com/zh-Hans-CN/codex/ - 选择与你的操作系统对应的版本(如
.exe,.dmg,.AppImage)下载。
CC Switch 路由工具:
- 来源:GitHub Releases 页面(推荐)或第三方网盘。
- GitHub 地址:
https://github.com/farion1231/cc-switch/releases - 在 Releases 页面找到最新的稳定版本,下载对应系统的安装包(如
CC-Switch-v3.16.1-Windows.msi)。 - (备选)如果 GitHub 访问不畅,搜索材料中提供了一个网盘链接,请注意辨别文件安全性。
建议:将下载好的安装包放在一个单独的文件夹中,方便管理。
4. 手把手配置流程
整个配置过程是图形化的,按照步骤操作,几分钟即可完成。
4.1 第一步:安装 Codex
运行下载好的 Codex 安装程序,按照向导完成安装。安装完成后,先不要启动Codex 应用程序。如果已经启动,请彻底退出(包括系统托盘中的图标)。
4.2 第二步:安装并启动 CC Switch
运行 CC Switch 的安装包(如.msi文件)。安装完成后,在开始菜单或桌面找到并启动 CC Switch。 启动后,你会看到一个简洁的界面,顶部是工具切换栏(如 Codex, Claude Code 等),中间区域是供应商列表(目前为空)。
4.3 第三步:开启本地路由(关键步骤)
这是让 CC Switch 开始工作的核心设置,很多人在此步骤遗漏导致配置失败。
- 在 CC Switch 主界面,点击右上角的设置(齿轮)图标,进入设置页面。
- 在设置页面中,找到「路由」选项卡。
- 在路由设置中,进行以下操作:
- 将「路由总开关」设置为打开状态。
- 在下方工具列表中,找到并勾选「CODEX」。这个操作确保 Codex 发出的网络请求会被 CC Switch 接管。
- 重要:完成上述设置后,返回 CC Switch 的主界面。你应该能看到主界面有一个显眼的「路由总开关」。务必将其也打开。
- 作用:这个开关控制着本地代理服务(
127.0.0.1:15721)的启停。打开后,CC Switch 会在后台启动这个代理服务。
- 作用:这个开关控制着本地代理服务(
至此,CC Switch 的“翻译”服务已经就绪,正在监听本地的 15721 端口,等待 Codex 的请求。
4.4 第四步:添加并启用 DeepSeek 供应商
现在需要告诉 CC Switch,将拦截到的请求转发给谁。
- 在 CC Switch 主界面的供应商列表区域,点击右上角的「+ 添加供应商」按钮。
- 在弹出的添加供应商窗口中,你会看到一个「预设」下拉列表。从列表中选择「DeepSeek」。
- 选择后,CC Switch 会自动填充 DeepSeek 的 API 请求地址(通常是
https://api.deepseek.com),你无需手动修改。 - 在「API Key」输入框中,粘贴你从 DeepSeek 平台获取的密钥。
- 点击「保存」。此时,DeepSeek 会出现在主界面的供应商列表中。
- 在供应商列表中,找到 DeepSeek,点击其右侧的「启用」开关,使其变为绿色启用状态。
4.5 第五步:启动并验证 Codex
- 现在,可以启动之前安装好的Codex桌面应用程序了。
- 启动后,观察 Codex 界面的左上角或模型选择区域。如果配置成功,这里显示的模型或 Provider(供应商)应该不再是默认的 OpenAI,而变成了「DeepSeek」。
- 进行功能测试:在 Codex 的对话框中输入简单的问题,例如:“你好,请介绍一下你自己。” 或 “用 Python 写一个快速排序函数。”
- 如果 Codex 能够正常接收并流畅地回复你的消息,那么恭喜你,整个链路已经打通!
5. 功能测试与效果验证
配置成功后,我们需要全面测试 Codex 的各项核心功能是否都能通过 DeepSeek 正常工作。
5.1 基础对话与代码能力测试
这是最直接的验证。
- 测试目的:确认大语言模型的基本理解和生成能力。
- 操作:在 Codex 中输入各类问题,包括技术问答、创意写作、逻辑推理等。
- 输入示例:
- “解释一下什么是 RESTful API。”
- “帮我写一个递归函数来计算斐波那契数列。”
- “将‘Hello World’翻译成法语、西班牙语和中文。”
- 预期结果:Codex 应能给出准确、连贯、符合 DeepSeek 模型能力的回答。你可以对比直接在 DeepSeek Web Chat 中的回答,风格和内容应基本一致。
- 成功标准:回复速度正常(国内直连,通常很快),内容合理,无报错信息。
5.2 文件操作功能测试
Codex 的特色功能之一是能读取和分析本地文件。
- 测试目的:验证 Codex 通过 DeepSeek 是否保留了文件系统交互能力。
- 操作:
- 在 Codex 对话框中,输入指令让它读取一个本地文件。例如:“请读取我桌面上的
test.py文件,并解释其功能。” - Codex 会弹出一个文件选择对话框,让你选择目标文件。
- 在 Codex 对话框中,输入指令让它读取一个本地文件。例如:“请读取我桌面上的
- 预期结果:Codex 成功读取文件内容,并基于内容进行分析和回答。
- 成功标准:无权限错误,文件内容被正确加载并用于对话上下文。
5.3 自动化与工具调用测试(进阶)
Codex 能够执行自动化任务,如操作浏览器。
- 测试目的:验证复杂的工具调用和自动化流程是否正常。
- 操作:向 Codex 发出一个需要多步操作或调用工具的指令。例如:“打开浏览器,搜索‘今天的天气’。”
- 预期结果:Codex 可能会尝试启动浏览器并执行搜索(具体行为取决于其当前版本的功能实现)。即使某些复杂自动化受限于环境,Codex 也应能理解指令并尝试规划步骤,而不是直接报错说“无法调用工具”。
- 成功标准:指令被理解,Codex 展示了执行计划或尝试了调用,没有出现“模型不支持此功能”的协议级错误。
6. 资源占用与链路状态监控
本方案不涉及本地模型推理,因此对 GPU、CPU 和显存几乎没有额外占用。资源消耗主要集中在网络请求和两个客户端的内存占用上。
- 内存占用:Codex 和 CC Switch 都是 Electron 类桌面应用,通常各自占用 200-500MB 左右内存,属于正常范围。
- 网络监控:你可以使用系统任务管理器或第三方网络监控工具(如
NetLimiter,GlassWire)查看进程的网络活动。当你在 Codex 中提问时,应该能看到CC-Switch.exe(或类似进程)产生对外网(api.deepseek.com)的网络流量。 - CC Switch 状态确认:始终确保 CC Switch 主界面的路由总开关是打开的,并且 DeepSeek 供应商的状态是“运行中”或“已启用”。这是链路畅通的基础。
7. 常见问题与排查方法
配置过程中可能会遇到一些问题,下表列出了常见现象及解决方法。
| 问题现象 | 可能原因 | 排查方式 | 解决方案 |
|---|---|---|---|
| Codex 卡在启动界面或无法启动 | 1. 首次启动需要连接 OpenAI 服务进行初始化验证。 2. 网络不通。 3. 进程残留。 | 1. 检查网络连接。 2. 查看系统任务管理器,确保所有 Codex 进程已结束。 | 1. 确保首次启动时有能访问 OpenAI 服务的网络环境。 2. 彻底退出 Codex(包括后台进程),重新启动。 |
| CC Switch 中已启用 DeepSeek,但 Codex 仍显示旧模型/OpenAI | 1. CC Switch路由总开关未打开。 2. 路由设置中未勾选CODEX。 3. Codex 未重启。 | 1. 检查 CC Switch 主界面和设置中的路由开关。 2. 确认 CODEX 已被勾选。 | 1. 在 CC Switch 中打开所有路由开关并勾选 CODEX。 2.完全退出 Codex,再重新启动。配置变更后必须重启 Codex 生效。 |
| Codex 能发送消息,但一直无响应或报错 | 1. DeepSeek API Key 无效或未充值。 2. CC Switch 代理服务未正常运行。 3. 网络防火墙/安全软件拦截。 | 1. 去 DeepSeek 平台检查 API Key 状态和账户余额。 2. 查看 CC Switch 日志或状态。 3. 暂时关闭防火墙/安全软件测试。 | 1. 在 DeepSeek 平台创建新的 Key 并充值少量金额,在 CC Switch 中更新 Key。 2. 重启 CC Switch,确保其正常运行。 3. 将 CC Switch 和 Codex 加入防火墙白名单。 |
| 请求速度慢 | 1. 本地网络问题。 2. DeepSeek 服务端临时负载高。 | 1. 测试其他网站速度。 2. 稍后再试。 | 1. 检查本地网络连接。 2. 通常国内直连 DeepSeek 速度很快,如持续缓慢可尝试切换网络环境。 |
| 无法读取本地文件 | 1. Codex 文件访问权限被系统阻止。 2. 文件路径包含特殊字符或过深。 | 1. 首次操作时,系统可能会弹出权限请求,请点击允许。 2. 尝试读取一个路径简单、无空格和中文的文件。 | 1. 在系统设置中为 Codex 授予文件访问权限。 2. 将待读取文件移动到桌面等简单路径下再尝试。 |
8. 最佳实践与使用建议
为了让这套组合更稳定、高效地为你服务,这里有一些进阶建议。
Key 与账户管理:
- 定期检查余额:虽然 DeepSeek 便宜,但也需关注使用量,避免意外超额。
- 密钥安全:API Key 如同密码,不要泄露。CC Switch 将 Key 保存在本地配置中,请确保电脑安全。
多模型切换:
- CC Switch 支持添加多个供应商(如 Kimi、智谱 GLM)。你可以根据任务类型(编程、创作、分析)在 CC Switch 界面中轻松点击切换“启用”状态,然后重启 Codex 即可使用新模型。无需修改 Codex 任何配置。
故障排查顺序:
- 遇到问题,遵循“由近及远”的原则:先重启 Codex -> 再检查 CC Switch 开关和供应商状态 -> 然后验证 DeepSeek API Key 和余额 -> 最后排查网络问题。
数据与隐私:
- 通过此方案,你的对话、代码和文件内容经由 CC Switch 代理发送至 DeepSeek 服务器。虽然数据在国内流转,但仍需注意不要上传敏感、机密或个人信息。对于高度敏感的数据,任何云端 AI 服务都需谨慎评估。
探索更多自动化:
- Codex 的自动化能力很强。尝试用它来整理文档、批量重命名文件、生成数据分析脚本等,将重复性工作自动化,能极大提升效率。
9. 总结
通过 CC Switch 这座桥梁,我们成功地将强大的 Codex 智能体与高性价比的 DeepSeek 大模型连接起来。这个方案完美解决了 Codex 原生使用成本高、网络访问不便的痛点,让你能在本地享受一个功能全面、响应迅速、且几乎“零成本”运行的 AI 编程与自动化助手。
整个配置过程的核心在于理解“协议转换”的概念,并严格按照“安装客户端 -> 启动路由 -> 添加供应商 -> 重启验证”的流程操作。最常遇到的“配置不生效”问题,十有八九是因为漏开了某个路由开关,或者忘记重启 Codex。
现在,你可以尽情探索 Codex 在代码生成、项目分析、文件操作和自动化工作流方面的潜力了。无论是作为学习编程的伙伴,还是提升工作效率的工具,这套组合都值得你深入使用。如果在实践中遇到其他问题,不妨回顾一下第 7 部分的排查清单,大多数问题都能迎刃而解。
🚀 30+款热门AI模型一站整合,DeepSeek/GLM/Qwen 随心用,限时 5 折。 👉 点击领海量免费额度