📌 项目地址:yynxxxxx/Codex-X | ⭐ 3,365 颗星 | 🔧 Rust | 📜 未标注
📌 项目地址:yynxxxxx/Codex-X | ⭐ 3,365 | Rust | 跨平台桌面应用
Codex 用户的配置碎片问题
重度 Codex 用户应该都体会过:提示词写在指令文件里,供应商配置在 config.toml,登录凭据在 auth.json,Skills 和 MCP 又是另外几处。想在两套提示词之间切换,或者从官方登录换到第三方 API,只能手动改文件。改完之后,你未必记得当前启用的是哪一套。
Codex-X 做的事就是把这些操作集中到一个桌面界面里。Rust 写的,macOS、Windows、Linux 都有安装包,目前 3365 星。
它管了六摊事
- 提示词:分类管理、导入
.md、编辑、一键启用/禁用 - Provider / API:多个可命名的官方登录配置,与第三方供应商统一管理、一键复制和切换,可从 cc-switch 导入
- 会话:搜索本地会话、按项目路径分组、同步当前供应商、单选/多选/项目级永久删除
- Skills / MCP:可视化查看、从 ZIP 安装 Skill、逐项启用/禁用
- 配置:集中查看
config.toml和auth.json,重要写入前自动备份 - 用量:按日期和模型筛 Token 用量,看每日趋势、缓存命中率、模型分布和最近 10 个主会话
有一个细节我比较认可:子代理的 Token 用量归入所属主会话,不单独算一条会话。统计口径明确,数据才有参考价值。
核心功能:可视化的提示词注入
这是这个项目最有特点的部分。每个提示词有独立开关,打开时自动写入 Codex 指令文件。写入方式有两种:
- 保留原提示词:追加写入,适合多套叠加
- 替换原提示词:完整切换,适合在不同模型或任务之间快速换
模板分两批。安装包离线自带 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 和安全研究是它明确指向的场景,但你得清楚自己在做什么。这类提示词试图让模型偏离默认行为,可能违反所用平台的服务条款,风险自负。
如果你的需求只是管理供应商配置、会话和 Skills / MCP,这些功能本身是中性的,用起来没问题。内置模板不合适的话,导入自己的 .md 就行。
一句话总结
Codex-X 解决的是真实存在的配置管理痛点,提示词开关加双模式注入的设计比手改文件省事得多,用量统计的口径也做得干净。3365 星说明需求确实存在。能不能用、该不该用那些内置模板,是你自己的判断。