Codex 是 OpenAI 官方的编程智能体桌面应用,补全、改 Bug、读项目、跑 Agent,体验确实出色。但用过的人都清楚它的几个痛点:
- 要么需要 ChatGPT 订阅,要么烧 OpenAI API,对个人开发者不够友好
- 需要海外账号、付费,还要解决网络问题
- 用 API Key 登录后,原生插件入口提示「需要登录 ChatGPT」,插件功能集体罢工
- 会话列表只能归档、不能真正删除
有没有办法——保留 Codex 这套丝滑的体验,但把底层模型换成自己想用的(比如国产大模型),顺手再把那些小毛病修了?
最近在 GitHub 上刷屏的Codex++(CodexPlusPlus)就是做这个的。一个开源项目,13.1k Star、800+ Fork,作者 BigPizzaV3。
Codex++ 是什么?
一句话:它是 Codex App 的「外部增强启动器 + 管理工具」。
最关键的一点,也是它能放心用的底气:它不修改 Codex App 的任何原始文件。不动 app.asar、不写入 DLL,而是通过一个外部启动器(launcher)拉起 Codex,再用 Chromium DevTools Protocol(CDP)把增强脚本「注入」进去。
这意味着:
- ✅ Codex 该更新更新,安装包还是干净的官方版
- ✅ 不喜欢了,删掉 Codex++ 即可,对 Codex 本体零污染
- ✅ 技术栈硬核:Rust 后端 + Tauri + React 管理面板,启动无需额外运行时,深色/浅色主题随便切
安装完你会得到两个入口:

- Codex++:静默启动器,平时点它来开 Codex
- Codex++ 管理工具:控制面板,所有配置在这里搞定
核心功能:让 Codex 接入国产大模型
这是最核心的功能——中转注入模式(Relay Injection)。
原理很直白:Codex 本质上是在调用一个「模型服务接口」。Codex++ 允许你把这个接口的地址(Base URL)和密钥(Key),替换成任意一个「OpenAI 兼容」的接口。
国产大模型——DeepSeek、Kimi(月之暗面)、GLM(智谱)、通义千问 Qwen——以及市面上各种聚合中转站,绝大多数都提供OpenAI 兼容接口。
一句话总结:Codex 的壳 + 国产模型的芯。编程体验还是那个 Codex,账单和模型却换成了你能 hold 住的。
配置会写进 ~/.codex/config.toml:
model_provider="CodexPlusPlus"
[model_providers.CodexPlusPlus]
name="CodexPlusPlus"
wire_api="responses"
requires_openai_auth=true
base_url="https://你的中转地址/v1"
experimental_bearer_token="sk-..."
在管理工具的「中转注入」页面,流程四步:
- 确认 ChatGPT 登录状态被识别到
- 添加一条或多条中转配置(填 Base URL 和 Key)
- 选中并「应用」
- 启动 Codex++,搞定
💡 避免踩坑:Codex 走的是 responses 协议(Responses API),而很多国产模型原生只提供 Chat Completions 接口。最省心的方式是选一个已经适配好 Codex 协议的兼容中转站来接国产模型。直连还是走中转,按自己的需求选。
不想折腾了想换回官方?在管理工具里清掉 API 模式,它会移除 OPENAI_API_KEY 相关配置、还原成官方 ChatGPT 登录。
实用增强功能
除了中转注入,Codex++ 还把 Codex 用 API Key 时的一堆痛点顺手修了:

- 解锁插件入口:API Key 登录后插件提示要登 ChatGPT?直接帮你解锁

- 真正的删除按钮:原生会话列表只能「归档」没法删,悬停时补上删除按钮

- Markdown 导出:会话一键导出 Markdown
- 项目移动 / Timeline:项目管理更顺手

- 菜单栏状态:新增 Codex++ 菜单项,后端状态、设置一目了然
- 用户脚本独立管理 / Provider 同步 / Zed 打开入口 / Upstream worktree 创建……进阶玩家的小工具一应俱全
- GitHub Release 自动更新,Windows / macOS 多架构都支持
注:走中转注入模式时,插件解锁这类操作就不需要了,按使用场景各取所需。
三步上手
第一步:下载安装

去 GitHub Releases 页按系统下载:
- Windows:
CodexPlusPlus-*-windows-x64-setup.exe - macOS(Intel):
CodexPlusPlus-*-macos-x64.dmg - macOS(Apple Silicon):
CodexPlusPlus-*-macos-arm64.dmg
第二步:配置

打开「Codex++ 管理工具」→ 概览,健康检查全绿就对了。
第三步:供应商配置

以智谱为例,配置参考:

特别注意上游协议:OpenAI 官方从 80 版本之后都是 Responses API,但智谱只支持 Chat Completions 方式,所以这里选择 Chat Completions,保存。
第四步:启动

以后用 Codex++ 入口启动 Codex 就行(别再点原版 Codex 了,不然增强不生效)。
启动后可以看到模型为 glm-5.1,也能正常回复了。

常见问题(FAQ)
- 菜单 / 增强没出现?确认你是用 Codex++ 入口启动的,而不是原版 Codex;可以看诊断日志
- 后端连不上?浏览器访问
http://127.0.0.1:57321/backend/status测一下;如果通但插件超时,重启或检查 CDP 桥接 / 脚本缓存日志 - macOS 提示「已损坏 / 无法打开」?未签名包会被 Gatekeeper 拦,对两个 .app 执行
sudo xattr -rd com.apple.quarantine即可 - Intel Mac 支持吗?支持,下 x64 版 DMG;Apple Silicon 下 arm64 版
相关数据都在本地:Codex 配置 ~/.codex/config.toml、登录态 ~/.codex/auth.json、本地库 ~/.codex/state_5.sqlite。
为什么能火到 13k Star?
说白了,它精准踩中了一群人的刚需:想用 Codex 这套顶级编程体验,但不想被 OpenAI 的账号、订阅和模型绑死。
「不改原始文件」的外挂式思路,让它既安全又可逆;中转注入让模型选择权重新回到用户手里;一堆增强又把日常痛点抹平。对国内开发者来说,「Codex 的体验 + 国产模型的成本」这个组合,确实太有吸引力了。
当然,作为依赖页面注入的外部工具,Codex App 大更新后页面结构变化,可能需要等作者更新注入脚本——这点心里有数就行。
温馨提示:本文基于项目公开 README 整理,仅作技术分享。请遵守 Codex / OpenAI 及各模型服务商的相关使用条款,理性选择中转服务,注意 API Key 安全。
项目地址:https://github.com/BigPizzaV3/CodexPlusPlus