用 CC Switch 接入 Voguesly API

2026-10-17 定價更新：請以當前價目頁所選渠道、模型及最終帳單為準；模型例外價優先於分組折扣。舊的 GPT官+AZ 混合、Claude特供分組已停止在本站銷售。本文早於19:56的實測金額是調價前歷史記錄，不是當前固定單次收費。

Claude Desktop、Claude Code 與 Codex 的圖文配置指南 · macOS · 2026-10-17

當前驗證：CC Switch 4.0.13、Claude Desktop Cowork 已通過本站 Sonnet 5.5 返回 OK，並核對客戶與代理日誌。Codex App 與 CLI 已通過本站 GPT-5.6 Terra 短文本並核對扣費，具體配置和帳單見第5、6節；Codex CLI 已以 none 推理模式通過兩輪真實工具／讀寫文件／編碼測試，帶推理的密文續接仍有上游兼容問題，App 工具未驗。當前按渠道展示售價，單獨模型例外價保留；以實時價目和帳單為準。

1. 先分清四個入口

CC Switch 是配置管理和可選的本地轉發工具。它不是模型供應商，也不附送本站餘額；本站 API 用量與 Claude / ChatGPT 官方訂閱分開計算。一個入口配置成功，不代表另外三個也已生效。

先看 API 註冊、餘額、首個請求與 Chatbox 入門教程。

2. 準備工作

1. 從 CC Switch 官方項目 安裝適合自己系統的版本。本教程以實際安裝的4.0.13界面為準；後續版本按鈕可能變化。
2. 登入 本站，確認錢包有餘額，準備自己的已有 API key。
3. 從本站“API 密鑰”頁複製現有key；帳號郵箱和登入密碼都不是API key。密鑰只填 CC Switch 的遮罩框，不放教程、截圖、分享連結或聊天中。
4. 第一次驗證新建空聊天，不恢復含私人文件或舊模型推理內容的歷史會話。
5. 看清當前生效的供應商，保留它作為回退。修改供應商不會代替安裝 Claude Code / Codex 本身。

3. Claude Desktop：本站 Sonnet 5.5（已實測）

填表

左側選擇 Claude Desktop → 添加供應商 → 自定義配置。

本站已驗證原生 /v1/messages。這裡填根地址，客戶端拼接請求路徑；不要把 /v1/messages 或 /chat/completions 當根地址重複填。

啟用

添加後在“易聯”卡片上點 切換。如果當前是路由模式，可選 直連 → 回到直連並使用。看到“直連生效中 · 直接連接 易聯”才表示該配置已經啟用，僅看到供應商卡片不算生效。

然後完全退出並重新打開 Claude Desktop。檢查模型選單中是 Sonnet 5.5，新建空任務發送：

Reply only OK. Do not use tools, files, connectors, web search, or create anything.

本次實測的是 Cowork，不據此承諾 Code 模式、工具調用、文件處理、圖片或長上下文已經驗證。

為什麼不用截圖裡原來的 DeepSeek 映射？

“模型映射”會把客戶端的 Sonnet / Opus / Haiku 檔位改成實際請求的模型。若 Sonnet 一行填寫 deepseek-v4-pro，實際請求就是 DeepSeek，不能對客戶說它調用了 Sonnet。本次要用本站原生 Claude，因此先使用直連及真實 Claude 模型 ID。

如果以後確實要在 Claude Desktop 使用 DeepSeek等其他模型，再選映射模式，並將“選單顯示名”和實際模型對應寫清楚；映射模式需要 CC Switch 保持運行。

4. Claude Code CLI：單獨配置

在 CC Switch 左側選 Claude Code。不要以為 Claude Desktop 的配置會自動套到這裡。

常規自定義供應商填法：

也可從 添加供應商 → 統一供應商 → 自定義網關 一次生成 Claude Code 和 Codex 兩張供應商卡片。它省去重複填 key，但兩邊的協議、啟用和實測仍須分別檢查。不要額外啟用暫時不用的 Gemini 等應用。

保存後啟用本站卡片，在新終端中啟動 claude --model claude-sonnet-5-5，發送一次短問題，再核對站上日誌。若舊終端有遺留 ANTHROPIC_BASE_URL / key 環境變量，可能覆蓋 CC Switch 設定；不要把完整環境變量輸出給客服。

