메인 콘텐츠로 건너뛰기
내용 업데이트: 2026-10-12
crazyrouter-hermes를 사용하면 Hermes Agent를 Crazyrouter를 모델 공급자로 변경할 수 있습니다. 설정이 완료되면 Hermes는 https://api.crazyrouter.com/v1를 OpenAI 호환 endpoint로 이용하고, 한 개의 Crazyrouter API Key로 Claude, GPT, DeepSeek, Gemini, Qwen 등 627개가 넘는 모델에 요청할 수 있습니다.

누구에게 적합한가요

  • Hermes Agent 사용자 중 Crazyrouter를 모델 공급자로 사용하고 싶은 분
  • 모델과 쿼터를 Crazyrouter로 통합 관리해야 하는 로컬 agent 사용 시나리오
  • OPENAI_API_KEY, OPENAI_BASE_URL, 기본 모델을 한 번에 설정하고 싶은 분

요구 사항

Hermes는 OpenAI 호환 설정을 통해 Crazyrouter에 연결됩니다. Base URL은 https://api.crazyrouter.com/v1여야 합니다.

한 번에 설정하기

스크립트는 Crazyrouter API Key 입력, 기본 모델 선택 및 필요시 연결 확인을 요청합니다.
스크립트는 Hermes의 로컬 설정 파일을 덮어씁니다. 기존 설정이 있다면, 먼저 ~/.hermes/.env 및 ~/.hermes/config.yaml을 백업하세요.

수동 설정하기

스크립트를 실행하지 않으려면 Hermes를 수동으로 설정할 수 있습니다.

환경 변수

~/.hermes/.env를 수정하세요:

기본 모델

~/.hermes/config.yaml를 편집하세요:
default를 Crazyrouter 토큰에 허용된 모델명으로 교체하세요.

모델 전환

설정이 완료되면 Hermes 내에서 /model를 통해 모델을 전환할 수 있습니다:
전환 시 model not allowed 또는 403 메시지가 나오면, 선택한 모델이 현재 Crazyrouter 토큰에서 허용되지 않은 경우가 많습니다.

체크리스트

  • OPENAI_API_KEY가 ~/.hermes/.env에 있는지, 유효한 Crazyrouter token인지 확인하세요.
  • OPENAI_BASE_URL가 https://api.crazyrouter.com/v1와 동일한지 확인하세요.
  • provider가 ~/.hermes/config.yaml 내의 custom와 동일한지 확인하세요.
  • 기본 모델이 Crazyrouter token에 허용되어 있는지 확인하세요.
  • Hermes가 테스트 메시지에 응답하는지 확인하세요.
  • /model gpt-5.5 또는 허용된 다른 모델이 정상적으로 전환되는지 확인하세요.

자주 발생하는 문제

crazyrouter-hermes 저장소 열기

설정 스크립트, 수동 설정 예제, 최신 참고사항을 확인하세요.