Alibaba Cloud Model Studio のモデルを Hermes Agent で使用します。
クイックスタート
クライアントを選択し、設定を完了します。
CLI
- 1
Get an API key
- Token Plan Personal Edition:API Key を作成または表示
- Token Plan Team Edition:シートを割り当てて API Key を取得
- Pay-as-you-go: Model Studio API キー
- Coding Plan: Coding Plan API キー
- 2
Configure the model
hermes modelを実行し、ご利用の料金プランのプロバイダーを選択して API キーを入力し、モデルを選択します。Token Plan
Pay-as-you-go
Qwen>Qwen Cloud (Alibaba DashScope)を選択します。- Model Studio API キーを入力します。
- 次の例ではシンガポールを使用します。Base URL として
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1を入力し、{WorkspaceId}を実際の Workspace ID に置き換えます。 - モデルを選択します。サポートされているモデルについては、サポートモデルをご覧ください。
Coding Plan
Qwen>Alibaba Cloud (Coding Plan)を選択します。- Coding Plan 専用 API キーを入力し、デフォルトの Base URL をそのまま使用します。
- モデルを選択します。サポートされているモデルについては、Coding Plan サポートモデルをご覧ください。
注記プロバイダーリストには、ご利用のプランでサポートされていないモデルが含まれている場合があります。プランのサポートモデルリストが正式です。
- 3
Verify
次のコマンドを実行して確認します:
hermes chat -q "hello"
Desktop
- 1
Configure the model
設定ファイルによる設定に従ってご利用のプランの設定を追加するか、先に CLI の設定を完了してください。
- 2
Select the model
Hermes Desktop を開き、Settings → Model に移動して、同じプロバイダーとモデルを選択します。
設定ファイルによる設定
v2026.8.31以降、hermes model のプロバイダーリストには Alibaba Cloud Model Studio が含まれています。リストに含まれていない場合は、次の手順を実行してください。
- 1
設定ファイルを開く/新規作成
- macOS / Linux / WSL2:
~/.hermes/config.yaml - Windows:
%LOCALAPPDATA%\hermes\config.yaml
- macOS / Linux / WSL2:
- 2
Add the configuration
YOUR_API_KEYをそのプランの API キーに置き換え(従量課金の場合は{WorkspaceId}も置き換え)、設定をmodelセクションに追加してください。Token Plan
OpenAI互換
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYAnthropic互換
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEYPay-as-you-go
次の例では Singapore を使用しています。
OpenAI互換
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYAnthropic互換
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEYCoding Plan
OpenAI互換
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/v1 api_key: YOUR_API_KEYAnthropic互換
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEY注記qwen4-max-preview を使用する場合、
providerはcustomのままにしてください。anthropicに設定すると、モデル名が書き換えられて 400 エラーが返されます。注記qwen4-max を使用する場合、
providerはcustomのままにしてください。anthropicに設定すると、モデル名が書き換えられて 400 エラーが返されます。qwen4-max のコンテキスト長は 1M Token です。非思考モードの最大出力は 131,072 Token、思考と最終回答の合計は最大 262,144 Token です。デフォルトは reasoning_effort=high、thinking_budget=131072 です。 - 3
Verify
保存後、
hermes chat -q "Hello"を実行して確認してください。
エラーコード
設定中にエラーが発生した場合は、ご利用の課金プランの FAQ を参照してください:
- Token Plan: Personal Edition FAQ · Team Edition FAQ
- Pay-as-you-go: エラーコード
- Coding Plan: Coding Plan FAQ
よくある質問
hermes model に Model Studio プロバイダーがありません
設定ファイルを使用してください。
モデルが利用できません
hermes model のモデルリストには、ご利用のプランがサポートしていないモデルが含まれている場合があります。プランでサポートされているモデルリストからモデルを選択するか、Enter custom model name を選択してモデル ID を入力してください。
節約プランの使用方法