首輪診斷可用 CLI 的輸出預算、禁工具和空目錄方式控制範圍。正常編碼任務則按真實工作需要使用，不要照搬診斷限制到日常工作。

Claude Code 2.1.299：關閉本次上游不接受的實驗性 beta

本次 CLI 起初失敗，客戶日誌顯示上游拒絕若干 anthropic-beta 特性；失敗鏈也有無可用通道503和分組無權限403。不能只看終端最後一條403，就斷定密鑰填錯或需要充值。

在 CC Switch 的 Claude Code → 編輯本站供應商 → 配置 JSON，在已有的 env 對象內新增：

"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"

注意逗號和 JSON 語法。只新增這個字段，不要用它覆蓋整份配置或刪除原有地址、模型、密鑰字段。 點保存，再啟動新的 Claude Code 進程。該設定關閉實驗特性，不是關閉證書校驗或冒充另一客戶端。

也可以先在新終端做一次臨時驗證：

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 claude --model claude-sonnet-5-5

14:17:24 實測已成功： 返回預期測試標記，輸入381／輸出21、5分鐘快取寫入666 tokens，本站實扣 US$0.001318。CLI估算US$0.002637按其本地標價計算，不等於本站最終收費。此為禁工具、空目錄的一條短文本測試；編碼工具、文件修改與完整Agent工作流尚未逐項驗收。

隨後把同一 beta 開關保存到 CC Switch 再做新進程複測，客戶端超時未收到結果；後續刷新查到服務端在14:22:19完成請求，輸入381／輸出18、快取寫636，另扣US$0.001266。因此超時不能直接當作沒有執行或沒有扣費，先查日誌再決定重試。這仍不是客戶端第二次成功驗收。

5. Codex CLI：GPT-5.6 Terra 原生 Responses（已實測）

本次選擇本站剛有成功記錄的 gpt-5.6-terra，不繼續重試飽和的 gpt-6-luna。在 CC Switch 左側 Codex → 添加供應商 → 自定義配置，或編輯已保存的本站供應商：

點 保存，再在 Codex 的 路由 模式選擇此卡片。確認“路由生效中 → 易聯 API · Codex”；保持 CC Switch 和本地路由運行。此路徑中 Codex 的 Responses 請求直接轉發到本站 /v1/responses，無需轉成 Anthropic Messages。不要把完整 /responses 再填進只要 /v1 前綴的欄位。

新開 CLI 進程，在空目錄開始全新會話，使用 /model 選 gpt-5.6-terra。首次只發：

Reply exactly CODEX_CLI_TERRA_OK. Do not use tools.

2026-10-17 16:53:27 實測： Codex CLI 0.162.1 返回 CODEX_CLI_TERRA_OK，退出碼0；本站記錄 Azure、輸入17,167／輸出11、快取寫入17,164 tokens，實扣 US$0.019372。客戶請求ID與代理日誌精確匹配。這次為隔離空目錄、read-only、單次且禁自動重試的短文本驗證，保留真實工具定義，但沒有執行工具或修改文件，不能據此宣稱完整編碼工作流已驗收。

若請求先在本地報502，檢查 CC Switch 設定 → 網絡 → 全局出站代理 是否與自己的網絡相符。本機使用已經運行的本地代理才到達上游；每台電腦端口可能不同，不能照抄端口。不要關閉證書驗證，也不要為此隨意切換系統TUN。

已知失敗路線： 本次 gpt-6-luna 返回429“上游負載已飽和”，已停止反覆測試；Sonnet經 Responses→Messages 轉換時，Bedrock拒絕 tools.*.strict 返回400，因此本教程不把這條轉換路線列為已通過。不要刪掉全部工具定義來湊一個“編碼接通”的結論。

多輪編碼：已驗證的 none 兼容方案

適用範圍：Codex CLI 0.162.1、CC Switch 4.0.13、本站 gpt-5.6-terra 原生 Responses。 先確認 CC Switch 顯示“路由生效中 → 易聯 API · Codex”，再開一個不含私人文件的空測試目錄，啟動新會話：

mkdir -p ~/ylink-codex-demo
cd ~/ylink-codex-demo
codex -m gpt-5.6-terra -c 'model_reasoning_effort="none"'

