中文 | English
Codex++ is an external launcher and manager for the OpenAI Codex / ChatGPT desktop app. It uses the Chromium DevTools Protocol and a local helper for provider switching, protocol conversion, session management, and UI enhancements without modifying the official app's app.asar or installation files.
Download the latest installer from GitHub Releases:
- Windows:
CodexPlusPlus-*-windows-x64-setup.exe - macOS Intel:
CodexPlusPlus-*-macos-x64.dmg - macOS Apple Silicon:
CodexPlusPlus-*-macos-arm64.dmg
After installation, two entry points are available:
Codex++: silently starts the official desktop app with saved provider settings and enhancements.Codex++ Manager: manages providers, models, tools, sessions, enhancements, scripts, updates, and diagnostics.
For first-time setup, open the manager, verify the detected app path, configure a provider and optional enhancements, then launch through Codex++. The Windows installer creates Desktop and Start Menu shortcuts. The macOS DMG installs /Applications/Codex++.app and /Applications/Codex++ 管理工具.app.
JOJO Code | Official Codex++ Relay
The official Codex++ relay service, focused on stable access and cost-effective pricing. JOJO Code supports the full GPT-5.6 family, Fable 5, Sonnet 5, GPT-5.5, GPT-5.4, Claude Opus 4.8, Claude Opus 4.7, gpt-image-2, and more for daily development, team collaboration, and long-running project workflows.
| 🏆 Sponsor 🏆 | Introduction |
|---|---|
|
|
JOJO Code | Official Codex++ Relay Thanks to JOJO Code for sponsoring this project. JOJO Code is the official Codex++ relay service with cost-effective pricing and stable, easy-to-configure Codex API access. It supports the full GPT-5.6 family, Fable 5, Sonnet 5, GPT-5.5, GPT-5.4, Claude Opus 4.8, Claude Opus 4.7, gpt-image-2, and more for daily development, quick setup, team collaboration, and continuous use. |
|
AIGoCode Thanks to AIGoCode for sponsoring this project! AIGoCode is an all-in-one platform integrating the latest Claude Code, Codex, and Gemini models, providing stable, efficient, and cost-effective AI programming services. It offers flexible subscription plans, direct access in China, no extra network setup, and fast responses. AIGoCode provides a special benefit for CodexPlusPlus users: users who register through this link can receive an extra 10% bonus credit on their first recharge. |
|
APIKEY.FUN Thanks to APIKEY.FUN for sponsoring this project! APIKEY.FUN is an AI relay platform focused on open, stable, and cost-effective access to mainstream global models. It supports API relay services for Claude, OpenAI, Gemini, and other popular models, with prices as low as 7% of the official rate. Register through the dedicated link to receive up to a permanent 5% recharge discount. |
|
RunAPI Thanks to RunAPI for sponsoring this project! RunAPI is an efficient and stable OpenRouter alternative API platform. One API key can access OpenAI, Claude, Gemini, DeepSeek, Grok, and 150+ mainstream models at prices as low as 10% of the original rate, with seamless compatibility for tools such as Claude Code and OpenClaw. |
|
0029 Cloud Bridge | Codex API Relay Station (gpt5.5 gpt-image-2) Supports individual and enterprise access. Monthly plans and pay-as-you-go billing are available, with Pro/Plus account pools, stable site-wide APIs, and 24/7 technical support. |
|
Yiyun Technology Yiyun Technology provides payment and settlement products for AI aggregation businesses, including Jiuwu Yunshang and Yiyun Pay. It supports WeChat Pay, Alipay, UnionPay, and Cloud QuickPass channels with low rates, D1/D0 settlement, 24/7 technical support, dedicated WeCom service groups, and strong website protection for merchants. |
|
Sui Xiang AI Gateway Thanks to Sui Xiang AI Gateway for sponsoring this project! Sui Xiang AI Gateway is a reliable and efficient API relay service provider for Claude, Codex, Gemini, and more. It focuses on privacy, transparent service, fast support, no data resale, and no model dilution. New accounts can receive 0.5 CNY in daily check-in test credit, with 1:1 recharge credit, no subscription, and pay-as-you-go billing. |
|
BytePlus ModelArk | Dola Seed Thanks to Dola Seed for sponsoring this project! Dola Seed 2.0 is a full-modal general large model independently developed by ByteDance for the global market. Built on a unified multimodal architecture, it supports joint understanding and generation of text, images, audio, and video. It natively enables agent collaboration, strong reasoning, long-task execution, tool integration, and coding capabilities, and is readily accessible through the ModelArk platform. Register via this link to get 500,000 tokens of free inference quota per model. Mainland China developers can click here. |
|
Smallice | AI Relay Thanks to Smallice for sponsoring this project! Smallice is one key to all the language models worth calling: a unified endpoint that acts as a quiet foundation layer beneath your applications. Whether you call Claude, GPT, Gemini, or DeepSeek, the request shape stays consistent. Register through this link to get started. |
|
Baikewei AI Baikewei AI is an all-in-one large-model API platform for developers, teams, and AI tool users. It supports Claude, OpenAI, Gemini, Codex, and other mainstream model capabilities, with stable relay access, flexible billing, usage statistics, balance management, and APIs for Claude Code, Codex, image generation, automation scripts, and intelligent applications. New users can claim free credit and start integrating immediately. |
|
Sublyx | AI API Gateway Thanks to Sublyx for sponsoring this project! Sublyx is an AI API aggregation gateway for developers and teams. One API Key provides unified access to OpenAI, Claude, Gemini, and other leading model services through OpenAI-compatible and Anthropic Messages-compatible APIs. It works with Codex, Claude Code, Cherry Studio, the OpenAI SDK, and other common development tools. The platform provides a unified console, usage management, stable routes, and pay-as-you-go billing for individual development, team collaboration, and Agent workflows. Codex++ users who register through this link and use promo code CDXPP receive an additional $10 in usage credit. |
Join the Codex++ community (QQ group: 830629290) to report issues, share feedback, or suggest features.
WeChat: get the latest group QR code.
Telegram: https://t.me/CodexPlusPlus
Friendly link: LINUX DO
If Codex++ helps you, you can support its continued maintenance.
| Area | Capabilities |
|---|---|
| Provider configuration | Official login, official login plus API, pure API, and aggregate providers; Responses / Chat Completions; model tests, model discovery, Provider Doctor, cc-switch and deep-link imports |
| Models and context | Per-model context windows, auto-compact limits, model_catalog_json, shared config, and per-provider MCP, Skill, and Plugin selection |
| Session management | Local session scanning, bulk deletion, Markdown export, token usage history, Provider metadata sync, and backups |
| Codex enhancements | Plugin marketplace and model whitelist handling, session actions, paste fix, Chinese locale, fast startup, conversation width and scroll restore, service-tier controls, Goals, Stepwise, and image overlay |
| Development workflow | Project move, Upstream worktree creation, thread IDs, and Zed Remote project discovery and opening |
| Scripts and maintenance | User script installation and toggles, app detection, shortcuts, Watcher, environment cleanup, logs, diagnostics, health checks, and Release updates |
Every UI enhancement is independently configurable. Disabling the global enhancement switch still leaves Codex++ available as a provider and launch manager.
Official login, mixed API, and pure API are stored and switched separately:
| Mode | Purpose | Authentication boundary |
|---|---|---|
| Official login | Use only the official ChatGPT / Codex account | Removes custom providers and API keys while preserving official login state |
| Official login + API | Keep official account features and plugins while routing model requests to a compatible API | Stores the key as a provider bearer token, not in pure API auth.json |
| Pure API | Use a custom Base URL and key without an official account | Maintains independent config.toml and API-key auth without mixing official credentials |
| Aggregate provider | Route across multiple ordinary API providers | Supports failover, conversation round-robin, request round-robin, and weighted round-robin |
Each provider can configure Responses or Chat Completions, model lists, a test model, User-Agent, context windows, auto-compact limits, and enabled MCP servers, Skills, and Plugins. Chat Completions can be converted locally into the Responses protocol used by Codex.
Per-model windows accept values such as 1M, 200K, or plain integers. Codex++ generates a dedicated model_catalog_json for Codex.
Provider switching saves the current profile before applying the target profile. Real API keys remain local and should never be posted in logs, screenshots, or issues.
- Session delete, bulk delete, Markdown export, and project move actions.
- Plugin marketplace unlock, plugin auto-expand, and model whitelist handling.
- Plain-text paste, forced Chinese locale, startup acceleration, and native menu localization.
- Conversation width, scroll restoration, thread IDs, service-tier controls, and Goals.
- Stepwise suggestions with a separate API, model, item count, and timeout.
- Upstream worktrees, Zed Remote, custom image overlays, and user scripts.
Settings that depend on renderer injection generally require saving and restarting Codex++.
Codex++ publishes installers through GitHub Releases. Windows builds an NSIS installer, while macOS builds separate Intel x64 and Apple Silicon arm64 DMGs.
The manager's About page can check and start updates. When the silent launcher finds a new version, it opens the manager directly on the update prompt.
- Codex config:
~/.codex/config.toml - Codex auth state:
~/.codex/auth.json - Codex local database: prefers
~/.codex/sqlite/*.db, falls back to legacy~/.codex/state_5.sqlite - Codex++ state and logs:
~/.codex-session-delete/ - Provider Sync backups:
~/.codex/backups_state/provider-sync
Launch through the Codex++ entry instead of opening the official app directly. Check the detected app path, launch status, and diagnostic logs in the manager's Maintenance and About pages.
Run the model test or Provider Doctor from the provider detail page. Verify that the protocol, Base URL, key, and test model match. Pure API and official-login-plus-API use different authentication locations; do not manually copy auth.json between them.
Codex++ updates the remote branch first, then creates the worktree as if you ran:
git worktree add -b <new-branch> <worktree-path> upstream/<base-branch>The new worktree starts from the fresh remote tracking branch instead of the local HEAD used by the current session. If Codex++ cannot safely recognize the current Codex version's native worktree form, use the Codex++ menu entry and enter the repository path, branch name, worktree path, remote, and base branch manually.
Unsigned and unnotarized builds may be blocked by Gatekeeper. Allow the app in System Settings -> Privacy & Security. For formal distribution, configure Apple Developer ID signing and notarization.
Yes. Releases provide both macos-x64.dmg and macos-arm64.dmg. Intel Macs should use the x64 package, while Apple Silicon Macs should use the arm64 package.
cd apps/codex-plus-manager
npm ci
npm run check
npm run vite:build
cd ../..
cargo fmt --all -- --check
cargo test
cargo build --releaseProject structure:
apps/
codex-plus-launcher/ Silent launcher
codex-plus-manager/ Tauri manager
assets/inject/
renderer-inject.js Enhancement script injected into Codex
crates/
codex-plus-core/ Launch, injection, config, update, install, bridge
codex-plus-data/ Session data, export, Provider Sync
scripts/installer/
windows/CodexPlusPlus.nsi Windows NSIS installer
macos/package-dmg.sh macOS DMG packager
Copyright (C) 2026 BigPizzaV3
CodexPlusPlus is licensed under the GNU Affero General Public License v3.0, SPDX identifier AGPL-3.0-only. Modified versions that are distributed or offered to users over a network must provide the corresponding source code as required by AGPLv3.
The license covers CodexPlusPlus code only. It does not grant rights to OpenAI, ChatGPT, Codex trademarks, application assets, or other third-party content.
Codex++ depends on the official desktop app's page structure, CDP behavior, and local data formats. Official app updates may require injection updates. Keep backups before changing provider configuration or local session data.