Codex Proxy Launcher
介绍: 一个轻量级的 Windows 启动器,用于通过本机 SOCKS5 代理启动 Microsoft Store 安装的 OpenAI Codex / ChatGPT 应用。
一句话总结: 强制让你微软商店下载的 ChatGPT/Codex App 走你指定代理,方便科学上网使用。
启动器会先检查本地代理端口,再自动枚举当前用户可见的 Windows 应用包,查找目标应用的 AUMID,并读取包清单中对应的可执行文件路径。随后通过 Windows 的 runas 请求以管理员身份启动目标程序,并保留代理参数。无需写死安装路径或版本号。
本项目是第三方社区工具,与 OpenAI、Microsoft 均无隶属或官方合作关系。
功能特性
- 无控制台窗口:以 Windows GUI 程序运行。
- 代理端口预检查:启动前检查
127.0.0.1:7897是否接受 TCP 连接。 - 自动发现应用:枚举应用包,查找 Codex / ChatGPT 的应用标识(AUMID)。
- 默认以管理员身份启动目标程序:使用
ShellExecuteExW的runas动词, 由 Windows 显示 UAC 确认;启动器自身保持普通权限。 - 失败时提示:代理不可用、应用未找到或启动失败时显示错误消息框。
- 不修改应用本体:不修改目标应用安装目录、文件或权限。
工作原理
-
检查本机
127.0.0.1:7897是否可以建立 TCP 连接。 -
通过 C++/WinRT 的 Windows 应用包 API 查找目标应用。
-
根据目标应用的 AUMID,在
AppxManifest.xml中解析对应的Executable路径。 -
请求管理员权限并启动目标可执行文件,同时传入代理参数:
1--proxy-server=socks5://127.0.0.1:7897
环境要求
- Windows 10 / Windows 11
- Microsoft Store 安装的目标应用(当前代码按
OpenAI.Codex/OpenAI.ChatGPT包名进行匹配) - 本机 SOCKS5 代理服务,默认监听
127.0.0.1:7897 - Visual Studio 2022 或更新版本,安装 使用 C++ 的桌面开发工作负载
- Windows 10/11 SDK
- MSVC C++ 工具集及 C++/WinRT 头文件
项目目前使用 Windows SDK 10.0.26100.0 编译验证。
编译方法
- 使用 Visual Studio 打开
CodexProxyLauncher.slnx。 - 选择
Release配置和x64平台。 - 确认项目使用 C++17 或更新的 C++ 标准,并将子系统设置为
Windows (/SUBSYSTEM:WINDOWS)。 - 重新生成解决方案。
- 成品路径为
x64\Release\CodexProxyLauncher.exe。
也可在 PowerShell 中使用本机 MSBuild 编译:
|
|
请按本机 Visual Studio 安装位置调整 MSBuild 路径。
如果项目中使用了 C++/WinRT,请确保包含相关 Windows SDK 头文件。当前源码为兼容特定工具链,可能定义:
|
|
该宏用于屏蔽 MSVC 对旧实验性协程头文件的弃用诊断,不代表项目需要自行实现协程。
使用方法
- 启动你的代理客户端,并确认 SOCKS5 代理监听在
127.0.0.1:7897。 - 双击
CodexProxyLauncher.exe。 - 在 Windows UAC 提示中允许以管理员身份运行目标程序;取消授权时不会降级为普通权限启动。
- 如果代理端口不可用、应用未找到或提权启动失败,启动器会显示错误提示。
修改代理地址或端口
默认地址配置在 main.cpp 中:
|
|
如果要使用其他代理地址或端口,需要同步修改端口检查配置和 PROXY_ARGUMENTS 中的地址,然后重新编译。
注意事项与限制
- 端口检查不等于代理可用性检查:它只能确认本机端口接受 TCP 连接,无法保证代理节点能够访问目标网站。
- 启动参数依赖应用行为:目标应用更新后,可能不再接受或处理该代理参数。请在更新后重新验证。
- 应用包名可能变化:当前通过
OpenAI.Codex和OpenAI.ChatGPT等包名进行匹配;如果未来包名变化,需要更新匹配逻辑。 - 已有实例:请先正常退出已运行的目标应用,再通过启动器重新启动。目标应用若复用现有普通权限实例,启动器无法将该实例原地提权。
- 目标程序需支持提权:适用于包清单提供可执行文件的桌面应用;受限的 UWP 应用不能通过此方式获得管理员权限。
- 仅面向打包应用:当前实现通过 Windows 应用包 API 查找目标应用,不保证适用于普通桌面安装版。
- 代理服务需要自行提供:本项目不包含代理服务,也不会自动创建或配置代理。
- 安全软件提示:自行编译并检查源码后再运行;不要运行来源不明的二进制文件。
常见问题
启动时提示代理不可用
确认代理客户端正在运行,并监听 127.0.0.1:7897。如果你的代理端口不同,请修改源码中的端口与启动参数后重新编译。
提示找不到应用
确认目标应用已安装,并且当前 Windows 用户能够看到该应用。若应用包名发生变化,需要调整 FindTargetApp() 中的匹配条件。
应用启动了,但请求没有经过代理
端口检查只验证本地 TCP 连接。请确认目标应用仍支持该启动参数,并检查代理客户端日志和网络连接情况。
如何查看错误原因
启动器会在失败时显示消息框。若遇到未覆盖的错误,请记录错误文本或 HRESULT,并提交 Issue。
参与贡献
欢迎提交 Issue 和 Pull Request。提交前请:
- 描述复现步骤和预期行为。
- 避免提交个人代理地址、访问令牌、账号信息或其他敏感配置。
- 在目标 Windows 版本上测试构建结果。
免责声明
本项目按"现状"提供,不提供任何明示或暗示的保证。使用者应自行确认相关软件的使用条款、网络环境及所在地适用法律法规。使用本项目造成的任何后果由使用者自行承担。
License
请在公开仓库前选择并添加适合你的开源许可证文件(例如 MIT License)。在仓库中加入 LICENSE 文件之前,不应将本项目描述为已采用某个特定许可证。