Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Instale o Agente Hermes

#Agente Hermes

Assistente de codificação Terminal AI da Nous Research

Hermes Agent é uma ferramenta de codificação de terminal AI que se conecta a QwenCloud por meio de pagamento conforme o uso, Token Plan (Personal Edition) ou Token Plan (Team Edition).

Instale o Agente Hermes

Execute este comando para instalar o Agente Hermes. O script instala automaticamente dependências como Python e Git.

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

O Windows não oferece suporte à instalação nativa. Instale WSL2 primeiro e, em seguida, 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. Um número de versão confirma o sucesso.

hermes --version

Configurar credenciais de acesso

Corre hermes config set para configurar o URL base e a chave de API para o plano escolhido:

Token Plan (Edição Pessoal): Assinatura individual; o consumo de token deduz créditos.
Token Plan (Team Edition): Assinatura baseada em assento; o consumo de token deduz créditos.
Pague conforme o uso: pós-pago com base no uso real.

Os exemplos neste tópico usam o protocolo compatível com Antrópico: o URL base termina com /apps/anthropic e api_mode está definido para anthropic_messages. O Hermes Agent também suporta o protocolo compatível com OpenAI: substitua o final /apps/anthropic no URL base com /compatible-mode/v1 e remova o api_mode configuração. Por exemplo, o URL base compatível com OpenAI para pagamento conforme o uso (Cingapura) é https://maas.qwencloudapi.com/compatible-mode/v1.

Além da versão de linha de comando, o Hermes Agent também oferece uma versão desktop (Hermes Desktop). Você pode baixar o instalador no site da Hermes ou execute hermes desktop depois de instalar a versão da linha de comando. Hermes Desktop e a versão de linha de comando compartilham o mesmo ~/.hermes/config.yaml arquivo de configuração, portanto os parâmetros de acesso são idênticos aos descritos aqui. Ao conectar-se por meio de um endpoint personalizado no aplicativo de desktop, use o URL base compatível com OpenAI descrito acima.

Plano de token (edição pessoal)

Substituir YOUR_API_KEY com seu plano de token (edição pessoal) chave de API. 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.maas.qwencloudapi.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 auto

Esses comandos escrevem para ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

model:
  default: auto
  provider: custom
  base_url: https://token-plan.maas.qwencloudapi.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Importante: qwen3.8-max modo de pensamento (híbrido — pode ser ativado/desativado):

temperatura: O padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.

raciocínio_esforço: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.

Plano de Token (Edição de Equipe)

Substituir YOUR_API_KEY com seu Plano de Token (Team Edition) Chave de API. 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.maas.qwencloudapi.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 auto

Esses comandos escrevem para ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

model:
  default: auto
  provider: custom
  base_url: https://token-plan.maas.qwencloudapi.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Importante: qwen3.8-max modo de pensamento (híbrido — pode ser ativado/desativado):

temperatura: O padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.

raciocínio_esforço: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.

Pague conforme o uso

Substituir YOUR_API_KEY com o seu QwenCloud Chave API. Os modelos disponíveis estão listados em API compatível com Antrópico.

Definir base_url para sua região. A chave API deve corresponder à região selecionada:

Singapura: https://maas.qwencloudapi.com/apps/anthropic

hermes config set model.provider alibaba
hermes config set model.base_url https://maas.qwencloudapi.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 escrevem para ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:

model:
  default: qwen3.7-max
  provider: alibaba
  base_url: https://maas.qwencloudapi.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Verifique a configuração

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

hermes chat -q "Hello"

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

hermes chat -m qwen3.7-max

Perguntas frequentes

Códigos de erro

Para erros de configuração, verifique as perguntas frequentes do seu plano de faturamento:

Pagamento conforme o uso: Códigos de erro e solução de problemas
Plano de token (edição pessoal): Perguntas frequentes sobre o plano de token (edição pessoal)
Plano de Token (Edição de Equipe): Perguntas frequentes sobre o Plano de Token (Edição de Equipe)