すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Hermes Agent

最終更新日:Aug 26, 2026

Hermes Agent は、従量課金、Coding Plan、Token Plan Personal Edition、または Token Plan Team Edition を介して Alibaba Cloud Model Studio に接続するターミナル AI コーディングツールです。

Hermes Agent のインストール

  1. このコマンドを実行して Hermes Agent をインストールします。スクリプトは、Python や Git などの依存関係を自動的にインストールします。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

注記Windows はネイティブインストールをサポートしていません。まず WSL2 をインストールし、次に WSL2 で上記のコマンドを実行してください。

  1. インストール後、ターミナル環境を再読み込みしてください。
source ~/.bashrc    # zsh を使用している場合は、source ~/.zshrc に変更してください
  1. インストールを検証します。バージョン番号が表示されれば成功です。
hermes --version

アクセス認証情報の設定

hermes config set を実行して、選択したプランのベース URL と API キーを設定します:

  • Token Plan Personal Edition: 個人向けサブスクリプションで、トークン消費に応じてクレジットが差し引かれます。
  • Token Plan Team Edition: シートベースのサブスクリプションで、トークン消費に応じてクレジットが差し引かれます。
  • Coding Plan: 月額固定のサブスクリプションで、モデルの呼び出し回数によって計測されます。
  • 従量課金: 実際の使用量に基づく後払いです。

注記このトピックの例では、Anthropic 互換プロトコルを使用します。ベース URL の末尾は /apps/anthropic で、api_mode は anthropic_messages に設定されます。Hermes Agent は OpenAI 互換プロトコルもサポートしており、ベース URL の末尾にある /apps/anthropic を /compatible-mode/v1 に置き換え、api_mode の設定を削除します。たとえば、従量課金 (中国北部 2、北京) の OpenAI 互換ベース URL は https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 です。

コマンドライン版に加えて、Hermes Agent はデスクトップ版 (Hermes Desktop) も提供しています。インストーラーは Hermes のウェブサイトからダウンロードするか、コマンドライン版のインストール後に hermes desktop を実行することで入手できます。Hermes Desktop とコマンドライン版は、同じ ~/.hermes/config.yaml 設定ファイルを共有するため、アクセスパラメーターはここで説明されているものと同一です。デスクトップアプリでカスタムエンドポイントを介して接続する場合は、上記の OpenAI 互換のベース URL を使用してください。

Token Plan Personal Edition

YOUR_API_KEY を、お客様の Token Plan Personal Edition の API キーに置き換えてください。利用可能なモデルは、サポートされているモデルに記載されています。

hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max

これらのコマンドは ~/.hermes/config.yaml に書き込みます。また、ファイルを直接編集することもできます:

config.yaml の例

model:
  default: qwen3.8-max
  provider: custom
  base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Token Plan Team Edition

YOUR_API_KEY を、お使いの Token Plan Team Edition の API キー に置き換えます。利用可能なモデルは、サポートされているモデル に記載されています。

hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max

これらのコマンドは ~/.hermes/config.yaml に書き込みます。このファイルを直接編集することもできます:

config.yaml の例

model:
  default: qwen3.8-max
  provider: custom
  base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Coding Plan

YOUR_API_KEY を、お使いの Coding Plan API キーに置き換えてください。 利用可能なモデルは、サポートされているモデルに記載されています。

hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-plus

これらのコマンドは ~/.hermes/config.yaml に書き込みます。また、このファイルを直接編集することもできます:

config.yaml の例

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

従量課金

YOUR_API_KEY を、お使いの Alibaba Cloud Model Studio API キー に置き換えます。利用可能なモデルは、Anthropic 互換 API にリストされています。お使いのリージョンに合わせて base_url を設定します。API キーは選択したリージョンと一致している必要があり、WorkspaceId を実際の ワークスペース ID に置き換えます。

  • 中国北部 2 (北京):https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
  • シンガポール: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic。
hermes config set model.provider alibaba
hermes config set model.base_url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max

これらのコマンドは ~/.hermes/config.yaml に書き込みます。ファイルを直接編集することもできます:

config.yaml の例

model:
  default: qwen3.7-max
  provider: alibaba
  base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

設定の検証

テストメッセージを送信して、設定を検証してください:

hermes chat -q "Hello"

正常なレスポンスは、設定が機能していることを示します。モデルを切り替えるには、-m パラメーターを使用します。

hermes chat -m qwen3.7-plus

よくある質問

エラーコード

設定エラーについては、お使いの課金プランのよくある質問をご確認ください: