---
name: codex-v2rayn-shortcut
description: 在 Windows 上为 Codex 桌面应用创建通过 v2rayN 本地 HTTP 代理启动的专用快捷方式，保留原图标。用于替代 Proxifier 的启动配置、调整代理端口和排查该快捷方式的连接问题。
---

# Codex 通过 v2rayN 启动

使用进程环境变量配置后台 HTTP 客户端，同时给桌面应用传入 Chromium 代理参数。支持 Windows 打包安装的 `OpenAI.Codex`；其他安装形式先确定实际启动入口再适配。

## 操作

1. 确认 v2rayN 正在运行，读取实际 HTTP 或 mixed 监听端口。不要把 SOCKS 端口当作 HTTP 端口，也不要仅凭默认值选择端口。本会话验证过 `http://127.0.0.1:10809`，换机器或配置后必须重新确认。
2. 用 `curl.exe --proxy <代理URL> --max-time 15` 访问一个 HTTPS 页面，确认代理可用。失败时先排查 v2rayN，不通过关闭 TLS 验证解决。
3. 用本 skill 的 [scripts/start-codex.ps1](scripts/start-codex.ps1) 创建启动方式。先执行只检查、不启动的模式：

   ```powershell
   powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill目录>\scripts\start-codex.ps1" -ProxyUrl "http://127.0.0.1:<已确认端口>" -CheckOnly
   ```

4. 将脚本复制到 `%LOCALAPPDATA%\OpenAI\CodexProxy\Start-Codex-v2rayN.ps1`，创建名为 `Codex - v2rayN` 的桌面快捷方式。快捷方式目标为 Windows PowerShell，参数如下；使用完整脚本路径，窗口隐藏只用于 PowerShell 启动器：

   ```text
   -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "<完整脚本路径>" -ProxyUrl "http://127.0.0.1:<已确认端口>"
   ```

   通过 `WScript.Shell.CreateShortcut` 创建或更新快捷方式。现有快捷方式保留 `IconLocation`；新建快捷方式使用 Codex 原程序的图标，不制作或替换图标。保留原来的 Codex 普通快捷方式。
5. 检查脚本、快捷方式目标与参数。用户完全退出 Codex 后，通过新快捷方式重开并发送消息；验证替代效果时关闭 Proxifier，保持 v2rayN 开启。

## 必须保留的行为

- 启动脚本动态查询 `Get-AppxPackage -Name OpenAI.Codex` 和应用清单，避免把版本化的 WindowsApps 路径写死。当前包的主入口可能叫 `ChatGPT.exe`，不要误用后台 `codex.exe`。
- `HTTP_PROXY`、`HTTPS_PROXY`、`ALL_PROXY`、`NO_PROXY` 仅设置在启动进程中，供应用和继承环境的子进程使用；不修改全局环境变量或 Windows 系统代理。
- 使用 `--proxy-server` 指定桌面网络代理，同时让 localhost、127.0.0.1、::1 保持直连，以免影响本地服务和浏览器桥接。
- Codex 的单实例机制可能让新启动参数被已有实例忽略，因此必须完整退出再启动。不要自动结束当前会话或强杀进程。
- 不卸载 Proxifier，不修改 v2rayN 节点、路由或其他软件代理设置。

## 完成标准

分别报告：文件已生成、代理与入口检查通过、重启后的 Codex 实际通信通过。`-CheckOnly` 只检查入口、端口及参数，并不证明应用全部网络请求都遵循代理设置。若重启后仍失败，检查主进程启动参数、后台连接是否到本地代理及日志，再判断当前版本是否接受这些设置；不要直接宣称已完全替代 Proxifier。
