Codex-X：把 Codex 的提示词、Provider 与会话集中到桌面端

给同时用Codex桌面端和CLI的人，把Prompt、Provider、会话与MCP集中到一个界面。

GitHub yynxxxxx/Codex-X 更新 2026-09-20 分支 main 星标 3.4K 分叉 446

Tauri 2 React 18 Rust Codex CLI SQLite macOS/Windows/Linux

🧭 决策指南

适合，如果你

你同时维护Codex桌面端、Codex CLI和多个第三方API Provider。
README“Codex-X是什么”和“Provider / API”章节说明可统一管理官方登录、第三方供应商并一键切换。
你需要把Markdown Prompt按破甲/逆向、软件开发、写作辅助分类维护。
README“可视化提示词注入中心”列出分类、Markdown导入、自定义编辑和启用/禁用功能。
你要从cc-switch迁移供应商，并测试连接和可用模型。
README“Provider / API：添加、检测、获取模型、随时切换”明确支持cc-switch导入、连接检测和模型获取。
你需要在macOS、Windows或Linux上管理Skills、MCP和Codex配置文件。
README“Skills / MCP管理”“TOML与官方Auth管理”和“跨平台桌面软件”章节列出相关功能及安装包。

不适合，如果你

你需要删除后仍能恢复Codex会话。
README“会话管理”警告永久删除不可恢复，并会从Codex自身存储中删除会话及派生子会话。
你的模型不支持1M上下文窗口，却希望开启该选项后自动获得1M上下文。
README“配置与登录”明确写明开启1M上下文窗口需模型支持。
你要求macOS安装包必须已签名和公证。
README“桌面端安装说明”说明未签名/未公证DMG可能触发Gatekeeper提示，并将签名和notarize列为最佳方式。
你只想安装一个命令行工具，不需要Tauri 2桌面界面。
README将Codex-X定义为跨平台桌面工具，并提供Tauri 2、桌面安装包和可视化管理页面。

前置条件

开发运行需要执行README中的“pnpm install”和“pnpm dev”。
默认读取Codex配置目录“~/.codex/config.toml”和“~/.codex/auth.json”。
可通过“CODEX_HOME=/path/to/.codex”指定Codex配置目录。
macOS提供Apple Silicon和Intel的“.dmg”，Windows提供“.msi”和“.zip”，Linux提供“.deb”、“.rpm”和“.AppImage”。
需要模型支持时才能启用“1M上下文窗口”。

第一步命令（README 原文）

pnpm install

要注意

删除会话前要关闭仍使用它们的Codex窗口或CLI。
README“会话管理”中的CAUTION说明永久删除不可恢复，并要求删除前关闭相关Codex窗口或CLI。
未签名DMG在macOS上可能显示“软件已损坏”。
README“桌面端安装说明”给出Gatekeeper说明及xattr命令。
启用Provider后，新建或重新打开Codex会话才会使用新中转。
README“Provider / API”说明不需要重启整个Codex客户端，但需要新建或重新打开会话。
替换原提示词会完整切换指令入口，不是追加已有规则。
README“可视化提示词注入中心”区分“保留原提示词”和“替换原提示词”两种模式。

材料未说明

README未说明API Key、auth.json和config.toml在本地数据库中的加密或访问控制方式。
README未说明支持的Codex桌面端和Codex CLI具体版本范围。
README未说明从cc-switch导入时对失效API Key或敏感字段的处理细节。
README未说明应用内自动更新的签名校验、回滚机制和更新包来源验证方式。
README未说明SQLite数据库迁移、损坏恢复和跨设备同步方案。
README未说明Linux不同发行版及桌面环境对Tauri 2安装包的兼容范围。

💡 深度解析

不适合我需要给多人统一分发 Codex Provider 和 Skills，并要求权限管理、操作审计、集中密钥托管和多人协作；Codex-X 能否作为团队级控制台？

适合读者：需要多人共享配置、集中管理 API Key、审计操作并在企业环境中统一分发 Codex 配置的技术团队负责人

