CodexPilot

让 Codex 的本地工作流更顺手、更可控。

简体中文 · English

CodexPilot 适合已经在本机使用 Codex App 的用户。它提供一个本地管理界面，用 Chromium DevTools Protocol 连接正在运行的 Codex 页面。你可以从这里启动 Codex、导出会话、处理回收站、同步 Provider 归属、配置混合中转和查看诊断日志；它不修改 Codex App 安装目录，也不替换 Codex 本身。

CodexPilot 是非官方工具，不隶属于 OpenAI 或 Codex App。

快速使用

1. 打开 GitHub Releases，在 Assets 区下载对应平台安装包，不要下载 Source code 压缩包。
   • Windows：下载 CodexPilot-*-windows-x64-setup.exe，运行安装程序。
   • macOS Apple Silicon：如果该版本提供 CodexPilot-*-macos-arm64.dmg，打开后把 CodexPilot.app 拖入 Applications。
2. 打开 CodexPilot 管理器，进入“启动”，确认 Codex 路径后点击“启动”。
3. Codex 页面打开后，可以直接使用 CodexPilot 菜单导出当前会话。
4. 需要自定义模型请求时，进入“模型通道”配置混合中转。
5. 需要整理历史会话时，进入“对话维护”处理回收站或同步 Provider 归属。

macOS 当前包未做 Apple Developer ID 签名和公证。如果系统提示无法验证开发者，请先阅读 DMG 内说明，再按需使用随包提供的修复脚本。macOS Intel 当前没有已验证安装包，需要自行从源码验证。

核心亮点

混合中转

混合中转是 CodexPilot 的重点能力。它保留官方 Codex/ChatGPT 登录态，同时把模型请求切到自定义兼容 API。这样你可以继续使用手机 ChatGPT 控制或接续桌面 Codex，又能让桌面 Codex 的模型请求走自己的中转站。

自定义 Provider 会收到模型请求，隐私、计费和数据处理策略以你配置的 Provider 为准。

Provider 归属同步

切换模型通道后，历史会话可能因为 Provider 元数据不一致而不可见或分组异常。CodexPilot 不会自动改写历史数据；你可以在“对话维护”里先预览影响范围，再手动把会话归属同步到选定 Provider。

其他功能

• 启动与注入
• 会话导出
• Timeline
• 对话维护
• 归档会话处理
• 诊断快照

完整功能说明见 docs/features.md。

本地数据与安全

CodexPilot 会读取或写入本机 ~/.codex 下的配置、会话、归档会话、状态数据库和备份目录。中转配置档会保存在本机，API Key 不会显示在状态面板里，但仍会写入本地配置文件。

请只在可信设备上使用，并避免把本地配置、日志、截图或备份目录上传到公开仓库。使用自定义兼容 API 时，请自行确认服务提供方的隐私、计费和数据处理策略。

更完整的数据范围见 功能说明。

文档

• 功能说明：启动、模型通道、会话维护、Provider 同步、诊断和本地数据说明。
• README 维护准则：项目首页的信息架构和文案规则。

交流与支持

如需交流使用问题、反馈异常或获取发布信息，可以加入微信交流群。

本项目链接并认可 LINUX DO 社区。欢迎在社区讨论帖中反馈问题、分享使用体验或提出改进建议。

License

MIT