---
title: "Hermes Agent: integração com a API Claude"
description: "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."
headingIds: {"Verificação da integração e resolução de problemas":"section-1","Custos e outras formas de integração":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
Use a funcionalidade de provedor personalizado do Hermes Agent para conectar-se à 1折AI. Primeiro, [crie uma chave de API](/pt/docs/api-keys/) e confirme os [modelos disponíveis atualmente](/pt/docs/models/); os IDs de modelo abaixo são exemplos — ajuste-os conforme as permissões da sua chave.

<Note>
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](/pt/docs/models/).
</Note>

Com base nos [Providers oficiais](https://hermes-agent.nousresearch.com/docs/integrations/providers): 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`:

```yaml
providers:
  onezhe:
    api: https://1zheai.com/v1
    key_env: ONEZHE_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6
model:
  provider: custom:onezhe
  default: claude-sonnet-4-6
```

Fornecida localmente em `~/.hermes/.env`:

```dotenv
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

1. Salve e recarregue a configuração; confirme que o provedor selecionado atualmente é `onezhe` ou o modelo personalizado que você adicionou.
2. 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.
3. Abra o [log de chamadas](/pt/docs/usage-logs/) 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.
4. 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](/pt/docs/troubleshooting/).

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](https://1zheai.com/en/pricing/) e as [regras de faturamento](/pt/docs/pricing-explained/). Para outros clientes, retorne ao [diretório de integrações de ferramentas](/pt/docs/integrations/); para escrever seu próprio programa, use o [SDK e guia de desenvolvimento](/pt/docs/guides/).