none 表示關閉該模式的深度推理，不是換模型，也不是關閉工具、沙盒、審批或證書驗證。它可能降低複雜任務的推理能力；本次只是針對密文續接錯誤驗證的兼容選擇。這個啟動參數不改寫全局配置。目錄裡已有內容時，請另選一個空目錄；在正常權限提示中只批准本測試需要的操作。

可以在同一個會話依次驗證下面兩輪，不要每輪都重開新聊天：

1. 第一輪：創建 Python invoice.py 的 total(rows)，用 Decimal 計算金額並 HALF_UP 保留兩位；創建 unittest，檢查空列表、0.10×3+19.99×2=40.28、1.005→1.01，實際運行測試。
2. 第二輪：先讀取剛才兩份文件，再把函數改為 total(rows, discount_percent="0")；折扣在最終舍入前計算，拒絕低於0或高於100的折扣，新增10%、100%、範圍及舍入測試，再實際運行全部測試。

2026-10-17 17:15–17:16 實測： 第一輪真實創建兩個文件並通過3條測試；第二輪恢復同一會話ID，真實讀文件、更新兩個文件並通過7條測試，返回 TOOL_ROUND2_OK；獨立重跑7條全部通過，兩份文件的字節確實改變。兩輪推理輸出均為0，歷史中沒有新增加密推理條目。

客戶精確金額與代理同時間、模型、token記錄匹配；第一輪輸入32,141／輸出544，第二輪新增輸入35,288／輸出678。客戶端 resume 的 usage 是會話累計數，不能把兩次累計值再相加。快取讀取已命中，實際金額隨上下文和路由變化，以上不是固定任務報價。

encrypted_content 報錯意味著什麼

此前 low 推理模式在工具續接時報“encrypted content could not be verified / decrypted or parsed”。本次不經過 Codex CLI，將同一段測試密文原樣回傳，上游仍記錄相同400，之後該請求返回成功；CC Switch 本機記錄只有一次向本站轉發，沒有密文整流重試日誌。結合4.0.13原生轉發源碼，證據主要指向上游密文續接／內部重試兼容，未發現 CC Switch 篡改該密文的證據。究竟是否由上游帳號、通道或密鑰域變化引起，尚未證實。

none 兩輪通過是規避這條故障路徑，不代表上游帶推理的原路線已修復。已有帶舊密文的會話不要靠修改或刪除歷史來“修復”；先保存工作，再開新會話使用此兼容參數。不要關閉 TLS 校驗，也不要持續點重試。本次定位額外三條小探針合計US$0.000260，加上兩輪編碼，整個排查共US$0.025690。

Codex App 仍只驗證到短文本。 CLI 的兩輪成功不能替代 App 的工具／文件／多輪驗收，也不保證長任務、併發或長期穩定性。需要深度推理時，保留可回退的供應商；不要把 none 說成與高推理模式能力相同。

6. Codex 桌面 App：GPT-5.6 Terra（已實測）

1. 在 CC Switch 設定 → 應用配置 → Codex 保持 “非接管切換時保留官方登入” 開啟；路由接管期間亦保留官方登入。不要把官方登入 token 當本站 API key。
2. 使用第5節同一張供應商卡：https://api.ylink.uk/v1 + gpt-5.6-terra + Responses（原生），保存並啟用路由。
3. 在 Codex App 新建空聊天，從模型選單選 GPT-5.6 Terra。選單顯示名和本站精確模型名可能格式不同；最終查本站日誌。不要恢復原供應商的舊會話，避免把舊內容發送給新供應商，或遇到 encrypted_content 無法解密。
4. 發送一次下方測試；若模型選單沒有相應條目，保存配置後再啟動新的 App 進程檢查，先保存正在做的工作。

Reply exactly CODEX_APP_TERRA_OK. Do not use tools.

2026-10-17 16:54:10 實測： App返回 CODEX_APP_TERRA_OK，CC Switch記錄Codex→易聯API路由；本站實際模型 gpt-5.6-terra、Azure、推理強度high，輸入20,361／輸出9、快取寫入20,358 tokens，實扣 US$0.022954。客戶與代理同一請求ID核對通過。

