从汉化界面到接入国产大模型,全程可视化、零代码,新手也能一次跑通

导语

OpenAI 的 Codex 桌面端是当下最火的 AI 编程助手之一,但对国内开发者来说,两座大山一直横在面前:

一是全英文界面,上手门槛高;二是绑定 OpenAI 账号和 GPT 系列模型,国内使用门槛高、额度烧不起。

GPT-5.5 输出 token 价格是 $30/百万,重度使用一个上午额度就清空了。而国产模型 DeepSeek V4 Pro 输出 token 仅需 $0.87/百万,相差约 34 倍,还能国内直连,不需要梯子。

今天这篇文章,手把手教你完成两件事:把 Codex 界面汉化为中文,以及通过 Codex++ 接入 DeepSeek 等国产大模型。全程可视化操作、零代码,跟着步骤走,新手也能一次跑通。

一、先搞懂:Codex 和 Codex++ 分别是什么?

1. Codex Desktop App

Codex Desktop App 是 OpenAI 推出的桌面端 AI 编程助手,可以直接在电脑上帮你完成代码编写、Bug 排查、代码重构、写测试、技术文档整理等任务。

它内置沙盒环境,支持工具调用、上下文管理、任务并行,是目前最强的 AI 编程工具之一。

2. Codex++ 是什么?

Codex++ 是 GitHub 上爆火的开源增强工具(上线不到 30 天斩获 16K 星),被称为「Codex 官方外挂」。

核心原理:运行时动态注入脚本,不改动 Codex 原始安装包,后续 Codex 官方更新也不会失效。

用 Codex++ 启动 Codex,能实现三大核心能力

能力 说明
自由接入第三方大模型 API 支持 DeepSeek、Agnes、通义千问、智谱等国产模型,脱离 OpenAI 限制
解锁全部原生插件 无 ChatGPT 账号也能正常调用 Skills 和插件功能
修复原版 Bug 解决会话删除异常、路由切换卡顿、模型切换受限等体验问题

3. 为什么不能直接填 API Key?

这是很多教程跳过的关键问题。

Codex 内部使用的是 OpenAI 独有的 Responses API,而 DeepSeek、通义千问、智谱等国产模型使用的是行业通用的 Chat Completions API,两者协议不兼容:

  • 请求格式不同:Codex 发出 Responses API 格式请求,国产模型服务端不认识
  • 响应格式不同:国产模型返回 Chat Completions SSE 流,Codex 客户端无法解析
  • 思维链字段冲突:DeepSeek V4 Pro 推理模式附带 reasoning_content 字段,Codex 解析器会报错

所以,Codex++ 的核心工作就是:在本地跑一个协议转换层,把 Codex 发出的 Responses API 请求翻译成 Chat Completions 格式,再把模型的回复翻译回来。

理解了这一点,后面的配置步骤就不会觉得莫名其妙了。

二、前置准备:三样必备材料

材料 1:Codex 官方桌面端

Windows / Mac 双端适配。

下载地址: https://chatgpt.com/zh-Hans-CN/download/

💡 小提示:首次打开需登录,无 OpenAI 账号可选择「其他方式登录」,输入任意字符即可进入主界面。国内直连大概率加载失败,建议提前备好代理环境完成初始化。

Mac 用户也可以直接在 App Store 搜索 "Codex" 下载安装。Windows 用户可以通过微软官方商店搜索 Codex 安装。

材料 2:Codex++ 开源安装包

GitHub 官方发布页: https://github.com/BigPizzaV3/CodexPlusPlus/releases/

根据你的电脑系统选择对应安装程序:

系统 安装包
Mac 苹果芯片(M 系列) macos-arm64.dmg
Mac 英特尔芯片 macos-x64.dmg
Windows 系统 windows-x64-setup.exe

安装完成后,桌面会生成两个快捷入口,务必区分清楚:

  • ✅ Codex++ 管理工具:配置 API、管理模型供应商专用
  • ✅ Codex++:启动增强版 Codex,日常使用入口

⚠️ Mac 用户注意:如果提示「文件已损坏」,是 macOS Gatekeeper 的安全拦截,右键 → 打开即可绕过。

材料 3:第三方大模型 API Key

