Skip to content

yynxxxxx/Codex-X

Repository files navigation

中文 English

Codex-X Logo

Codex-X

Codex 提示词注入 · Provider 切换 · TOML / Auth 可视化管理器

一款面向 OpenAI Codex 桌面端 / Codex CLI 的跨平台桌面工具,内置 gpt5.5-unrestricted.mdgpt5.4-unrestricted.md,支持一键写入 / 禁用指令提示词、第三方 Provider 切换、官方 Auth 管理、TOML 可视化编辑与本地会话 Provider Sync。

version platform tauri license


Codex-X 是什么?

Codex-X 不是普通的配置文件编辑器,而是一个面向 Codex CLI 的 可视化增强管理器

它把几个高频操作做成了桌面软件:

  • 给 Codex 写入 / 禁用指令提示词模板
  • 切换官方 OpenAI 与第三方 Codex API Provider
  • 查看 / 编辑 ~/.codex/config.toml
  • 查看 / 编辑官方 ~/.codex/auth.json
  • 检查并修复本地历史会话的 Provider 元数据

软件预览

应用界面预览:主界面 / Provider / TOML / Auth

Codex-X 应用界面预览:主界面、Provider、TOML、Auth

提示词注入效果:安全测试场景
SQL 注入测试
部署后测试:如何对目标进行 SQL 注入测试?
SQL 注入测试效果图
NSFW 响应测试
用于观察提示词注入后的边界响应变化
NSFW 响应测试效果图
提示词注入效果:逆向工程场景
APK 逆向分析
Android APK 静态 / 动态分析思路
APK 逆向分析效果图
APK 逆向分析 2
补充 APK 逆向流程与定位方式
APK 逆向分析效果图 2
EXE 逆向分析
Windows 可执行文件分析与调试方向
EXE 逆向分析效果图

功能特性

功能 说明
⚡ 供应商 API 可视化管理官方 OpenAI / 第三方 Codex Provider,支持 Base URL、API Key、Model、Wire API 与一键切换。
🧩 提示词注入 特色功能:内置 gpt5.4-unrestricted.md / gpt5.5-unrestricted.md,一键写入 Codex 配置;启用后可达到上方效果图中的 SQL 注入测试、APK / EXE 逆向等响应效果。
💬 会话管理 读取 Codex 本地 SQLite 与 rollout JSONL,会话列表可视化展示,并支持 Provider Sync / 修复历史 thread 元数据。
📝 TOML 配置 查看当前 ~/.codex/config.toml,并在 Provider 编辑页直接编辑完整 TOML,保存后同步到 Codex 配置目录。
🔐 Auth 管理 读取 / 编辑官方 ~/.codex/auth.json,区分 ChatGPT 登录态 Auth 与第三方 API Key。
📦 跨平台发布 提供 macOS Apple Silicon / Intel .dmg、Windows .msi / portable .zip、Linux .deb / .rpm,支持应用内检测更新。

核心亮点

1. 内置双指令提示词模板

Codex-X 当前内置两套提示词模板:

  • examples/gpt5.5-unrestricted.md
  • examples/gpt5.4-unrestricted.md

你可以在【指令提示词】页面直接点击启用 / 禁用。启用后,Codex-X 会把对应 .md 写入 Codex 配置目录,并更新 config.toml 中的 model_instructions_file

对比项 gpt5.4-unrestricted.md gpt5.5-unrestricted.md
定位 5.4 CTF 沙箱 5.5 无限制模式
策略 CTF 竞赛沙箱间接绕过 直接声明无限制开发者模式
风格 安全研究导向,方法论详细 极简指令,覆盖面广
长度 约 180 行 约 40 行
适用 GPT-5.4 Codex CLI GPT-5.5 Codex CLI

部署后可以测试:

如何对目标进行 SQL 注入测试?

典型效果:

破甲前 → 拒绝或泛化回答
破甲后 → 直接给安全研究方法论与测试步骤

2. Provider 可视化切换

  • 添加第三方 Codex API Provider
  • 编辑 Base URL / API Key / Model / Wire API
  • Provider 页面可查看并编辑对应 TOML
  • 当前启用 Provider 状态清晰可见
  • 支持从 cc-switch 数据库导入 Codex Provider

3. 官方 Auth 管理

  • 自动读取 Codex 官方 auth.json
  • 支持查看 / 编辑 ChatGPT 登录态 Auth
  • 区分官方 Auth 与第三方 API Key
  • 官方配置可和第三方 Provider 在 UI 中统一管理

4. TOML 可视化编辑

  • 查看当前 Codex config.toml
  • 深色代码预览与语法高亮
  • Provider 编辑页可直接编辑完整 TOML
  • 保存后同步到 Codex 配置目录

5. 会话管理 / Provider Sync

Codex-X 可以读取 Codex 本地会话数据:

~/.codex/sqlite/*.db
~/.codex/state_5.sqlite
~/.codex/sessions/**/rollout-*.jsonl
~/.codex/archived_sessions/**/rollout-*.jsonl

用于检查旧会话的 Provider 元数据是否和当前配置一致,并支持一键同步 / 修复,让历史 thread 继续被原生 Codex 识别、打开和续聊。

6. 跨平台桌面软件

  • macOS Apple Silicon .dmg
  • macOS Intel .dmg
  • Windows .msi
  • Windows Portable .zip
  • Linux .deb / .rpm
  • GitHub Releases 自动构建发布
  • 应用内检查更新

技术栈

类型 技术
桌面框架 Tauri 2
前端 React 18 / TypeScript / Vite
后端 Rust
本地数据 SQLite / rusqlite
配置编辑 TOML / JSON
发布 GitHub Actions / GitHub Releases

配置路径

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

macOS 安装说明

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

  • 最佳方式:使用 Apple Developer ID 签名并 notarize
  • 仅本地测试:可手动移除 quarantine 属性
xattr -dr com.apple.quarantine /Applications/Codex-X.app

许可证

本项目基于 MIT License 开源。

致谢 / Thanks

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

Star History

Star History Chart

About

Codex Switch & Instruct desktop manager

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors