A v0.14.0 trouxe um comando de uma linha — hermes proxy — que engoliu em silêncio uma classe inteira de pergunta de integração que a comunidade vinha fazendo há meses. Você roda hermes proxy e ganha um endpoint local em http://localhost:port que fala a API da OpenAI, apoiado em qualquer provider OAuth no qual você esteja logado via Hermes — Claude Pro, ChatGPT Pro ou SuperGrok.
A consequência prática: ferramentas que só sabem falar a API da OpenAI — Aider, Cline, Codex CLI, Continue e a cauda longa de plugins de editor — agora conseguem conversar com Claude Pro, ChatGPT Pro e SuperGrok através da sua assinatura existente, sem você nunca gerar uma API key.
Essa é a parte que importa: a maioria dessas ferramentas exige relação de cobrança por provider. Aider com Claude → conta no Anthropic console com forma de pagamento. Cline com GPT-5 → conta de cobrança na OpenAI. Codex CLI → idem. hermes proxy dobra tudo isso num único endpoint localhost que autentica com a sessão OAuth que você já tem.
Aqui vai o workflow exato.
0. Pré-requisitos
- •Hermes Agent v0.14.0 ou mais novo instalado e configurado (
hermes --versionpra conferir) - •Pelo menos uma assinatura OAuth ligada via
hermes model— Claude Pro, ChatGPT Pro ou SuperGrok
Se você nunca fez login num provider OAuth, da primeira vez que rodar hermes model, ele te leva pelo flow OAuth de cada provider. Escolhe a assinatura que você realmente paga.
1. Subir o proxy
hermes proxy
Por padrão, ele se prende numa porta livre do localhost. O log de boot mostra a URL — copia. Pra fixar a porta:
hermes proxy --port 11500
Roda como processo de longa duração — deixa vivo enquanto as ferramentas de baixo estão usando. systemd, launchd, tmux ou só uma aba de terminal, qualquer um serve.
2. Apontar a ferramenta de baixo pro proxy
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # qualquer string não vazia serve
aider --model claude-sonnet-4-6
A flag --model do Aider referencia o nome do modelo do jeito que o proxy resolve a partir da sua config de provider do Hermes. Se você logou via Claude Pro, seu modelo Claude padrão tá disponível ; o mesmo vale pra ChatGPT Pro e SuperGrok.
Cline (VS Code)
Nas configs do Cline, escolhe OpenAI Compatible como provider. Coloca:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(qualquer valor não vazio) - •Model ID: o nome do modelo na sua config do Hermes (por exemplo
claude-sonnet-4-6,gpt-5.1)
Salva. O Cline agora roteia as requests pelo Hermes ; a auth da sua assinatura cuida do resto.
Codex CLI
O Codex CLI normalmente espera OPENAI_API_BASE e OPENAI_API_KEY. Mesma forma do Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Se você tá logado em ChatGPT Pro via Hermes, o modelo gpt-5-codex aparece pelo proxy e o Codex CLI tem acesso completo sem você nunca abrir uma relação de cobrança com a OpenAI.
Continue (JetBrains / VS Code)
Edita sua config do Continue (~/.continue/config.json ou pela UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Mesmo padrão. O "provider" continua openai porque, do ponto de vista do Continue, ele tá batendo num endpoint OpenAI.
3. Conferir se funciona
Um curl rápido:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Você deve receber de volta a lista de modelos que a sua config de provider do Hermes expõe. Se vier 401 ou uma lista vazia, o proxy tá rodando mas o Hermes não consegue ver uma sessão OAuth ativa — roda hermes model de novo e escolhe um provider com assinatura viva.
4. Resolução de problemas
- •"Connection refused" — o proxy não tá rodando. Sobe ele.
- •"401 unauthorized" — o modelo que você pediu não tá coberto pela sua assinatura conectada. Roda
hermes modele vê quais providers estão ativos. - •"Model not found" — o nome do modelo na ferramenta de baixo não bate com o que o seu provider do Hermes expõe. Usa os nomes do
hermes model list. - •Rate-limited — você bateu nos limites de taxa da assinatura (Claude Pro fica em torno de 50 mensagens a cada 5 h no Sonnet ; ChatGPT Pro tem uma cota separada ; SuperGrok tem a dele). O proxy não adiciona rate limiter próprio ; ele só repassa a cota que o seu provider te dá.
Por que isso importa
A API da OpenAI é a língua franca do ecossistema de ferramentas de IA. Quase todo plugin de editor e assistente de código suporta primeiro OpenAI e em segundo "endpoints compatíveis com OpenAI". O detalhe é que "endpoint compatível" quase sempre quer dizer "você precisa de API key, então precisa de uma conta de cobrança, então sua assinatura de US$ 20 por mês vira uma conta pay-as-you-go no dashboard de outra pessoa".
hermes proxy dobra esse problema. Sua assinatura OAuth fica onde ela mora. O proxy fala OpenAI no localhost. Aider, Cline, Codex CLI, Continue — não sabem que estão conversando com Claude ou Grok. Só veem um endpoint OpenAI que funciona.
Uma assinatura, todas as ferramentas, sem API key. Esse é o discurso inteiro.