目前主流兼容的国产模型平台,注册后在 API 管理页面创建密钥并保存(密钥仅展示一次,务必复制留存):

平台 注册地址 推荐模型
DeepSeek https://platform.deepseek.com/ deepseek-chat(V4 Pro)、deepseek-reasoner(推理版)
Agnes https://agnes-ai.com/ agnes-2.0-flash
通义千问 https://dashscope.console.aliyun.com/ qwen-plus、qwen-vl(多模态)
小米mimo https://platform.xiaomimimo.com?ref=PN8TSW mimo-v2.5-pro-ultraspeed

💡 建议先充 10 元测试,DeepSeek V4 Pro 永久定价为 $0.435/百万输入 token、$0.87/百万输出 token,10 元够用很久。

三、第一步:Codex 界面汉化(切换中文)

Codex Desktop App 默认界面是英文,但官方已内置中文语言包,手动切换即可。

操作步骤

  1. 1打开 Codex 桌面端
  2. 2点击左上角 File
  3. 3进入 Settings
  4. 4选择 General
  5. 5找到 Language for the app UI
  6. 6在下拉框中选择 Chinese (China)
  7. 7重启软件生效

汉化失败怎么办?

有些人会遇到:选了中文但界面没变。

原因通常是软件需要联网下载语言包,国内网络可能下载失败。

解决方案:

  • 开启代理后重新切换一次语言
  • 必要时完全退出软件再重启
  • 确保网络通畅后重试

基本就可以解决。

四、第二步:安装 Codex++ 增强工具

1. 下载安装

从 GitHub Releases 页面下载对应系统的安装包,双击下一步完成安装。

⚠️ 不要去微软商店找 Codex++,那里没有这个工具。

安装成功后,桌面会出现 Codex++ 和 Codex++ 管理工具 两个图标。

2. 彻底退出原版 Codex(最容易忽略的关键步骤)

这一步是整个流程中最容易出错的地方

仅关闭软件窗口无效,必须:

  • Windows:在电脑任务栏右下角找到 Codex 图标,右键选择「完全退出」
  • Mac:在菜单栏点击 Codex 图标,选择「退出 Codex」

若程序后台残留,Codex++ 无法注入增强脚本,后续配置全部失效。

💡 验证方法:打开任务管理器(Windows)或活动监视器(Mac),确认没有 Codex 相关进程。

五、第三步:配置国产模型(以 DeepSeek 为例)

1. 打开 Codex++ 管理工具

软件会自动扫描本地已安装的 Codex,自动识别版本,无需手动选择安装路径。

2. 新增模型供应商

左侧菜单栏点击「供应商配置」,右上角点击「添加供应商」,按以下参数精准填写:

参数项 填写内容 说明
名称 DeepSeek(自定义即可) 方便区分多个模型
接入模式 纯 API 固定选项,不可修改
测试模型 deepseek-chat 或 deepseek-reasoner 前者为 V4 Pro 综合版,后者为推理版
Base URL https://api.deepseek.com 注意末尾不要加 /v1
Key 你的 sk 开头 API 密钥 在 DeepSeek 开放平台创建
上游协议 Chat Completions 重中之重,选错直接报错

⚠️ 关键提醒:上游协议必须选 Chat Completions。国产主流大模型均采用该协议,如果误选 OpenAI 私有 Responses API,接口会持续报错。

3. 模型选择建议

模型名称 说明 适用场景
deepseek-chat DeepSeek V4 Pro,综合能力最强 日常代码编写、调试、重构
deepseek-reasoner 带推理链的版本 复杂逻辑任务、深度 Bug 排查,token 消耗更大

4. 一键填充(快捷方式)

新版 Codex++ 内置 23 个主流模型预设模板,点击对应厂商即可一键填充参数,仅粘贴 Key 即可。

建议第一次手动配置,方便后续报错排查时理解每个参数的含义。

5. 保存配置并测试

全部信息填写完毕后:

  1. 点击「保存
  2. 选中刚创建的供应商
  3. 点击右侧「使用
  4. 点击「发送 hi 测试

返回 HTTP 200 状态码 + 正常文字回复,代表 API 链路配置成功。

6. 开启页面增强(重要)

