Use o ChatGPT no Hermes sem chave de API: guia completo de configuração

Como Rodar o ChatGPT com Hermes Sem uma API Key

Você pode rodar modelos GPT dentro do Hermes Agent usando nada além da sua assinatura já existente do ChatGPT. O Hermes autentica via OAuth por código de dispositivo do ChatGPT, armazena as credenciais em ~/.hermes/auth.json, e pode importar credenciais já existentes do Codex CLI. Isso significa: sem API key de desenvolvedor, sem painel de cobrança por token e sem rotação de chaves para gerenciar. Vale lembrar de um limite importante: esse fluxo exige um plano pago, e o custo do ChatGPT Plus se mantém em $20 desde o lançamento.

Este guia explica o mecanismo, passa pela instalação e mostra o fluxo exato de login via OAuth. Também cobre a forma mais inteligente de pagar por assinaturas de IA como ChatGPT, Claude e Gemini sem perder dinheiro com taxas de conversão internacional. São cerca de 10 minutos de leitura, e ao final você terá o GPT rodando em um agente de terminal com sua assinatura fazendo o trabalho pesado.

Paga por ChatGPT, Claude ou Gemini em dólar todo mês? A Bleap cobra 0% de taxas de conversão nas suas assinaturas em dólar e dá 20% de cashback fixo em Claude, ChatGPT e Gemini, com um cartão Mastercard autocustodial e sem assinatura própria. (O cashback de 20% vale apenas para Claude, ChatGPT e Gemini.) Peça o cartão Bleap →

1. Como Funciona de Fato a Integração OAuth da OpenAI com o Hermes

O Mecanismo por Trás do Acesso Baseado em Assinatura

O Hermes usa o fluxo de código de dispositivo OAuth da OpenAI, o mesmo padrão de autenticação usado em ferramentas como Slack e o GitHub CLI. Em vez de gerar uma chave de API no painel de desenvolvedor da OpenAI, sua assinatura existente do ChatGPT funciona como credencial. O código-fonte original do Hermes Agent usa um fluxo de dispositivo OAuth do OpenAI Codex para autenticação com a OpenAI, e não uma simples variável de ambiente OPENAIAPIKEY. Esse fluxo de dispositivo foi pensado para usuários que têm uma assinatura do Codex e preferem se autenticar pelo site da OpenAI em vez de lidar com uma chave de API bruta.

Isso faz com que as requisições passem pela infraestrutura de assinatura para consumidores do ChatGPT, e não pelo modelo de cobrança por token da API.

Por Que Isso É Diferente da Autenticação por Chave de API

Uma chave de API significa ter uma conta de desenvolvedor mais cobrança por token. Já o login via OAuth significa que sua assinatura mensal fixa cobre o uso. A vantagem prática é real: sem surpresas na fatura da API, sem precisar ficar de olho no orçamento de tokens e sem chaves para gerenciar. Vale destacar uma ressalva: ainda não está documentado quais níveis de plano do ChatGPT são elegíveis, nem como o uso do Hermes é contabilizado nos limites do Codex do seu plano. Trate o acesso aos modelos como uma foto do momento, não como uma garantia fixa.

2. Pré-requisitos: o que você precisa antes de começar

Contas e assinaturas necessárias

• Um plano pago do ChatGPT ativo. Os preços do ChatGPT vão de $0 a $200 por mês em cinco níveis: Free por $0, Go por $8, Plus por $20, e dois planos Pro por $100 e $200. O plano gratuito não é compatível com esse fluxo.
• Uma conta OpenAI com e-mail verificado.
• Uma assinatura paga é o requisito mínimo, pois o fluxo OAuth de dispositivo faz a autenticação com base na sua assinatura, e contas gratuitas não têm acesso ao modelo que esse método utiliza.

Software necessário e compatibilidade do sistema

• Hermes Agent instalado (explicado na próxima seção).
• Um sistema operacional compatível: macOS, Linux ou Windows.
• Um emulador de terminal moderno, como bash, zsh ou PowerShell.
• Conexão com a internet para o redirecionamento do navegador via OAuth.

Usuários do Windows devem executar a instalação em uma sessão elevada do PowerShell. No Linux, confirme se o perfil do seu shell está apontando corretamente para o caminho do binário do Hermes.

3. Instalando o Hermes Agent: Dois Métodos

Método 1: Instalador Desktop (Recomendado para Iniciantes)

