CC Switch 設定 API 教學

優先使用穷哥么控制台的一鍵匯入，將服務商、端點、模型與 API Key 安全交給 CC Switch；匯入失敗時，也可以依官方欄位手動設定。

快速設定

建議入口
https://qionggeme.com/console/token
在 API Key 該列的操作選單中選擇「CC Switch」
匯入協定
ccswitch://v1/import
連結可能包含 API Key，禁止複製到公開聊天、支援單或螢幕截圖中
Codex Endpoint
https://qionggeme.com/v1
原生 Responses 協定，不需要本機路由映射
Claude / Gemini Endpoint
https://qionggeme.com
匯入狀態
enabled=true
匯入後仍須確認目標服務商處於啟用狀態

事前準備：

本教學優先使用控制台現有的一鍵匯入，不要求你手動組合 Deep Link。Deep Link 查詢參數可能帶有明文 API Key，請勿分享、轉傳或公開截圖包含 Key 的連結。

設定步驟

  1. 開啟穷哥么 API Key 頁面

    前往 https://qionggeme.com/console/token，找到要匯入的 API Key。在該列的操作選單中選擇 「CC Switch」。不要從瀏覽器網址列複製之後產生的含密鑰連結。

  2. 選擇目標應用程式、服務商名稱與主要模型

    在彈出視窗中選擇 Claude、Codex 或 Gemini，填寫方便辨識的服務商名稱，再選擇主要模型。模型 ID 必須與 價格頁目前可用模型 完全一致。

  3. 點選「Open CC Switch」

    控制台會產生 ccswitch://v1/import Deep Link 並要求開啟 CC Switch。本站產生的內容包含 apiKey、model、homepage 與 enabled=true；Codex 的 endpoint 為 https://qionggeme.com/v1，Claude / Gemini 則為 https://qionggeme.com。

  4. 在 CC Switch 中確認匯入

    CC Switch 會顯示匯入確認畫面。核對應用程式類型、服務商名稱、端點與模型後再確認。官方協定要求匯入前顯示設定預覽並由使用者確認；來源不可信或欄位異常時應取消。

  5. 確認服務商已啟用，並重新啟動目標 CLI

    回到對應應用程式的服務商清單，確認剛匯入的服務商已啟用。若 Claude Code、Codex 或 Gemini CLI 在匯入前已經執行，請關閉並重新啟動該 CLI，讓程序重新讀取設定；尤其是 Codex，官方切換手冊明確要求切換後重新啟動終端機。

  6. 一鍵匯入失敗時手動新增服務商

    在 CC Switch 對應應用程式分頁中新增自訂服務商：

    • Codex 分頁：端點填 https://qionggeme.com/v1，填寫 API Key 與模型；使用原生 responses，不需要開啟本機路由映射。
    • Claude 分頁：端點填 https://qionggeme.com，填寫 API Key 與模型後儲存並啟用。

    手動設定時也不要使用內容站位址，更不能在 API 端點後加上 /docs。

設定範例

# 安全核對表（不顯示真實 API Key，也不組合完整 Deep Link）
協定: ccswitch://v1/import
resource: provider
Codex endpoint: https://qionggeme.com/v1
Claude/Gemini endpoint: https://qionggeme.com
欄位: apiKey, model, homepage, enabled=true

# Codex 手動備用設定
Base URL: https://qionggeme.com/v1
Wire API: responses
本機路由映射: 不需要

疑難排解

點選「Open CC Switch」後沒有開啟應用程式

先確認 CC Switch 已安裝並啟動過。官方說明指出，安裝時會註冊 ccswitch:// 協定；若系統未正確註冊，請依官方 Deep Link 文件重新安裝或修復協定註冊，再從 API Key 頁面 重新發起匯入。

CC Switch 顯示匯入失敗或欄位缺漏

不要手動修改含 Key 的連結。返回控制台重新選擇應用程式、服務商名稱與主要模型後再開啟；若仍然失敗，請依本頁的手動備用方案設定。確認端點分別為 https://qionggeme.com/v1 或 https://qionggeme.com，且不包含 /docs。

匯入成功，但目標 CLI 仍使用舊服務商

在 CC Switch 中確認新服務商狀態為已啟用，再完全結束並重新啟動正在執行的目標 CLI。Codex 需要關閉目前的終端機視窗後重新開啟。

Codex 請求失敗，或誤以為必須開啟本機路由

核對 Codex 端點為 https://qionggeme.com/v1，協定為原生 responses。本站介面不需要 CC Switch 的本機路由映射；只有上游不是原生 Responses（例如僅支援 Chat Completions 或 Anthropic Messages）時才需要轉換。

出現 401、餘額不足或模型不存在

重新核對 API Key 是否有效、權杖權限與餘額，並到 模型價格頁 確認模型 ID。請勿將 Key 或含 Key 的 Deep Link 傳到公開管道求助。

準備好開始了嗎？

註冊 穷哥么 取得 API Key，立即使用全部在售模型

立即註冊

常見問題

CC Switch 一鍵匯入會寫入哪些欄位？

穷哥么產生的服務商匯入內容包含 apiKey、model、homepage、enabled=true，並依應用程式寫入 endpoint：Codex 為 https://qionggeme.com/v1，Claude/Gemini 為 https://qionggeme.com。

可以把 ccswitch:// 匯入連結傳給別人嗎？

請勿分享包含 API Key 的 Deep Link。連結參數可能直接帶有密鑰；公開聊天、支援單、截圖、瀏覽器歷史同步或記錄檔都可能造成外洩。需要協作時，應移除敏感欄位並讓對方使用自己的 Key。

Codex 為什麼不需要本機路由映射？

因為穷哥么的 Codex 端點 https://qionggeme.com/v1 原生支援 Responses 協定。直接填寫 Base URL、API Key 與模型即可；只有非 Responses 上游才需要本機協定轉換。

匯入後為什麼沒有立即生效？

請先確認服務商已經啟用。正在執行的 CLI 可能仍保留舊設定，需要重新啟動；Codex 官方切換說明要求關閉目前終端機視窗後重新開啟。

API 端點可以填寫內容站 /docs 位址嗎？

不可以。Codex 使用 https://qionggeme.com/v1，Claude/Gemini 使用 https://qionggeme.com；API 端點絕不包含 /docs。

相關教學

Codex CLI 設定自訂 API 教學

透過 Codex 官方自訂 model provider 設定接入 穷哥么，密鑰儲存在環境變數中，provider 使用 Responses API。

閱讀教學 →

Claude Code 設定 API 教學

透過環境變數讓 Claude Code 使用 穷哥么 中轉 API，不需要官方訂閱也能使用 Claude 程式開發能力。

閱讀教學 →

Cockpit Tools 設定 API 教學

Cockpit Tools 會管理 Codex profile。必須依照「新增服務商 → 綁定執行個體 → 啟用並啟動」的順序操作，Codex 才會真正使用穷哥么中轉 API。

閱讀教學 →