CodexProxyLanucher

一个轻量级的 Windows 启动器,用于通过本机 SOCKS5 代理启动 Microsoft Store 安装的 OpenAI Codex / ChatGPT 应用。

   
文章摘要
摘要小助理今天溜号啦……😜

Codex Proxy Launcher

Github 地址

介绍: 一个轻量级的 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 确认;启动器自身保持普通权限。
  • 失败时提示:代理不可用、应用未找到或启动失败时显示错误消息框。
  • 不修改应用本体:不修改目标应用安装目录、文件或权限。

工作原理

  1. 检查本机 127.0.0.1:7897 是否可以建立 TCP 连接。

  2. 通过 C++/WinRT 的 Windows 应用包 API 查找目标应用。

  3. 根据目标应用的 AUMID,在 AppxManifest.xml 中解析对应的 Executable 路径。

  4. 请求管理员权限并启动目标可执行文件,同时传入代理参数:

    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 编译验证。

编译方法

  1. 使用 Visual Studio 打开 CodexProxyLauncher.slnx。
  2. 选择 Release 配置和 x64 平台。
  3. 确认项目使用 C++17 或更新的 C++ 标准,并将子系统设置为 Windows (/SUBSYSTEM:WINDOWS)。
  4. 重新生成解决方案。
  5. 成品路径为 x64\Release\CodexProxyLauncher.exe。

也可在 PowerShell 中使用本机 MSBuild 编译:

1
& "C:\Program Files\Microsoft Visual Studio\18\Insiders\MSBuild\Current\Bin\MSBuild.exe" .\CodexProxyLauncher.vcxproj /t:Rebuild /p:Configuration=Release /p:Platform=x64 /m

请按本机 Visual Studio 安装位置调整 MSBuild 路径。

如果项目中使用了 C++/WinRT,请确保包含相关 Windows SDK 头文件。当前源码为兼容特定工具链,可能定义:

1
#define _SILENCE_EXPERIMENTAL_COROUTINE_DEPRECATION_WARNINGS

该宏用于屏蔽 MSVC 对旧实验性协程头文件的弃用诊断,不代表项目需要自行实现协程。

使用方法

  1. 启动你的代理客户端,并确认 SOCKS5 代理监听在 127.0.0.1:7897。
  2. 双击 CodexProxyLauncher.exe。
  3. 在 Windows UAC 提示中允许以管理员身份运行目标程序;取消授权时不会降级为普通权限启动。
  4. 如果代理端口不可用、应用未找到或提权启动失败,启动器会显示错误提示。

修改代理地址或端口

默认地址配置在 main.cpp 中:

1
2
3
4
5
constexpr wchar_t PROXY_HOST[] = L"127.0.0.1";
constexpr unsigned short PROXY_PORT = 7897;

constexpr wchar_t PROXY_ARGUMENTS[] =
    L"--proxy-server=socks5://127.0.0.1:7897";

如果要使用其他代理地址或端口,需要同步修改端口检查配置和 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 文件之前,不应将本项目描述为已采用某个特定许可证。

CC BY-NC-SA 4.0
最后更新于 2026-11-21 13:06