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 描述或聊天记录中；本地调试时使用环境变量传入即可。
相关资源
