8848AI 使用文档
ChatGPT / Codex 桌面版
适用范围：本方法不只适用于 ChatGPT / Codex 桌面版，也适用于 Claude Code、OpenClaw、Google Official、Hermes 等 CC Switch 支持的 Agent 工具。不同工具只需在 CC Switch 中切换到对应应用面板，添加 8848API 供应商并开启该应用的本地代理/路由接管；Base URL 和 API Key 的填写方法相同。
推荐方式：CC Switch 本地代理

通过 CC Switch 为 ChatGPT / Codex 桌面版配置 8848API

ChatGPT / Codex 桌面版不需要在客户端里到处寻找 Base URL。正确流程是：先安装 CC Switch，在 CC Switch 里添加 8848API 供应商，然后启动本地代理并接管 Codex。桌面客户端把请求交给本机 CC Switch，再由 CC Switch 转发到 8848API。

CC Switch 官方下载 ↗ ChatGPT 官方下载 ↗
下载建议：优先使用上方官方入口，来源最直接、版本也最新。如果官方页面打不开、GitHub 下载慢或安装包无法正常下载，再使用 8848AI 本地下载中心。本地下载中心提供 CC Switch 与 ChatGPT 桌面版的 Windows、macOS 安装包，并支持断点续传。

开始前准备

CC Switch
建议使用 v3.16.1 或更新版本
服务名称
8848API
Base URL
https://api.884819.xyz/v1
API Key
8848API 控制台 → 令牌管理 → 添加令牌
本地代理
http://127.0.0.1:15721
应用接管
Codex

完整流程

顺序不要颠倒：下载 CC Switch → 添加 8848API → 启动代理 → 接管 Codex → 启用供应商 → 重启 Codex 测试。

1. 下载并安装 CC Switch

  1. 优先打开 CC Switch 官方 Releases 页面；若官方页面无法打开或下载速度慢，可使用 8848AI 本地下载。
  2. Windows 用户下载 Windows.msi；macOS 用户下载 macOS.dmg。不要下载来源不明的修改版。
  3. 安装完成后打开 CC Switch。

macOS 无法打开怎么办？

进入“系统设置 → 隐私与安全性”，找到 CC Switch，点击“仍要打开 / Open Anyway”，再重新启动应用。

2. 安装 ChatGPT / Codex 桌面版

  1. 优先从 ChatGPT 官方下载页面安装桌面版；若官方页面无法打开或下载失败，可使用 8848AI 本地下载。
  2. 至少正常启动一次，让客户端生成本地配置目录。
  3. 如果你还要保留手机远程操作或官方插件，先在 Codex 中用官方 ChatGPT 账号登录一次；Free 账号也可以。
  4. 完成后先退出 Codex，后面由 CC Switch 写入配置后再重新打开。
官方账号只用于保留客户端登录态；模型请求是否走 8848API，以 CC Switch 当前启用的 Codex 供应商和请求日志为准。

3. 在 8848API 创建令牌

  1. 登录 8848API 控制台。
  2. 进入左侧“令牌管理”。
  3. 点击“添加令牌”，创建一个 sk- 开头的 API Key。
  4. 复制并妥善保存，下一步填入 CC Switch。
不要把完整 API Key 发给别人，不要截图公开，也不要填写 8848API 的登录密码。

4. 在 CC Switch 添加 8848API 供应商

  1. 打开 CC Switch，顶部切换到 Codex 应用面板。
  2. 点击右上角 ＋，进入“添加供应商”。
  3. 选择“应用专属供应商”；如果有“自定义 / OpenAI Compatible”预设，优先选择它。
  4. 名称填写 8848API。
  5. Base URL / 端点填写 https://api.884819.xyz/v1。
  6. API Key 填写刚创建的 sk- 密钥。
  7. API 协议选择 OpenAI Chat Completions / chat_completions。
  8. 打开“需要本地路由映射”，让 CC Switch 将 Chat Completions 请求转换成 Codex 使用的 Responses 协议。
  9. 模型选择 8848API 当前可用的 Codex / GPT 编程模型；如果支持“获取模型”，可点击按钮从接口读取模型列表。
  10. 保存供应商。
