yynxxxxx/codex-x

---

Codex-X 是什么？

当你同时使用 Codex 桌面端、CLI、第三方 API、Skills / MCP 和多套提示词时，配置很容易散落在不同文件里。Codex-X 把这些高频操作集中到一个桌面界面中，让当前状态看得见、常用操作点一下就能完成。

你可以用它：

• 像管理插件一样管理提示词：分类、导入 Markdown、自定义编辑、一键启用 / 禁用
• 内置 5 套提示词模板，同时支持用户把自己的提示词变成可视化模板库
• 保存、测试并切换 OpenAI Official 与第三方 API，还能从 cc-switch 导入现有供应商
• 同步、检查、搜索和删除本地会话，按项目路径整理 Codex 历史记录
• 集中管理 Skills 与 MCP，查看当前 config.toml、auth.json 和操作备份

软件预览

功能特性

核心亮点

1. 可视化提示词注入中心

[!TIP] 安装后就能用，联网后自动补齐，也能维护自己的提示词库。

安装包离线自带 5 套模板；软件启动后会从 GitHub examples/ 同步另外 6 套软件开发与写作辅助模板，以及后续更新。同步成功的在线版本会缓存到本地，临时离线仍可继续使用。你也可以导入自己的 .md、新增分类、编辑说明，并像切换插件一样启用或禁用任意提示词。

Codex-X 现在不只是“几套内置 Prompt”的启动器，而是一个可视化提示词注入与管理工具：

• 按分类管理提示词，例如破甲 / 逆向、软件开发、写作辅助，也可以新增自己的分类
• 支持同步 GitHub 模板、导入 Markdown、手动添加提示词、编辑标题 / 文件名 / 内容
• 每个提示词都有独立开关，打开时自动按当前启用方式写入 Codex 指令文件
• 支持“保留原提示词”和“替换原提示词”两种模式，适合日常叠加或完整切换
• 本地缓存可离线使用，后续模板更新不会影响你自己维护的自定义提示词

每次启用或禁用前都会自动创建备份。除了模板库，你也可以导入、编辑、删除自己的 .md 提示词，并通过分类管理把常用提示词整理成自己的工作流。

[!NOTE] 如果你有好用的提示词模板，欢迎在 Issues 提交：请附上模板名称、适用场景、Markdown 内容、推荐启用方式和必要说明。合适的模板会考虑收录到 examples/，让更多用户可以一键同步使用。

2. Provider / API：添加、检测、获取模型、随时切换

[!NOTE] 启用新的第三方供应商后，新建或重新打开 Codex 会话即可使用新的中转，不需要重启整个 Codex 客户端。

• 保存多个第三方供应商，随时查看当前正在使用哪一个
• 切换前可检测连接，并可获取模型进行测试
• 在同一页面编辑 Base URL、API Key、Model、Wire API 和完整 TOML
• 从 cc-switch 导入时自动区分新增、更新、合并与跳过；相同 URL + Key 不再重复显示
• 切回 OpenAI Official 时保留当前官方登录态，第三方配置也不会凭空消失

3. 会话管理：同步、检查与永久删除

[!CAUTION] 永久删除不可恢复。 删除前请先关闭仍在使用这些会话的 Codex 窗口或 CLI，并在确认窗口中再次核对待删除列表。

4. Skills / MCP 管理

在【技能和 MCP】页面集中管理 Codex 的能力扩展，不必再到多个目录和配置文件中逐项查找。

5. TOML 与官方 Auth 管理

• 自动读取 Codex 官方 auth.json
• 支持查看 / 编辑 ChatGPT 登录态 Auth
• 区分官方 Auth 与第三方 API Key
• 官方配置可和第三方 Provider 在 UI 中统一管理
• 查看当前 Codex 正在使用的 live config.toml
• 深色代码预览与语法高亮
• Provider 编辑页可直接编辑完整 TOML
• 保存后同步到 Codex 配置目录

6. 逆向 Skills 导航

🚀 打开 Codex-X 逆向 Skills 导航

7. 跨平台桌面软件

• macOS Apple Silicon .dmg
• macOS Intel .dmg
• Windows .msi
• Windows Portable .zip
• Linux .deb / .rpm / .AppImage
• GitHub Releases 自动构建发布
• 安装版支持应用内自动更新，Windows 便携版保留手动更新

技术栈

配置路径

Codex-X 默认读取 Codex 配置目录：

~/.codex/config.toml
~/.codex/auth.json

也支持环境变量：

CODEX_HOME=/path/to/.codex
CODEXX_HOME=/path/to/codex-x-data
CC_SWITCH_HOME=/path/to/.cc-switch

Codex-X 自身数据库默认位于：

~/.codexx/codexx.db

下载

请前往 Releases 页面下载：

https://github.com/yynxxxxx/Codex-X/releases

开发运行

pnpm install
pnpm dev

构建桌面端：

pnpm --dir apps/desktop tauri build

桌面端安装说明

如果你在未签名 / 未公证的 DMG 中看到“软件已损坏”提示，这是 macOS Gatekeeper 的正常行为。

• 最佳方式：使用 Apple Developer ID 签名并 notarize
• 仅本地测试：可手动移除 quarantine 属性

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

许可证

本项目基于 MIT License 开源。

致谢 / Thanks

感谢 LINUX DO 论坛 社区的关注、反馈与支持。

Star History

[!IMPORTANT] 使用声明

本项目仅用于大模型与智能体相关技术的学习、研究与交流，软件本身不包含主动破坏性功能。请在合法、合规并获得授权的范围内使用，禁止将其用于攻击、侵害他人权益或其他违法用途。使用者应自行判断使用边界，并对相关行为与后果承担责任。