跳转到内容
NexaGW 使用文档

Windows 一键配置 Codex

完成本页后，Codex 会使用 NexaGW Responses API，同时保留你原有的其他 provider、MCP、权限、功能开关和注释。

准备工作

Section titled “准备工作”
  • Windows 10 或 11。
  • 已安装 Codex CLI。
  • 已创建支持 GPT / Codex 模型的 NexaGW API Key。
  • 运行脚本的 Windows 账户有权写入自己的用户目录和用户环境变量。

  1. 下载 Windows 配置包

    下载 NexaGW-Codex-Setup.zip。不要从聊天转发、网盘或其他域名获取脚本。

  2. 核对 SHA-256

    在下载目录打开 PowerShell：

    Terminal window
    Get-FileHash .\NexaGW-Codex-Setup.zip -Algorithm SHA256

    结果应为：

    b9224226bc4d18d6201655c1e5e50787ba589a3011565bc279a8c2f6e0223dae

  3. 解压并运行

    解压 ZIP，双击 nexagw-codex-setup.cmd。若双击窗口立即关闭，可在解压目录运行：

    Terminal window
    .\nexagw-codex-setup.cmd

  4. 选择 Configure

    输入 1，确认执行，选择 primary 主线路或运行时指定 hongkong。Key 在隐藏输入框中录入，不会作为命令行参数出现。

  5. 重新打开终端

    工具将 Key 写入当前用户的 NEXAGW_API_KEY 环境变量。关闭旧终端并打开一个新 PowerShell，让新进程读取该变量。

  6. 验证配置

    Terminal window
    [Environment]::GetEnvironmentVariable('NEXAGW_API_KEY', 'User').Length
    codex

    第一条命令只显示字符数，不显示 Key。进入 Codex 后确认当前模型为 gpt-5.6-sol，再发起一条简单请求。

查看状态、切换和恢复

Section titled “查看状态、切换和恢复”
  • Status：只检查配置文件、线路与环境变量是否存在，不显示 Key。
  • Switch：先备份，再只切换 NexaGW 的 Base URL。
  • Restore：列出从新到旧的时间戳备份，由你选择要恢复的版本；恢复前还会创建安全备份。

切换到香港线路

Section titled “切换到香港线路”

菜单中的 Switch 只会切到主线路。要切换到香港线路，在解压目录用命令行指定线路（hongkong 或 primary）：

Terminal window
.\nexagw-codex-setup.cmd Switch hongkong

首次配置时也可以直接指定线路，例如 .\nexagw-codex-setup.cmd Configure hongkong。两条线路使用同一个 Key。

备份位于 %USERPROFILE%\.codex\nexagw-backups\。详细边界见备份与恢复。

下一步：查看 Codex 手动配置与模型选择。