Skip to main content
업데이트: 2026-06-06
crazyrouter-hermes를 통해 Hermes Agent의 모델 백엔드를 Crazyrouter로 전환할 수 있습니다. 설정을 완료하면 Hermes는 Crazyrouter의 OpenAI 호환 base_url을 사용하며, 하나의 Crazyrouter API Key로 Claude, GPT, DeepSeek, Gemini, Qwen 등 627개 이상의 모델을 호출합니다.

​
적합한 대상

  • 이미 Hermes Agent를 설치했고 바로 Crazyrouter에 연결하고 싶은 사용자
  • 로컬 Agent에서 Crazyrouter 모델과 크레딧을 통합해서 사용하고 싶은 사용자
  • 명령 한 줄로 OPENAI_API_KEY, OPENAI_BASE_URL, 기본 모델 설정을 완료하고 싶은 사용자

​
사전 조건

Hermes는 OpenAI 호환 설정으로 Crazyrouter에 연결하며, 기본 연결 주소는 https://api.crazyrouter.com/v1을 직접 사용합니다. 특정 클라이언트에 루트 도메인을 입력해야 할지 /v1을 입력해야 할지 확실하지 않다면 먼저 API Endpoint 설명을 참고하십시오. 계정 로그인, 충전, 콘솔은 여전히 https://crazyrouter.com을 사용합니다.

​
원클릭 설정

스크립트가 Crazyrouter API Key 입력, 기본 모델 선택, 선택적으로 연결 테스트까지 안내합니다.
원클릭 스크립트는 로컬 Hermes 설정을 덮어씁니다. 실행 전에 기존 ~/.hermes/.env와 ~/.hermes/config.yaml을 먼저 백업하는 것을 권장합니다.

​
수동 설정

스크립트를 실행하고 싶지 않다면 Hermes 설정 파일을 수동으로 작성할 수도 있습니다.

​
환경 변수

~/.hermes/.env를 편집합니다.
기본적으로 이 국제 API 연결 주소를 유지하면 됩니다. 이 주소는 API 요청에만 사용되며, 계정 로그인, 충전, 콘솔은 여전히 https://crazyrouter.com을 사용합니다.

​
기본 모델

~/.hermes/config.yaml을 편집합니다.
기본값으로도 국제 API 연결 주소를 유지하는 것을 권장합니다.
default를 Crazyrouter 토큰에서 이미 허용한 모델로 변경하면 됩니다.

​
모델 전환

설정이 완료되면 Hermes 내에서 언제든지 /model로 모델을 전환할 수 있습니다.
전환 후 model not allowed 또는 403이 반환된다면 보통 현재 Crazyrouter 토큰이 해당 모델을 허용하지 않은 경우입니다.

​
검증 체크리스트

  • ~/.hermes/.env의 OPENAI_API_KEY가 유효한 Crazyrouter 토큰인지
  • OPENAI_BASE_URL이 https://api.crazyrouter.com/v1인지
  • ~/.hermes/config.yaml의 provider가 custom인지
  • 기본 모델이 Crazyrouter 토큰에서 허용되었는지
  • Hermes에서 테스트 메시지를 보내면 정상적으로 응답이 오는지
  • /model gpt-5.5 또는 다른 허용된 모델로 전환이 성공하는지

​
자주 묻는 질문

crazyrouter-hermes 저장소 보기

원클릭 설정 스크립트, 수동 설정 예시, 최신 안내를 확인합니다.