在管理工具里找到「页面增强」,打开启用。

这一步解锁了 API 模式下默认被禁用的插件功能,如果不开启,后续 Skills 和插件会是灰色不可用状态。

六、第四步:接入其他国产模型

Agnes 模型

仅需修改两处参数,其余保持不变:

参数项 填写内容
Base URL https://apihub.agnes-ai.com/v1
测试模型 agnes-2.0-flash

通义千问

参数项 填写内容
Base URL https://dashscope.aliyuncs.com/compatible-mode/v1
测试模型 qwen-plus
上游协议 Chat Completions

⚠️ 注意:阿里云 API 的 Base URL 格式特殊,末尾的 /v1 是必须的,参考阿里云百炼平台官方文档。

智谱 AI(GLM)

参数项 填写内容
Base URL https://open.bigmodel.cn/api/paas/v4
测试模型 glm-4-plus
上游协议 Chat Completions

七、第五步:启动增强版 Codex 并验证

1. 通过 Codex++ 启动

不要双击原版 Codex 图标!

打开桌面「Codex++」快捷方式。Codex++ 需要在 Codex 启动前就把协议转换层跑起来,如果直接打开原版 Codex,转换层不会介入。

2. 验证增强模式激活

界面右上角出现绿色圆点 + Codex++ 标识,代表增强模式已激活。

对话框底部会展示已配置的 DeepSeek / Agnes 模型,直接选中就能对话使用。

3. 验证模型接入成功

⚠️ 重要:Codex 界面右下角的模型名可能仍然显示 OpenAI 或 GPT,这是正常现象——Codex 客户端不知道自己被中间层拦截了,它以为自己还在和 OpenAI 通信。

正确的验证方式:

  • 去 Codex++ 管理工具查看「使用记录」,确认模型栏显示 deepseek-chat,来源是 Codex
  • 或者发一张图片给 Codex,DeepSeek V4 会报错说无法识别图片——这反而证明接入成功了,因为 GPT 是可以识图的

八、踩坑全汇总:90% 的报错都能解决

坑 1:启动无绿点,看不到第三方模型

原因:原版 Codex 未彻底关闭,后台进程残留

解决:任务栏彻底退出 Codex,重启 Codex++ 管理工具再启动。打开任务管理器确认无 Codex 残留进程。

坑 2:接口测试持续 502 报错

原因:上游协议选错,误选 OpenAI 私有 Responses API

解决:供应商配置中将协议切换为「Chat Completions」,国产主流大模型均采用该协议。

坑 3:测试提示「模型不存在」

原因:模型名称简写或拼写错误

解决:严格复制完整模型名,如 deepseek-chat,禁止简写 deepseek 或 deepseek-v4 这类名称。

坑 4:发消息一直 reconnecting

原因:WebSocket 代理未配置

解决:

  • 开启代理的 TUN 模式
  • 或在 .codex/.env 文件里配置本地代理端口:
HTTP_PROXY=http://127.0.0.1:你的端口

坑 5:搭配中转工具频繁崩溃、请求超时

原因:多工具冲突(EchoBird、CC Switch 叠加 Codex++)

解决:Codex++ v1.2.8 及以上版本已内置完善供应商管理,卸载其他中转工具,仅保留 Codex++ 即可稳定运行。

坑 6:切换中文后界面没变

原因:语言包未下载成功

解决:开启代理后重新切换一次语言,必要时完全退出软件再重启。

坑 7:Windows 打开白屏或无反应

解决:右键以管理员身份运行 Codex++。

坑 8:切换模型后对话记录消失

原因:登录方式切换(GPT 账号 vs API Key)导致会话存储在不同位置

解决:Codex++ v1.1.7 有「历史会话恢复」功能,可以找回。

坑 9:第二天接入报错,需要重新配置

原因:中间件服务重启后需要重新启动

解决:建议设置开机自启,或者养成每次使用前先打开 Codex++ 管理工具的习惯。

九、高阶技巧:提升 AI 工作效率

1. 多模型切换

对话框底部可快速切换已启用供应商。如需更换模型,回到管理工具选中目标模型点击「使用」,重启 Codex++ 生效

