Agent 快速接入
透過 CC Switch 為 Claude Desktop 接入 Tokatlas
在 CC Switch 中設定提供方，再由 Claude Desktop 使用 Tokatlas。
開始之前
安裝 Claude Desktop 與支援 Desktop 面板的 CC Switch 版本。本指南使用 CC Switch 的第三方設定檔整合方式。
準備 Tokatlas API Key 與帳戶已開通模型。替換全部 YOUR_... 佔位值，合併設定前先備份既有內容。
連線設定
| 設定 | 內容 |
|---|---|
| 提供方名稱 | Tokatlas |
| 協定 | Messages |
| 端點／Base URL | https://api.tokatlas.ai |
| API Key | YOUR_TOKATLAS_API_KEY |
| Model ID | YOUR_TOKATLAS_MODEL_ID |
設定步驟
- 在 CC Switch 選擇 Claude Desktop，新增名為 Tokatlas 的自訂提供方。此入口與 Claude Code 分開。
- 選擇 Anthropic Messages 格式，填入 Tokatlas 端點與金鑰。使用直連模式前，確認閘道接受 Desktop 模型 ID 與驗證方式。
- 若實際模型 ID 需要映射，啟用模型映射，將 Desktop 角色對應至 Tokatlas 已開通的完整模型 ID，並保持 CC Switch 本機路由執行。
- 啟用提供方，完全退出 Claude Desktop，重新開啟後測試新對話。
在 CC Switch 中新增提供方
下圖是 CC Switch 的 Add New Provider（新增提供方）頁面，並非 Claude Desktop 本身的設定介面。
先開啟 CC Switch，切換至其中的 Claude Desktop 分頁，再按右上角 + 進入下圖頁面。選取 Custom Configuration，在 Provider Name 填入 Tokatlas，接著依上方步驟完成端點、金鑰與模型設定。圖中的其他預設提供方無須選取。
截圖來源：CC Switch 官方文件（原圖，介面可能隨版本調整）。
相容性說明
相容性取決於 Desktop 與 CC Switch 版本，此流程尚未對 Tokatlas 完成實際聯調。若要恢復原登入方式，在 CC Switch 啟用 Claude Desktop Official 並重啟 Desktop。
驗證與排錯
- 開啟新對話，傳送「只回覆 OK」，確認收到文字回覆。
- 到 Tokatlas 用量記錄確認同一時間有成功請求，且模型符合設定。
- 需要工具時，再請客戶端列出測試目錄中的檔案；確認工具結果有回到對話。
- 若第一步失敗，先依 API 使用入門直接測試金鑰與模型。直接呼叫成功後，再依下表排查客戶端設定。
| 問題 | 檢查項目 |
|---|---|
401／403 | 重新貼上 Tokatlas 金鑰，移除引號與空白，核對驗證模式及模型權限。 |
404 | 對照上表檢查完整 URL，移除重複的 /v1 或端點後綴。 |
| 未知模型 | 從可用列表複製完整 ID，儲存後在新對話中選取該模型。 |
| 工具失敗 | 模型能力與客戶端協定支援。 |
| 變更未生效 | 切換至 Tokatlas 提供方／profile，完全退出客戶端後重新開啟。 |