客戶端指南
選擇命令列、桌面或通用用戶端，並完成可執行的 AIXHUB 串接流程。
本區用來將現成用戶端連到 AIXHUB，並證明請求確實使用預期路由。若要在應用程式或服務程式碼中呼叫，請改從 API 驗證開始。
選擇用戶端
請依工作方式與協定選擇工具。變更設定前先開啟該工具的專用指南，因為各用戶端的 Base URL、憑證儲存方式、模型選擇及復原步驟都不相同。
命令列用戶端
| 用戶端 | 適用情境 | 協定 | 平台摘要 | 指南 |
|---|---|---|---|---|
| Claude Code | Anthropic 相容程式開發流程 | Anthropic 相容 | Windows、macOS 與 Linux | 開啟指南 |
| Codex CLI | 使用 Responses API 的終端機程式開發 | OpenAI Responses | Windows、macOS 與 Linux | 開啟指南 |
| OpenCode | 使用自訂供應端的可設定終端機流程 | OpenAI 相容 | Windows、macOS 與 Linux | 開啟指南 |
| OpenClaw | 多供應端模型與本機代理回合 | OpenAI Responses | macOS 與 Linux；Windows 透過 WSL，支援有限 | 開啟指南 |
桌面用戶端
| 用戶端 | 適用情境 | 協定或角色 | 平台摘要 | 指南 |
|---|---|---|---|---|
| Codex desktop | 桌面 Codex 工作流程 | OpenAI Responses | Windows 與 macOS；沒有原生 Linux 應用程式 | 開啟指南 |
| Cherry Studio | 透過自訂供應端進行圖形化聊天 | OpenAI 相容自訂供應端 | Windows、macOS 與 Linux | 開啟指南 |
| CC-Switch | 管理 Claude Code 與 Codex 設定檔 | Claude Code 與 Codex 設定檔管理 | Windows、macOS 與 Linux | 開啟指南 |
通用備援指南
若其他圖形或命令列用戶端支援自訂 OpenAI 相容供應端與自訂 Base URL，請使用通用 OpenAI 相容指南。已有專用指南的用戶端不要套用通用值，因為 URL 組合或憑證格式可能不同。
準備設定值
開啟用戶端前，先準備以下值：
| 設定值 | 使用內容 |
|---|---|
| API 金鑰 | 只為這個用戶端建立的專用 AIXHUB 金鑰 |
| 模型 | 從模型路由複製的完整 ID；指南範例使用 panel-model-id |
| Anthropic 用戶端 Base URL | https://api.aixhub.org |
| OpenAI 相容 Base URL | https://api.aixhub.org/v1 |
| Responses 完整端點 | 只有欄位明確要求 Full endpoint 時才使用 https://api.aixhub.org/v1/responses |
欄位語意會決定正確值。Base URL 或 API Base 通常使用含版本的基底網址；若用戶端會自行附加 /v1，Host 或 Origin 才可能使用根網址；Full endpoint 則使用完整請求路徑。不要把完整端點填入 Base URL 欄位，也不可產生 /v1/v1。
Claude Code 使用 Anthropic 相容根 Base URL。Codex CLI、OpenCode、OpenClaw 及通用 OpenAI 相容用戶端，則依各自指南使用指定值與 API 模式。請直接複製專用指南內容，不要從另一個工具搬用設定。
完成第一筆成功請求
每個用戶端都依以下順序操作：
-
為這個工具建立獨立的 AIXHUB API 金鑰。不要重複使用其他用戶端或應用程式程式碼的金鑰。
-
從模型路由複製完整相容模型 ID，不要憑記憶輸入模型名稱。
-
開啟上方專用指南；只有沒有專用指南時，才使用通用備援指南。
-
備份目前設定，並記錄供應端、Base URL、模型、API 模式與憑證位置的原始值。
-
設定 AIXHUB、儲存、完整重啟用戶端，再確認作用中的供應端與模型。
-
送出範圍明確的唯讀或不呼叫工具請求，並限制只回傳
OK：不要使用工具，也不要變更任何資料。只回覆 OK。 -
開啟 AIXHUB 用量，核對請求時間、模型與成功狀態。只有用量實際顯示 API 模式或協定時才一併核對，不要假設一定有該欄位。
小型請求與用量記錄一致前，不要啟用工具、核准寫入權限或開始大型工作。
常見錯誤
- 使用官方登入： AIXHUB 金鑰不是 OpenAI、Anthropic 或其他供應商的官方帳號憑證。請使用用戶端指南指定的自訂供應端或 API 流程。
- 所有工具共用一組金鑰： 每個工具使用一組金鑰，程式碼再使用另一組，才能分別輪替、撤銷與調查用量。
- 手動輸入模型名稱： 請從面板複製完整模型 ID；顯示名稱與 ID 不可互換。
- 混淆根網址、Base URL 與完整端點： 先看欄位標示與專用指南，三者不是同一個值。
- 跳過重啟或用量驗證： 執行中的用戶端可能保留舊設定，或悄悄使用其他供應端。請完整重啟，再到用量核對小型請求。
- 洩露金鑰： 不可貼進提示內容、提交、顯示，或放入螢幕擷取畫面與支援記錄。外洩後立即輪替。
選擇 API 或用戶端
選擇用戶端
想直接使用現成的程式開發、代理、聊天、桌面或設定檔管理工具時，請選擇用戶端。依該工具的專用指南操作，讓供應端、URL、憑證、模型、驗證與復原行為都保持明確。
選擇 API
要建置應用程式或服務程式碼時，請選擇 API 接入。另建一組只供該程式碼使用的 AIXHUB 專用金鑰，不要重複使用任何用戶端金鑰，再繼續閱讀：
最後核對：2026-07-14