Codex++ 是 AI 编程 Agent 的统一管理应用。它从 OpenAI Codex / ChatGPT 桌面应用起步，提供供应商切换、协议转换、会话管理和界面增强；现在也管理 Claude Code、Claude Desktop 与 Grok CLI，并提供跨 Agent 的 Computer Use 与子 Agent 协作。双击打开配置界面，再从界面启动各个应用。它不修改任何官方应用的安装文件。
交流与支持
遇到问题请通过 GitHub Issues 提交，附上系统、Codex++ 版本、复现步骤与已脱敏的日志。欢迎分享拓展、主题和使用经验。
感谢赞助商
感谢以下赞助商对项目的支持。服务范围、价格与活动以各平台官网说明为准。
想支持项目或展示品牌？联系维护者。
功能一览
| Agent | Codex++ 能做什么 |
|---|
| Codex 桌面版 | 供应商切换与协议转换、请求避震、会话管理、界面增强、多开、拓展与桌宠 |
| Claude Code | 供应商一键切换、接入 Computer Use |
| Claude Desktop | 增强版（中文界面、语音输入、Computer Use）、接入 Computer Use |
| Grok CLI | 模型与 API 端点配置 |
| DeepSeek Harness 等 | 接入 Computer Use、在 Codex 对话中作为子 Agent 调用 |
所有增强都能单独开关；关闭增强总开关后，供应商与启动管理照常可用。
看看它能做什么
概览：当前供应商、最近请求与健康检查，一屏看完
Computer Use：把 Codex 的桌面控制借给其他 Agent
给客户端点「接入」，重启后就能在 Claude Code、Claude Desktop、DeepSeek Harness 等里操作桌面和浏览器。目前仅支持 macOS。
请求日志与自动重试
Claude Code 与 Grok，也在同一个地方管
用量状态栏
Codex 多开
在 Codex 对话里，直接请其他 Agent 帮忙
对 Codex 说「让 DeepSeek 实现这个功能」，结果回到当前对话。配置见 子 Agent 协作指南。
模型选择器按供应商分组
拓展市场
认真工作，也可以有点趣味
Agent 桌宠：在 Codex 里放一只可拖动的桌宠，点击会压扁并播放音效；图片可从内置图库（Fluent Emoji，运行时联网拉取）挑选，也可填自己的 https 图片地址。桌宠类型也可以选「大肥鱼（DeepSeek 鲸鱼）」，即原版用量挂件：余额、价格 / 用量统计、泡泡编辑器与音效。在管理器「Agent 桌宠」页开启，目前支持 Codex，说明见 Agent 桌宠 与 大肥鱼。
**鲸鱼功能来源与鸣谢：**原始功能、完整界面引擎、鲸鱼角色及内置音效/动图来自 MeteorNOX/DeepSeek-Balance-Whale-Widget，本项目将其适配为 Codex++ 内置功能；Codex 桌面版技术路线另参考 Yang-huai406/Codex-Whale-Public。原始代码与素材声明见随项目保留的 LICENSE 和 PROVENANCE.md，素材不重新声明为本项目原创。
- 打开「Codex 增强 → 常用增强」，开启增强总开关与「原生 Fast 强制解锁」（默认关闭）。
- 在「供应商配置」中为该模型设置「Fast（priority）支持」并保存。
- 从 Codex++ 重启 Codex，在模型菜单中选择 ⚡ Fast。
实际可用性与计费由供应商决定。
快速上手
1. 下载安装包：前往 GitHub Releases。
| 你的设备 | 安装包 |
|---|
| Windows · x64 | CodexPlusPlus-*-windows-x64-setup.exe |
| macOS · Apple Silicon / Intel | CodexPlusPlus-*-macos-universal.dmg |
2. 打开 Codex++ 完成配置：确认官方 Codex / ChatGPT 桌面应用路径，选择供应商，按需开启增强；使用 Claude、Grok 相关功能时需安装对应客户端。
3. 点击「启动 Codex」：依赖注入的设置需在界面中重启 Codex 才生效。
新发布的 DMG 会保留一个隐藏的兼容壳，让 v1.7.x 的旧更新器可以自动替换两个旧 app；更新后首次启动会自动将兼容壳移到 ~/.codex-session-delete/legacy-migrations，Applications 中只保留 Codex++。v1.5/v1.6 的旧版本只会打开 DMG，请把其中可见的 Codex++.app 拖入「应用程序」替换一次；新版启动时同样会自动归档旧的 Codex++ 管理工具.app。原有配置与会话数据继续沿用。
Codex 供应商与模型
| 模式 | 适用场景 |
|---|
| 官方登录 | 使用 ChatGPT / Codex 官方账号。 |
| 官方登录 + API | 保留官方登录与插件入口，模型请求走兼容 API（不消耗官方额度）。 |
| 纯 API | 自定义 Base URL / Key，无需官方账号。 |
| 聚合供应商 | 故障转移：多个供应商之间失败切换与轮转。模型聚合：带 cpx-供应商ID/模型名 前缀的模型固定发往对应成员。 |
在模型列表中加窗口后缀，即可给每个模型设置自己的上下文窗口：
deepseek-v4-pro[1M]
your-model[200K]
another-model[128000]
API Key 只保存在本机，提交反馈前请隐藏密钥与认证信息。
常见问题
确认在 Codex++ 界面中点击「启动」打开官方应用。打开「安装维护」与「关于」页面，检查应用路径、启动状态和诊断日志。
先在供应商详情中运行模型测试或 Provider Doctor，确认协议、Base URL、Key 与模型匹配。纯 API 和官方登录 + API 使用不同的认证位置，不要手工复制两种模式的 auth.json。
接入后需要重启对应客户端才会加载工具；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 等商标或应用资源的权利。
