간단한 답변
이 사례에서 검토한 Hermes 구현에서는 모델 선택기에 공급자당 최대 50개 모델이 표시됩니다. 이는 모델 선택기에 전송되는 데이터에 대한 제한이지, API 키의 모델 권한에 대한 제한이 아닙니다. API 엔드포인트나 Hermes 캐시에는 더 많은 모델 ID가 포함될 수 있습니다. 표시되는 목록에 없는 모델도 전체 ID를 사용해 선택할 수 있지만, 각 모델은 별도로 테스트해야 합니다. 모델 선택기는models 필드를 model_ids[:max_models]로 자르지만, total_models에는 자르기 전의 개수가 유지됩니다. 따라서 50 available은 메뉴에 최대 50개 항목이 표시된다는 의미이지, 공급자에게 모델이 50개만 있다는 의미는 아닙니다.
동일한 백엔드, 프로필, 공급자 및 모델 카탈로그를 공유하는 경우 Hermes Desktop과 터미널 선택기는 동일한 선택 로직을 사용해야 합니다. 개수가 다르다면 모델 선택기에 전체 카탈로그보다 적은 모델이 표시되는 이유는 50개 제한일 수 있지만, 먼저 두 화면에서 동일한 공급자와 카탈로그를 사용하고 있는지 확인해야 합니다.
세 가지 목록 이해하기
문제 해결 단계
- 제공업체 행 확인:
openai-api,openai,openrouter는 각각 별도의 제공업체 항목이며, 제한은 각 제공업체에 개별적으로 적용됩니다. 한 제공업체의 선택 가능한 개수와 다른 제공업체의 전체 카탈로그 개수를 비교하는 대신, 데스크톱과 CLI에 같은 행이 표시되는지 확인합니다. - 모델 ID가 없으면 직접 입력: 채팅에서
/model gpt-5.5를 사용하거나hermes chat --model gpt-5.5로 세션을 시작합니다.gpt-5.5를 API 엔드포인트에서 반환된 정확한 모델 ID로 바꿉니다. 현재 설정에서 Hermes에 필요하다면 제공업체 접두사를 추가합니다. - 기본 모델 설정 및 확인:
hermes config set model.default gemini-3.8-flash을 사용한 다음hermes config show을 실행하여 값이 올바른 필드에 기록되었는지 확인합니다.hermes config set은 모델 이름을 사용할 수 있는지 검증하지 않으므로 실제 요청으로 확인합니다. - 목록 제한과 호출 실패 구분: 항목이 50개 표시된다는 것은 선택기 메뉴가 잘렸다는 의미일 뿐이며, 50번째 항목 이후의 모든 모델을 사용할 수 있다는 뜻은 아닙니다. 전체 모델 ID로 최소한의 요청을 보내고, APIYI 호출 로그에서 전달 여부, 상태 코드, 오류 세부 정보를 확인합니다.
config.yaml 설정은 없습니다. 같은 Hermes 버전, 프로필, 제공업체, 캐시를 사용하는데도 데스크톱과 CLI의 개수가 계속 다르면 제공업체 이름, 전체 모델 ID, Hermes 백엔드 버전, 호출 로그를 기록합니다. 로그를 공유하기 전에 API 키를 삭제합니다.
관련 문서
Hermes의 공식 참고 자료는hermes-agent.nousresearch.com/docs/user-guide/desktop, hermes-agent.nousresearch.com/docs/user-guide/configuring-models, hermes-agent.nousresearch.com/docs/reference/model-catalog를 참조하세요.