Configurar o Hermes Agent
O exemplo usa Kimi K3.1 Pro (k3.1-pro). Obtenha uma chave da I Code Easy em Chaves de API.
Instalação
Execute o comando abaixo no Linux, macOS ou WSL. Para usar o Windows nativo, siga as instruções de PowerShell no guia oficial de instalação.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Hermes Agent
Essa configuração envia solicitações de Chat Completions para /v1/chat/completions.
Adicione a configuração abaixo a ~/.hermes/config.yaml. No Windows nativo, o diretório padrão é %LOCALAPPDATA%\hermes. Se você definiu HERMES_HOME, use o diretório indicado pela variável.
providers:
icodeeasy:
api: https://api.icodeeasy.cc/v1
key_env: ICODEEASY_API_KEY
transport: chat_completions
model:
default: k3.1-pro
provider: custom:icodeeasy
Acrescente a linha abaixo ao arquivo .env no mesmo diretório e substitua YOUR_API_KEY pela sua chave.
ICODEEASY_API_KEY=YOUR_API_KEY
Iniciar uma sessão
Execute hermes para iniciar uma sessão. Em uma sessão aberta, use /model custom:icodeeasy:k3.1-pro para trocar de modelo.
Verificar a primeira solicitação
Envie um prompt curto e confira o modelo e o status da solicitação nos Registros de uso. Se receber um erro 401, confira a chave. Em caso de erro de modelo ou permissão, confira o ID do modelo e o endpoint selecionado. Se a conexão estiver instável, altere o domínio para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc mantendo o caminho /v1.
Documentação oficial do cliente
Guias relacionados
Configurar Kimi Code: API Key, K3.1 Pro e Claude Code
Configure K3.1 Pro no Kimi Code CLI ou Claude Code. Compare opções persistentes e temporárias, valide a primeira chamada e resolva erros 401, de modelo e URL.
Chat Completions
Envie uma conversa no formato OpenAI Chat. Antes da requisição, confirme se o modelo e o endpoint escolhido aceitam o protocolo Chat.
Como investigar e recuperar conexões lentas ou requisições com falha?
Separe 401, 403, 429, tempo esgotado e erro de caminho do Gemini antes de trocar o host. Use o domínio jp ou sg só quando a rede for o problema.