Acesse a página oficial de download do instalador desktop do Hermes e baixe a versão certa para sua plataforma.

1. Baixe o instalador adequado para seu sistema operacional: .dmg para macOS, .exe para Windows, ou um .AppImage ou pacote para Linux.
2. Execute o instalador e siga as instruções da interface gráfica.
3. Confirme que o Hermes está disponível no PATH do seu sistema assim que a instalação terminar.

Verifique a instalação com uma checagem rápida da versão:

hermes --version

Método 2: Instalação via Terminal (Recomendado para Desenvolvedores)

Se você preferir ficar no terminal, use um gerenciador de pacotes ou o script de instalação.

• macOS e Linux: execute o script de instalação baseado em curl, ou use brew install hermes-agent.
• Windows: winget install hermes-agent ou o pacote equivalente.

No macOS e Linux, talvez seja necessário conceder permissão de execução ao script baixado e adicionar o diretório do binário ao seu PATH. Depois, confirme com a mesma checagem:

hermes --version

Configuração Pós-Instalação

Na primeira execução, o Hermes cria um arquivo de configuração em ~/.hermes/config.toml (ou o equivalente da plataforma). Não há campos de chave de API para preencher no fluxo de assinatura. Não existe uma chave de API estática; o Hermes gera e atualiza automaticamente o token para você, inclusive gerando um novo em caso de erro 401 no meio de uma sessão. O OAuth cuida do resto.

4. Executando o comando de autenticação OAuth

O comando exato do terminal para iniciar o login

Inicie o login do ChatGPT via device-code com:

hermes auth add openai-codex

Você também pode acessar isso de forma interativa. Execute hermes auth add openai-codex (ou hermes model → ChatGPT ou Codex Subscription) para iniciar um novo login por device-code; a quarentena é liberada na próxima troca bem-sucedida. O seletor interativo é útil se você não tiver certeza de qual rótulo de provedor escolher, já que ele te guia pela escolha.

O que acontece logo depois de rodar o comando

O Hermes gera um código de dispositivo único e o exibe no terminal junto com uma URL de verificação. Em seguida, o terminal entra em um estado de espera, aguardando você concluir a aprovação pelo navegador. Nessa etapa, a saída do terminal geralmente mostra o código, a URL e uma linha do tipo "aguardando autorização" que fica se atualizando enquanto o processo continua. É normal essa janela de aprovação ficar aberta por vários minutos, então não há pressa para ir correndo até o navegador.

Quer que o seu gasto mensal com IA realmente volte pro seu bolso? No ChatGPT, Claude e Gemini, o Bleap te dá 20% de cashback fixo em USDC, além de 0% de taxa de câmbio na cobrança em dólar, sem mensalidade do cartão. Peça o cartão Bleap →

5. Aprovando a Solicitação OAuth e Concluindo o Login

Confirmação Passo a Passo no Navegador (Fluxo de Código de Dispositivo)

1. Abra a URL exibida em qualquer navegador. Você não precisa estar no mesmo dispositivo em que executou o comando.
2. Faça login com suas credenciais da conta OpenAI, caso ainda não esteja conectado.
3. Digite o código de dispositivo exibido no terminal quando solicitado.
4. Revise as permissões que o Hermes está solicitando, que envolvem acesso de leitura à sua sessão do ChatGPT.
5. Clique em Confirmar ou Permitir para concluir a autorização.

Como é um Login Bem-Sucedido

O terminal exibe uma mensagem de sucesso confirmando a conta autenticada, e o token é salvo localmente no diretório de configuração do Hermes. A partir daí, a atualização em segundo plano mantém você conectado. Isso segue o mesmo modelo OAuth usado por outros provedores do Hermes, em que nenhuma chave de API é necessária, você faz login apenas uma vez, e o Hermes atualiza automaticamente sua sessão em segundo plano. Você não precisará repetir o login até que o token armazenado seja revogado ou expire por completo.

Solucionando Erros Comuns de Login

• Código expirado: os códigos de dispositivo têm validade curta, então execute o comando de login novamente para gerar um novo código e uma nova URL.
• Conta não elegível: uma conta gratuita do ChatGPT não consegue concluir esse fluxo, o que é um comportamento esperado.
• Problemas de redirecionamento no navegador: desative bloqueadores de pop-up para o domínio de autenticação, e se um token parecer estar desatualizado, um novo login é mais confiável do que tentar novamente. Vale lembrar a dica mais ampla de que provedores baseados em OAuth, como o Nous Portal ou o OpenAI Codex, podem precisar de um novo fluxo de login em vez de outra chave de API.