不适合直接作为团队级控制台，因为项目定位是单机本地管理工具，而不是集中式治理平台。

项目洞察明确指出，README 未显示权限管理、集中配置分发、审计、多用户协作或企业级密钥托管能力。
README 的“配置路径”使用本机目录 ~/.codex、~/.codexx/codexx.db，并通过 CODEX_HOME、CODEXX_HOME 和 CC_SWITCH_HOME切换本地数据位置。
Provider 配置包含 API Key，Skills、MCP 和提示词也由本机界面直接导入、启停或写入配置；这不是团队审批或集中策略系统。
自动备份只是在重要写入前创建本地备份，不能替代密钥托管、审计日志和灾备机制。

它可以作为每位成员的个人工作台，但团队仍需另建密钥托管、配置审批、版本控制和操作审计体系。

项目洞察「usage_limitations」：主要面向单机本地使用，README 未显示权限管理、集中配置分发、审计、多用户协作或企业级密钥托管能力
README「配置路径」：`~/.codex/config.toml`、`~/.codex/auth.json`、`~/.codexx/codexx.db`
README「配置路径」：支持 `CODEX_HOME`、`CODEXX_HOME` 和 `CC_SWITCH_HOME`
项目洞察「best_practices」：团队需另行建设密钥托管、配置审批、版本控制和操作审计机制

材料未说明：README 未说明是否存在远程同步、组织账户、RBAC、审计日志或集中策略接口。；README 未说明本地数据库和备份文件是否支持加密或企业密钥托管。

适合我长期使用 Codex CLI，本地会话已经按多个项目路径积累，需要按标题、项目路径、供应商或 ID 查找，并批量删除某些项目的历史会话；Codex-X 是否适合这项整理工作？

适合读者：长期积累大量本地 Codex 会话、按项目路径整理记录，并需要批量清理已关闭项目的 Codex CLI 用户

适合，因为 README 明确提供按项目整理、状态检查和项目级批量删除能力；但删除部分是永久性的，不能当作普通列表清理。

“会话管理”支持按标题、项目路径、供应商或 ID 搜索，也能按项目路径分组查看长期积累的会话。
可以检查会话是否与当前 Provider / Model 一致，并在需要时同步到当前供应商配置，且不修改聊天内容。
删除支持单选、多选和项目级选择，会连同对应的派生子会话从 Codex 存储中删除。
README 的警告要求删除前关闭仍在使用这些会话的 Codex 窗口或 CLI，并在确认窗口核对列表；删除不可恢复。

因此它适合有明确项目边界的本地清理，但 README 没有说明是否提供回收站、导出功能或跨设备会话同步。

README「会话管理：同步、检查与永久删除」：按标题、项目路径、供应商或 ID 搜索，按项目路径分组
README「会话管理」：检查会话与当前 Provider / 模型是否一致，并可同步到当前供应商配置
README「精确删除」：支持单选、多选和项目级永久删除，并删除派生子会话
README 警告：永久删除不可恢复，删除前先关闭仍在使用会话的 Codex 窗口或 CLI

材料未说明：README 未说明会话索引的扫描范围、刷新机制和超大规模会话库的性能。；README 未说明是否支持会话导出、回收站或删除前自动归档。

适合我同时使用 Codex 桌面端和 CLI，需要保存多个官方登录态、第三方 API、Base URL、Model 和 Wire API，并经常切换当前供应商；Codex-X 是否适合我的本地配置管理？

适合读者：同时使用 Codex 桌面端和 Codex CLI、还要在 OpenAI 官方登录与多个第三方 API 供应商之间切换的开发者

适合，因为它正是为 Codex 多配置和 Provider 切换设计的本地管理层。

README 的“Provider / API”支持保存多个可命名的官方 Codex 登录配置和第三方供应商，并可复制、切换、连接检测和获取模型。
编辑页覆盖 Base URL、API Key、Model、Wire API 以及完整 TOML，能处理比单一环境变量更复杂的配置。
从 cc-switch 导入时会区分新增、更新、合并和跳过，相同 URL + Key 不重复显示。
启用第三方供应商后，新建或重新打开 Codex 会话即可使用，不需要重启整个 Codex 客户端。

