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

Como usar o ChatGPT com o Hermes sem chave de API

Podes correr modelos GPT dentro do Hermes Agent usando apenas a tua subscrição existente do ChatGPT. O Hermes autentica-se através do OAuth por código de dispositivo do ChatGPT, guarda as credenciais em ~/.hermes/auth.json e consegue importar credenciais já existentes do Codex CLI. Isto significa que não precisas de chave de API para programadores, nem de um painel de faturação por token, nem de gerir rotações de chaves. Vale a pena ter em conta um limite fixo: este fluxo exige um plano pago, e o custo do ChatGPT Plus mantém-se nos 20 USD desde o lançamento.

Este guia explica o mecanismo, percorre a instalação e mostra o processo exato de login por OAuth. Aborda também a forma mais inteligente de pagar subscrições de IA como ChatGPT, Claude e Gemini sem perder dinheiro em comissões de transação no estrangeiro. Reserva cerca de 10 minutos de leitura e, no final, terás o GPT a correr num agente de terminal, com a tua subscrição a fazer o trabalho pesado.

Pagas o ChatGPT, o Claude ou o Gemini em USD todos os meses? A Bleap cobra 0% de comissões cambiais nas tuas subscrições em USD e oferece 20% de cashback fixo em Claude, ChatGPT e Gemini, com um cartão Mastercard self-custodial e sem qualquer subscrição própria. (O cashback de 20% aplica-se apenas ao Claude, ChatGPT e Gemini.) Pede já o cartão Bleap →

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

O Mecanismo Por Detrás do Acesso Baseado em Subscrição

O Hermes usa o fluxo de código de dispositivo OAuth da OpenAI, o mesmo padrão de autenticação usado por ferramentas como o Slack e o GitHub CLI. Em vez de gerares uma chave API no painel de desenvolvedor da OpenAI, a tua subscrição existente do ChatGPT funciona como credencial. O código-fonte do Hermes Agent utiliza um fluxo OAuth de dispositivo do OpenAI Codex para a autenticação com a OpenAI, e não uma simples variável de ambiente OPENAIAPIKEY, sendo esse fluxo pensado para utilizadores que têm uma subscrição Codex e preferem autenticar-se através do site da OpenAI em vez de gerir uma chave API bruta.

Desta forma, os pedidos passam pela infraestrutura de subscrição de consumidor do ChatGPT, em vez de pela camada de API paga por token.

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

Uma chave API implica uma conta de desenvolvedor mais faturação por token. O login via OAuth significa que a tua subscrição mensal fixa cobre a utilização em vez disso. A vantagem prática é real: sem faturas de API inesperadas, sem orçamento de tokens para vigiar e sem chaves para renovar. Um alerta importante a fazer desde já: quais os níveis de plano do ChatGPT elegíveis, e como é que a utilização do Hermes conta para os limites do Codex do teu plano, são aspetos que ainda não estão documentados. Trata o acesso ao modelo como um retrato momentâneo, e não como uma garantia fixa.

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

Contas e subscrições necessárias

• Um plano pago do ChatGPT ativo. Os preços do ChatGPT vão de 0 a 200 dólares por mês, distribuídos por cinco níveis: Free a 0€, Go a 8€, Plus a 20€, e dois planos Pro a 100€ e 200€. O nível gratuito não é suportado neste processo.
• Uma conta OpenAI com um endereço de email verificado.
• Uma subscrição paga é o requisito mínimo, porque o fluxo OAuth de dispositivo autentica-se com base na sua subscrição, e as contas gratuitas não têm o acesso a modelos que este método disponibiliza.

Software necessário e compatibilidade do sistema

• Hermes Agent instalado (abordado na secção seguinte).
• Um sistema operativo suportado: macOS, Linux ou Windows.
• Um emulador de terminal atual, como bash, zsh ou PowerShell.
• Uma ligação à internet para o redirecionamento do browser via OAuth.

Os utilizadores de Windows devem executar as instalações a partir de uma sessão PowerShell com privilégios elevados. No Linux, confirme que o perfil da shell está a fazer o source do caminho do binário do Hermes.