6. Selecionando e Trocando o Modelo GPT no Hermes

Configuração do Modelo Após a Autenticação

Depois de autenticado, o Hermes usa um modelo padrão, mas você pode definir explicitamente o modelo GPT de sua preferência:

hermes config set model <model-name>

Os modelos disponíveis dependem do seu plano de assinatura, e o catálogo da OpenAI muda rapidamente, então vale a pena listar o que sua conta realmente pode acessar antes de definir uma configuração fixa.

Modelos GPT Disponíveis na Assinatura do ChatGPT

Em 2026, a família principal da OpenAI é a GPT-5.6. O Hermes Agent pode rodar com a família GPT da OpenAI, incluindo GPT-5.6 Sol, Terra, Luna e outros, sendo o GPT-5.6 Sol o modelo principal atual.

A disponibilidade dos modelos muda conforme a OpenAI atualiza seus planos. Na verdade, o GPT-5.6 já está aparecendo em assinaturas pagas do ChatGPT, incluindo contas Plus e Pro, mas a liberação pode variar de acordo com a conta, a região e o plano. Liste tudo que sua conta pode usar com:

hermes models list

Trocando de Modelo no Meio da Sessão

Você pode alternar entre modelos diretamente durante uma sessão ativa. Um padrão comum é usar um modelo mais leve e rápido para consultas simples, e voltar ao modelo principal quando precisar de raciocínio mais complexo ou tarefas longas de programação. Isso mantém as respostas ágeis sem comprometer a qualidade onde ela realmente importa.

7. Verificando se a Configuração Está Funcionando Corretamente

Executando um Prompt de Teste

Confirme se tudo está funcionando com um único prompt:

hermes run "Explain OAuth device code flow in one paragraph"

Uma execução bem-sucedida exibe o nome do modelo ativo, retorna uma resposta gerada e não mostra erros de chave de API. A primeira resposta após a autenticação pode demorar um pouco mais do que as seguintes, enquanto a sessão é inicializada.

Confirmando os Detalhes da Sessão e da Assinatura

Verifique o estado atual da sua autenticação com:

hermes auth status

A saída confirma o e-mail com o qual você está logado, o modelo ativo e a validade do token. Como a documentação menciona na visão de provedores, a seção Auth Providers mostrará o estado atual de cada provedor.

O Que Fazer Se o Teste Falhar

• Execute novamente hermes auth add openai-codex se a sessão parecer ter expirado.
• Verifique a conectividade com a internet e as regras de firewall.
• Inspecione os logs recentes com hermes logs --tail 50 para identificar em qual camada está o problema.

8. Por Que Usar o GPT via Hermes em Vez de um Modelo Local

Qualidade e Capacidade de Raciocínio

Os modelos GPT principais superam consistentemente a maioria dos modelos open-weight que podem ser executados localmente em tarefas de raciocínio, programação e linguagem. Os modelos GPT são conhecidos por sua forte capacidade de codificação, amplo conhecimento geral e chamadas de ferramentas confiáveis, características que os tornam eficazes para cargas de trabalho agênticas. Você chega a um resultado de alta qualidade sem precisar recorrer a workarounds de prompt engineering.

Janela de Contexto e Memória

Os modelos GPT hospedados na nuvem lidam com janelas de contexto muito maiores do que a maioria do hardware de consumo consegue gerenciar localmente. Isso significa bases de código maiores, documentos mais longos e conversas com múltiplas interações sem degradação perceptível no meio de uma sessão.

Requisitos de Hardware (ou a Falta Deles)

Modelos locais como Llama e Mistral exigem VRAM considerável, geralmente pelo menos 8 GB para modelos pequenos e 24 GB ou mais para os maiores. Com o Hermes junto com o OAuth do ChatGPT, o processamento roda na infraestrutura da OpenAI. Isso torna essa configuração ideal para placas de vídeo integradas, notebooks mais antigos ou máquinas de trabalho com drivers de GPU bloqueados.

Confiabilidade e Tempo de Atividade

Não há tempo de carregamento de modelo, nenhum compromisso com quantização e nenhum throttling térmico. Você tem disponibilidade consistente em vez de precisar cuidar de um servidor de inferência local.

Quando um Modelo Local Ainda É a Melhor Escolha

