> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> AIHubMix Skill は、Codex、Claude Code、Cursor、Cline などの AI Agent に、リアルタイムのモデル検索、接続設定、サンプル生成、エラー調査機能を提供します。

**AIHubMix Skill** は、AI コーディング Agent 向けのローカル拡張機能です。インストール後は、Codex、Claude Code、Cursor、Cline など Skills 対応 Agent の中で、自然言語だけで AIHubMix の接続、モデル検索、能力別の選定、サンプル生成、エラー調査を行えます。

この Skill は固定のモデル一覧を内蔵しません。必要なときに AIHubMix 公式 API からモデル、価格、コンテキスト長、プロトコル契約などのリアルタイム情報を取得し、Agent が古い記憶に依存しないようにします。

## 利用シーン

| シーン          | こう言えます                          | Skill が行うこと                                                |
| ------------ | ------------------------------- | ---------------------------------------------------------- |
| AIHubMix を接続 | “このプロジェクトを AIHubMix に接続して”      | プロジェクト構成を判定し、適切なプロトコルを選び、最小構成の実行可能な接続方法を示します               |
| モデルを検索       | “gemini の最新利用可能モデルを調べて”         | AIHubMix のリアルタイムモデル API から結果を取得して整理します                     |
| 能力で選定        | “利用できる画像入力モデルは？”                | vision、画像生成、動画、TTS、STT、embedding、rerank などの能力で候補モデルを絞り込みます |
| サンプル生成       | “Anthropic messages の呼び出し例を出して” | OpenAI、Anthropic、Gemini などのプロトコル向けに実行可能な例を生成します            |
| Key を確認      | “このモデルが使えるか確認して”                | 実際の最小リクエストで API Key とモデルの呼び出し可否を検証します                      |
| エラー調査        | “この 401 / 400 はなぜ？”             | エンドポイント、モデル、エラー本文、リクエスト ID をもとに対処方法を分析します                  |

## 前提条件

* Codex、Claude Code、Cursor、Cline、Gemini CLI、OpenCode など、Skills 対応 AI Agent を少なくとも 1 つインストールしていること。
* ローカルで Python 3.8 以上を実行できること。
* 実際にモデルを呼び出す場合は、[AIHubMix API Key](https://console.aihubmix.com/token) を用意してください。
* 残高、Key 一覧、現在のアカウントで呼び出せるモデルを確認する場合は、公式 `aihubmix` CLI を追加でインストールしてログインしてください。

## インストール

### 方法 1: Agent にインストールしてもらう

現在使っている AI Agent に、次の指示を渡します。

```text theme={null}
https://github.com/AIhubmix/skills から AIHubMix Skill を取得し、現在のツールの Skills ディレクトリに配置してください。

Claude Code では ~/.claude/skills、
Codex では ~/.codex/skills を使用できます。

インストール後、python <skill>/scripts/AiHubMixAPI.py --help を実行して確認してください。
```

### 方法 2: 手動インストール

```bash theme={null}
# Claude Code
cp -r AiHubMixAPI ~/.claude/skills/

# Codex
cp -r AiHubMixAPI ~/.codex/skills/
```

<Tip>
  Agent によって Skills ディレクトリは異なります。使用中のツールが共有ディレクトリを使う場合は、その Agent の Skills ドキュメントを先に確認するか、Agent にインストール先を判断させてください。
</Tip>

## 任意: AIHubMix CLI をインストール

`AiHubMixAPI` スクリプトは公開モデル情報とプロトコル情報を取得できます。アカウント残高、Key 管理、現在のアカウントで実際に呼び出せるモデルなどは、公式 CLI にログインして確認します。

```powershell theme={null}
# Windows
irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
```

```bash theme={null}
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
```

インストール後に実行します。

```bash theme={null}
aihubmix login
aihubmix whoami
aihubmix models list
```

## 使い方

インストール後は、通常コマンドを覚える必要はありません。Agent に直接タスクを伝えます。

```text theme={null}
この Next.js プロジェクトを AIHubMix に接続し、呼び出し可能なテキストモデルで smoke test を実行して。

AIHubMix 上の Claude 系列の最新モデルと価格を調べて。

使える画像生成モデルは？現在のアカウントで呼び出せるものだけ表示して。

このエンドポイントが 401 を返します。Key、Base URL、モデル権限のどれが原因か確認して。
```

Agent が自動で Skill を起動しない場合は、明示的に呼び出します。

```text theme={null}
/AiHubMixAPI gemini の最新モデルを調べて
/AiHubMixAPI この 400 エラーを調査して
```

## コマンドラインでの使い方

Skill ディレクトリに入った後、スクリプトを直接実行することもできます。

```bash theme={null}
# モデルを検索
python scripts/AiHubMixAPI.py list --limit 20
python scripts/AiHubMixAPI.py report gemini
python scripts/AiHubMixAPI.py compare <model-a> <model-b>

# 能力別に候補モデルを探す
python scripts/AiHubMixAPI.py candidates --capability vision
python scripts/AiHubMixAPI.py candidates --capability image-gen
python scripts/AiHubMixAPI.py candidates --capability rerank

# 現在のアカウントで呼び出せる候補だけを表示。ログイン済みの aihubmix CLI が必要です
python scripts/AiHubMixAPI.py candidates --capability vision --mine

```

中国語で出力したい場合は `--lang zh` を追加するか、次を設定します。

```bash theme={null}
export AIHUBMIX_LANG=zh
```

## 能力早見表

| 能力               | 推奨コマンド                                                              |
| ---------------- | ------------------------------------------------------------------- |
| モデル一覧を見る         | `list`                                                              |
| モデルまたは系列を検索      | `get <model-id>` / `report <query>`                                 |
| 複数モデルを比較         | `compare <model-a> <model-b> ...`                                   |
| 能力で選定            | `candidates --capability <capability>`                              |
| 呼び出せるモデルだけ表示     | `candidates --capability <capability> --mine`                       |
| API Key を検証      | `doctor --model <model-id>`                                         |
| 画像入力を検証          | `doctor --model <model-id> --image`                                 |
| OpenAI 互換例を生成    | `example chat --model <model-id>`                                   |
| Anthropic 互換例を生成 | `example messages --model <model-id>`                               |
| エラーを調査           | `troubleshoot --status <code> --endpoint <path> --model <model-id>` |

## よくある質問

### インストール後に 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 説明、チャットログに書き込まないでください。ローカル検証では環境変数を使用してください。

## 関連リソース

* Skill リポジトリ：[https://github.com/AIhubmix/skills](https://github.com/AIhubmix/skills)
* AIHubMix CLI：[https://github.com/AIhubmix/platfrom-cli](https://github.com/AIhubmix/platfrom-cli)
* AIHubMix モデル広場：[https://aihubmix.com/models](https://aihubmix.com/models)