Hermes Agent は、従量課金、Coding Plan、Token Plan Personal Edition、または Token Plan Team Edition を介して Alibaba Cloud Model Studio に接続するターミナル AI コーディングツールです。
Hermes Agent のインストール
- このコマンドを実行して Hermes Agent をインストールします。スクリプトは、Python や Git などの依存関係を自動的にインストールします。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
注記Windows はネイティブインストールをサポートしていません。まず WSL2 をインストールし、次に WSL2 で上記のコマンドを実行してください。
- インストール後、ターミナル環境を再読み込みしてください。
source ~/.bashrc # zsh を使用している場合は、source ~/.zshrc に変更してください
- インストールを検証します。バージョン番号が表示されれば成功です。
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
よくある質問
エラーコード
設定エラーについては、お使いの課金プランのよくある質問をご確認ください:
- 従量課金: エラーコードのトラブルシューティング
- Coding Plan: Coding Plan のよくある質問
- Token Plan Personal Edition: Token Plan Personal Edition のよくある質問
- Token Plan Team Edition: Token Plan Team Edition のよくある質問