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 用戶端，請下載下方對應版本；Apple 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 頁面複製，不要混用兩個站點的 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 下載連結是專案提供的鏡像入口。