推荐策略:用 GPT-5.5 做规划和复杂推理,用 DeepSeek 执行简单的重复性任务,按任务复杂度分配模型。

2. 两大智能任务模式

模式 说明 适用场景
计划模式 AI 先输出完整执行方案,确认后再执行 需求模糊、容易跑偏的任务
追求目标 全自动闭环,自主规划、执行、自检结果 多步骤复杂工程需求

3. 三级权限管控

权限级别 说明 推荐程度
请求批准 仅限定文件夹操作,调用系统权限主动弹窗申请,安全性最高 ⭐⭐⭐ 日常推荐
替我审批 自动放行权限申请 ⭐⭐ 长时间批量任务
完全访问权限 可修改系统底层文件 ⚠️ 日常不推荐

4. 安装 Context Used Meter 插件

在脚本市场安装 Codex Context Used Meter,这个工具会在界面上显示当前上下文的使用量,帮你判断什么时候该开新对话。上下文超过 50% 就建议开新对话,避免 token 浪费。

十、功能限制说明(提前避坑)

接入国产模型后,有些功能会受限,提前了解避免配置完发现不对劲:

完全不可用的功能

功能 原因
Image Gen(AI 生图) 调用的是 GPT Image 模型,与接入的大模型无关,换模型后失效
Computer Use(操控电脑) 工具调用格式与国产模型不兼容
识图 / 多模态 DeepSeek V4 没有此能力,需换 Qwen-VL 或 MiniMax

降级可用的功能

功能 说明
Skills 和插件 需 Codex++ 解锁,部分插件仍不稳定
工具调用(读写文件、执行命令) 基本正常,偶有格式错误
上下文窗口 实际约 256K,不是宣传的 1M

完全正常的功能

代码编写、调试、重构、文件读写、项目管理、多轮对话、任务规划——这些是 Codex 的核心使用场景,接入国产模型后都可以正常工作。

十一、什么时候不建议接入?

接入 DeepSeek 之后,你用的还是 Codex 的框架,但大脑换成了 DeepSeek。Codex 的框架很强——沙盒环境、工具调用、上下文管理、任务并行——但模型能力本身的差距是真实存在的。

接入建议:

  • 如果你的主要需求是轻量代码问答、文字任务、简单脚本 → 接 DeepSeek 性价比极高,强烈推荐 推荐
  • 如果你需要识图、生图、Computer Use → 不要接,这些功能会直接失效 不推荐
  • 如果你在做复杂工程项目 → 建议先用 GPT 跑通,再用 DeepSeek 处理简单子任务 谨慎
  • 如果你的 GPT Plus 额度还够用 → 不用折腾,原生体验是最好的 😎

总结

Codex++ 的核心价值,是打破 Codex 对 OpenAI 账号与原生模型的绑定限制

国内开发者无需高额订阅、不用复杂代理中转,凭借国产大模型 API 低成本使用 Codex 强大的代码编写、文件处理能力。

整套流程总结为五步

  1. 下载安装 Codex 桌面端 + Codex++
  2. 汉化界面 → Settings → General → Chinese (China)
  3. 彻底退出 原版 Codex
  4. 配置国产模型 → 添加供应商 → 填写参数 → 选 Chat Completions 协议
  5. 通过 Codex++ 启动 → 验证绿点 → 开始使用

DeepSeek V4 Pro 的代码能力已经很强,在大多数日常任务上和 GPT-5.5 的差距没有想象中那么大。按照本文步骤操作,大约十分钟就能跑通。

如果配置过程中遇到报错、接口不通、模型加载失败等问题,欢迎在评论区留言,看到会逐一回复排查方案。

📎 相关链接汇总:

• Codex 官方下载:https://chatgpt.com/zh-Hans-CN/download/

• Codex++ GitHub:https://github.com/BigPizzaV3/CodexPlusPlus/releases/

• DeepSeek 开放平台:https://platform.deepseek.com/

• Agnes 官网:https://agnes-ai.com/

• 通义千问百炼平台:https://dashscope.console.aliyun.com/

• 智谱 AI 开放平台:https://open.bigmodel.cn/

小米顶尖模型 MiMo:https://platform.xiaomimimo.com?ref=PN8TSW

— END —

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