但它修改的是实际的 config.toml 和 auth.json；README 没有承诺不同 Codex 版本的长期格式兼容，也没有说明第三方供应商对所有 Codex 能力的兼容程度。

README「Provider / API：添加、检测、获取模型、随时切换」：支持多个可命名的官方 Codex 登录配置与第三方供应商
README「Provider / API」：支持 Base URL、API Key、Model、Wire API 和完整 TOML
README「Provider / API」：从 cc-switch 导入时自动区分新增、更新、合并与跳过
README「Provider / API」：新建或重新打开 Codex 会话即可使用新的中转，不需要重启整个 Codex 客户端

pnpm install

材料未说明：README 未说明支持哪些具体 Codex 版本及其配置格式兼容范围。；README 未说明每个第三方 Wire API 对工具调用、流式输出或其他 Codex 能力的兼容边界。

视情况我主要做 Android APK、Windows EXE/DLL 和 Web/API 协议逆向，希望安装 ZIP Skills、启停 MCP，并使用 GPT-5.5 / unrestricted jeli 提示词导航；Codex-X 是否适合我的工作流？

适合读者：进行 Android APK、Windows EXE/DLL 和 Web/API 协议逆向的 CTF 研究者，需要通过 Skills、MCP 和提示词导航组织 Codex 工作流

视情况，功能形态很匹配逆向和 CTF 工作流，但是否适合取决于 Skills、MCP 来源以及研究是否处于合法授权范围内。

README 的“逆向 Skills 导航”覆盖 Android APK、Windows EXE / DLL、Web / API / 协议逆向，并提供 Skill 用途、来源地址、安装方式和推荐流程。
“Skills / MCP”页面支持查看、导入、ZIP 安装 Skill，逐项启用/禁用并检查更新；MCP 导入前还能预览现有 Server。
提示词库包含 gpt5.4-unrestricted.md、gpt5.5-jeli.md 和“海鸥3.0破甲.md”，覆盖 CTF、逆向、内存和协议任务路由。
但项目声明仅用于学习、研究和交流，禁止攻击或侵害他人权益；远程 GitHub 模板、Skills 和 MCP 也可能带来供应链与凭据风险。

因此，授权实验室或个人靶场较匹配；未授权目标、生产系统或高合规环境不应直接采用。

README「逆向 Skills 导航」：覆盖 Android APK、Windows EXE / DLL、Web / API / 协议逆向
README「Skills / MCP 管理」：支持 ZIP 安装 Skill、逐项启用/禁用、更新检查和 MCP 导入前预览
README「可视化提示词注入中心」：`gpt5.4-unrestricted.md`、`gpt5.5-jeli.md`、`海鸥3.0破甲.md`
README「使用声明」：仅用于学习、研究与交流，禁止攻击、侵害他人权益或违法用途

材料未说明：README 未逐一审计导航中第三方 Skills、MCP Server 或远程提示词的代码和数据处理行为。；README 未说明逆向工具链、调试器或 APK/PE 分析环境是否由 Codex-X 提供。

适合我维护 GPT-5.4 / Codex CLI、GPT-5.5 和 gpt5.6-sol 的提示词，还要在软件开发、代码审查、写作和逆向任务间切换；Codex-X 能否替代我手动编辑 Markdown 和指令文件？

适合读者：维护 GPT-5.4 / Codex CLI、GPT-5.5 和 gpt5.6-sol 提示词，并在软件开发、代码审查与逆向任务间切换的高级 Codex 用户

适合，尤其适合把多套 Markdown 提示词变成可分类、可启停的本地模板库，但不应把模型兼容性理解成项目已经验证过。

README“可视化提示词注入中心”列出 gpt5.4-unrestricted.md、gpt5.5-unrestricted.md、gpt5.5-jeli.md 和 gpt-5.6-sol-unrestricted.md，并覆盖 coding、CTF、安全研究和逆向流程。
另有 software-development-maintainer.md、software-development-debugging.md、software-development-code-review.md 以及写作模板，适合在任务类型间切换。
模板支持 Markdown 导入、分类、说明编辑、独立启用/禁用、GitHub 同步和本地缓存。
“保留原提示词”只追加 Codex-X 内容，“替换原提示词”则切换主要指令入口；每次启用或禁用前会自动备份。

