Hermes Agent: integração com a API Claude

Tutorial de configuração do Hermes Agent para o relay da API Claude da 1折AI, incluindo endereço, chave e modelo, com escolha de protocolo, exemplos de configuração, etapas de verificação e erros comuns.

Use a funcionalidade de provedor personalizado do Hermes Agent para conectar-se à 1折AI. Primeiro, crie uma chave de API e confirme os modelos disponíveis atualmente; os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

Data de verificação da configuração oficial: 2026-10-15. A configuração abaixo foi organizada com base na documentação oficial; a verificação ponta a ponta neste site ainda não foi concluída — conclua primeiro uma breve pergunta e a chamada de ferramenta de verificação antes de usá-la em tarefas longas. Modelos OpenAI / GPT já estão disponíveis; a lista de modelos e preços está em descrição dos modelos.

Com base nos Providers oficiais: no terminal, execute hermes model → Custom endpoint, selecione explicitamente o modo de API chat_completions, preencha a Base URL com https://1zheai.com/v1 e informe a chave e o modelo. Não selecione o login ChatGPT/Codex — é outra forma de integração.

Configuração de provider nomeada reutilizável, a ser mesclada em ~/.hermes/config.yaml:

1
providers:
2
  onezhe:
3
    api: https://1zheai.com/v1
4
    key_env: ONEZHE_API_KEY
5
    transport: chat_completions
6
    default_model: claude-sonnet-4-6
7
model:
8
  provider: custom:onezhe
9
  default: claude-sonnet-4-6

Fornecida localmente em ~/.hermes/.env:

1
ONEZHE_API_KEY=sk-替换为本站密钥

Após a configuração, é possível alternar /model custom:onezhe:claude-sonnet-4-6 na conversa. /model não substitui a criação de um novo provider via hermes model no terminal. O suporte oficial inclui transporte anthropic_messages, mas este tutorial usa Chat Completions para evitar adivinhar o protocolo automaticamente pela URL. OPENAI_BASE_URL não é uma configuração universal para todos os provedores personalizados; use a configuração explícita acima.

Verificação da integração e resolução de problemas

Salve e recarregue a configuração; confirme que o provedor selecionado atualmente é onezhe ou o modelo personalizado que você adicionou.
Envie uma pergunta curta e confirme que há resposta; em seguida, tente uma pequena tarefa reversível e verifique separadamente a chamada de ferramentas e o diálogo em múltiplas rodadas.
Abra o log de chamadas e confira hora da requisição, modelo, status e uso. Uma única resposta de texto bem-sucedida não significa que todas as capacidades do Agent são compatíveis.
Em caso de 404, confira se o endereço e o protocolo deste artigo são compatíveis; em caso de 401, confira a origem da chave e se o processo leu as variáveis de ambiente; em caso de 429, consulte as informações de limitação de taxa antes de tentar novamente. Mais cenários em códigos de erro e resolução de problemas.

A chave deve ser armazenada apenas no ambiente local ou no armazenamento de credenciais da ferramenta; não a envie para repositórios de código, capturas de tela ou logs públicos. Serviços em segundo plano podem não herdar as variáveis de ambiente do terminal; modelos auxiliares, busca e outras ferramentas também podem ter configurações de provedor independentes e precisam ser verificadas separadamente.

Custos e outras formas de integração

Consulte os preços em tempo real da API Claude e as regras de faturamento. Para outros clientes, retorne ao diretório de integrações de ferramentas; para escrever seu próprio programa, use o SDK e guia de desenvolvimento.