yynxxxxx/Codex-X

项目介绍

Codex-X 是一个基于 Tauri 2 的桌面应用，面向同时使用 OpenAI Codex 桌面端/CLI 与多个第三方 API、多套提示词、Skills 和 MCP 的用户。它把原本分散在 config.toml、auth.json 和提示词文件里的操作收进统一界面：带分类和开关的提示词模板库、可命名的官方登录与第三方供应商、本地会话的搜索/分组/删除、Skills 与 MCP 的启用与禁用，以及 TOML 和 Auth 的实时查看。用量统计支持按日期和模型筛选。

提示词注入有「保留原提示词」和「替换原提示词」两种写入方式，每次启用或禁用前都会自动备份。会话可以检查是否与当前供应商/模型一致，并同步到当前配置，不改动聊天内容。

快速使用

从 GitHub Releases 下载安装包：macOS 提供 Apple Silicon 与 Intel 的 .dmg，Windows 提供 .msi 和便携版 .zip，Linux 提供 .deb/.rpm/.AppImage。启动后通过侧边导航进入提示词中心、供应商页、会话或 Skills/MCP 管理。应用默认读取 ~/.codex/config.toml 与 ~/.codex/auth.json，自身数据库位于 ~/.codexx/codexx.db。

从源码开发需先安装 pnpm：

pnpm install
pnpm dev

构建桌面端：

pnpm --dir apps/desktop tauri build

配置项

三个环境变量可重定向数据来源：CODEX_HOME 指定 Codex 配置目录，CODEXX_HOME 指定 Codex-X 自身数据目录，CC_SWITCH_HOME 指定 cc-switch 目录用于导入供应商。供应商编辑支持 Base URL、API Key、模型、上游协议和 Headers，本地路由覆盖 Responses、Chat Completions、Claude Messages 和 Gemini 接口，细节见供应商协议说明。

使用约束

• 会话删除是永久的，会连带删除派生子会话；操作前应先关闭仍在使用这些会话的 Codex 窗口或 CLI。
• 「开启 1M 上下文窗口」选项仅在所选模型支持时生效。
• macOS 的 DMG 未签名且未公证，Gatekeeper 可能提示「软件已损坏」；README 建议使用 Developer ID 签名并 notarize，本地测试时才提供 xattr 移除 quarantine 属性。
• Windows 便携版只能手动更新，应用内更新仅限 MSI 安装版。
• Windows 上的 WSL 会话仅支持只读查看和导出，限制见 WSL 会话说明。
• 许可证为 MIT。

HotRepo 点评

该项目在 2026 年 9 月 19 日至 22 日的四个日榜快照中分别新增 64、32、79、50 星，随后于 11 月 15 日出现在 Rust 日榜第 7 位，当天总星数 4,525、新增 68 星；尚未记录到全语言日榜名次。这一增长节奏与一款面向现有 Codex 用户、通过社区传播的工具有关，README 中也致谢了 LINUX DO 论坛的反馈。对潜在用户来说值得注意的是：项目内置了一批以「破甲」人格和逆向技能为核心的提示词模板，且主要交付物是未签名的桌面安装包，因此信任问题更多在于二进制来源，而非功能本身。