Codex++ 是 AI 编程 Agent 的统一管理应用，构建于万物皆拓展的架构之上：界面、命令、模型能用的工具、agent 循环的钩子、发往模型的请求与回复，都能由拓展接管。不想写代码？在 Codex 对话里说一句「把发送按钮改成狗头」，agent 就会写出拓展、热重载并截图确认。
它还内置一个本地网关：Codex、Claude Code、Gemini CLI、OpenCode、Zed 等 50 多个 Agent 共用一份供应商池，按模型名选供应商，Key 冷却或供应商熔断时自动换上游，ChatGPT、GitHub Copilot、Cursor 等订阅也能登录进池。原来的直连模式（官方登录、官方 + API、纯 API、聚合供应商）完整保留，Codex 在「经网关」和「直连」之间一键切换。
此外还有会话管理、Codex 界面增强、Claude Desktop 增强版、跨 Agent 的 Computer Use 与子 Agent 协作。管理器是一个桌面程序的样子：侧栏切 Agent 和页面，顶部页签切分页，齿轮进设置目录；只用 Codex 或只想要增强功能，可以切换使用模式把用不到的页面藏起来。双击打开管理界面，再从界面启动各个应用；它不修改任何官方应用的安装文件。
交流与支持
遇到问题请通过 GitHub Issues 提交，附上系统、Codex++ 版本、复现步骤与已脱敏的日志。欢迎分享拓展、主题和使用经验。
感谢赞助商
感谢以下赞助商对项目的支持。服务范围、价格与活动以各平台官网说明为准。
想支持项目或展示品牌？联系维护者。
功能一览
| Agent | Codex++ 能做什么 |
|---|
| Codex 桌面版 | 经网关或直连接入供应商、协议转换、请求避震、会话管理、界面增强、多开、拓展与桌宠 |
| Claude Code | 经网关接入任意协议的供应商（Anthropic 请求在网关里转成 Chat / Responses）、接入 Computer Use |
| Claude Desktop | 增强版（中文界面、语音输入、Computer Use）、接入 Computer Use |
| Grok CLI | 经网关接入供应商池，可用 SuperGrok 订阅 |
| Gemini CLI、OpenCode、Zed、VS Code 等 50+ Agent | 经网关接入供应商池，Anthropic / Chat / Responses / Gemini 协议互转 |
| DeepSeek Harness 等 | 接入 Computer Use、在 Codex 对话中作为子 Agent 调用；dsh 插件可导入 Codex |
所有增强都能单独开关；关闭增强总开关后，供应商与启动管理照常可用。
看看它能做什么
万物皆拓展：说一句话，拓展就写好了
在管理器「拓展」页点「接入 Codex」，新开一个 Codex 对话直接说需求。agent 能查看 Codex 自己的页面结构，写出拓展包、热重载，再截图确认效果；拓展只写在你自己的拓展目录里，写入走 Codex 的工具审批。
拓展是一个带 codexpp.json 的文件夹，能做的不止改界面：
| 能力 | 说明 |
|---|
| 界面插槽与页面 | 输入框上方、对话区、侧栏、标题栏插槽；页面、菜单项、会话行操作 |
| 斜杠命令与输入区按钮 | 输入 / 时提示拓展命令并可补全；发送按钮旁加图标按钮 |
| 消息操作与侧边面板 | 每条消息下加按钮或内容；右侧面板 |
| 给模型加工具 | 清单里声明工具，经 Codex++ 拓展 MCP 提供给模型 |
| Codex 钩子与工具管道 | 工具前后、回合结束等钩子；执行前改参数、代为执行、改写结果 |
| 网关中间件 | 请求发往上游前改写、响应流改写、失败重试 |
| 常驻后台与服务 | 后台进程；拓展间按名字提供和调用服务，可跨进程 |
| 会话、配置与多语言 | 只读查询与订阅会话；配置项自动生成设置表单 |
完整接口见 拓展开发指南。
网关总览：50 多个 Agent，一份供应商池
供应商池：加一次，所有 Agent 都能用
添加供应商时自动拉模型列表、按公开价格表填价格；中转站（sub2api / new-api）自动识别倍率与余额，订阅账号显示剩余额度。每家可以按模型设置价格、上下文窗口、思考等级和独立代理。
路由：多家都有的模型，怎么分由你定
裸模型名发给池里提供它的供应商，<供应商>/<模型> 只发给那一家，group/<组> 走自建的组。多家都有的模型自动成组；组可选依次、轮换、按权重、额度优先、速度优先或手动，出错按顺序换下一家。
Agent 接入：开关一拨就接上
给 Agent 打开开关就经网关接入，选它默认用哪个模型；Claude Code 还能分别指定 opus / sonnet / haiku 用哪个模型。接入前会存档 Agent 的配置文件，断开时只还原网关改过的那几项。
用量与请求日志
「统计」按天看费用、token、缓存与调用，按 Agent、供应商或模型拆开；「请求」列出每条请求的状态、自动重试、首字耗时、token、缓存与估算费用，失败的直接显示原因。
Computer Use：把 Codex 的桌面控制借给其他 Agent
给客户端点「接入」，重启后就能在 Claude Code、Claude Desktop、DeepSeek Harness 等里操作桌面和浏览器。目前仅支持 macOS。
Codex 增强、Claude 增强版、会话与缓存清理
用量状态栏
Codex 多开
每个供应商身份一个隔离的 Codex 实例，配置、会话和用户数据目录互不干扰，可单独重启或结束。
在 Codex 对话里，直接请其他 Agent 帮忙
对 Codex 说「让 DeepSeek 实现这个功能」，结果回到当前对话；同一 Agent 可以并发执行多个任务，超出上限自动排队。配置见 子 Agent 协作指南。
模型选择器按供应商分组
Codex 里的拓展页
不离开 Codex 也能浏览、安装和启停拓展。
认真工作，也可以有点趣味
Agent 桌宠：在 Codex 里放一只可拖动的桌宠，点击会压扁并播放音效；图片可从内置图库（Fluent Emoji，运行时联网拉取）挑选，也可填自己的 https 图片地址，音效可导入自定义音频。桌宠类型也可以选「大肥鱼（DeepSeek 鲸鱼）」，即原版用量挂件：余额、价格 / 用量统计、泡泡编辑器与音效。在「万物皆拓展 → 本地拓展」里桌宠那一行点「设置」开启，目前支持 Codex，说明见 Agent 桌宠 与 大肥鱼。
**鲸鱼功能来源与鸣谢：**原始功能、完整界面引擎、鲸鱼角色及内置音效/动图来自 MeteorNOX/DeepSeek-Balance-Whale-Widget，本项目将其适配为 Codex++ 内置功能；Codex 桌面版技术路线另参考 Yang-huai406/Codex-Whale-Public。原始代码与素材声明见随项目保留的 LICENSE 和 PROVENANCE.md，素材不重新声明为本项目原创。
- 打开「Codex → 内置拓展」，开启顶部的「启用内置拓展」总开关与「原生 Fast 强制解锁」（默认关闭）。
- 直连模式在「Codex → 连接与供应商」中为该模型设置「Fast（priority）支持」并保存；网关模式下模型组里每个成员都支持 Fast 时，选这个组也能开 Fast。
- 从 Codex++ 重启 Codex，在模型菜单中选择 ⚡ Fast。
实际可用性与计费由供应商决定。
快速上手
1. 下载安装包：前往 GitHub Releases。
| 你的设备 | 安装包 |
|---|
| Windows · x64 | CodexPlusPlus-*-windows-x64-setup.exe |
| macOS · Apple Silicon / Intel | CodexPlusPlus-*-macos-universal.dmg |
2. 添加供应商：打开「网关 → 供应商池」，点「添加供应商」：填 API Key、登录 ChatGPT / GitHub Copilot / SuperGrok 订阅，或从直连模式、OpenCode 一次导入多家。添加时自动拉模型列表并填好价格。
3. 接入 Agent：打开「网关 → Agent 接入」，给要用的 Agent 打开开关并选默认模型。Claude Code、Grok 接入后照常在终端里用。
4. 启动 Codex：点 Codex 页右上角的「启动 Codex」或侧栏 Codex 行的启动按钮。依赖注入的设置（大部分增强、Fast 解锁等）改完后需从 Codex++ 重启 Codex 才生效。
不想用网关？直连模式照旧：在「Codex → 连接与供应商」顶部把「连接方式」切到「直连」，选供应商后启动即可。完整步骤见官网 使用教程。
新发布的 DMG 会保留一个隐藏的兼容壳，让 v1.7.x 的旧更新器可以自动替换两个旧 app；更新后首次启动会自动将兼容壳移到 ~/.codex-session-delete/legacy-migrations，Applications 中只保留 Codex++。v1.5/v1.6 的旧版本只会打开 DMG，请把其中可见的 Codex++.app 拖入「应用程序」替换一次；新版启动时同样会自动归档旧的 Codex++ 管理工具.app。原有配置与会话数据继续沿用。
网关与直连
| 模式 | 适用场景 |
|---|
| 网关（推荐） | Codex、Claude Code、Grok 共用一份供应商池；按模型名路由、多 Key 轮换、出错换下一家。只在 Codex++ 运行时可用。 |
| 直连 · 官方登录 | 使用 ChatGPT / Codex 官方账号。 |
| 直连 · 官方登录 + API | 保留官方登录与插件入口，模型请求走兼容 API（不消耗官方额度）。 |
| 直连 · 纯 API | 自定义 Base URL / Key，无需官方账号。 |
| 直连 · 聚合供应商 | 故障转移：多个供应商之间失败切换与轮转。模型聚合：带 cpx-供应商ID/模型名 前缀的模型固定发往对应成员。 |
Codex 用哪种，在「Codex → 连接与供应商」顶部的「连接方式」里一键切换；直连供应商也能一键加进网关的供应商池。
网关里的模型名有三种写法：
| 写法 | 发往 |
|---|
deepseek-v4-pro | 池里提供这个模型的供应商；多家都有时自动成组，出错按顺序换下一家 |
deepseek/deepseek-v4-pro | 只发给这一家 |
group/coding | 自建的模型组，按组的路由方式选成员 |
上下文窗口按模型设置：网关在供应商详情里按模型填（可按公开资料一键填），路由时请求比某家窗口还长，这家排到最后再试；直连模式在模型列表里加窗口后缀：
deepseek-v4-pro[1M]
your-model[200K]
another-model[128000]
API Key 只保存在本机，界面里只显示打码后的样子；提交反馈前请隐藏密钥与认证信息。
常见问题
精选与官方拓展经 Codex++ 审核，安装锁定到审核过的那次提交。社区拓展未经审核，作者可以在新版本里加入任意代码：安装前会列出它声明的全部能力（后台进程、钩子、网关中间件、模型工具、路由、页面脚本），装完默认不启用，请只安装你信任的作者的拓展。
增强脚本只挂载到从 Codex++ 启动的官方应用上。自己从程序坞或开始菜单打开的 Codex，侧栏 Codex 行会提示「未挂载」，这时它的按钮变成「重启并挂载」，点一下即可。仍然没有时，到「设置 → Codex」（含安装维护）和「设置 → 日志与诊断」检查应用路径、启动状态和诊断日志。macOS 上也可以在「设置 → Codex」里打开「自动接管官方 App」，自己双击启动官方 App 时由 Codex++ 接管。
网关模式先在供应商池详情里点「测试」：选模型（和 Key）发一条短请求，会显示状态码、首字耗时和上游错误原文；「用量 → 请求」里失败的请求也会直接显示原因。直连模式在供应商详情中运行模型测试或 Provider Doctor，确认协议、Base URL、Key 与模型匹配；纯 API 和官方登录 + API 使用不同的认证位置，不要手工复制两种模式的 auth.json。
接入网关的 Agent 一直指着本机网关，网关只在 Codex++ 运行时可用，再打开 Codex++ 就恢复。想在退出后用回直连，可在「设置 → 网关」里打开「退出 Codex++ 时恢复直连」（默认关闭）；安装更新前总会先切回直连。
接入后需要重启对应客户端才会加载工具；Claude Desktop 退出时会重写自己的配置，建议先完全退出再接入。仍然没有时，在「Computer Use」页的「高级」卡里核对客户端实际读取的配置目录，必要时登记自定义路径；并确认已在系统设置里给 ChatGPT 授予辅助功能与屏幕录制权限。
可以分别关闭，也可以关闭增强总开关。Codex++ 依赖官方桌面应用的页面结构、CDP 和本地数据格式；官方应用更新后，部分功能可能需要跟随适配。修改供应商配置或会话数据前，请保留备份。
设置了 CODEX_HOME 时，Codex 主目录以该变量为准；否则使用 ~/.codex。
| 数据 | 位置 |
|---|
| Codex 配置与登录状态 | ~/.codex/config.toml、~/.codex/auth.json |
| 本地数据库 | 优先 ~/.codex/sqlite/*.db，旧版回退 ~/.codex/state_5.sqlite |
| Codex++ 状态与日志 | ~/.codex-session-delete/ |
| Provider 同步备份 | ~/.codex/backups_state/provider-sync |
一起把「++」做得更好
欢迎修复问题、完善文档、开发拓展，或分享你的使用建议。感谢每一位贡献者，也感谢帮助定位问题、测试版本和支持项目的人。
前端位于 apps/codex-plus-manager，核心 Rust 库位于 crates/codex-plus-core，数据层位于 crates/codex-plus-data，界面注入脚本位于 assets/inject。
# 前端检查（先在 apps/codex-plus-manager 安装项目依赖）
cd apps/codex-plus-manager
npm ci
npm run check
npm run vite:build
# Rust 检查（回到仓库根目录）
cd ../..
cargo fmt --all -- --check
cargo test
cargo build --release
修改 renderer 注入分片后，运行 node scripts/assemble-renderer-inject.mjs 重新组装产物。
Star History
如果 Codex++ 对你有帮助，欢迎 点一颗 Star。
CodexPlusPlus 的修改与分发、通过网络提供修改后版本的源代码义务，以 GNU AGPL v3.0 为准。许可证覆盖本项目自身代码，第三方素材遵循各自声明；不授予 OpenAI、ChatGPT、Codex、Anthropic、Claude、xAI、Grok 等商标或应用资源的权利。
