Hermes Agent에서 AI provider 설정하는 방법

AI provider 설정 유형

Hermes Agent에서 AI provider를 설정하는 방법은 크게 2종류인 것 같습니다.

• 1번째 방법: gateway를 연동(예: OpenRouter)
• 2번째 방법: Hermes Agent가 직접 AI provider를 연동

 

token으로만 AI를 사용하고 있다면 gateway를 연동하면 좋습니다. 구독 형태로 사용하고 있는 AI가 있다면 Hermes Agent에 직접 AI provider를 연동합니다. 단, AI provider가 자사가 아닌 타사에 OAuth를 제공해야 합니다. Claude는 2026년 6월 기준 Max 구독제만 타사에 OAuth를 제공합니다.

• 참고자료: https://hermes-agent.nousresearch.com/docs/integrations/providers

 

AI provider 설정 방법

model 설정은 Hermes 공식 문서를 0순위로 참고하는 게 좋습니다.

• model 설정 문서: https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models

 

Hermes Agent CLI로 설정

hermes model 명령어는 AI provider를 설정합니다. hermes model 명령어는 ~/.hermes/config.yaml을 수정합니다.

hermes model

hermes model 명령어에서 선택한 AI provider는 기본 AI provider로 선택됩니다. AI provider를 세부적으로 설정하고 싶으면 ~/.hermes/config.yaml 파일을 직접 수정합니다.

 

설정 파일에서 직접 설정

AI provider 설정은 Hermes 설정 파일인 ~/.hermes/config.yaml에 관리됩니다. 이 파일을 직접 수정하여 AI provider 설정을 수정할 수 있습니다.

• model 필드: 기본으로 사용하는 AI provider 설정
• fallback_providers 필드: 기본 AI provider 사용에 실패했을 때 사용하는 AI provider
• auxiliary 필드: 기본 AI provider 이외에 추가로 사용하고 싶은 보조 AI provider 설정

$ cat ~/.hermes/config.yaml
model:
  default: gpt-5.5
  provider: openai-codex
  base_url: https://chatgpt.com/backend-api/codex
fallback_providers: []
auxiliary:
  vision:
    provider: auto
    model: ''
    base_url: ''
    api_key: ''
    timeout: 120
    extra_body: {}
    download_timeout: 30
  web_extract:
    provider: auto
    model: ''
    base_url: ''
    api_key: ''
    timeout: 360
    extra_body: {}

 

AI provider OAuth 설정 확인

hermes auth list 명령어로 Hermes Agent가 관리하는 인증 정보를 조회할 수 있습니다. 저는 Codex를 OAuth로 연동해서 OAuth 인증 정보가 보입니다.

hermes auth list

 

참고 자료

• https://hermes-agent.nousresearch.com/docs/integrations/providers