Codex/ChatGPT
推荐使用 CC Switch 管理 Codex/ChatGPT 的 Provider 配置。你可以把 getapi.one 和 getapi.pro 分别保存成两个配置，后续切换服务或模型时不用反复手动改 Key。
TIP
推荐路径：先安装 CC Switch，再准备要使用的 Codex/ChatGPT 客户端，然后把 GetAPI 添加为 OpenAI Compatible Provider。
本文统一使用 Codex/ChatGPT 这个名称，覆盖当前 Codex 相关客户端体验以及 ChatGPT 桌面端相关使用场景。
下载安装
CC Switch 下载
优先使用 CDN 包下载。如果系统需要其它版本，可以从 CC Switch Releases 页面下载。
| 客户端 | 系统 / 场景 | CDN 下载 | 备用下载 |
|---|---|---|---|
| CC Switch | macOS | 下载 | GitHub Releases |
| CC Switch | Windows | 下载 | GitHub Releases |
| CC Switch | 更多版本 | — | GitHub Releases |
Codex/ChatGPT 下载
当前桌面端优先使用 ChatGPT 桌面版。如果你需要独立 Codex 客户端，可以下载下面对应版本；苹果 Intel 芯片也可以到 OpenAI Codex Releases 下载对应版本。
| 客户端 | 系统 / 场景 | 推荐下载 | 官方 / 备用 |
|---|---|---|---|
| ChatGPT 桌面版 | macOS / Windows / Linux | 官方下载 | 文档 |
| Codex 客户端 | macOS（M 芯片 / Apple Silicon） | 下载 | GitHub Releases |
| Codex 客户端 | macOS（Intel 芯片） | 下载 | GitHub Releases |
| Codex 客户端 | Windows | 下载 | GitHub Releases |
| Codex IDE 插件 | VS Code / Cursor / Windsurf / JetBrains | 文档 | 文档 |
如果你使用终端版，请查看单独的 Codex CLI 配置文档。
开始前准备
- 已安装 CC Switch。
- 已安装准备使用的 ChatGPT 桌面版、Codex 客户端或 IDE 插件。
- 已完成 GetAPI 注册和登录。如果还没有完成，先查看注册和登录总览。
- 已申请 GetAPI API Key。如果还没有创建，先查看申请 API Key 总览。
- 确认这次要使用 getapi.one 还是 getapi.pro。
- 确认要使用的模型名称。
选择 GetAPI 服务
API Key 和 Base URL 必须来自同一个服务。Codex 和 CC Switch 配置时，Base URL 需要带上 /v1。不要把 getapi.one 的 Key 配到 getapi.pro 的中转地址，也不要反过来混用。
| 服务 | Codex Base URL | API Key 来源 | 申请说明 |
|---|---|---|---|
| getapi.one | https://www.getapi.one/v1 | getapi.one API Keys | 申请说明 |
| getapi.pro | https://relay-api.getapi.pro/v1 | getapi.pro API Keys | 申请说明 |
使用 CC Switch 配置
1. 打开 CC Switch
先打开 CC Switch，准备进入 Codex 供应商配置区域。
2. 打开 Codex 供应商页
在 CC Switch 顶部选择 Codex 供应商页，然后点击右上角加号新增供应商。
3. 选择自定义配置
进入添加新供应商页面后，选择“自定义配置”；如果没看到，可以向下滑动查找。
4. 填写 GetAPI 供应商
填写供应商名称，粘贴对应服务的 API Key，并在 API 请求地址中填写带 /v1 的地址，例如 https://relay-api.getapi.pro/v1。
| 配置项 | getapi.pro | getapi.one | 说明 |
|---|---|---|---|
| 供应商名称 | GetAPI Pro | GetAPI One | 自定义名称，方便后续识别。 |
| 官网链接 | https://www.getapi.pro | https://www.getapi.one | 填写供应商官网；如果 CC Switch 不强制要求，也可以不填。 |
| API Key | getapi.pro 的 API Key | getapi.one 的 API Key | 从对应站点的 API 密钥页面复制，不要混用两个站点的 Key 和地址。 |
| API 请求地址 | https://relay-api.getapi.pro/v1 | https://www.getapi.one/v1 | 必须带上 /v1。 |
| 默认模型 | 例如 gpt-5.6-sol | 例如 gpt-5.6-sol | 填写对应 GetAPI 控制台中可用的模型名称。 |
5. 启用供应商
保存后回到供应商列表，点击“启用”，让 Codex 使用刚刚添加的 GetAPI 配置。
验证是否成功
1. 在 Codex/ChatGPT 中验证
打开 Codex/ChatGPT 发送一条简单消息。如果模型正常回复，说明 Provider 已经可以使用。
常见问题
| 问题 | 可能原因 |
|---|---|
| 401 / Unauthorized | API Key 错误、已禁用，或 Key 和服务地址不匹配。 |
| 404 / Not Found | Base URL 填写错误、缺少 /v1，或客户端自动拼接了不兼容的路径。 |
| Model not found | 模型名称填写错误，或当前分组没有开通该模型。 |
| 请求无响应或超时 | 余额不足、额度限制、速率限制、网络异常或服务异常。 |
安全提醒
不要把 API Key 放进公开截图、公开仓库、前端代码或共享文档中。需要发截图排查问题时，先遮盖 Key、账号和余额信息。
参考链接
OpenAI 官方文档提供 ChatGPT App、Codex CLI 和 Codex IDE 插件参考。上面的 CDN 下载链接是项目提供的镜像入口。