Modelos locais ainda vencem em três casos: dados sensíveis que nunca devem sair do dispositivo, uso genuinamente offline e volumes de uso extremamente altos, em que a economia por requisição favorece hospedar você mesmo. De forma útil, o Hermes suporta os dois caminhos, então você não fica travado em nenhuma direção.

Sua stack de IA custa dinheiro de verdade todo mês. Faça ela devolver um pouco. ChatGPT, Claude e Gemini cobram em dólar, e um cartão comum adiciona 2-3% em cada renovação. O Bleap cobra 0% de taxa de câmbio e paga 20% de cashback fixo nos três. Peça o cartão Bleap →

Perguntas frequentes: usando o ChatGPT com o Hermes sem uma chave de API

Preciso de uma assinatura do ChatGPT Plus para usar o Hermes com os modelos GPT?

Sim, é necessária uma assinatura paga do ChatGPT Plus ou Pro. O fluxo de autenticação por código de dispositivo (OAuth) valida sua assinatura, e contas do plano gratuito não conseguem concluir esse processo. O preço do ChatGPT Plus se mantém em US$ 20 desde o lançamento, e o custo anual do ChatGPT Plus é de US$ 240, cobrado apenas mensalmente.

Qual é o comando de terminal do Hermes para iniciar o login OAuth do ChatGPT?

Execute hermes auth add openai-codex, ou use hermes model e selecione a opção ChatGPT ou Codex Subscription. Isso inicia o fluxo de código de dispositivo, exibindo uma URL e um código único que você confirma no navegador para concluir a autenticação.

Quais modelos GPT posso acessar através da minha assinatura do ChatGPT no Hermes?

Isso depende do seu plano e da disponibilidade atual. Em 2026, a família principal é a GPT-5.6 Sol, Terra e Luna. Execute hermes models list após a autenticação para ver exatamente o que sua conta consegue acessar, já que a disponibilidade ainda pode variar por conta, região e plano.

Qual é a diferença entre isso e usar uma chave de API da OpenAI com o Hermes?

Uma chave de API cobra por token através da plataforma de desenvolvedores da OpenAI. Já o login via OAuth com sua assinatura do ChatGPT usa seu plano mensal fixo. A API tem uma estrutura de custo separada das assinaturas do ChatGPT: você paga por milhão de tokens processados, não por mensagem ou por mês, e o acesso à API não inclui uma assinatura do ChatGPT (e vice-versa).

O que devo fazer se o código do dispositivo expirar antes de eu confirmá-lo?

Os códigos de dispositivo têm validade curta. Basta executar novamente hermes auth add openai-codex para gerar um novo código e URL, e concluir a confirmação no navegador rapidamente.

Posso usar o Hermes com um modelo local e alternar para o GPT quando necessário?

Sim. O Hermes é agnóstico em relação a provedores e oferece suporte tanto a backends locais quanto a modelos GPT na nuvem. O Hermes Agent é agnóstico em relação a provedores; o Nous Portal é uma rota compatível, mas OpenRouter, Ollama, provedores diretos, GitHub Copilot, Hugging Face e endpoints compatíveis com OpenAI também são suportados. Use hermes config set model <model-name> para trocar a qualquer momento.

Conclusão: aproveite ainda mais sua assinatura do ChatGPT com o Hermes

Se você já paga pelo ChatGPT Plus ou Pro, usá-lo dentro de um agente de terminal como o Hermes libera um valor que, de outra forma, ficaria sem uso. O processo tem quatro passos: instalar o Hermes, rodar o comando de autenticação, confirmar no navegador e escolher seu modelo GPT. O resultado é nada de gerenciar chaves de API, nenhuma surpresa com cobrança por token e nenhuma necessidade de hardware local pesado. A única contrapartida honesta é que ter uma assinatura paga é indispensável para esse fluxo de trabalho. A partir daí, vale experimentar a troca de modelos, usando um modelo mais leve para velocidade e o modelo principal para tarefas mais pesadas.

Uma última dica prática sobre a fatura em si. Suas assinaturas de IA renovam em dólar, e a maioria dos cartões adiciona discretamente de 2% a 3% em cada cobrança internacional. Com o Bleap, você paga na cotação real, sem taxas de câmbio, e no Claude, ChatGPT e Gemini você ganha um cashback fixo de 20% em USDC a cada renovação, sem mensalidade de cartão. É um Mastercard autocustodial que você pode usar em qualquer lugar que aceite Mastercard, fazendo com que o dinheiro que sua configuração economiza renda ainda mais.