Source: https://aiprimetech.io/pt/learn/run-hermes-agent-with-claude-api/ [Início](/pt/) / [Aprenda](/pt/learn/) / Hermes Agent com Claude por meio de um gateway: configuração de provedor personalizado, controles de custo e correções # Hermes Agent com Claude por meio de um gateway: configuração de provedor personalizado, controles de custos e correções O Hermes Agent mantém os segredos em ~/.hermes/.env e todo o restante em ~/.hermes/config.yaml. A maneira confiável de executá-lo com o Claude por meio de um gateway é usar um provedor personalizado nomeado que utilize o formato Anthropic Messages. O atalho, provider: anthropic com uma URL base diferente, parece correto, mas envia solicitações para a Anthropic quando o host não é reconhecido. ## Instalação Linux / macOS / WSL2Copiar ``` curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` WindowsCopiar ``` iex (irm https://hermes-agent.nousresearch.com/install.ps1) ``` hermes setup executa o assistente completo; hermes model configura apenas o provedor e o modelo; hermes doctor verifica uma instalação existente. ## Adicione o gateway como provedor personalizado ~/.hermes/.envCopiar ``` AIPRIME_API_KEY=your_gateway_key ``` ~/.hermes/config.yamlCopiar ``` providers: aiprime: api: https://aiprimetech.io/v1 key_env: AIPRIME_API_KEY transport: anthropic_messages catalog_provider: anthropic model: provider: custom:aiprime default: claude-sonnet-5 ``` | Chave | Por quê | transport: anthropic_messages | Use o formato Messages da Anthropic. Sem isso, o Hermes passa a usar o formato Chat Completions da OpenAI | key_env | O nome da variável em .env que contém a chave | catalog_provider: anthropic | Os modelos Claude do gateway herdam os metadados de contexto e visão da Anthropic | provider: custom:aiprime | Seleciona o provedor nomeado; /model custom:aiprime: alterna dentro de um chat O assistente faz o mesmo: hermes model, depois **Endpoint personalizado** e, em seguida, o modo de API **Anthropic Messages**. Se escolher Chat Completions, mantenha /v1 na URL. ## Por que provider: anthropic com uma URL base não funciona Definir provider: anthropic e base_url: https://aiprimetech.io parece correto, mas não tem efeito: no código-fonte atual do Hermes, a substituição da URL base no provedor Anthropic integrado só é aceita para hosts da Anthropic, do Claude e do Azure, portanto as solicitações continuam sendo enviadas à Anthropic. Use o provedor personalizado nomeado acima. ANTHROPIC_BASE_URL é documentado como uma substituição da URL base da Anthropic, mas um bug em aberto no Hermes faz com que o seletor de modelos o ignore. O provedor personalizado evita ambos os problemas. ## O que determina o uso de tokens e quais configurações o limitam O Hermes executa tarefas além da conversa que você vê, e todas elas são cobradas na mesma chave, a menos que você as encaminhe para outro destino. | Origem do uso | Definir | Subagents (delegation) | delegation.max_concurrent_children (padrão 10), delegation.max_iterations (padrão 250), delegation.max_spawn_depth (padrão 1); um mais barato delegation.model | Revisão de memória e habilidades em segundo plano após cada turno | auxiliary.background_review.enabled: false, ou um menor max_input_tokens | Tarefas auxiliares (compressão, títulos, visão) | auxiliary..provider e .model para enviá-las a um modelo mais barato | Tarefas agendadas | cron.model para todas as tarefas; hermes cron pause ou hermes pause | Gateway de mensagens (Telegram, Discord e outros) | Listas de permissões como TELEGRAM_ALLOWED_USERS; evite GATEWAY_ALLOW_ALL_USERS=true ~/.hermes/config.yaml (adições)Copiar ``` delegation: max_concurrent_children: 3 model: claude-haiku-4-5 auxiliary: background_review: enabled: false cron: model: claude-haiku-4-5 ``` hermes prompt-size mostra o custo fixo de cada chamada; /usage e /compress ajudam durante uma sessão longa. ## Login no Claude Pro ou Max em vez de uma chave O Hermes pode fazer login em uma conta Claude, mas sua documentação informa que essa opção funciona apenas em um plano Max com créditos de uso adicional comprados e que assinantes Pro não podem usá-la. Com uma chave de API de um gateway, não há janela de uso da assinatura; o uso é cobrado por token e descontado do seu saldo. ## Modelos | ID do modelo | Use para | claude-sonnet-5 | Padrão para programação e trabalho com agentes: rápido, eficiente e de preço intermediário. | claude-opus-5-5 | Raciocínio mais complexo, grandes refatorações e execuções longas de agentes. | claude-fable-5-1 | O mais capaz e mais caro; reserve-o para as tarefas mais difíceis. | claude-haiku-4-5 | Barato e rápido: títulos, resumos, classificação e pequenas etapas. O Hermes precisa de uma janela de contexto de pelo menos 64K tokens; todos os modelos da tabela atendem a esse requisito. ## Solução de problemas | O que você vê | Causa | Correção | HTTP 400 na primeira execução | O nome do modelo não corresponde a um ID de modelo do gateway | Use um ID da tabela acima | As solicitações são enviadas à Anthropic ou falham com um erro de autenticação da Anthropic | provider: anthropic com uma URL base de terceiros | Use o provedor personalizado nomeado | Respostas sem sentido ou vazias | Transporte incorreto para a URL | transport: anthropic_messages para Claude | Limite de tamanho do contexto excedido | Sessão maior que a janela configurada | Defina model.context_length; /compress | 403 Your request was blocked | Um firewall na frente do endpoint rejeita o cliente | Adicionar extra_headers com um User-Agent semelhante ao de um navegador | Configurações ausentes após uma atualização | O esquema de configuração mudou | hermes config check, depois hermes config migrate | Bot sem responder no Telegram ou Discord | Gateway não está em execução ou remetente não autorizado | hermes gateway status; verifique ~/.hermes/logs/gateway.log Comparando frameworks de agentes? Consulte o [guia de configuração do OpenClaw](/pt/learn/run-openclaw-with-claude-api/). ## Perguntas frequentes Como usar o Hermes Agent com um endpoint personalizado do Claude? Adicione um provedor nomeado em ~/.hermes/config.yaml com api definido como a URL do gateway, key_env apontando para uma variável em ~/.hermes/.env e transport: anthropic_messages; depois, defina model.provider: custom:. Por que o Hermes ignora meu base_url da Anthropic? Com provider: anthropic, o Hermes aceita uma substituição da URL base apenas para hosts da Anthropic, Claude e Azure, portanto uma URL de terceiros é descartada. Use um provedor personalizado nomeado. Como reduzir o uso de tokens do Hermes Agent? Limite os subagentes (configurações de delegação), encaminhe tarefas auxiliares e tarefas cron para um modelo mais barato, desative a revisão em segundo plano e verifique hermes prompt-size. O Hermes Agent pode usar uma assinatura Claude Pro? Segundo a documentação do Hermes, não: o método de login do Claude funciona apenas no Max com créditos de uso extra. Uma chave de API evita por completo os limites da assinatura. Comece a usar o Claude em minutos Obtenha uma chave de API — sem precisar de conta na Anthropic nem de lista de espera.[Obtenha sua chave de API](/register) AI Prime Tech é um gateway de API independente. Não tem afiliação com a Anthropic, não é endossado por ela e não é seu revendedor. Claude e os nomes dos modelos relacionados são marcas comerciais de seus respectivos proprietários. ## Mais guias da API do Claude [Como obter uma chave de API do Claude](/pt/learn/how-to-get-a-claude-api-key/)[Preços da API Claude explicados](/pt/learn/claude-api-pricing-explained/)[A maneira mais barata de usar a API do Claude](/pt/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado com a API do Claude](/learn/use-claude-api-with-cursor/)[Acesso ilimitado ao Claude Code](/pt/learn/use-claude-api-with-claude-code/)[Gateway da API do Claude vs. acesso direto à Anthropic](/pt/learn/claude-api-vs-anthropic-direct/)[Use Claude com o SDK da OpenAI: endpoint compatível com OpenAI, streaming, ferramentas e limites](/pt/learn/openai-compatible-claude-api/)[Modelos Claude explicados: uma comparação entre Claude Opus, Sonnet, Haiku e Fable — todos os modelos da API Claude, nomes e preços dos modelos Anthropic (2026)](/pt/learn/claude-api-models-compared/)[Pagamento da API do Claude com criptomoedas](/pt/learn/claude-api-with-crypto-payment/)[Acesso à API do Claude sem lista de espera](/pt/learn/claude-api-without-waitlist/)[Como reduzir o uso de tokens do Claude](/pt/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado com a API do Claude](/pt/learn/use-claude-api-with-cline/)[Roo Code ilimitado com a API do Claude](/pt/learn/use-claude-api-with-roo-code/)[Claude ilimitado nas IDEs da JetBrains](/pt/learn/use-claude-api-with-jetbrains/)[Aider com Claude por meio de um gateway: ANTHROPIC_API_BASE, arquivos de configuração, modo arquiteto e correções](/pt/learn/use-claude-api-with-aider/)[Claude ilimitado no VS Code](/pt/learn/use-claude-api-with-vscode/)[Configuração do OpenCode para Claude: configuração do opencode.json, modelos e erros comuns](/pt/learn/use-claude-api-with-opencode/)[Executando OpenClaw ilimitado com Claude](/pt/learn/run-openclaw-with-claude-api/)[O que significa uma API compatível com a Anthropic](/pt/learn/anthropic-compatible-api/)[Chave de API do Claude Code — ANTHROPIC_API_KEY: como obtê-la, configurá-la e quando usar claude setup-token em seu lugar](/pt/learn/claude-code-api-key-setup/)[Custos da API do Claude Code — Preços e como reduzi-los](/pt/learn/claude-code-api-costs/)[Erros da API Claude explicados: erro de servidor 500, sobrecarga 529, limite de requisições 429, requisição inválida 400 — e a correção para cada um](/pt/learn/claude-api-errors-troubleshooting/)[Como comprar créditos da API do Claude — e por que um crédito do Claude é melhor do que qualquer oferta de "comprar conta do Claude"](/pt/learn/buy-claude-api-credits/)[API Claude gratuita: existe uma chave de API Claude gratuita e o que realmente é gratuito em 2026?](/pt/learn/claude-api-free-trial/)[API do Claude vs assinatura Claude Pro/Max — Qual escolher](/pt/learn/claude-api-vs-subscription/)[Codex CLI com um provedor personalizado: config.toml, modelos GPT e Claude, extensão para IDE e correções](/pt/learn/use-claude-api-with-codex/)[Conectando Claude ao n8n](/pt/learn/use-claude-api-with-n8n/)[Roteando LiteLLM para Claude](/pt/learn/use-claude-api-with-litellm/)[Usando Claude no Kilo Code](/pt/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat com Claude por meio de um gateway: configuração de Custom Endpoint, modo agente e correções](/pt/learn/use-claude-api-with-github-copilot/)[Conecte o Zed ao Claude por meio do gateway](/pt/learn/use-claude-api-with-zed/)[Conecte o Cherry Studio ao Claude](/pt/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic no LangChain: importação, base_url, streaming, ferramentas e erros](/pt/learn/use-claude-api-with-langchain/)[SDK de Python da Anthropic: instale, defina base_url, use streaming e trate erros](/pt/learn/anthropic-python-sdk/)[Claude com o Vercel AI SDK: baseURL de createAnthropic, streaming e correções](/pt/learn/use-claude-api-with-vercel-ai-sdk/)[Execute o Factory Droid com o Claude](/pt/learn/use-claude-api-with-factory-droid/)[A API do Claude Code, explicada](/pt/learn/claude-code-api/)[Como integrar a API do Claude à sua aplicação](/pt/learn/claude-api-integration/)[Como obter uso ilimitado do Claude — e por que não existe "Claude Code crackeado"](/pt/learn/get-unlimited-claude-usage/)