3. Instalar o Hermes Agent: Dois Métodos

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

Vá à página oficial de download do instalador desktop do Hermes e escolha a versão para a sua plataforma.

1. Faça o download do instalador adequado ao seu sistema operativo: .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 sistema depois de concluída a instalação.

Confirme a instalação com uma verificação rápida da versão:

hermes --version

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

Se preferir manter-se na shell, use um gestor 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 pode ser necessário atribuir permissões de execução ao script descarregado e adicionar o diretório do binário ao seu PATH. Depois, confirme com a mesma verificação:

hermes --version

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

Na primeira execução, o Hermes cria um ficheiro de configuração em ~/.hermes/config.toml (ou o equivalente na sua plataforma). Não há campos de chave API para preencher no fluxo de subscrição. Não existe uma chave API estática; o Hermes gera e renova automaticamente o token por si, incluindo a regeneração em caso de erro 401 a meio de uma sessão. O OAuth trata do resto.

4. Executar o comando de autenticação OAuth

O comando exato do terminal para iniciar o login

Inicie o login por código de dispositivo do ChatGPT com:

hermes auth add openai-codex

Também pode aceder de forma interativa. Execute hermes auth add openai-codex (ou hermes model → ChatGPT ou Codex Subscription) para iniciar um novo login por código de dispositivo; a quarentena é removida na próxima troca bem-sucedida. O seletor interativo é útil se não tiver a certeza de qual etiqueta de fornecedor escolher, pois guia-o ao longo da escolha.

O que acontece imediatamente depois de executar o comando

O Hermes gera um código de dispositivo único e apresenta-o no terminal juntamente com um URL de verificação. O terminal entra depois num estado de espera, aguardando que conclua a aprovação no browser. Durante esta fase, o resultado no terminal mostra normalmente o código, o URL e uma linha de "à espera de autorização" que se atualiza enquanto faz a verificação. É de esperar que a janela de aprovação fique aberta durante vários minutos, por isso não há pressa em mudar para o browser de imediato.

Quer que a sua despesa mensal em IA lhe traga algum retorno? No ChatGPT, Claude e Gemini, a Bleap dá-lhe 20% de cashback fixo em USDC, além de 0% de taxas de câmbio na cobrança em USD, sem mensalidade do cartão. Peça já o cartão Bleap →

5. Aprovar o Pedido OAuth e Concluir o Login

Confirmação Passo a Passo no Navegador (Device Code Flow)

1. Abra o URL impresso em qualquer navegador. Não precisa de estar no mesmo dispositivo em que executou o comando.
2. Faça login com as suas credenciais da conta OpenAI, caso ainda não esteja autenticado.
3. Introduza o código do dispositivo mostrado no terminal quando for solicitado.
4. Reveja as permissões que o Hermes está a solicitar, que abrangem 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 apresenta uma mensagem de sucesso a confirmar a conta autenticada, e o token é guardado localmente no diretório de configuração do Hermes. A partir desse momento, a renovação em segundo plano mantém-no autenticado. Isto reflete o comportamento do mesmo modelo OAuth noutros fornecedores do Hermes, onde não é necessária qualquer chave de API, faz login uma vez e o Hermes renova automaticamente a sua sessão em segundo plano. Não precisará de repetir o login até que o token guardado seja revogado ou expire por completo.

Resolução de Erros Comuns de Login

• Código expirado: os códigos de dispositivo têm uma duração curta, por isso volte a executar o comando de login para gerar um novo código e URL.
• Conta não elegível: uma conta gratuita do ChatGPT não consegue concluir este processo, o que é o comportamento esperado.
• Problemas de redirecionamento no navegador: desative os bloqueadores de pop-ups para o domínio de autenticação e, se um token parecer estar desatualizado, um novo login é mais fiável do que tentar novamente. Tenha em conta a dica geral de que fornecedores baseados em OAuth, como o Nous Portal ou o OpenAI Codex, podem precisar de um novo processo de login em vez de outra chave de API.

6. Selecionar e Mudar de Modelo GPT no Hermes

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

