📌 项目地址yynxxxxx/Codex-X | ⭐ 3,365 颗星 | 🔧 Rust | 📜 未标注

问题很具体:Codex 的配置太散了

如果你同时用 Codex 桌面端和 CLI,大概遇到过这些麻烦:提示词写在指令文件里,供应商配置在 config.toml,登录凭据在 auth.json,Skills 和 MCP 又是另一摊。想在两套提示词之间切换,或者在官方登录和第三方 API 之间切换,只能手动改文件。改完之后,你还未必记得当前到底启用了哪一套。

Codex-X 就是冲着这个问题来的。一个 Rust 写的跨平台桌面工具,3365 星。它把上面这些高频操作收进一个界面,让当前状态看得见,常用操作点一下就能完成。

六块功能,各管一摊

  • 提示词管理:内置 5 套模板,支持分类、GitHub 同步、本地缓存、导入 .md 文件、自定义编辑、一键启用/禁用
  • Provider / API:保存多个可命名的官方 Codex 登录配置,和第三方供应商统一管理、一键复制和切换;第三方供应商支持连接检测、模型获取/测试,还能从 cc-switch 直接导入
  • 会话管理:搜索本地会话、按项目路径分组、同步当前供应商、检查会话状态,支持单选/多选/项目级永久删除
  • Skills / MCP:可视化查看、从 ZIP 安装 Skill、逐项启用/禁用、检查更新状态
  • 配置查看:集中看 config.tomlauth.json,重要写入前自动备份
  • 用量统计:按日期和模型筛 Token 用量,看每日趋势、缓存命中率、模型分布,以及最近 10 个主会话

一个细节我觉得做得不错:子代理的 Token 用量归入所属主会话,不单独计为一条会话记录。统计口径清楚了,数据才可信。

提示词注入:这工具最有特点的地方

每个提示词有独立开关,打开时自动按当前“启用方式”写入 Codex 指令文件。有两种方式可选:

  1. 保留原提示词:追加写入,适合叠加使用
  2. 替换原提示词:完整切换,适合在不同模型、不同任务、不同 Prompt 之间快速换

模板获取的机制是:安装包离线自带 5 套,软件启动后从 GitHub examples/ 目录再同步 6 套软件开发和写作辅助模板。同步成功的版本会缓存到本地,临时离线也能继续用。你自己导入和编辑的提示词不受后续模板更新影响。

模板清单和定位:

模板 定位 获取方式
gpt5.5-unrestricted.md 短小通用,日常 coding 离线内置
gpt5.4-unrestricted.md 面向 GPT-5.4 / Codex CLI,偏 CTF 与安全研究 离线内置
gpt5.5-jeli.md 大白话通用版,工程与逆向执行流程 离线内置
gpt-5.6-sol-unrestricted.md 破甲,偏直接执行与中英文任务 离线内置
海鸥3.0破甲.md 中文技术操作员人格,覆盖 coding/CTF/逆向/内存与协议任务路由 离线内置
software-development-maintainer.md 长期维护正式项目,强调复用、最小改动、测试 GitHub 在线同步
software-development-debugging.md 稳定复现、证据采集,推进到根因修复与回归验证 GitHub 在线同步
software-development-code-review.md 按严重级别审查缺陷、回归、安全风险和测试缺口 GitHub 在线同步
writing-clarity-editor.md 保留原意和事实的前提下润色中英文表达 GitHub 在线同步

Provider 管理的几个实用点

第三方供应商编辑页支持连接检测、模型获取和测试,不用改完配置再开个终端验证。官方登录和第三方供应商编辑页都可以勾选“开启 1M 上下文窗口”,保存后写入 config.toml 生效,前提是模型支持。

从 cc-switch 导入这个设计值得说一句。已经在用 cc-switch 管理多家供应商的人,不用一条条重新录入,迁移成本基本为零。

安装

支持 macOS(Apple Silicon / Intel)、Windows(MSI / 便携版)和 Linux。安装版可以在应用内直接下载、校验并安装更新,便携版继续手动下载。README 没给 brew、winget 之类的命令行安装方式,具体去仓库 Releases 页面看。

用之前要想清楚的几件事

这工具一半的内置模板是“破甲”提示词,也就是尝试绕过模型默认限制。CTF 和安全研究是它明确指向的场景,但你要清楚自己在做什么:它试图让模型偏离默认行为,可能违反你所用平台的服务条款,风险自担。

它改的是你本地文件。指令文件和 config.toml 都会被写入,好在重要写入前有自动备份,出了问题可以回退。

这是社区项目,不是官方工具。3365 星说明有不少人在用,但迭代节奏和长期维护需要自己判断。

谁该用它

判断标准很简单:你是否同时用 Codex 桌面端和 CLI、是否切换多个 API 供应商、是否维护多套提示词。三个问题里有两个答“是”,这个工具就值得装来试试。如果只是偶尔用一次官方 Codex,它解决的问题你大概率没有。

这篇文章对你有帮助吗?

发表回复