開源專案
BigPizzaV3/CodexPlusPlus avatar
BigPizzaV3/CodexPlusPlus

Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器

CodexApp的增強工具,努力讓Codex更好用、更舒適一個CodexApp的增強工具,努力讓Codex網格更好用更舒適。

30,983 個 Star1,976 個 ForkRustAGPL-3.0
GitHub

秒懂

它是什麼?
一款透過 Chromium DevTools 協定與本機助手協同工作的外部啟動器和管理器,不修改官方應用檔案。
適合誰用?
README 涵蓋了提供者模式、工作階段管理、增強功能、資料位置和開發結構。Codex++ 以 AGPL-3.0 許可發布,且該許可僅涵蓋專案自身程式碼,不涉及 OpenAI 或其他第三方資產。
可以商用嗎?
可以,但條件嚴格。AGPL-3.0 是網路 copyleft 授權:如果別人透過網路使用你修改過的版本(例如作為託管服務),你必須以同一授權向他們提供原始碼。
還在維護嗎?
有在維護。儲存庫最近一次提交在 1 天前。
用什麼語言寫的?
主要是 Rust(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

Codex++ 是什麼

Codex++ 是 OpenAI Codex / ChatGPT 桌面應用的外部啟動器和管理器。它利用 Chromium DevTools 協定和本機助手來執行提供者切換、協定轉換、工作階段管理和介面增強,而無需觸碰官方應用的 app.asar 或安裝檔案。根據 README,該專案使用 Rust 編寫,管理器元件基於 Tauri 2.x。倉庫中繼資料顯示擁有 27,874 個星標和 1,779 個分支,但 README 本身並未描述專案的採用情況或使用者特徵。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 CodexPlusPlus 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 README.md,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第1章核對:請以本章提到的命令、檔案或設定鍵觀察 輸入格式,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

快速開始

README 指示使用者從 GitHub Releases 下載最新安裝程式。Windows 獲得名為 CodexPlusPlus-*-windows-x64-setup.exe 的 NSIS 安裝程式,macOS 則獲得單獨的 Intel(macos-x64)和 Apple Silicon(macos-arm64)DMG 檔案。安裝後出現兩個入口:Codex++ 靜默啟動帶有已儲存提供者設定和增強功能的官方桌面應用,而 Codex++ Manager 處理提供者、模型、工具、工作階段、增強功能、指令碼、更新和診斷。首次設定涉及開啟管理器、驗證偵測到的應用程式路徑、設定提供者和可選的增強功能,然後透過 Codex++ 啟動。Windows 安裝程式建立桌面和開始功能表捷徑;macOS DMG 安裝 /Applications/Codex++.app 和 /Applications/Codex++ 管理工具.app。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 README.md 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 main,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第2章核對:請以本章提到的命令、檔案或設定鍵觀察 輸出內容,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

提供者模式與協定處理

Codex++ 將提供者設定儲存為三種獨立模式:官方登入、官方登入加 API 和純 API。官方登入僅保留官方 ChatGPT / Codex 帳戶,並移除自訂提供者和 API 金鑰。官方登入加 API 保留官方帳戶功能和外掛,同時將模型請求路由到相容 API,金鑰作為提供者持有者權杖儲存,而非純 API 的 auth.json。純 API 使用自訂 Base URL 和金鑰,無需官方帳戶,維護獨立的 config.toml 和 API 金鑰認證。聚合提供者模式可跨多個普通 API 提供者路由,支援故障轉移、工作階段輪詢、請求輪詢和加權輪詢。每個提供者可以選擇 Responses 或 Chat Completions,Chat Completions 可本地轉換為 Codex 使用的 Responses 協定。README 指出,每個模型的上下文視窗接受諸如 1M、200K 或普通整數之類的值,並且 Codex++ 為 Codex 生成專用的 model_catalog_json。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 main 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 GitHub Releases,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第3章核對:請以本章提到的命令、檔案或設定鍵觀察 錯誤訊息,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

增強功能與工作階段管理

README 列出了多個領域的增強功能。工作階段管理包括本地工作階段掃描、批次刪除、Markdown 匯出、權杖使用歷史、提供者中繼資料同步和備份。Codex 增強包括外掛市場和白名單模型處理、工作階段操作、貼上修復、中文地區設定、快速啟動、對話寬度和捲動恢復、服務層級控制、Goals、Stepwise 和影像疊加。開發工作流程功能包括專案移動、Upstream 工作樹建立、執行緒 ID 和 Zed Remote 專案探索與開啟。指令碼和維護涵蓋使用者指令碼安裝與切換、應用程式偵測、捷徑、Watcher、環境清理、日誌、診斷、健康檢查和 Release 更新。README 指出每個介面增強都可獨立設定,停用全域增強開關仍可讓 Codex++ 作為提供者和啟動管理器使用。它還說明依賴渲染器注入的設定通常需要儲存並重啟 Codex++。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 GitHub Releases 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 CodexPlusPlus,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第4章核對:請以本章提到的命令、檔案或設定鍵觀察 權限變化,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

資料位置與更新

Codex++ 將其自身狀態和日誌儲存在 ~/.codex-session-delete/,同時從 ~/.codex/config.toml 讀取 Codex 設定,從 ~/.codex/auth.json 讀取認證狀態,並從 ~/.codex/sqlite/*.db(回退到舊版 ~/.codex/state_5.sqlite)讀取本地資料庫。提供者同步備份位於 ~/.codex/backups_state/provider-sync。更新透過 GitHub Releases 發布。管理器的「關於」頁面可以檢查和啟動更新,靜默啟動器在發現新版本時直接開啟管理器並顯示更新提示。README 未指定自動更新機制或發布節奏。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 CodexPlusPlus 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 README.md,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第5章核對:請以本章提到的命令、檔案或設定鍵觀察 版本差異,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

開發與專案結構

README 中的開發工作流程使用 npm 和 cargo。專案組織為 apps/codex-plus-launcher(靜默啟動器)、apps/codex-plus-manager(Tauri 管理器)、assets/inject/renderer-inject.js(增強指令碼)、crates/codex-plus-core(啟動、注入、設定、更新、安裝、橋接)、crates/codex-plus-data(工作階段資料、匯出、提供者同步)和 scripts/installer/(包含 Windows NSIS 指令碼和 macOS DMG 打包器)。README 展示了 npm ci、npm run check、npm run vite:build、cargo fmt --all -- --check、cargo test 和 cargo build --release 等命令,但未描述貢獻流程或程式碼風格指南。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 README.md 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 main,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第6章核對:請以本章提到的命令、檔案或設定鍵觀察 資料路徑,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

許可與相容性

根據 README 和許可摘錄,CodexPlusPlus 採用 GNU Affero 通用公共許可證 v3.0(SPDX: AGPL-3.0-only)。該許可要求,分發的修改版本或透過網路提供給使用者的修改版本必須提供相應的原始碼。README 明確表示該許可僅涵蓋 CodexPlusPlus 程式碼,不授予對 OpenAI、ChatGPT、Codex 商標、應用程式資產或其他第三方內容的權利。許可摘錄本身除了標準 AGPL 條款外,未提及安全狀況、支援或保固。README 還警告說,Codex++ 依賴官方桌面應用的頁面結構、CDP 行為和本地資料格式,因此官方應用更新可能需要注入更新,並建議在更改提供者設定或本地工作階段資料之前保留備份。 CodexPlusPlus 的 README 明確提供了 An enhanced tool for CodexApp, striving to make Codex better to use and more comfortable 一个CodexApp的增强工具,努力让Codex变得更好用更舒服.。閱讀 main 時,應把這個記號與實際命令、輸入、輸出或設定位置一起記錄。文件未說明的預設值、效能與相容性不在本文結論內;若要採用,請在隔離環境執行 GitHub Releases,觀察錯誤訊息、產出檔案與權限需求,再依 CodexPlusPlus 的版本說明檢查升級影響。這些觀察點屬於本專案,而非通用工具評估清單。

bigpizzav3-codexplusplus-deep-analysis 第7章核對:請以本章提到的命令、檔案或設定鍵觀察 快取結果,不要用其他專案的預設推測 Codex++:OpenAI Codex 桌面應用的外部啟動器與管理器 的行為。

編輯結論

README 涵蓋了提供者模式、工作階段管理、增強功能、資料位置和開發結構。Codex++ 以 AGPL-3.0 許可發布,且該許可僅涵蓋專案自身程式碼,不涉及 OpenAI 或其他第三方資產。官方應用的更新可能需要相應的注入更新。 適合願意依 CodexPlusPlus README 建立隔離試跑的人,不適合把倉庫描述當成生產保證。先執行 CodexPlusPlus 的專案命令並保存輸出,再核對 README.md 與 release 版本,確認權限、資料路徑和回滾方式。

官方來源

  1. Official README
  2. Project repository
  3. Release notes
社群筆記

社群筆記