Depois de autenticado, o Hermes usa um modelo base, mas podes definir explicitamente o teu modelo GPT preferido:

hermes config set model <model-name>

Os modelos disponíveis dependem do teu nível de subscrição, e a gama de modelos da OpenAI muda rapidamente, por isso vale a pena verificar quais os que a tua conta consegue realmente usar antes de escolheres.

Modelos GPT Disponíveis Através da Subscrição do ChatGPT

Em 2026, a família principal da OpenAI é o GPT-5.6. O Hermes Agent pode correr na família GPT da OpenAI, GPT-5.6 Sol, Terra, Luna, entre outros, sendo o GPT-5.6 Sol o modelo principal atual.

A disponibilidade dos modelos vai mudando à medida que a OpenAI atualiza os seus níveis de subscrição. De facto, o GPT-5.6 já está disponível em subscrições pagas do ChatGPT, incluindo contas Plus e Pro, mas a disponibilização pode variar consoante a conta, a região e o plano. Consulta tudo o que a tua conta pode usar com:

hermes models list

Mudar de Modelo a Meio da Sessão

Podes mudar de modelo diretamente durante uma sessão ativa. Um padrão comum é passar para um modelo mais leve e rápido para perguntas simples, e depois voltar ao modelo principal para tarefas de raciocínio mais exigentes ou trabalhos de programação mais longos. Isto mantém as respostas ágeis sem sacrificar a qualidade onde ela realmente importa.

7. Verificar se a Configuração Está a Funcionar Corretamente

Executar um Prompt de Teste

Confirme que tudo funciona com um único prompt:

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

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

Confirmar os Detalhes da Sessão e da Subscrição

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

hermes auth status

O resultado confirma o email com que está autenticado, o modelo ativo e a validade do token. Tal como referido na documentação sobre a vista dos fornecedores, a secção Auth Providers mostra o estado atual de cada fornecedor.

O Que Fazer Se o Teste Falhar

• Volte a executar hermes auth add openai-codex se a sessão parecer ter expirado.
• Verifique a ligação à internet e as regras da firewall.
• Consulte os registos recentes com hermes logs --tail 50 para identificar a camada onde ocorre a falha.

8. Porquê Usar o GPT via Hermes em Vez de um Modelo Local

Qualidade e Capacidade de Raciocínio

Os modelos GPT de topo superam consistentemente a maioria dos modelos de peso aberto executáveis localmente em tarefas de raciocínio, programação e linguagem. Os modelos GPT são conhecidos pela sua forte capacidade de programação, conhecimento geral abrangente e chamadas de ferramentas fiáveis, qualidades que os tornam eficazes para workloads agênticos. Consegue obter resultados de alta qualidade sem precisar de recorrer a truques de prompt-engineering.

Janela de Contexto e Memória

Os modelos GPT alojados na cloud lidam com janelas de contexto muito maiores do que a maioria do hardware de consumo consegue gerir localmente. Isto significa bases de código maiores, documentos mais longos e conversas com múltiplas interações sem degradação percetível a meio da sessão.

Requisitos de Hardware (ou a Falta Deles)

Modelos locais como o Llama e o Mistral precisam de bastante VRAM, muitas vezes um mínimo de 8 GB para modelos pequenos e 24 GB ou mais para os maiores. Com o Hermes mais o OAuth do ChatGPT, o processamento é feito na infraestrutura da OpenAI. Isto torna esta configuração ideal para gráficos integrados, portáteis mais antigos ou máquinas de trabalho com drivers de GPU bloqueados.

Fiabilidade e Tempo de Atividade

Não há tempos de carregamento de modelos, não há compromissos de quantização e não há throttling térmico. Obtém uma disponibilidade consistente em vez de ter de gerir manualmente um servidor de inferência local.

Quando um Modelo Local Ainda É a Melhor Escolha

Os modelos locais ainda ganham em três situações: dados sensíveis que nunca devem sair do dispositivo, utilização genuinamente offline, e volumes de utilização extremamente elevados, onde a economia por pedido favorece o alojamento próprio. Convenientemente, o Hermes suporta ambos os caminhos, por isso não fica preso a nenhuma direção.

