Usar o GPT Luna no Hermes

O GPT Luna é o modelo gpt-5.6-luna, que o Hermes acessa pelo provedor openai-codex. Esse provedor não usa chave de API. A autenticação é o login da assinatura do ChatGPT ou do Codex. As credenciais ficam no arquivo ~/.hermes/auth.json do usuário que roda o agente. O Codex CLI não precisa estar instalado na VPS.

A tabela do Hermes para os modelos da assinatura do Codex usa 272 mil tokens de janela de contexto para a maioria deles. A documentação não informa o valor do GPT Luna em particular, quais planos dão acesso ao provedor nem como o uso do agente entra nos limites da assinatura. Por isso este guia não cita plano nem cota.

Faça o login pelo código do dispositivo

Abra a sessão do usuário hermes na VPS e inicie o login do provedor:

1
sudo -iu hermes
2
hermes auth add openai-codex

O comando mostra um endereço e um código. Abra o endereço no navegador do computador ou do celular, faça o login da assinatura e digite o código. Esse fluxo dispensa navegador na VPS e túnel SSH. O login precisa ser feito com o usuário hermes, porque o token fica no auth.json da pasta pessoal do usuário que executa o comando. Um login feito pelo administrador grava o token na pasta errada. Nesse caso, o agente não encontra a credencial.

Escolha o GPT Luna como modelo padrão

Com o login feito, rode o assistente de modelo com o usuário hermes:

1
hermes model

Escolha ChatGPT or Codex Subscription na lista de provedores e selecione gpt-5.6-luna. Pelo mesmo provedor, a documentação lista também gpt-6-astra, gpt-5.6-sol, gpt-5.6-terra e gpt-5.5. Para conferir, abra a TUI com hermes --tui, mande uma mensagem e use o comando /model para ver o provedor e o modelo da sessão.

Login pelo navegador, com túnel SSH

O login também funciona pelo navegador, com a opção --browser. Nesse fluxo, o Hermes espera o retorno em http://localhost:1455/auth/callback, numa porta fixa da VPS. Para o navegador do computador alcançar essa porta, abra um túnel a partir do computador antes do login:

1
ssh -N -L 1455:127.0.0.1:1455 admin@IP_DA_VPS

Com o túnel aberto, rode hermes auth add openai-codex --browser numa outra sessão SSH, com o usuário hermes. Quando a porta 1455 já está ocupada, o Hermes avisa e volta para o código do dispositivo.

Faça o login de novo quando o token expirar

O Hermes renova o token sozinho. Quando a renovação falha de forma definitiva, ele para de tentar e mostra um aviso de login expirado. Rode outra vez hermes auth add openai-codex com o usuário hermes e repita o código do dispositivo. Depois do novo login, rode hermes gateway restart: as sessões que já estavam abertas no gateway só passam a usar a credencial nova depois do reinício. Uma credencial do Codex CLI guardada em ~/.codex/auth.json pode ser importada, mas o login próprio do Hermes dispensa o Codex CLI na VPS.