Home → Guides → 把 Claude 桌面版與 Codex 指向 APICLAN

把 Claude 桌面版與 Codex 指向 APICLAN

Q: 該填的位址，以及 /v1 那條規則

所有請求都必須落在以 /v1 開頭的路徑上。至於你要不要在用戶端裡自己把 /v1 打進去，取決於用戶端 —— 有的會自動補，有的不會。我們收到的「連不上」回報，大多數就是卡在這一處。 填反了，請求會在邊緣直接 404，代表它根本沒到閘道，也不會出現在你的用量紀錄裡 —— 所以「紀錄裡什麼都沒有」本身就是症狀。位址結尾不要帶斜線。

桌面用戶端本身的設定裡沒有填 base URL 的欄位，這份設定由 CC Switch 替你寫。以下是該填什麼，以及幾乎所有設定失敗都栽在的那兩件事。

開始之前

你需要一個有餘額的帳號和一把 API 金鑰。在主控台的「API 金鑰」裡建立：先選你要呼叫的廠商 —— Claude 桌面版選 Anthropic，Codex 選 OpenAI —— 再選要從哪個分組扣款。分組決定你的價格，每個模型多少錢見價格頁。

一把金鑰只屬於一個分組。為文字模型建立的金鑰無法呼叫圖片模型，反之亦然；這種情況回傳的是模型 404，而不是權限錯誤。兩邊都要就建兩把。某把金鑰究竟能呼叫什麼，一律以帶著它請求 GET /v1/models 的結果為準。

該填的位址，以及 /v1 那條規則

所有請求都必須落在以 /v1 開頭的路徑上。至於你要不要在用戶端裡自己把 /v1 打進去，取決於用戶端 —— 有的會自動補，有的不會。我們收到的「連不上」回報，大多數就是卡在這一處。

用戶端	請求位址要填什麼
Claude Desktop (via CC Switch)	`https://apiclan.us/v1`
Codex / ChatGPT desktop app	`https://apiclan.us/v1`
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	`https://apiclan.us/v1`
Cursor, Cline, Roo Code	`https://apiclan.us/v1`
Claude Code	`https://apiclan.us`
Anthropic SDK	`https://apiclan.us`

填反了，請求會在邊緣直接 404，代表它根本沒到閘道，也不會出現在你的用量紀錄裡 —— 所以「紀錄裡什麼都沒有」本身就是症狀。位址結尾不要帶斜線。

Codex：現在裝在 ChatGPT 桌面用戶端裡

Codex 已併入 ChatGPT 桌面應用程式。Windows 在 Microsoft Store 搜尋 ChatGPT 安裝；macOS 至 OpenAI 官網下載。命令列版 Codex 的設定方式相同。

在 CC Switch 裡為 Codex 新增一個供應商，貼上金鑰，請求位址填 https://apiclan.us/v1。啟用它，然後完全結束 Codex —— 不是關掉視窗 —— 再重新啟動。設定只在啟動時讀取，還在執行的實例會繼續用舊設定，看起來就像什麼都沒生效。

如果你不想用 CC Switch，寧願直接改設定檔，base URL 和金鑰該放哪，都寫在快速上手裡。

Claude 桌面用戶端

先從 claude.com 安裝 Claude 桌面用戶端，然後在 CC Switch 裡設定供應商：

開啟 CC Switch，選擇 Claude 桌面版，新增供應商。
名稱隨你取，把 APICLAN 的金鑰貼進 API Key 欄位。
請求位址填 https://apiclan.us/v1 —— 用戶端會自己在後面補 /messages。結尾不要帶斜線。
儲存，然後啟動 Claude 桌面用戶端，選一個模型。

如果 CC Switch 讓你在「直連」和「模型對應」之間選，先看下一節再決定。這個選項決定了模型選單能不能用。

模型選單出現閘道錯誤時

顯示「連線正常，但供應商拒絕了請求」，問題幾乎都出在模型名稱上，而不是金鑰。桌面用戶端送出的是它內建的那套模型識別碼，而閘道只能提供上游帳號真正有的模型。

解法是用模型對應而不是直連：把用戶端裡的項目對應到本閘道實際提供的模型名稱上。只有當供應商恰好認得用戶端送來的那些識別碼時，直連才成立。

帶著你的金鑰請求 GET /v1/models，取得可以對應的清單。這份清單是依你這把金鑰所在的分組算出來的，是針對你帳號的真實答案，不是通用型錄。

切回官方帳號

沒有任何東西被永久覆寫。在 CC Switch 裡重新啟用官方供應商並重啟用戶端，桌面應用就回到你的訂閱上。兩套可以一直留著隨時切 —— 這裡的餘額是預付、不會過期，暫時不用的那套留著也不花錢。

若還是不行

回傳 404，用量紀錄裡什麼都沒有 —— 位址錯了。對照上表看這個用戶端要不要 /v1，並去掉結尾的斜線。
回傳 401 —— 金鑰沒真正帶進請求。重新貼一次；它很長，複製少一截和填錯的表現一模一樣。
同一把金鑰，別的模型都行就某一個不行 —— 那個模型在另一個分組裡。選對分組再建一把金鑰；改權限是解決不了的。

還是卡住？把失敗的模型名稱和大致時間寄到 support@apiclan.us，有真人看。

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.