这里必须选择 Chat Completions，并开启“需要本地路由映射”。请求链路为：Codex Responses 请求 → CC Switch 本地路由转换 → 8848API Chat Completions 接口 → CC Switch 转回 Responses 响应。

5. 建立 CC Switch 本地代理

  1. 进入 设置 → 高级 → 代理服务 / 路由服务。
  2. 监听地址保持 127.0.0.1，不要改成 0.0.0.0。
  3. 端口保持默认 15721。
  4. 打开“代理服务 / 路由总开关”。
  5. 在“应用路由 / 路由启用”区域打开 Codex。

接管后，CC Switch 会把 Codex 的本地配置指向 http://127.0.0.1:15721/v1；真实的 8848API 地址和密钥仍由 CC Switch 管理。

ChatGPT / Codex 桌面版
        ↓
CC Switch 本地代理（127.0.0.1:15721）
        ↓
8848API（https://api.884819.xyz/v1）

6. 启用 8848API，并保留官方登录（推荐）

  1. 如果需要保留 Codex 官方账号、手机远程和官方插件，进入 设置 → 通用 → Codex 应用增强。
  2. 打开“切换第三方时保留官方登录”。
  3. 回到 Codex 供应商列表，找到 8848API，点击“启用”。
  4. 确认 CC Switch 顶部代理状态为运行中，并且 Codex 路由已开启。

开启后，Codex 仍可能显示你的官方 ChatGPT 账号，这是正常现象；模型流量会按 CC Switch 当前供应商转发到 8848API。

7. 重启 Codex 并验证

  1. 完全退出 ChatGPT / Codex 桌面版，再重新打开。
  2. 新建一个任务，发送：只回复：8848API 连接成功。
  3. 打开 CC Switch 的“用量 / 请求日志”，确认出现一条 Codex 请求。
  4. 日志中的供应商应为 8848API，状态码应为 200。
  5. 8848API 控制台出现对应调用记录，即表示配置完成。
不要只看 Codex 界面显示的账号名称判断流量去向。最可靠的判断是：CC Switch 当前供应商 + CC Switch 请求日志 + 8848API 调用记录。

日常使用

  • 先打开 CC Switch 并确认代理为绿色运行状态。
  • 确认 Codex 路由已开启。
  • 确认当前供应商为 8848API。
  • 再启动 ChatGPT / Codex 桌面版。

安全建议

  • 代理只监听 127.0.0.1。
  • 不要把 API Key 写进公开文件。
  • 不要把 CC Switch 数据库分享给别人。
  • 切换供应商后重启 Codex，避免旧配置缓存。

常见问题

Codex 提示 401 / Unauthorized

检查 CC Switch 中的 8848API Key 是否完整，确认令牌未被禁用、未过期，并且没有多余空格。

提示 404、模型不存在或模型列表为空

Base URL 必须填写 https://api.884819.xyz/v1；模型名必须与 8848API 控制台当前可用模型完全一致。可在供应商编辑页点击“获取模型”。

CC Switch 有供应商，但 Codex 还是走官方

确认 8848API 已点击“启用”，代理服务正在运行，并且“应用路由”中的 Codex 开关已打开。然后完全退出并重启 Codex。

关闭 CC Switch 后 Codex 无法请求

这是正常现象：当前客户端指向本机代理。重新打开 CC Switch 并启动代理；或者先在 CC Switch 中关闭 Codex 路由，让它恢复原配置。

端口 15721 被占用

先停止代理，在 CC Switch 中换一个空闲端口，保存后重新启动；不要只修改端口却不重新接管 Codex。

Codex 仍显示官方 ChatGPT 账号，是不是没成功？

不一定。开启“切换第三方时保留官方登录”后，账号界面继续显示官方账号是预期行为。请以 CC Switch 请求日志和 8848API 调用记录为准。

8848AI 静态使用文档｜CC Switch 仅在本机管理配置和转发请求｜页面不读取数据库，不保存用户信息。