ShimX 是面向 Codex Desktop 的本地增强器。它通过 Chrome DevTools Protocol 连接 Codex 页面，并注入本地增强脚本，让 Codex 获得供应商切换、会话导入导出、Claude Bridge、用户脚本、插件面板和日志面板等能力。

环境要求

• Flutter 桌面运行环境，当前项目使用 Dart SDK ^3.9.2。
• Windows 或 macOS。
• 本机已安装 Codex Desktop。
• Windows 默认通过 OpenAI.Codex* UWP 包启动 Codex；macOS 默认查找 /Applications/Codex.app。

基本流程

1. 启动 ShimX。
2. 在首页确认本地代理、MCP、Bridge 和 Codex 状态。
3. 点击注入，ShimX 会启动或连接 Codex Desktop，并确保 Codex 开启远程调试端口。
4. 注入成功后，Codex 页面会出现 ShimX 徽章、控制面板、日志面板、插件面板、供应商/模型选择器和会话操作入口。
5. 需要接管请求时，在供应商页配置上游并开启本地代理。

常用入口

• 供应商页：配置 API Base URL、Key、协议、模型、权重和自动切换策略。
• 会话页：浏览 Codex / Claude Code 会话，执行导入、导出、删除、桶移动和备份恢复。
• MCP 页：管理 ShimX 内置 MCP server 和写入 Codex config.toml 的 MCP 配置。
• Skills 页：扫描、安装、导入和删除 ShimX 管理的 Codex Skills。
• 设置页：管理语言、主题、主题色、官方登录、快捷方式和工具过滤关键词。

数据安全

ShimX 会在用户操作下修改 ~/.codex/config.toml、auth.json 快照、state_5.sqlite 和 rollout JSONL。会话删除、导入、桶移动和恢复前建议确认 Codex 未处于关键请求中。

贡献者: 挽风

下一页工作机制