需要注意，1M 上下文窗口只有底层模型支持时才有意义；README 没有保证这些提示词在每个 Provider 或模型上产生相同效果。

README「可视化提示词注入中心」：列出 `gpt5.4-unrestricted.md`、`gpt5.5-unrestricted.md`、`gpt5.5-jeli.md`、`gpt-5.6-sol-unrestricted.md`
README「可视化提示词注入中心」：支持导入 Markdown、分类、GitHub 同步、本地缓存和独立启用/禁用
README「启用方式切换」：支持“保留原提示词”和“替换原提示词”
README「配置与登录」：开启 1M 上下文窗口需模型支持

pnpm install

材料未说明：README 未说明不同模型对同一提示词的实际效果差异。；README 未说明启用多个模板时的冲突检测、优先级规则或最大指令文件长度。

视情况我在 macOS Apple Silicon 和没有安装权限的 Windows 环境之间工作，需要使用 Windows Portable，并希望安装版支持应用内更新；Codex-X 的跨平台交付是否满足这个约束？

适合读者：在 macOS Apple Silicon 和 Windows Portable 之间切换的个人开发者，不能依赖管理员权限，并希望应用内更新 Codex-X

视情况，平台包覆盖和更新能力符合你的设备范围，但 Windows Portable 与安装版的更新方式不同，macOS 还存在未签名 DMG 的 Gatekeeper 障碍。

README“跨平台使用”提供 macOS Apple Silicon .dmg、Windows .msi、Windows Portable .zip，因此两类系统都有对应发布物。
安装版支持在应用内下载、校验并安装更新；README 明确说明 Windows 便携版继续使用手动下载，不享受该更新路径。
macOS 未签名或未公证 DMG 可能被 Gatekeeper 标记为损坏，文档给出的本地测试处理命令是移除 quarantine 属性。
项目数据显示最新版本为 v0.3.20、共 5 个版本，足以证明已有发布，但不足以证明长期跨平台兼容性。

如果 Windows 必须免安装，应接受手动更新；如果组织禁止移除 quarantine 或运行未公证应用，macOS 端则不满足约束。

README「跨平台使用」：macOS Apple Silicon `.dmg`、Windows `.msi`、Windows Portable `.zip`
README「跨平台使用」：安装版可在应用内直接下载、校验并安装更新，便携版继续手动下载
README「桌面端安装说明」：未签名 / 未公证 DMG 可能被 macOS Gatekeeper 标记为损坏
项目核心数据：latest_release 为 v0.3.20，release_count 为 5

xattr -dr com.apple.quarantine /Applications/Codex-X.app

材料未说明：README 未说明 Windows Portable 是否需要写入管理员受限目录或注册系统级组件。；README 未说明应用内更新是否支持跨大版本回滚、离线更新或企业代理网络。

✨ 核心亮点

内置5套Prompt，并可同步GitHub模板
Provider支持检测、模型获取与cc-switch导入
Skills、MCP、config.toml和auth.json集中管理
覆盖macOS、Windows与Linux安装包

🔧 工程化

用可视化界面管理Prompt分类、Markdown导入与启用状态
集中切换官方Codex登录、第三方API和模型配置
按项目路径搜索、同步、检查和删除Codex会话
基于Tauri 2、React 18、Rust和SQLite构建

⚠️ 风险

会话永久删除不可恢复，需关闭Codex窗口或CLI
未签名DMG可能触发macOS Gatekeeper的损坏提示
1M上下文窗口只有模型支持时才会生效
切换第三方Provider需新建或重开Codex会话

👥 适合谁？

同时使用Codex桌面端、CLI和多个Provider的开发者
需要管理Skills、MCP与config.toml的Codex用户
使用macOS、Windows或Linux的个人开发者与小团队