O Hermes Agent é uma ferramenta de codificação com IA para terminal que se conecta ao Alibaba Cloud Model Studio por meio dos planos Pay-as-you-go, Coding Plan, Token Plan (Personal Edition) 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
ObservaçãoO 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 (Personal Edition): Assinatura pessoal que deduz créditos pessoais conforme o consumo de tokens.
- Token Plan (Team Edition): Assinatura baseada em assentos; o consumo de tokens deduz créditos da equipe.
- Coding Plan: Assinatura mensal fixa, mensurada pela quantidade de invocações de modelo.
- Pay-as-you-go: Pós-pago com base no uso real.
ObservaçãoOs exemplos neste tópico utilizam 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 Pay-as-you-go (China North 2, Beijing) é https://{WorkspaceId}.cn-beijing.maas.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, utilize a Base URL compatível com OpenAI descrita acima.
Token Plan (Personal Edition)
Substitua YOUR_API_KEY pela sua API Key do Token Plan (Personal Edition). Os modelos disponíveis estão listados em supported models.
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-preview
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:
config.yaml example
model:
default: qwen3.8-max-preview
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
ImportanteModo de raciocínio do qwen3.8-max-preview:
- thinking: Sempre ativado. Não pode ser desativado.
- temperature: O padrão é 0,6 no modo de raciocínio. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
- reasoning_effort: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.
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 supported models.
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-preview
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente:
config.yaml example
model:
default: qwen3.8-max-preview
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
ImportanteModo de raciocínio do qwen3.8-max-preview:
- thinking: Sempre ativado. Não pode ser desativado.
- temperature: O padrão é 0,6 no modo de raciocínio. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
- reasoning_effort: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.
Coding Plan
Substitua YOUR_API_KEY pela sua API Key do Coding Plan. Os modelos disponíveis estão listados em supported models.
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
Pay-as-you-go
Substitua YOUR_API_KEY pela sua Alibaba Cloud Model Studio API Key. Os modelos disponíveis estão listados em Anthropic compatible API. Defina a base_url correspondente à sua região. A API Key deve corresponder à região selecionada. Substitua WorkspaceId pelo seu Workspace ID real.
- China North 2 (Beijing):
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic - Singapore:
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
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:
- Pay-as-you-go: Error Code Troubleshooting
- Coding Plan: Coding Plan FAQ
- Token Plan (Personal Edition): Token Plan (Personal Edition) FAQ
- Token Plan (Team Edition): Token Plan (Team Edition) FAQ