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 安装说明。

1. 登录 Sub2API 面板

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

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

2. 创建 API 密钥

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

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

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

3. 复制 URL 与 API Key

点击 使用密钥 后，平台会自动给出 Codex 所需配置。这里不再建议手动编辑 config.toml 与 auth.json；更推荐只从弹窗中复制两项关键信息：URL / base_url 与 API Key，后续交给 CC Switch 写入配置文件。

操作前提示：开始写入或切换 Provider 前，请先完全关闭正在运行的 Codex App、Codex CLI 以及相关终端窗口；配置完成后再重新打开，避免应用读取缓存配置或在退出时覆盖新配置。

4. 安装 CC Switch

CC Switch 可以理解为一个把 URL 和 API Key 写入 Codex 配置文件的工具。用它配置 Sub2API 后，后续切换不同配置时会更直观，也更不容易手动改错文件。下载入口在 CC-Switch Releases；Windows 用户优先下载 CC-Switch-*-Windows.msi 安装版，无法正常安装时再考虑 Portable 压缩包。

双击下载得到的 .msi 后进入标准安装向导，第一页直接点击 Next。

随后确认安装目录。默认目录通常可以直接使用，如无特殊要求不需要修改，继续点击 Next。

进入 Ready to install 页面后，点击 Install 开始写入文件。

安装完成后，建议保留 Launch CC Switch 选项并点击 Finish，方便直接进入后续配置流程。

5. 新增 Sub2API Provider

首次打开 CC Switch 时会出现欢迎提示。这里主要说明：CC Switch 会把已有配置保存为 default Provider，后续切换时可以回退。确认后点击 我知道了。

进入主界面后，先选择顶部的 OpenAI / Codex 图标，再点击右上角 + 新增 Provider。

如果弹出“关于通用配置”的说明，直接确认即可。该提示用于说明通用配置片段可以在不同 Provider 之间复用，通常不需要额外改动。

在新增 Provider 页面中，先填写一个便于识别的名称，例如 Sub2API-Codex。随后将 Sub2API 弹窗中的 API Key 原样粘贴到 API Key 输入框，不要自行增删字符。

接着在 API 请求地址 中填写 https://sub2api.20020519.xyz/v1。注意：Sub2API 弹窗中的 base_url 显示为站点根地址，而 CC Switch 这里需要填写完整 OpenAI 兼容接口地址，因此需要补上 /v1。确认无误后点击右下角 添加。

6. 启用并重新打开 Codex

Provider 添加成功后会回到列表页。找到刚新增的 Sub2API Provider，点击右侧 启用。启用完成后，再重新打开 Codex CLI 或 Codex App，使其读取最新 Provider 配置。

看到该 Provider 出现在列表中并保持选中状态，即表示 CC Switch 侧配置已经完成。后续如果需要切回官方配置或其他 Provider，仍建议先关闭 Codex App / CLI，再回到 CC Switch 中切换。

测试与反馈：配置完成后，可以在 Codex 中发送一条测试消息，然后观察 Sub2API 仪表盘是否产生消耗记录。如果遇到任何问题，请立刻联系管理员，不用担心麻烦。积极交流和及时反馈，才能不断完善本测试方案；毕竟当前重点就是验证方案可行性，麻烦大家及时反馈。

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 切换说明