aihubmix）です。インストールすれば、ウェブコンソールを開かずに、ターミナルからアカウント残高の照会・API Key の管理・利用可能モデルの確認が行えます。単一バイナリで、Python・Node・Go のインストールは不要、1 つのコマンドでインストールできます。すべてのコマンドが JSON 出力に対応しており、スクリプト・CI・AI Agent（Claude Code など）にそのまま組み込めます。
できること：
- 残高照会：アカウント残高と利用済み額をリアルタイムで照会
- Key 管理：API Key の作成・閲覧・検索・変更・削除
- モデル確認：現在のトークンで利用可能なモデルを一覧表示
- スクリプト化：JSON 出力 + 安定した終了コードで、自動化や AI Agent との連携に最適
2 種類の認証情報を混同しないでください：CLI は「システムアクセストークン」（Manage Key、形式
fd***）でログインします。コンソール console.aihubmix.com/setting で「システムアクセストークンを生成」をクリックして取得してください。これはアカウントの管理に使用するもので、モデル呼び出しに使う API Key（sk-***）とは別物です。インストール
ワンクリックインストール（推奨）
ご利用のシステムに対応したコマンドをコピーしてターミナルで実行すると、バイナリがダウンロードされ自動的にPATH に追加されます：
aihubmix login を実行すれば利用を開始できます。
Releases から対応プラットフォームのバイナリを手動でダウンロードすることもできます（Windows は
aihubmix_windows_amd64.exe）。PATH のディレクトリに配置してください。Unix 系では chmod +x が必要です。クイックスタート
ログインすればすべてのコマンドが利用できます：コマンド一覧
よく使う操作
API Key の管理
-q 10 はその Key の上限が $10 であることを、-u は上限なしを意味します。削除はデフォルトで確認を求めますが、CI 環境では --yes を付けてスキップできます。
スクリプト / AI Agent での利用
CLI は自動化に非常に適しており、CI・スクリプト・AI Agent（Claude Code など）から直接操作できます：- ログイン不要：環境変数
AIHUBMIX_TOKENまたは--tokenで Manage Key を渡すことで、対話的なログインをスキップできます（優先順位：--token>AIHUBMIX_TOKEN> 設定ファイル）。 - JSON 出力：任意のコマンドに
--json（-j）を付けると、正常な結果は stdout、エラーは stderr に出力され、jqでのパースが容易です。 - 安定した終了コード：スクリプトはこれに基づいて成否を判定できます。
グローバルパラメータ
以下のパラメータはすべてのコマンドに適用されます：設定ファイル
ログイン情報は~/.aihubmix/config.json（Windows は %USERPROFILE%\.aihubmix\config.json）に保存され、権限は現在のユーザーのみ読み書き可能に制限されます。ログイン時の Manage Key は非表示で、ログにも記録されません。
よくある質問
Python / Node / Go のインストールは必要ですか？ 不要です。CLI は単一バイナリで、ダウンロードすればすぐに使えます。 Manage Key と API Key の違いは何ですか？ Manage Key（fd***）はアカウントの管理（残高照会、Key 管理）に使用し、CLI で利用します。API Key（sk-***）はモデルの呼び出しに使用します。両者はコンソールの別々の場所で生成され、混用できません。
Windows に対応していますか？
対応しています。Windows・macOS・Linux すべてにネイティブバイナリを提供しています。
CI / スクリプトで非対話的に使うには？
環境変数 AIHUBMIX_TOKEN で Manage Key を渡し、--json と終了コードを組み合わせれば、aihubmix login を実行する必要はありません。
Manage Key を忘れた / 漏洩した場合は？
console.aihubmix.com/setting で再生成してください。古いトークンは即座に無効になります。
関連ドキュメント：プラットフォーム API · CliEndpoints · 旧バージョン Python スクリプト · AIHubMix コンソール
最終更新：2026-06-22