Hermes Agent - Terminal AI Coding Tool | Model Studio - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

O Hermes Agent é uma ferramenta de codificação com IA para terminal que se conecta ao Alibaba Cloud Model Studio pelos planos Pagamento conforme o uso, Coding Plan ou Token Plan (Team Edition).

Instale o Hermes Agent

Execute este comando para instalar o Hermes Agent. O script instala automaticamente dependências como Python e Git.
```
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
Nota
O Windows não oferece suporte à instalação nativa. Instale o WSL2 primeiro e execute o comando acima no WSL2.

Após a instalação, recarregue o ambiente do terminal.

source ~/.bashrc    # If using zsh, change to source ~/.zshrc

Verifique a instalação. A exibição de um número de versão confirma o sucesso.
```
hermes --version
```

Configure credenciais de acesso

Execute hermes config set para configurar a Base URL e a API Key do plano escolhido:

Token Plan (Team Edition): assinatura baseada em assentos; o consumo de tokens desconta Créditos.
Coding Plan: assinatura mensal fixa, mensurada pela quantidade de invocações de modelo.
Pagamento conforme o uso: pós-pago com base no uso real.

Nota

Os exemplos neste tópico usam o protocolo compatível com Anthropic: a Base URL termina com /apps/anthropic e api_mode está definido como anthropic_messages. O Hermes Agent também suporta o protocolo compatível com OpenAI: substitua o sufixo /apps/anthropic na Base URL por /compatible-mode/v1 e remova a configuração api_mode. Por exemplo, a Base URL compatível com OpenAI para Pagamento conforme o uso (China North 2, Beijing) é https://dashscope.aliyuncs.com/compatible-mode/v1.

Além da versão de linha de comando, o Hermes Agent oferece uma versão desktop (Hermes Desktop). Baixe o instalador no site do Hermes ou execute hermes desktop após instalar a versão de linha de comando. O Hermes Desktop e a versão de linha de comando compartilham o mesmo arquivo de configuração ~/.hermes/config.yaml, portanto os parâmetros de acesso são idênticos aos descritos aqui. Ao conectar-se por meio de um Custom Endpoint no aplicativo desktop, use a Base URL compatível com OpenAI descrita acima.

Token Plan (Team Edition)

Substitua YOUR_API_KEY pela sua API Key do Token Plan (Team Edition). Os modelos disponíveis estão listados em modelos suportados.

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.7-max

Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

config.yaml example

model:
  default: qwen3.7-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

Substitua YOUR_API_KEY pela sua API Key do Coding Plan. Os modelos disponíveis estão listados em modelos suportados.

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

Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

config.yaml example

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

Pagamento conforme o uso

Substitua YOUR_API_KEY pela sua API Key do Alibaba Cloud Model Studio. Os modelos disponíveis estão listados em API compatível com Anthropic. Defina a base_url correspondente à sua região. A API Key deve ser compatível com a região selecionada:

China North 2 (Beijing): https://dashscope.aliyuncs.com/apps/anthropic
Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. Substitua WorkspaceId pelo seu ID do Workspace real.

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

Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

config.yaml example

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

Verifique a configuração

Envie uma mensagem de teste para validar sua configuração:

hermes chat -q "Hello"

Uma resposta bem-sucedida confirma que a configuração funciona. Para alternar modelos, use o parâmetro -m:

hermes chat -m qwen3.7-max

Perguntas frequentes

Códigos de erro

Em caso de erros de configuração, consulte as perguntas frequentes do seu plano de faturamento:

Pagamento conforme o uso: Solução de problemas de códigos de erro
Coding Plan: Perguntas frequentes do Coding Plan
Token Plan (Team Edition): Perguntas frequentes do Token Plan (Team Edition)