概要

Hermes AgentでCodex OAuth経由でGPT-5.6系を利用した際、モデルの指定方法によってエラーになる事象があった。

モデル名まわりの設定を調整したところエラーを解消できたため、同様の事象が発生した場合に確認できるよう備忘録として整理しておく。

2026年9月4日時点では、Hermes Agentで gpt-5.6-sol / gpt-5.6-terra / gpt-5.6-luna などをモデル名だけで指定した際、Codex OAuthの認証情報が有効で、OpenAI APIキーが未設定または利用できない状況でも openai-api が優先的に選択され、有効な openai-codex のOAuth認証が利用されない問題が報告されている。

Hermes AgentではGPT-5.6系が openai-api と openai-codex の両方のモデル候補として扱われており、Providerを明示しない場合の判定で意図しないProviderが選ばれることがある。

そのため、Codex OAuth経由でGPT-5.6系を利用する場合は、Providerを明示的に openai-codex と指定する方法が回避策になる。

実際に発生した事象

Hermes AgentでGPT-5.6系のモデルを利用しようとしたところ、モデル設定に関連するエラーが発生した。

設定を確認し、モデル名およびProviderの指定方法を調整したところ、エラーを解消して利用できることを確認した。

今回の事象から、GPT-5.6系でエラーが発生した場合は、認証設定だけでなく、Hermes AgentがどのProviderとしてモデルを認識しているかも確認した方がよさそう。

特に、

Codex OAuthの認証は完了している
OpenAI APIキーは未設定、または利用できない
モデル名だけを指定している

という条件では、openai-api 側に解決されていないか確認する価値がある。

対応

Codex OAuthでGPT-5.6系を利用する場合は、Providerを明示的に openai-codex と指定する。

例：

/model gpt-5.6-sol --provider openai-codex

設定ファイルを利用する場合も、モデル名だけでなくProviderを明示する。

model:
  provider: openai-codex
  default: gpt-5.6-sol

これにより、Hermes Agentが利用するProviderを明示でき、Codex OAuthの認証情報を使う構成であることを分かりやすくできる。

公式情報

Hermes Agent公式GitHub：不具合報告

Hermes AgentのGitHub Issueでは、GPT-5.6系のモデルをモデル名だけで指定した場合、openai-api が優先的に選択され、利用可能な openai-codex のOAuth認証が使われない問題が報告されている。

Issue内では、以下のようにProviderを明示することで回避できることも報告されている。

/model gpt-5.6-luna --provider openai-codex

Hermes Agent公式ソース

Hermes AgentのCodex向けモデル定義では、GPT-5.6系のモデルがCodex OAuth向けモデルとして定義されている。

2026年9月時点では、以下のモデルが DEFAULT_CODEX_MODELS に含まれている。

gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna

一方、Hermes AgentのProvider別モデル定義では、GPT-5.6系は openai-api 側にも含まれている。

そのため、今回の問題は「GPT-5.6系が openai-api に存在してはいけない」というものではなく、Providerを明示しない場合に認証状況を十分に考慮せず openai-api が優先されるケースがある点にある。

修正PR

Issue #102775に対する修正PRとして、以下が作成されている。

このPRでは、GPT-5.6系などが openai-api と openai-codex の両方に存在する場合に、

利用可能なOpenAI APIキーがない
利用可能なCodex OAuth認証がある

という条件では openai-codex を選択するよう、Provider判定を調整する修正が提案されている。

2026年9月8日時点では、Issue #102775はOpenで、修正PR #102786も未マージの状態となっている。

今後Hermes Agent側のアップデートによって、Providerを明示しなくても期待するProviderが選ばれるよう挙動が変更される可能性がある。

OpenAI公式情報

OpenAI公式ヘルプでは、Codex CLIなどでChatGPTアカウントを利用してサインインできることが案内されている。

備忘

Hermes Agent + GPT-5.6 + Codex OAuthでエラーになった場合は、まずモデル名と provider: openai-codex の指定を確認する。

今回もモデル名まわりの設定を調整することでエラーを解消できた。

そのため、同様のエラーが発生した場合は、

モデル自体が利用できない
Codex OAuthの認証に失敗している

とすぐに判断するのではなく、Hermes Agent側のモデル名・Provider判定も確認するのがポイント。

※この問題はHermes Agent側のProvider判定に関連するもので、GPT-5.6やCodex OAuth自体が利用できないという意味ではない。

※2026年9月8日時点ではIssue #102775はOpenで、修正PR #102786も未マージのため、利用時点のIssue・Pull Request・リリースノートもあわせて確認することをおすすめする。