AIHubMix Skill 是面向 AI 編程助手的一套本地擴展能力。安裝後，你可以在 Codex、Claude Code、Cursor、Cline 等支援 Skills 的 Agent 裡，用自然語言完成 AIHubMix 接入、模型查詢、能力選型、範例生成和錯誤排查。
該 Skill 不內建固定模型清單，而是在需要時從 AIHubMix 官方介面讀取模型、價格、上下文、協議契約等即時資訊，讓 Agent 避免依賴過期記憶。
適用場景
前置條件
- 至少安裝一個支援 Skills 的 AI Agent，例如 Codex、Claude Code、Cursor、Cline、Gemini CLI、OpenCode 等。
- 本機可執行 Python 3.8 或更高版本。
- 如需真實呼叫模型，需要準備 AIHubMix API Key。
- 如需查詢餘額、Key 列表或目前帳號可呼叫模型，需要額外安裝並登入官方
aihubmix CLI。
方式一：讓 Agent 幫你安裝
把下面這段話交給目前使用的 AI Agent：
方式二：手動安裝
不同 Agent 的 Skills 目錄可能不同。如果你的工具使用統一目錄，可優先查看該 Agent 的 Skills 文件，或讓 Agent 自動判斷安裝位置。
可選：安裝 AIHubMix CLI
AiHubMixAPI 腳本可以讀取公開模型和協議資訊；帳戶餘額、Key 管理、目前帳號實際可呼叫模型等資料需要官方 CLI 登入後查詢。
安裝後執行：
如何使用
安裝完成後，通常不需要記命令。直接在 Agent 裡描述任務即可：
如果 Agent 沒有自動觸發，可以顯式呼叫對應 Skill，例如：
命令列用法
進入 Skill 目錄後，也可以直接呼叫腳本：
中文輸出可以追加 --lang zh，或設定：
能力速查
常見問題
安裝後 Agent 沒有自動呼叫
不同 Agent 對 Skill 觸發的策略不同。可以先直接輸入 /AiHubMixAPI 顯式呼叫；也可以把需求說得更明確，例如包含“AIHubMix”“模型”“Base URL”“API Key”“報錯碼”等關鍵詞。
公開模型列表裡有模型，但我的 Key 調不通
公開模型列表只說明平台存在該模型，不代表目前帳號一定有權限或餘額可呼叫。需要使用 aihubmix models list 或 candidates --mine 查看目前帳號實際可呼叫範圍，再用 doctor --model <model-id> 做真實校驗。
什麼時候需要安裝 aihubmix CLI
只查公開資料時不需要。需要餘額、Key 管理、帳號可呼叫模型、--mine 篩選等帳戶相關能力時，需要安裝並登入 CLI。
會不會洩露 API Key
Skill 的腳本會對密鑰做脫敏處理。仍然建議不要把真實 Key 寫入倉庫檔案、Issue、PR 描述或聊天記錄中；本地調試時使用環境變數傳入即可。
相關資源