同次操作在代理日誌中還看到一條503“High demand”，費用US$0，之後成功；沒有逐層抓包，不判斷重試由客戶端、本地路由還是上游哪層觸發。這證明本次可以調用，不代表無波動或固定可用率。 遇錯先查日誌，不連續點發送。

兩端真實帳單（非固定單次報價）

兩筆主要是首次快取寫入，不是快取讀取命中；客戶端會附帶系統指令和工具定義，短短“OK”也不代表只有幾個輸入token。本站本筆按standard檔及0.45折扣，分別列新增輸入、輸出與快取寫入，費用最終按本站明細取整。客戶端／CC Switch本地估算不等於本站實扣。此頁不改變任何售價，不把這兩筆當作所有後續任務的價格。

7. 真實費用：不要拿一句“OK”的字數估價

本次 Claude Desktop / Cowork 驗證新增了以下三筆成功記錄，客戶及代理同時間、同模型記錄已匹配：

只有一次手動 Cowork 任務；另外兩筆為本次啟用／任務期間的附加調用，未抓取各自請求正文，不能斷言分別是什麼用途。主請求的費用主要來自快取寫入。Agent 可能自動附帶系統提示、工具定義、歷史和輔助請求，簡短回答不等於低輸入量。

這些是本次樣本，不是固定任務價。請在 使用日誌 查看自己的時間、模型、分組、輸入輸出、快取、最終金額和請求ID。客戶端估算、代理四位小數顯示、錢包四舍顯示都不能代替精確費用詳情。

後續真實自測：快取讀取已命中（13:51–13:53）

後續同測試帳號的使用日誌已有明確快取讀取樣本：

13:53:42的快取讀取部分實收 US$0.02661285，有效讀價US$0.05／百萬tokens；同檔普通輸入有效價US$1／百萬，讀取該批已有快取比普通輸入便宜95%。整筆還包括新輸入、輸出和新增快取寫入，不能把95%理解為整筆帳單或所有路由的統一折扣。

快取讀取不等於免費，快取寫入也會收費。 第二行雖有命中，但另有44萬餘tokens寫入，因此仍貴。明細證明“大段內容未複用”，具體是內容前綴、路由、快取分段還是其他變化，缺少對應請求證據，不能直接歸因。

同一個key不是快取命中的充分條件；不要只靠切key或頻繁換模型來驗證。先看每筆的快取讀取／寫入和適用時長。日誌裡另有503無通道、403分組權限樣本，均顯示US$0；這與快取是否命中分開排查，不循環重試。

8. 排錯與恢復

回退時回到原供應商卡片切換；Claude Desktop可選 Claude Desktop Official 恢復官方模式，再重啟。只切供應商，不刪除原帳號、歷史或備份。日誌先查明再重試，避免重複扣費。

9. 驗證邊界與來源

• 已完成：本機Claude Desktop本站直連、Sonnet5.5短任務、三筆新增費用與代理記錄匹配。
• 已完成：Claude Code 2.1.299 關閉實驗 beta 後，Sonnet 5.5 短文本成功並核對本站扣費。
• 已完成：Codex CLI 0.162.1 與桌面 App，GPT-5.6 Terra 原生 Responses 短文本、客戶/代理同請求核費，均返回指定標記。
• 已完成：Codex CLI 的 none 模式，同會話兩輪真實工具／文件／3→7條測試及獨立復跑；帶推理原路線仍有密文兼容錯誤。
• 尚未完成：Codex App工具、多輪編碼，Claude工具工作流，Opus、Haiku、1M上下文、圖片、長任務與併發；共享通道穩定性不作保證。
• 教程按上述驗證邊界公開；未驗證鏈路僅提供配置參考。

官方參考（配置行為參考，不等於本站實測）：

• CC Switch官方README
• Claude Desktop手冊
• Codex使用Claude的路由指南

• Codex桌面自定義模型顯示排障

• OpenAI Responses：推理狀態與密文續接

• CC Switch 4.0.13 原生 Responses 轉發源碼

前往 API 站註冊／使用 · 查看當前分檔價格

API 服務與住宅 IP 套餐分別計費。網絡排查見 連接自測；本頁不承諾共享通道 SLA、零保留或退款保證。具體使用與退款條件以 API 站現行條款為準。