GPT PRO 20x 共享方案（长期更新）

如果主要是命令行工作流、批量调用和轻量配置，优先使用 Codex CLI；如果更看重桌面界面、线程管理和本地项目工作台，优先使用 Codex App。对于大多数初次参与测试的成员，推荐先装 Codex App，需要纯终端工作流时再补装 Codex CLI。

Codex CLI（官方方式）

1. 先从 Node.js 官网安装 LTS 版本，确保 node 与 npm 可用：
   https://nodejs.org/en/download

2. 在 PowerShell 中执行官方安装命令：
   npm install -g @openai/codex

3. 安装完成后验证：
   codex --version

Codex CLI 的官方安装与使用说明可参考 OpenAI 官方文档：https://developers.openai.com/codex/cli

Codex App（官方方式）

1. 优先打开 Microsoft Store
2. 搜索 Codex
3. 点击安装并完成首次启动
4. 如果 Microsoft Store 无法访问或无法正常下载，
   可改用离线安装方式

如果采用离线安装方式，详细安装步骤、更新方式以及常见问题排查，统一参考：Codex App Windows 安装说明。

Sub2API 面板地址：https://sub2api.20020519.xyz。登录时使用管理员提供的邮箱和密码。

登录成功后，进入后台首页。左侧侧边栏中找到 API 密钥，后续 Codex 分发所需的密钥、配置片段和导入入口都在这一页完成。

如果当前账号下还没有可用密钥，页面中部会显示 创建密钥 按钮。点击后进入新建弹窗。

创建密钥时，建议至少完成以下三项：填写一个便于识别的名称，选择管理员指定的分组，并将额度限制保持为 0。其中 0 表示当前这把密钥不单独设置额度上限，更适合测试期内持续验证。确认无误后点击右下角 创建。

密钥创建成功后，会出现在 API 密钥列表中。此时不要手动复制表格里的密钥文本，直接点击右侧操作区中的 使用密钥，让平台自动给出 Codex 所需配置。

点击后会弹出配置窗口。这里是整个流程里最关键的一步，建议严格按下列顺序操作：

1. 在顶部标签中选择 Codex CLI，然后切换到 Windows。
2. 按 Win + R，输入 %USERPROFILE%\.codex 打开 Codex 配置目录；如果目录不存在，请手动创建。
3. 窗口上半部分对应 %USERPROFILE%\.codex\config.toml。如果你本地已经有 config.toml，先备份，再将平台给出的这一段内容放到文件靠前位置，不要随意删除你自己的其他配置。
4. 窗口下半部分对应 %USERPROFILE%\.codex\auth.json。如果本地没有该文件，就手动新建；如果已经存在旧文件，建议先备份后再替换为平台给出的内容。
5. 其中 OPENAI_API_KEY 的值就是当前这把 Sub2API 密钥对应的认证内容，应原样保存，不要自行增删字符。
6. 保存完 config.toml 与 auth.json 后，重新打开 Codex CLI 或 Codex App，使新配置生效。

如果只是使用 Codex CLI，完成上述配置后，重新打开 PowerShell 并运行 codex 即可开始测试；如果使用 Codex App，也可以先关闭再重启应用，让其读取同一套本地配置目录。

    提示：如果你本地已经长期使用其他 Codex 配置，请务必先备份原有 %USERPROFILE%\.codex 目录，再进行覆盖或合并，以免影响原先工作流。

codex-provider-sync 主要用于解决切换 model_provider 后，旧会话在 Codex Desktop 或 /resume 中不可见的问题。它会同步本地会话文件、SQLite 线程表和项目路径缓存中的 provider / 可见性 metadata；不处理登录、认证或 auth.json。

下载地址：https://github.com/Dailin521/codex-provider-sync/releases

GUI 说明：README_GUI_ZH.md

Windows GUI 推荐流程：
1. 关闭 Codex CLI / Codex App / app-server
2. 打开 CodexProviderSync.exe
3. 确认顶部 Codex Home 路径
4. 点击 Refresh
5. 在列表中选择目标 Provider
6. 如需同时改写 config.toml 的 root model_provider，勾选对应选项
7. 点击 Execute
8. 如需回滚，使用 Restore Backup

    注意：该工具只同步历史会话可见性相关 metadata，不会切换账号或处理认证信息。含 encrypted_content 的旧会话跨 provider / account 后，通常只能恢复列表可见性，继续对话或 compact 仍可能报错。

更多方式：Codex Provider 切换说明