1つのAPIキーで600以上のAIモデルを切り替える方法【Hermes Agent + APIゲートウェイ】
はじめに
AIモデルを日常的に使い分けている開発者は多いと思います。
- コーディングには Claude
- 翻訳には GPT
- 推論には DeepSeek
- 素早い質問には Gemini
それぞれ得意分野があるので、全部使いたい。でも現実は：
- Anthropicでアカウント作成 → APIキー取得
- OpenAIでアカウント作成 → APIキー取得
- Googleでアカウント作成 → APIキー取得
- DeepSeek、Mistral……以下同文
キーの管理だけで疲れます。
最近、この問題をスッキリ解決できる構成を見つけたので共有します。オープンソースのAI Agent + APIゲートウェイで、1つのキーだけで全モデルにアクセスできるようになりました。
Hermes Agent とは
Hermes Agent は Nous Research が開発したオープンソースの AI Agent です。ターミナルで動作しますが、完成度が高く実用的です。
主な特徴
ターミナル体験が良い。 マルチライン編集、オートコンプリート、ストリーミング出力に対応。操作感がスムーズです。
マルチプラットフォーム対応。 CLI以外に Telegram、Discord、Slack、WhatsApp と連携可能。VPSで gateway プロセスを起動すれば、スマホから Telegram 経由で操作できます。
学習機能あり。 繰り返しの操作を「スキル」として自動的に蓄積し、次回から再利用します。
軽量。 GPUは不要。月額$5のVPSで十分動きます。
インストール
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Linux、macOS、WSL2、Android Termux に対応しています。
課題：プロバイダーごとにキーを管理する必要がある
Hermes Agent は複数のモデルプロバイダーに対応していますが、設定方式は「1プロバイダー = 1 APIキー」です。
個人なら4〜5個のキーを管理するのはまだ耐えられます。しかしチームで使う場合、全員が各プロバイダーのキーを設定する必要があり、費用の一元管理もできません。
解決策：APIゲートウェイで全モデルを1つの入口に集約
Hermes Agent には優れた設計があります——OpenAI API互換の任意のエンドポイントに接続できることです。
つまり、APIゲートウェイを1つ挟めば、Base URL と APIキーを1組だけ管理すればよくなります。
Hermes Agent
↓ 1つのキー
[APIゲートウェイ]
↓ ↓ ↓ ↓
GPT Claude Gemini DeepSeek
ここでは Crazyrouter を使います。OpenAI互換のAPIゲートウェイで、627以上のモデルを集約しており、従量課金で月額費用はかかりません。
セットアップ手順
方法1：自動スクリプト（推奨）
GitHubに設定スクリプトが用意されています：
git clone https://github.com/xujfcn/crazyrouter-hermes.git
cd crazyrouter-hermes
./setup.sh
Windowsの場合は .\setup.ps1 または setup.bat を使用。
スクリプトが自動で実行する内容：
- 環境の検出
- Base URL の設定
- APIキーの入力
- デフォルトモデルの選択
- 接続テスト
方法2：手動設定
hermes config set providers.crazyrouter.base_url https://crazyrouter.com/v1
hermes config set providers.crazyrouter.api_key あなたのキー
hermes model # モデルを選択
APIキーは crazyrouter.com で登録後に作成できます。新規ユーザーには無料クレジットが付与されます。
使い方
モデルの切り替えは1行のコマンドで完了します：
# コーディングには Claude
hermes model claude-sonnet-4-20250514
> この関数をコールバックから async/await にリファクタリングして
# 翻訳には GPT
hermes model gpt-4o
> この技術ドキュメントを日本語に翻訳して
# 推論には DeepSeek
hermes model deepseek-r1
> このアルゴリズムの時間計算量を分析して
# 素早い質問には Gemini Flash
hermes model gemini-2.5-flash
> Linuxで特定のポートを使っているプロセスを確認する方法は？
タスクに応じて最適なモデルを使い分けられます。キーや設定を変更する必要はありません。
その他の便利な機能
| 機能 | 説明 |
|---|---|
| Telegramリモート操作 |
hermes gateway 起動後、スマホから利用可能 |
| スケジュールタスク | 「毎日9時にGitHub trendingをまとめて」→ 自動でcron作成 |
| 並列処理 | subagent対応、複数モデルに同時にタスクを割り当て |
注意点
- Base URL の末尾に
/v1を付けること（付けないと404になります） - APIキーをコピーする際、前後にスペースが入らないよう注意
- 初回は
hermes doctorを実行して環境を確認 - 設定スクリプトは既存の設定を上書きしません（新しいproviderを追加するだけ）
まとめ
AIモデルが増えるのは良いことですが、管理コストも増えます。複数のモデルを日常的に切り替える開発者にとって、「オープンソースAgent + APIゲートウェイ」の組み合わせは効果的です：
- ✅ 1つのキーで全モデルにアクセス
- ✅ 1コマンドでモデル切り替え
- ✅ 費用の一元管理
- ✅ 新モデルが追加されても設定変更不要
セットアップは5分以内で完了します。ぜひ試してみてください。
関連リンク
- Hermes Agent：github.com/NousResearch/hermes-agent
- セットアップスクリプト：github.com/xujfcn/crazyrouter-hermes
- APIゲートウェイ：crazyrouter.com
Tags: AI, OpenSource, 開発ツール, API, LLM