📌 项目地址: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.toml和auth.json,重要写入前自动备份 - 用量统计:按日期和模型筛 Token 用量,看每日趋势、缓存命中率、模型分布,以及最近 10 个主会话
一个细节我觉得做得不错:子代理的 Token 用量归入所属主会话,不单独计为一条会话记录。统计口径清楚了,数据才可信。
提示词注入:这工具最有特点的地方
每个提示词有独立开关,打开时自动按当前“启用方式”写入 Codex 指令文件。有两种方式可选:
- 保留原提示词:追加写入,适合叠加使用
- 替换原提示词:完整切换,适合在不同模型、不同任务、不同 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,它解决的问题你大概率没有。