A tua stack de IA custa dinheiro a sério todos os meses. Faz com que ela recupere parte disso. O ChatGPT, o Claude e o Gemini cobram em dólares, e um cartão normal acrescenta 2-3% em cada renovação. O Bleap cobra 0% de comissões cambiais e devolve um cashback fixo de 20% nos três. Obtém o cartão Bleap →

FAQ: Como usar o ChatGPT com o Hermes sem uma chave de API

Preciso de uma subscrição ChatGPT Plus para usar o Hermes com modelos GPT?

Sim, é necessária uma subscrição paga ChatGPT Plus ou Pro. O fluxo de autenticação por código de dispositivo (OAuth) valida a tua subscrição, e as contas gratuitas não conseguem concluir este processo. O custo do ChatGPT Plus mantém-se nos 20 USD desde o lançamento, e o custo anual do ChatGPT Plus é de 240 USD, com faturação apenas mensal.

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

Executa hermes auth add openai-codex, ou usa hermes model e seleciona a opção de Subscrição ChatGPT ou Codex. Isto inicia o fluxo de código de dispositivo, apresentando um URL e um código único que deves confirmar num navegador para concluir a autenticação.

A que modelos GPT posso aceder através da minha subscrição ChatGPT no Hermes?

Isso depende do teu plano e da disponibilidade atual. Em 2026, a família principal é composta pelo GPT-5.6 Sol, Terra e Luna. Executa hermes models list depois de autenticares para veres exatamente o que a tua conta consegue aceder, já que a disponibilidade ainda pode variar consoante a conta, a região e o plano.

Em que é que isto difere de usar uma chave de API da OpenAI com o Hermes?

Uma chave de API cobra-te por token através da plataforma de programadores da OpenAI. O login OAuth através da tua subscrição ChatGPT usa, em vez disso, o teu plano mensal fixo. A API tem uma estrutura de custos separada das subscrições ChatGPT; pagas por milhão de tokens processados, e não por mensagem ou por mês, e o acesso à API não inclui uma subscrição ChatGPT, nem vice-versa.

O que devo fazer se o código de dispositivo expirar antes de o confirmar?

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

Posso usar o Hermes com um modelo local e mudar para o GPT quando for preciso?

Sim. O Hermes é agnóstico em relação ao fornecedor e suporta tanto backends locais como modelos GPT na nuvem. O Hermes Agent é agnóstico quanto ao fornecedor; o Nous Portal é uma das opções suportadas, e o OpenRouter, Ollama, fornecedores diretos, GitHub Copilot, Hugging Face e endpoints compatíveis com OpenAI também são suportados. Usa hermes config set model <model-name> para mudar em qualquer momento.

Conclusão: Aproveita melhor a tua subscrição ChatGPT com o Hermes

Se já pagas pelo ChatGPT Plus ou Pro, usá-lo dentro de um agente de terminal como o Hermes desbloqueia um valor que de outra forma estarias a desperdiçar. O processo tem quatro passos: instalar o Hermes, executar o comando de autenticação, confirmar no navegador e selecionar o teu modelo GPT. O resultado é não teres de gerir chaves de API, sem surpresas de faturação por token e sem precisar de hardware local pesado. A única contrapartida honesta é que uma subscrição paga é obrigatória para este fluxo de trabalho. A partir daí, experimenta alternar entre modelos, usando um modelo mais leve para rapidez e o modelo principal para tarefas mais exigentes.

Uma última dica prática sobre a própria fatura. As tuas subscrições de IA renovam-se em USD, e a maioria dos cartões acrescenta discretamente 2-3% em cada cobrança estrangeira. Com o Bleap pagas à taxa real, sem comissões de câmbio, e no Claude, ChatGPT e Gemini ganhas 20% de cashback fixo em USDC em cada renovação, sem qualquer subscrição mensal de cartão. É um cartão Mastercard self-custodial que podes usar em qualquer lugar onde a Mastercard seja aceite, por isso o dinheiro que a tua configuração poupa rende ainda mais.