メインコンテンツへスキップ
更新日: 2026-06-06
crazyrouter-hermes を使うと、Hermes Agent のモデルプロバイダーを Crazyrouter に切り替えられます。設定後、Hermes は https://api.crazyrouter.com/v1 を OpenAI 互換エンドポイントとして使い、1 つの Crazyrouter API Key で Claude、GPT、DeepSeek、Gemini、Qwen など 627 以上のモデルを呼び出します。

​
向いている用途

  • Hermes Agent から Crazyrouter をモデルプロバイダーとして使いたい場合
  • ローカル Agent のモデルと利用枠を Crazyrouter に統一したい場合
  • OPENAI_API_KEY、OPENAI_BASE_URL、デフォルトモデルを 1 コマンドで設定したい場合

​
前提条件

項目説明
Hermes Agentローカルにインストールし、起動できることを確認します
Crazyrouter アカウントcrazyrouter.com で作成します
Crazyrouter API KeyHermes 専用の sk-... token を作成することを推奨します
モデル権限Hermes で使うモデルを token で許可します
Hermes は OpenAI 互換設定で Crazyrouter に接続します。Base URL は https://api.crazyrouter.com/v1 のままにしてください。

​
ワンクリック設定

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-hermes/main/setup.sh | bash
スクリプトは Crazyrouter API Key の入力、デフォルトモデルの選択、任意の接続テストを案内します。
セットアップスクリプトはローカルの Hermes 設定を書き換えます。既存のカスタム設定がある場合は、先に ~/.hermes/.env と ~/.hermes/config.yaml をバックアップしてください。

​
手動設定

スクリプトを使わない場合は、Hermes の設定ファイルを手動で編集します。

​
環境変数

~/.hermes/.env を編集します。 
OPENAI_API_KEY=sk-your-crazyrouter-key
OPENAI_BASE_URL=https://api.crazyrouter.com/v1

​
デフォルトモデル

~/.hermes/config.yaml を編集します。 
model:
  provider: "custom"
  default: "claude-opus-4-8"
  base_url: "https://api.crazyrouter.com/v1"
default は Crazyrouter token で許可済みのモデル名に変更できます。

​
モデルの切り替え

設定後、Hermes 内で /model を使ってモデルを切り替えられます。 
/model claude-opus-4-8
/model gpt-5.5
/model claude-sonnet-4.6
/model gemini-3.1-pro
/model deepseek-v4-pro
/model qwen-max
/model gpt-4o
切り替え時に model not allowed または 403 が返る場合、通常は現在の Crazyrouter token でそのモデルが許可されていません。

​
確認チェックリスト

  • ~/.hermes/.env の OPENAI_API_KEY が有効な Crazyrouter token である
  • OPENAI_BASE_URL が https://api.crazyrouter.com/v1 である
  • ~/.hermes/config.yaml の provider が custom である
  • デフォルトモデルが Crazyrouter token で許可されている
  • Hermes でテストメッセージに応答が返る
  • /model gpt-5.5 など、許可済みモデルへの切り替えが成功する

​
よくある問題

現象主な原因対処
401 unauthorizedAPI Key が間違っている、期限切れ、またはローテーション済みCrazyrouter token を再作成し、~/.hermes/.env を更新します
403 または model not allowedtoken で選択モデルが許可されていないCrazyrouter token 設定でそのモデルを許可します
古いプロバイダーが使われるHermes が設定を再読み込みしていない、または別の設定ファイルを編集したHermes を再起動し、~/.hermes/.env と ~/.hermes/config.yaml を確認します
接続タイムアウトローカルネットワークから Crazyrouter に到達できないプロキシ、ファイアウォール、DNS を確認します

crazyrouter-hermes リポジトリを見る

セットアップスクリプト、手動設定例、最新の説明を確認できます。